# 项目交接文档：模型库 / 模型管理子系统 MVP

## 1. 当前阶段

已完成 QPI 和思想考古学两个样板模型的本地工程化打样。

当前状态：模型内容通过本地 contract，但仍是 `draft`，等待产品 / ChatGPT / CCRA 内容审查。

## 2. 本轮目标

验证 QPI 和思想考古学两个核心模型，能否被整理为：

- 人读模型卡
- 机器可读 JSON
- 来源文章索引
- 来源证据片段
- 回归测试用例
- schema 校验对象
- 最小规则选择器对象
- model/card index 条目

## 3. 已完成内容

- 建立 GPT 规划本地化协议。
- 建立模型抽取规则。
- 建立模型卡结构规范。
- 建立模型抽取工作流。
- 建立知识资产规则。
- 建立 ChatGPT 交接规则。
- 建立 `knowledge_assets/` 长期知识资产目录。
- 创建 model/card/source/excerpt/regression/index schemas。
- 创建 QPI 和思想考古学的 JSON model card。
- 创建 QPI 和思想考古学的 Markdown card。
- 创建 source article 和 source excerpt 索引。
- 创建 regression cases。
- 创建 selector rules 和 selector examples。
- 创建 model index 和 card index。
- 创建 validator、card contract checker、selector demo。

## 4. 关键文件路径

规则和流程：

- `docs/GPT_PLAN_LOCALIZATION_PROTOCOL.md`
- `docs/MODEL_EXTRACTION_RULES.md`
- `docs/MODEL_CARD_CONTRACT.md`
- `docs/MODEL_EXTRACTION_WORKFLOW.md`
- `docs/CHATGPT_HANDOFF_RULES.md`
- `docs/KNOWLEDGE_ASSET_RULES.md`

长期知识资产：

- `knowledge_assets/00_用户背景与产品上下文.md`
- `knowledge_assets/01_核心模型地图.md`
- `knowledge_assets/02_模型卡结构规范.md`
- `knowledge_assets/03_核心模型抽取样板.md`
- `knowledge_assets/06_模型稳固性评级规则.md`
- `knowledge_assets/07_产品规划过程记录.md`

模型资产：

- `models/qpi.model.json`
- `models/intellectual_archaeology.model.json`
- `cards/qpi.md`
- `cards/intellectual_archaeology.md`
- `models/model_index.json`
- `cards/card_index.md`

数据与测试：

- `sources/source_articles.json`
- `sources/source_excerpts.json`
- `tests/regression_cases.json`
- `selector/selector_rules.json`
- `selector/selector_examples.json`

校验：

- `scripts/validate_model_library.py`
- `scripts/check_card_contract.py`
- `scripts/run_selector_demo.py`
- `reports/validation_report.md`
- `reports/内容修复检查摘要_v0.1.md`

## 5. Codex 实现和原计划的差异

- 原 GPT 规划是外部计划；Codex 已将其转为本地规则、schema、workflow、index 和工具。
- 原 GPT 规划建议长期知识库文件名带版本号；本地决定文件名不带版本号，版本写入文档内部。
- 原 GPT 规划建议可包含具体模型卡长期资产；本地决定不复制具体模型卡，具体模型卡 source of truth 保持在 `cards/` 和 `models/`。
- 原 GPT 规划中的 `source_index.json` 被拆分为 `sources/source_articles.json` 和 `sources/source_excerpts.json`。
- regression cases 当前使用合并文件 `tests/regression_cases.json`，未按模型拆分。

## 6. 当前问题

- QPI 和思想考古学内容通过 contract，但仍需产品语义审查。
- source evidence 是否足够支撑所有字段，仍需进一步判断。
- regression cases 是样板级，真实业务案例仍不足。
- selector demo 可运行，但评分逻辑仍是 v0.1 简单规则。
- 长期知识资产刚建立，需要确认是否还缺 `04/05` sample 类文件。

## 7. 需要 ChatGPT / CCRA 判断的事项

- QPI 当前字段和边界是否准确。
- 思想考古学是否应保持七层结构，还是需要更强的停止条件表达。
- 是否应引入第三个核心模型。
- 从产品角度看，后续模型抽取是否需要拆成抽取、检验、评分三个环节。
- 如果需要多环节审查，这三个环节的质量标准分别是什么。
- 当前 QPI / 思想考古样板是否已经暴露出需要多角色审查的质量问题。
- regression cases 是否应按模型拆分。
- selector 应继续规则化，还是加入 LLM 判断层。

## 8. 下一步候选方向

- 继续完善模型管理子系统。
- 接入最小问题回答流程。
- 扩展到第三个核心模型。
- 做模型稳固性评级审查。
- 扩展 regression cases。
- 评估是否需要抽取、检验、评分三段式审查流程。

## 9. 验证结果

已运行：

```powershell
python -m unittest discover -s tests -p "test*.py" -v
python scripts\check_card_contract.py
python scripts\validate_model_library.py
python scripts\run_selector_demo.py
```

结果：

- Unit tests: PASS, 9 tests.
- Card contract: PASS.
- Model library validation: PASS.
- Selector demo: PASS.
- `reports/validation_report.md`: `Status: PASS`.
