code4history/UPGRADE_v0.8.md

v0.8 迁移说明：人机交接区

v0.8 新增 /upload、/requests、/todo、/handoff，以及 01_sources/provenance 和 tools/interaction.py。

不在旧研究仓库上直接解压新模板。 使用 python tools/migrate.py upgrade --source OLD --template code4history-v0.8.zip --target NEW，或 export/restore 两阶段迁移。先使用 --dry-run 查看将迁移的研究文件与框架定制。

新目录既保留旧 topic.md、USERINFO.md、STATE.md、史料、笔记、论文，也保留已存在的旧用户自定义交接文件（如 /todo/TODO-*.md、/requests/*.md、/upload/*.pdf、/upload/*.source.md、/handoff/latest.md）。不让新模板的空白内容覆盖已填交接事项。自行改过的框架入口和 Skill 仅供人工比对，不自动覆盖 v0.8。

迁移完成后在新目录执行 python tools/interaction.py scan 与 python tools/validate.py，确认收件箱与待办；处理遗留上传时不得因为迁移即视为已归档。