01
Agent 写入
Agent 直接读写 .hy.md
已有：五种围栏块；外部改动自动重读
还差：给 AI 的写作契约（T8）
已完成代码与验收均已完成
进行中正在推进
完善中代码已有，界面走查待验证
规划中方案已定，尚未实现
Vision
十年之后，依然是：本地、纯文本、人签字
AI 越来越会写初稿，但签字的始终是人。HyMd 想做的，是让这份“签字前的最后一稿”有一个可靠、可审计、长期可读的家。
-
1年
工程师日常在 HyMd 里定稿
有体检、有确认、能签字导出。打开一份 AI 写的计算书，HyMd 告诉你哪里有问题、哪些数字还没人核过，确认后一键交付。
-
3年
.hy.md成为团队的公共交付格式团队里的 Agent 和人用同一种文件交接：Agent 写入，人审阅、修改、确认，再交回 Agent 继续。
-
5年
围栏块稳定，第三方工具可降级读
电子表格、幻灯、图版、排版参数等扩展块的写法稳定下来；任何普通 Markdown 工具都能读出正文，不会读坏。
-
10年
本地、纯文本、人签字
文件在你自己的电脑上，用任何文本工具都能打开；最后对内容负责的，是签字的那个人。
短期方针：先把已写的功能验到“用户看得见”，再补文档体检与审阅确认；分层、预算、准入清单仍是硬约束。
Where we are
定稿闭环：已经有的，和还差的
“Agent 写入 → 人审阅 → 改 → 确认与导出”是 HyMd 要打通的往返。四步的基础能力代码都已具备，下面是诚实的缺口清单。
02
审阅
一眼看出新改动和未核的数字
已有：所见即所得 Git Diff、行尾归属
还差：待确认 / 已确认标记（T7）
03
修改
改表、改图注、调排版、对数字
已有：文内电子表格、图版块、纸面排版、主题
还差：calc 求值（T10）、交叉引用（T9）
04
确认与导出
签字，交出别人能打开的文件
已有：Word / PDF / 幻灯导出，四种视图
还差：定稿状态、导出前体检（T6）
优先级顺序：G0 验收门 → 文档体检 → 审阅确认 → Agent 契约 → 交付纸面 → calc 求值。
Phases
阶段计划：一道验收门，三条主线
所有后续阶段都排在 G0 验收门之后。G0 不加新功能，只做一件事：把已经写好的功能在真实窗口和干净电脑上逐项验一遍。
G0
验收门 进行中
单测通过不算通过，GUI 走查才算。G0 通过之前，我们不会把任何功能称为“已验证”。
47 步界面走查按验收手册逐步点过编辑、表格、纸面、导出、四种视图等（第 44–47 步为“一源四视图”）。
干净机安装冒烟在没有开发环境的电脑上安装 NSIS 安装包，确认不依赖开发机残留。
三口径 CAD 对照TSSD / 微软雅黑 / 宋体三套字体，导出对照数据与 AutoCAD 实测逐行比对。
包与应用单测构建与类型检查GUI 走查干净机冒烟
视图线
- T0 文档约束已完成
产品口诀、架构约束、路线文档定稿。
- T11 幻灯视图完善中
整篇按标题自动切页，marp-core 渲染，应用内拍图导出 pptx / pdf。代码已完成，界面待走查。
- T12 论文视图完善中
中文期刊单栏 / IEEE 双栏模板，引用按首次出现编号，导出 PDF。代码已完成，界面待走查。
定稿线
- T6 文档体检规划中
把底部“问题”面板做实：失联锚点、可疑之处集中列出，导出前过一遍。
- T7 审阅确认规划中
段落、数字可打“待确认 / 已确认”标记，标记可降级保存，不破坏纯文本。
- T9 交付纸面规划中
页眉、页脚、页码与交叉引用，让导出件可以直接归档。
- T10 calc 求值规划中
计算块最小求值并写回围栏；之后再做单位与量纲检查。
协作与工程线
- T8 Agent 契约规划中
一份给 AI 的
.hy.md写作规范，让 Agent 写出的稿子天然适合人来定稿。可与 T6 并行。 - T1 检查脚本规划中
依赖方向与单文件行数预算挂进自动测试，防止架构变形。
- T2 状态整理规划中
拆分过大的文档状态中心，为后续功能腾出空间。
后期预留：可编辑的幻灯 pptx（在拍图出口通过界面验收之后）、calc 单位与量纲（在最小求值验过之后）、轻量的“人类确认 / 来源”字段——把产物与生成它的代码、环境、对话绑在一起。
Next up
近期重点
按优先级排列。P0 是公开发布前必须完成的事。
P0
- 界面走查 1～47 步，其中 44–47 步专门验证“一源四视图”。
- 三口径 CAD 对照夹具：导出对照数据，在 AutoCAD 里逐行比较；目标是中文字数差 ≤ 1、单行 / 双行高度差 < 0.2 mm。
P1
- 宋体字形比例精修；研究图纸多行文字是否应禁止标点出现在行首。
- 架构检查脚本（依赖方向 + 行数预算）。
- Git 侧栏的窗口走查。
P2
- 简单图片编辑、本机识字、Word / PPT / 表格 / HTML / 作图界面走查。
- Word / PPT 默认只读打开，需要时在同目录转写出一份
.md，不动原文件。 - 内部代码结构整理与工具链升级。
Directions
调研已有结论的功能方向
每个方向都先做过调研、比较过开源方案与许可证，再决定要不要做、怎么做。以下均为规划，上线时间以实际验收为准。
导出不用装任何东西 完善中
Word 由内置的 remark-docx（MIT）直接生成，公式先转为 SVG，以后自写原生 Word 公式。接下来补 PDF 页码与书签、Word 页眉页脚、Mermaid 在 Word 中成图。
Word 原件编辑 规划中
在主区用 Apache-2.0 许可的 docx-editor 直接改 .docx 并存回，首次保存自动留一份 .bak。
Office / PDF 只读与转写 规划中
Word、PPT、PDF 在文件树里默认可见、只读、可拖选复制；需要时在同目录写出同结构的 .md。
更强的本机识字 规划中
从 PP-OCRv5 mobile 升级到更新的模型；“字码 → 字形 → 像素”三级取字，有文字层的页面永远不走 OCR。
作图板扩展 规划中
第一版是平面函数与几何（JSXGraph），后续范围包含符号计算（CAS）与三维作图。
图片与版式 规划中
图版块统一适配框与 DPI 检查为必做，单张标注其次，再加 8 个固定区域版式的画廊。
Git 多仓库 规划中
自动识别父目录下的多个子仓库，状态栏跟随当前文件所属仓库。
论文视图著录 规划中
中文著录按 GB/T 7714—2025，IEEE 纸型 US Letter。界面只写模板名，不写“符合某标准”。
多视图进阶 规划中
合订导出与拆开、把视图里的修改“提升”回原稿、从视图派生新原稿、模糊摘录锚点。
Citation vision
引用落到句子，带上原文与可信度
这是 HyMd 文献方向的核心目标：每一句话的出处都能悬停查看原文片段，并带着撤稿、关注声明、更正等可信度信号——而且全部保存在文档本身里。
烟酰胺被认为可以保护视网膜神经节细胞。小鼠膳食烟酰胺在最高剂量使 93% 眼不发生青光眼 [@williams2017vitamin]。另一项转录组研究提出了损伤后的核心程序 [@tian2022core]。
原文片段 · 摘要支持
…前文（灰字）… 来源原文中支撑这句话的那一段 …后文（灰字）…
DOI 已核验检查时间与来源
撤稿
关注声明
更正 / 勘误
新版本
已核实
无法核实
界面示意 · 规划中（C2 / C4）
句子级引用
引用就是正文里的标准 Pandoc 文本 [@key, p. N]，写在句末。换任何编辑器都不会丢，Pandoc 可以直接排版。
原文锚点
每条引用可挂一段原文片段（W3C TextQuoteSelector），两头都记：本稿被支持的那句话，和来源里的原话。锚点存在文档元数据或旁车文件里，不污染正文。
可信度层
覆盖撤稿、关注声明（EoC）、更正、新版本与 DOI 存在性；中文文献无可查来源时标“无法核实”。没查过就显示“未检查”，绝不显示成“无问题”。
自动化只出候选，人来确认
原文补回、错位修正、可信度判定都只给候选并排序，不自动采纳；确认时由你选择“支持 / 部分支持 / 相反”。
常见文献工具的引用
- 只到“哪篇文献 + 第几页”，没有句子与原文片段
- 原文高亮插入 Word 后与 PDF 位置断开
- 引用藏在私有域代码里，换编辑器、手改文字可能失效
- 只提示撤稿，关注声明和更正不提示
HyMd 的目标 规划中
- 句子级引用，锚点可收窄到分句
- 原文片段随文档走，插入、复制、导出都不断链
- 纯文本 Pandoc 引用 + 文首 CSL YAML，离线照样渲染
- 撤稿 / 关注声明 / 更正 / 新版本全类型提示
原型已验证
修复 OpenEvidence 粘贴稿
把 OpenEvidence 的回答粘进编辑器后，原本的引用只剩编号加链接，原文片段、证据信息、撤稿信号全部丢失。HyMd 的导入原型在一份真实样稿上做到了：
181→84181 个散乱标记合并为 84 个 Pandoc 引用组
123/123123 条文献全部解析并拿到 PMID
4条文献被查出有事后更新
3处疑似引用错位被自动标出
0转换后的稿子用 Pandoc 渲染零告警
以上为单份真实样稿上的原型结果，不代表所有稿件。产品命令“修复 OE 粘贴稿”（C3b）排在引用路线前列，尚未上线。
Literature & citation tracks
文献库与引用：两条并行路线
文献库主线预计约 20–24 周（1–2 人）。文献与引用功能包含在 HyMd 标准版（及专业版）中。
文献库 M0–M4
- M0 打底待验收
DOI 查询不卡界面、按注册机构分流（知网 DOI 给提示）、写回时保留手加字段、结构化作者、多键引用。代码已合入主线，待手动验收。2–3 周
- M1 工程文献库规划中
工程目录下
refs/一条一文件；只读读取本机 Zotero；导出 BibTeX / CSL-JSON。4–6 周 - M2 引文校验 v1规划中
对照 Crossref、doi.org、PubMed、arXiv 核验引文是否真实存在。4–5 周
- M3 著录样式规划中
自写 GB/T 7714—2025 中文著录 + Hayagriva 英文样式，可选交给 Zotero 代排。4–5 周
- M4 附件与批注暂不排期
附件管理、pdf.js 批注、全文检索。可选，默认不开工。
引用 C1–C7
- 基础已就绪待验收
RIS / BibTeX / CSL-JSON 导出；Zotero 快速复制；从引用跳回 Zotero 的 PDF 页与批注；在 Zotero 原生对话框里插引用。已合入主线，待手动验收。
- C1 格式与稳定性下一轮
中文引用键、页码等定位信息拆分、CSL YAML 读写、未改动的块按字节原样保留、按 PMID 去重。
- C2 锚点模型与悬停卡规划中
句子切分、元数据与隐藏行互转、悬停卡片、“待重新确认”流程。
- C3 修复 OE 粘贴稿 / 粘贴时识别规划中
先做“修复已粘贴的稿子”（原型已在实样验证），再做粘贴时直接识别。
- C4 可信度层规划中
撤稿、关注声明、更正、新版本、DOI 存在性；中文无源标“无法核实”。
- C5 原文候选规划中
从 PubMed / Europe PMC 抓取摘要与全文，跨语言排序，一键确认并选择立场。
- C6 Zotero 批注 → 锚点规划中
把你在 Zotero 里做的高亮批注直接变成原文锚点。
- C7 导出与收尾规划中
锚点导出 CSV、原文附脚注、请 Zotero 排注释体（手动按钮）。
Out of scope
我们明确不做的事
说清楚不做什么，和说清楚做什么一样重要。专注，才能把定稿这一步做好。
产品边界
- 不做科研 Agent 工作台，不把聊天窗当产品中心
- 不做 Word / PPT 完整版式编辑
- 不做截图软件、图片软件
- 首版不做暗色主题
- 不做 VS Code 扩展市场、hex 编辑器
文献方向
- 不做浏览器连接器、Word / WPS 插件
- 不抓取知网
- 不做组库协作、WebDAV 同步
- 不做 AI 自动综述
- 不做移动端、WASM 插件
交付原则
- 代码已有但界面未验证的功能，对用户等于不存在
- 未实测不称“已验证”
- AGPL / GPL / LGPL 组件不进安装包
- 论文视图只出“作者稿的期刊样”，正式投稿仍用期刊模板