4.6 KiB
4.6 KiB
阶段 0 · 技术验证报告（实测记录）
验证时间：2026-11-13 · 环境：Linux 沙箱 Node v24.22.1（前端层验证）；Windows/WebView2/真实输入法为人工验证项，见 §4。 原型位置：
prototype/（Vite + React 18 + TS + Milkdown 7.23.0），UI 与测试共用src/editor.ts同一编辑器工厂。
1. 构建与自动化测试结果
| 项 | 命令 | 结果 |
|---|---|---|
| 依赖安装 | npm install |
✅（vite 降至 5.4.11 以匹配 @vitejs/plugin-react 4.3.3 的 peer 范围，已在 package.json 锁定） |
| 类型检查 | npx tsc -b |
✅ 0 错误 |
| 自动化测试 | npx vitest run |
✅ 6/6 通过（2 文件，约 2.5s） |
| 生产构建 | npm run build |
✅ 产物 JS 623KB / gzip 194KB（未分包，阶段 6 做代码分割） |
2. 自动化用例明细（tests/）
roundtrip.test.ts（双向转换，核心验收）
- ✅ 基础结构：H1/H2、粗体、斜体标记、删除线、行内代码、引用（含多段）、无序/有序/嵌套列表、分割线、链接 —— 内容保真，且第二轮往返与第一轮逐字一致。
- ✅ 复杂结构：任务列表
[ ]/[x]双状态、GFM 表格（含对齐列）、TypeScript 代码块语言与原文、图片相对路径、H6、Mermaid 代码块源码 —— 同上。 - ✅ 纯中文无格式段落往返稳定。
editing.test.ts（编辑行为）
4. ✅ 撤销/重做：程序化插入 → Ctrl+Z 等价命令恢复原文 → 重做再次应用。
5. ✅ 选区合法性：插入后选区落在文档模型合法区间，文档可继续序列化。
6. ✅ 编辑器 DOM 为真实 contenteditable（ProseMirror），非 textarea、非静态 HTML。
一次性探针（已跑，结论登记，不留常驻用例）
- 脚注
[^1]：定义与引用完整往返 ✅（超出官方预设宣传范围，阶段 3 转正前复测） - 行内 HTML
<u>与块级 HTML<div>：原文保留 ✅ - 引用内嵌列表、三级嵌套列表：结构保留 ✅
- 性能探针：158KB 文档 jsdom 全量加载 ≈3.6s、序列化 ≈0.27s —— jsdom 无布局引擎、显著慢于 WebView2，仅作悲观下界；产品指标阶段 6 在真机重测（需求 §20）。
3. 验证中发现并已处理的问题
- 序列化符号规范化：Milkdown 默认无序列表符号为
*，已设remarkStringifyOptionsCtx: { bullet: '-' }对齐 Typora 习惯；表格对齐冒号仍会规范化（:---→:-），语义无损、次轮稳定。已登记为选型报告已知限制 1。 - React StrictMode 双重挂载会重复创建 Milkdown 编辑器，原型已移除 StrictMode 并注释原因；正式版在编辑器组件内做幂等挂载处理。
4. 必须由大王在 Windows 人工验证的清单（沙箱无法替代）
阶段 0 结论为「有条件通过」，条件即以下四项在原型页面（npm run dev 后浏览器打开，或阶段 1 的 Tauri 壳内）人工确认：
- 中文 IME：微软拼音连续输入中文长句，组合区不提前上屏、不触发
#/列表等自动转换；搜狗拼音同验一轮。 - 即时渲染手感：键入
#、- [ ]、>、表格语法，转换即时、无闪烁、光标不跳位。 - 表格内编辑：单元格内增删文字、Tab 跳格、末格 Tab 新增行（末格新增行为阶段 3 完整实现，原型先验基础编辑与跳格）。
- 大段粘贴：从网页/Word 粘贴富文本，格式映射合理、无整篇重排卡顿。
5. 阶段 0 交付物对照（需求 §23）
| 交付 | 状态 |
|---|---|
| 技术验证 Demo | ✅ prototype/，可 npm run dev 运行 |
| 技术选型报告 | ✅ docs/01-tech-selection.md |
| 核心交互原型 | ✅ 原型含标题栏/菜单/侧边大纲/编辑区/序列化侧栏/状态栏 + docs/04-ui-prototype.md |
| 项目架构设计文档 | ✅ docs/02-architecture.md |
| 核心编辑体验实际操作测试 | ⚠️ 自动化部分全绿；真机手感部分待 §4 人工清单（需大王 Windows 环境） |
6. 未完成事项与下一阶段
- Tauri 壳、窗口/菜单/标签页正式实现 → 阶段 1（前置：Windows Rust 工具链）。
- 数学/Mermaid/代码高亮渲染、表格浮动工具栏、图片节点 → 阶段 3（原始文本保真已在阶段 0 锁定）。
- 源码模式（CodeMirror 6）与标记显隐装饰 → 阶段 2。
- 下一阶段计划（阶段 1）：Tauri 2 工程初始化、自定义标题栏、菜单栏骨架（仅真实可用项）、标签页、侧边栏容器、编辑器挂载、状态栏、基础明暗主题；验收：可启动、界面完整、打开/编辑/保存一个 .md 全链路走通。