# Windows 真机验收清单（阶段 0–3 合并版）

> 整理时间：2026-11-13 晚 · 对应已推送版本：Gitea `xieyinlu/new-markdown` main = `ac2c29d`（阶段 0–3）
> 来源：docs/03 §4（阶段 0）、docs/05 §4（阶段 1）、docs/06 §3（阶段 2）、docs/07 §3（阶段 3）。
> 本文件为合并整理，不含新功能；逐项打勾即可。发现的问题直接记在对应项后，阶段 4 前统一清零。
> 注意：本文件写于推送之后，**未随 ac2c29d 推送**，随下一次推送一并提交即可。

## 0. 前置与首次构建

前置：Rust stable（rustup）、Visual Studio Build Tools（C++ 桌面开发）、WebView2（Win11 自带）。

```powershell
cd new-markdown
npm install
npm run tauri dev
```

- [ ] 首次真机构建通过，窗口正常启动（沙箱因 libzstd 定制版装不上 GTK/WebKit 开发包，未能完整构建，见 docs/05 §2——属系统层问题，非工程问题）

## 1. 阶段 1：窗口 / 文件全链路

- [ ] 自定义标题栏可拖动、双击最大化、最小化/最大化/关闭三个按钮可用
- [ ] 打开一个真实 .md，再打开一个 GBK 编码的老文件：内容正确，状态栏编码 / 换行符显示正确
- [ ] 改两笔 → 标题栏与标签出现未保存圆点 → Ctrl+S 保存 → 圆点消失，用外部编辑器确认落盘内容
- [ ] 打开文件夹 → 文件树展开、点开第二个文件成新标签；拖拽标签排序；右键「关闭其他」
- [ ] 关一个未保存标签 → 弹保存确认，「保存 / 不保存 / 取消」三选都试一遍
- [ ] 视图：深色主题、源码模式切回不丢内容、Ctrl+= 放大（Ctrl+0 为「段落」，恢复缩放走视图菜单，见 docs/05 §3）

## 2. 阶段 0：IME 与即时渲染手感

- [ ] **中文 IME**：微软拼音连续输入中文长句，组合区不提前上屏、不触发 `#` / 列表等自动转换；搜狗拼音同验一轮
- [ ] **即时渲染手感**：键入 `# `、`- [ ] `、`> `、表格语法，转换即时、无闪烁、光标不跳位
- [ ] **大段粘贴**：从网页 / Word 粘贴富文本，格式映射合理、无整篇重排卡顿

## 3. 阶段 2：标记显隐 / 任务列表 / 源码模式

- [ ] **标记显隐**：光标进标题显 `#`、进引用显 `> `、进粗体/斜体/行内代码/删除线/链接显 `**` / `*` / `` ` `` / `~~` / `[…](href)`，移开即藏；保存后序列化与原文逐字一致
- [ ] **任务列表勾选**：`- [ ]` 渲染出真实复选框，点击勾选 → 文字变灰，保存后变 `- [x]`；再点可取消（可撤销）
- [ ] **代码块 Tab**：代码块内 Tab 插两空格、Shift+Tab 反缩进；普通段落 Tab 行为不变
- [ ] **源码模式（CodeMirror 6）**：行号、Markdown 高亮、深色跟随主题；渲染 ⇄ 源码切换光标大致回到原处、内容不丢
  - 已知边界：锚点同步是近似定位——同一段文字在全文重复出现时取首个匹配，可能落到同文的另一段（内容零丢失）
- [ ] **菜单粘贴**：菜单「粘贴」可用（已改 Clipboard API；阶段 1 的 execCommand 版在部分 WebView2 策略下可能被拒）

## 4. 阶段 3：表格 / 图片 / 公式 / Mermaid

- [ ] **表格**：Ctrl+T 插入 3×3；光标进表格出现浮动工具栏（加行 / 加列 / 删行 / 删列 / 整列对齐 / 删表，滚动跟随）；在**数据格**点整列对齐也能生效；Tab 跳格、Shift+Tab 回退、末格 Tab 自动新增一行
- [ ] **图片落盘**：粘贴截图 / 拖入图片 → 文件复制进 `<文档主名>.assets/`、Markdown 写相对路径；重名自动 `-1` 递增；文件名含 Windows 非法字符时被清洗
- [ ] **附件**：插入任意附件文件 → 以 `[文件名](相对路径)` 插入，链接标记不丢
- [ ] **数学公式**：行内 `$…$` 与块级 `$$…$$` 渲染成公式，保存往返无损
- [ ] **Mermaid**：mermaid 代码块渲染出真 SVG 图表（沙箱缺布局引擎未验到这一步）；块头可切「编辑源码 / 查看预览」；故意写错语法 → 显示错误原因、不白屏，仍能回源码
- [ ] **脚注 / HTML**：脚注定义与引用、行内 `<u>`、块级 `<div>` 往返稳定

## 5. 已知不做 / 留待阶段 6 的项（验到也不算问题）

- 图片暂无缩放 / 对齐操作条；表格无行列拖动排序、无多格拖拽选区
- 列表标记 `-` / `1.` 由浏览器样式天然呈现，不做显隐
- 表格对齐冒号首轮会被规范化（` :--- ` → ` :- `），语义无损、次轮稳定

## 6. 验完之后

- 清单全绿 → 可拍板进**阶段 4**（SQLite 落库、自动保存与崩溃恢复、外部修改检测、工作区新建/重命名/删除）
- 有问题 → 把未通过项贴回对话，按项修，不急着进阶段 4