# 辅助工具

## 职责
只负责生成模板、校验结构和组装正文；不自动确定历史事实真伪。

## 内容
按本目录职责存放 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)。