code4history/UPGRADE_v0.4.md

从 Code4History v0.3 升级到 v0.4

升级原则

• v0.4 调整的是研究解释与写作流程，不是研究事实、现有假说或具体选题。
• 补丁包不包含已有研究资料、topic.md、USERINFO.md、STATE.md、参考文献库及已建卡片，因此不会主动覆盖它们。
• 补丁会覆盖 AGENTS.md、code4history.md、主 Skill 的若干说明与相关模板。若已手动改写这些框架文件，请先建立 Git 提交或备份，并逐项合并改动。

操作

1. 在你自己的 Code4History 仓库中先提交或备份当前变更。
2. 解压 code4history-v0.4-framework-patch.zip 到包含 code4history/ 文件夹的上一级目录；确认合并覆盖框架文件。亦可手工复制本补丁中需要的文件。
3. 运行 python tools/validate.py 与 python -m unittest discover -s tests -v。
4. 在新的 Codex 会话中要求其读取根 AGENTS.md 与 INTERPRETATION.md，按更新后的主 Skill 继续现有课题。
5. 若旧会话已陷入防御循环，可将 QUICK_FIX.md 中的提示词直接发给 Codex，无需等待重新索引。

哪些内容没有变化

• USERINFO.md 保持用户自填优先级，补丁不写入任何内容。
• topic.md 仍使用 Q1—Q20，没有加入新的复杂配置。
• 三个 Skill 的名称、卡片编号、目录结构、工具命令保持兼容。
• 不降低原始文献、逐字引文、关键事实与数字的校验要求；仅取消不必要的解释和写作阻断。

**注意：**本次测试确认结构和工具功能，不能保证 Codex 在任何上下文下都不会再次保守化。如果现有会话积累了大量旧的反复审查记录，建议新开 Codex 会话并只读取持久化研究文件。