# TraceCite Roadmap

更新日期：2026-10-01（北京时间）。

按 **正式交付 → 日常维护体验 → 真实项目验证 → 生态接入** 推进。
项目持续围绕引用与来源的一致性、来源变化后的文档维护，保留人工复核入口。

## 当前基础

0.5.1 为本轮交付版本，继承 0.5.0 的项目配置、init/check、GitHub Action 和 portable 核心库。
本轮将验收说明、第三方许可及 13 步离线维护演示纳入正式包，按下面的清单完成发布与验证。
已发布内容与后续改动见 [版本记录](CHANGELOG.md)，交付证据见 [验收说明](docs/acceptance.md)。

下列版本为规划目标，尚未完成的事项保持未勾选；执行顺序与范围根据实际反馈调整。

## 0.5.1：发布收口

优先让 GitHub 和 Mooncakes 的正式交付材料一致。

- [ ] 将新增验收材料、许可通知纳入正式 Mooncakes 包。
- [x] 同步模块、CLI、安装示例和版本记录中的版本号。
- [ ] 创建 GitHub 版本标签和正式 Release，长期提供 Linux/macOS 独立包与 SHA-256 校验文件。
- [x] 发布脚本防止重复发布已有版本，核对构建来源与交付身份。
- [ ] 从实际注册表安装发布后的库和 CLI，验证公开 API 与维护流程。

**完成标准**：Mooncakes 安装、源码构建、独立包运行均通过，发布版本可对应固定提交。
执行步骤以 [发布指南](docs/publishing.md)为基础。

## 0.6.0：降低维护成本

优先改善团队反复检查、定位问题和复核来源变化的体验。

- [ ] 项目配置支持常用文件通配符，明确匹配、排除与空范围的行为。
- [ ] 补充 Setext 标题解析，并验证与当前锚点和快照机制的兼容性。
- [ ] 提供来源变化的集中复核报告和基线更新预览。
- [ ] 允许项目明确要求检查覆盖范围，复核网页跳过项与未绑定源码的代码块。
- [ ] 增加上述能力的边界测试和可运行维护示例。

**完成标准**：在一个示例项目中完成扫描、定位、修复、复核和更新基线，新增边界测试全部通过。
现有 [离线演示](examples/maintenance/README.md)继续作为维护闭环的回归验证。

## 0.6.x：真实项目验证

用实际维护反馈决定后续功能优先级。

- [ ] 接入 2–3 个实际 MoonBit 或技术文档仓库。
- [ ] 记录自然发生的来源变化、误报、漏检及修复过程。
- [ ] 为每个案例保存固定提交、检查结果和人工复核记录。
- [ ] 明确区分真实问题、受控演示和暂时无法核验的来源。
- [ ] 根据反馈修正默认行为，并为可复现问题增加回归测试。

**完成标准**：每个案例都可沿固定提交与复核记录追溯；采用与收益结论由实际数据支持。

## 0.7.0：完善生态接入

让新的 MoonBit 项目更容易使用核心库、CLI 或 Action。

- [ ] 增加可直接编译运行的 MoonBit 库接入样例。
- [ ] 简化 CI 模板，继续复用项目配置。
- [ ] 完善 JSON 诊断字段和兼容性说明，支持消费方稳定处理结果。
- [ ] 改善网页失败诊断，帮助维护者区分回源失败和引文需要复核的情况。
- [ ] 验证新项目按文档完成库、CLI 或 Action 接入。

**完成标准**：新项目可按文档完成接入，核心库的 native、JS、Wasm 三个编译目标保持验证通过。

## 更新与发布原则

每次更新都应包含清晰提交、CHANGELOG、可运行示例、相关测试和发布验证。
优先保持现有公开 API、命令和项目配置的兼容性；发生兼容性变化时，在版本记录中明确说明。
第三方组件继续保留各自许可和来源，具体要求见 [第三方通知](THIRD_PARTY_NOTICES.md)。

实施顺序为：先完成 0.5.1，再改善变化复核体验，同时尽早积累真实仓库反馈。
项目安装与当前用法见 [README](README.mbt.md)。