docs: 阶段0 技术验证（选型/架构/原型与验证记录）

docs/06-stage2-report.md

@@ -0,0 +1,36 @@
+# 阶段 2 · Markdown 编辑器核心报告（实测记录）
+
+> 日期：2026-11-13 · 范围（需求 §23 阶段 2）：即时渲染深化、标题/段落/格式/引用/列表/任务列表/代码块、撤销重做、源码模式、IME 兼容。
+
+## 1. 本阶段实现内容
+
+- **语法标记显隐**（`src/editor/plugins.ts`，自研 ProseMirror 插件）：光标所在块显示 Markdown 标记、其余块只显排版结果——标题显示 `#` 前缀、引用段显示 `> `、行内标记（`**`、`*`、`` ` ``、`~~`、链接的 `[` 与 `](href)`）在光标进入对应文本段时在段两端显形。纯 Decoration 实现：不进文档模型、不进撤销栈、序列化零影响（测试硬断言）。IME 组合期间冻结装饰重算，组合结束补算一次。
+- **任务列表可点击勾选**（`src/editor/nodeViews.ts`）：验证中发现 Kit 的 preset-gfm 只渲染 `<li data-checked>`、**没有真实复选框**（可点击勾选是 Crepe 组件层能力，选型时未覆盖到此细节）。已给 `list_item` 注册自有 NodeView：任务项渲染真实 checkbox，点击以一条事务切换 `checked`（可撤销），序列化自动回写 `- [ ]`/`- [x]`；普通列表项外观不变；完成项文字变灰。
+- **代码块键盘行为**：Tab 在代码块内插入两空格、Shift+Tab 反缩进（吞掉无缩进时的 Tab 防焦点跳走）；其余位置 Tab 不变。Enter 换行、粘贴代码走既有 Milkdown 行为。
+- **列表/结构命令回归**：段落转无序列表、列表项升降级等命令与阶段 1 菜单共用同一命令层，本阶段补齐自动化断言。
+- **源码模式升级**（`src/components/SourceEditor.tsx`）：textarea 换 **CodeMirror 6**——行号、Markdown 语法高亮（含代码块内嵌语言）、独立历史栈、括号匹配、Tab 缩进；深色跟随应用主题（oneDark）。组件懒加载，不进首屏主包。
+- **双向光标锚点同步**（`src/editor/cursorSync.ts`）：以「当前文本块纯文本 + 块内偏移」为锚，渲染→源码按行匹配定位、源码→渲染按文本块定位；重复文本取首个匹配，找不到回落开头，不丢内容。纯函数单测覆盖标题/任务/引用标记的剥离与往返一致性。
+- **IME 守卫**：全局快捷键入口统一 `isImeComposing` 判定（isComposing 或 keyCode 229 直接放行）；标记插件组合期冻结（见上）。真实输入法手感仍在 Windows 人工清单内（与阶段 0/1 清单合并）。
+- **菜单粘贴修复**：改走 Clipboard API 读纯文本后以事务插入选区，失败才退回 execCommand；源码模式聚焦 CodeMirror 走原生粘贴。
+
+## 2. 构建与测试结果（实跑）
+
+| 项 | 结果 |
+|---|---|
+| 类型检查 `tsc -b` | ✅ 0 错误 |
+| 自动化测试 `vitest run` | ✅ **31/31**（8 文件；本阶段新增 13：stage2 8 + cursorSync 4 + SourceEditor 冒烟 1） |
+| 生产构建 | ✅ 主包 646KB / gzip 202KB（SourceEditor 懒加载分包 539KB，语言高亮小块按需） |
+| 阶段 0/1 套件 | ✅ 全部继续绿（往返稳定、撤销、tabs、text 等 18 项） |
+
+新增用例要点：标记显隐三态（标题显形 → 粗体显形且标题标记消失 → 移开全隐）+ 序列化与原文逐字一致；引用 `> ` 显形；代码块 Tab 进/退；任务 checkbox 渲染 2 个且第二项 checked、**点击第一项后序列化变 `- [x]`**；段落转列表命令；纯文本插入；IME 判定；锚点往返；CodeMirror 挂载与锚点/跳行 API。
+
+## 3. 已知问题与边界
+
+1. **标记显隐覆盖范围**：当前覆盖标题、引用、五种行内标记。列表标记（`-`/`1.`）由浏览器列表样式天然呈现，不做显隐；链接显形为 `[文案](href)` 近似形态。嵌套格式（如粗体内斜体）按段逐标记显形，顺序为 schema 顺序，真机观感待验。
+2. **锚点同步是近似定位**：锚点文本在全文重复出现时取第一个匹配，可能定位到同文段落而非原段落（内容零丢失）。精确版需给块级节点加稳定 id，排阶段 6 体验优化评估。
+3. **SourceEditor 在 jsdom 仅冒烟**（挂载/API），真实滚动、中文输入与高亮观感随 Windows 清单验。
+4. 阶段 0/1 的 Windows 清单仍未销账（含 IME 真机四项）——本阶段没有新增必须真机的前置，但建议合并一次验完再进阶段 3。
+
+## 4. 下一阶段（阶段 3）预告
+
+复杂内容编辑：表格（浮动工具栏、增删行列、Tab 跳格/末格加行）、图片（插入/粘贴落盘/浮动操作条）、超链接编辑、数学公式（KaTeX 节点）、Mermaid（渲染节点 + 源码编辑）、脚注转正、HTML 块编辑、附件链接。验收口径不变：先给往返套件加用例再实现。