4.7 KiB
4.7 KiB
Windows 真机验收清单（阶段 0–3 合并版）
整理时间：2026-11-13 晚 · 对应已推送版本：Gitea
xieyinlu/new-markdownmain =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 自带）。
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