0.8

tools/readme.md

@@ -0,0 +1,21 @@
+# 辅助工具
+
+## 职责
+只负责生成模板、校验结构和组装正文；不自动确定历史事实真伪。
+
+## 内容
+按本目录职责存放 Markdown、索引或明确允许的原始资料。研究对象由仓库根目录 `topic.md` 决定，目录本身不绑定任何主题。
+
+## 约束
+- 研究断言与其引文应能追溯到 `01_sources` 中的具体来源和位置。
+- 不得为了符合预设结论而修订史料原文或删除反证。
+- 文件之间使用稳定 ID；更改解释时保留历史决定。
+- 若材料无法核实，明确写为 `unverified`、`pending` 或 `unknown`。
+
+返回项目总说明：[`code4history.md`](../code4history.md)。
+
+## 版本迁移工具
+
+`migrate.py` 与 `migration_baselines.json` 配套，用于识别 v0.1—v0.7 官方框架文件，导出项目自有研究资料并恢复至新版本。可分别使用 `export`、`restore` 或一键 `upgrade`，操作指南见根目录 `UPGRADE_v0.7.md`。脚本只使用 Python 标准库。
+
+新增 `interaction.py`：使用 `scan`/`intake`/`todo-new`/`todo-close`/`request-done`/`finish` 管理人机交接区。详见 [`INTERACTION.md`](../INTERACTION.md)。