@@ -0,0 +1,51 @@
+# Changelog
+
+User-facing changes to the document editor ([edit.chaxus.com](https://edit.chaxus.com/)).
+Format loosely follows [Keep a Changelog](https://keepachangelog.com/); this
+file is the single source for the site changelog page and GitHub release
+notes. Entries describe what users experience, not internal refactors.
+
+## [Unreleased]
+
+### Known issues
+
+- Editing complex real-world PPTX decks can raise "An error occurred during
+  the work with the document" (under investigation; a full regression
+  campaign against real-world documents is running and gates the next
+  release announcement).
+
+### Changed
+
+- The editor engine was upgraded to an OnlyOffice 9.3-based build: new
+  rendering engine and font pipeline, sharp toolbar icons on 2k/4k displays,
+  fonts loaded on demand instead of up front.
+
+### Added
+
+- PDF files now open in a dedicated PDF viewer/editor.
+- Legacy Word 97 binary `.doc` files now open correctly.
+- Read-only mode can be toggled at runtime (embed API `document:set-readonly`
+  works in both directions without reloading the document).
+- Comments work in the Word editor, including add/update/delete lifecycle
+  callbacks for integrators.
+- Editor errors now surface as a visible notification with the error code
+  instead of failing silently.
+- CSV files in legacy encodings (GBK/GB18030, e.g. Chinese "ANSI" exports
+  from Excel) are detected and decoded correctly instead of showing mojibake.
+
+### Fixed
+
+- Saving a document that contains an inserted image no longer freezes the
+  page; the image bytes are correctly included in the saved file.
+- Excel: right-aligned text no longer disappears after editing another cell.
+- Excel: the caret now moves visibly while editing inside a cell.
+- Word: the caret renders exactly at the insertion point (no more offset
+  caret on some documents).
+- Save-as-PDF produces a complete document instead of empty output.
+- Multi-sheet workbooks opened via the embed API save back with all sheets
+  intact.
+
+## [0.0.5] - 2026-07-12
+
+Last release of the previous (v7) engine line. See the
+[GitHub release](https://github.com/ranuts/document/releases/tag/v0.0.5).
@@ -241,9 +241,14 @@ E2E 在 CI 中依赖 `lint` job 成功后才运行（`needs: lint`）。
    `public/embed-demo.html`、404 等）必须使用 ranui 组件/设计 token
    （`--ran-*`）与 ranuts 工具，不允许手写游离于设计体系外的样式。
    demo 页也是产品门面，风格必须与主站一致。
-3. **循环依赖处理**：`onlyoffice-editor.ts` 与 `converter.ts` 之间通过回调注入（`setConverterCallbacks`）解耦；`ui.ts` 与 `document.ts` 之间通过 `setUICallbacks` 解耦
-4. **编辑器操作队列**：`createEditorInstance` 内部有 `editorOperationQueue`，防止并发创建/销毁编辑器
-5. **.claude/ 目录**：已加入 `.gitignore`，不提交本地 Claude Code 配置
+3. **用例固化制度（2026-08-15 起）**：每个缺陷修复与新功能必须附带
+   对应的自动化用例（E2E 优先），否则不算完成；回归类用例优先使用
+   真实复杂度语料而非手拼最小文档——合成文档全绿曾两次掩盖真实文档
+   的致命问题（插图保存假死、真实 PPTX 编辑报错）。CHANGELOG.md 随
+   用户可感知的改动同步更新。
+4. **循环依赖处理**：`onlyoffice-editor.ts` 与 `converter.ts` 之间通过回调注入（`setConverterCallbacks`）解耦；`ui.ts` 与 `document.ts` 之间通过 `setUICallbacks` 解耦
+5. **编辑器操作队列**：`createEditorInstance` 内部有 `editorOperationQueue`，防止并发创建/销毁编辑器
+6. **.claude/ 目录**：已加入 `.gitignore`，不提交本地 Claude Code 配置
 
 ---
 
@@ -404,7 +409,12 @@ v7 代码分支（OO_VARIANT、页面级 x2t 打开转换、empty_bin 模板、v
   `getDocumentType`）与文件选择 accept；保存与其他格式共用 file-stream 通道。
 - **错误提示**：编辑器 `onError` 会用 ranui message 弹 toast（含错误码与
   描述；-85 附"内容与扩展名不一致"提示），别再只留 console.error。
-- **待办**：无（截至 2026-08-15）。
+- **待办（最高优先级，2026-08-15 用户实测判定）**：v9 全面回归战役。
+  真实文档实测稳定性不如 v7（P0 现场：真实 35 页 PPTX 编辑标题弹
+  "An error occurred during the work with the document" 致命错误框）。
+  现有 E2E 全是手拼最小文档，真实文档复杂度零覆盖——战役方案与用例
+  固化制度见 docs/superpowers/plans/2026-08-15-next-phase-roadmap.md
+  方向零。v9 release 公告冻结至战役通过。
 
 ---
 
 
@@ -4,6 +4,51 @@
 前置状态：v9 已转正并即将替换 main 部署（main 备份为 backup 分支）；
 CLAUDE.md 代码侧待办已清零；E2E 17 条全绿。
 
+## 方向零：v9 全面回归战役（最高优先级，压倒其余全部方向）
+
+**背景（2026-08-15 用户实测判定）**：v9 上线后用真实文档实测，稳定性与
+可用性**不如 v7**。已确认的 P0 现场：一份真实的 35 页 PPTX
+（含主题、图片、代码截图）在编辑幻灯片标题时弹出
+"An error occurred during the work with the document. Use the
+'Download as' option to save the file backup copy to a drive."
+（OnlyOffice 的文档致命错误对话框）。同日刚修掉的"插图保存假死"
+也属于同类——**合成最小文档全绿，真实文档踩雷**。
+
+**根因反思（决定战役设计）**：现有 18 条 E2E 的 fixture 全部是页内手拼
+的最小 OOXML/最小 PDF——它们证明管线通，但真实文档的复杂度
+（主题、母版、动画、嵌图、大文件、多字体、修订痕迹）一点都没覆盖。
+两次教训同构：只验 embed-demo 漏掉主站路径；只验合成文档漏掉真实
+文档。**测试语料必须真实化**。
+
+### 战役内容
+
+1. **建立真实文档语料库**（前置，需要决策）：
+   - 来源：自制"复杂度全开"文档（每种格式一份：多页/主题/嵌图/表格/
+     动画/公式/修订/中英混排）、用户可提供的实际踩雷文件（如那份
+     EMP PPTX，仅本地测试不入库）、公开可再分发的样例。
+   - **仓库约束决策**：现行"不放二进制 fixture"规则与真实语料冲突。
+     建议：`test/fixtures/corpus/` 允许小体积（<2MB/个）自制真实文档
+     入库；大文件与版权不明文件走本地目录 + CI 缓存，不入库。
+2. **系统化测试矩阵**：三编辑器 × {打开、渲染无错、编辑（文字/图片/
+   格式）、保存往返、导出 PDF} × 语料库全量。判定不只看"不崩"：
+   拦截编辑器内 `asc_onError` 与 `Common.UI.warning`（正是本次 PPT
+   弹窗的通道）作为硬失败信号，console error 白名单化。
+3. **P0 缺陷清单驱动**：战役第一目标是复现并修复 PPTX 编辑致命错误
+   （需要那份 PPT 或等复杂度替代品）；每修一个，固化一条 E2E。
+4. **用例固化为制度**（用户要求）：
+   - 战役产出的每个缺陷修复**必须**带一条真实语料回归用例；
+   - 语料库测试作为独立 E2E project（`test/e2e/corpus-*.spec.ts`），
+     进 CI（体量大可设 nightly / 手动触发档）；
+   - 制度写入 CLAUDE.md：新功能/新修复没有对应用例不算完成。
+5. **发布门槛**：v9 的对外 release 公告（方向七 3）冻结，直到战役
+   通过——"稳定性达到或超过 v7"由语料矩阵全绿定义。
+
+### 与 v7 的关系
+
+backup/main-pre-v9 保留完整 v7。若战役发现 v9 有结构性不可修问题，
+回滚路径存在；但当前证据（图片保存已修、根因均为"无服务器适配缺口"
+而非引擎本体）支持"逐个补适配层"优先于回滚。
+
 ## 现状诊断（2026-08-15 页面盘点结论）
 
 存量 24 页落地矩阵（12 en + 12 zh-CN）的 SEO 工程质量很高：TDK、
@@ -224,7 +269,13 @@ llms.txt 形成互补）。结构化数据用 FAQPage / HowTo，并入 sitemap
 版本号语义由用户定）。它同时是方向二 3「外链发布事件」的弹药——发稿
 时有一个正经的 release notes 页可以指向，比空口说"升级了"有力得多。
 
-## 建议执行顺序（2026-08-15 更新：加入方向六、七，第 1 项已完成）
+## 建议执行顺序（2026-08-15 三修：方向零插入为最高优先级）
+
+**方向零（全面回归战役）压倒下表所有事项**；表内条目在战役期间仅在
+等待复现/等待用户提供语料的空档穿插推进。CHANGELOG.md 已建立
+（方向七 3 前半完成），但 v9 release 公告冻结至战役通过。
+
+## 原执行顺序（2026-08-15 更新：加入方向六、七，第 1 项已完成）
 
 | 序  | 事项                                             | 体量      | 状态               |
 | --- | ------------------------------------------------ | --------- | ------------------ |