# Codex 新会话交接文档：模型库 / 模型管理子系统 MVP

## 1. 当前状态

仓库：`C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong`

当前阶段：`model_library_mvp`

当前已完成：

- QPI 和思想考古学两个样板模型已工程化为模型资产。
- 本地规则、schema、workflow、index、validator、selector demo 已建立。
- ChatGPT 交接规则和长期知识资产规则已建立。
- `knowledge_assets/` 已建立，放置长期复用的规则性文档，不复制具体模型卡 source of truth。
- 索引维护已升级为脚本化规则：每次资产变更增量同步，关键节点全量重建或校验。
- `status` 已加入模型 JSON，作为 `models/model_index.json.status` 的来源字段。
- 第二轮内容稳定化已完成：字段级 evidence matrix、source excerpt quote 状态、QPI 输出契约、思想考古停止门、regression 扩展、selector v0.2、防误召回测试、JSON/Markdown 同步检查、content review report。

当前模型资产状态：

- `qpi`: `draft` / `B` / `pending`
- `intellectual_archaeology`: `draft` / `B` / `pending`

二者通过本地 contract，但仍等待产品 / ChatGPT / CCRA 内容审查。

当前 review 结论：

- draft-callable: allowed
- stable: not allowed
- third model expansion: not allowed

## 2. 下个 Codex 会话先读文件

按顺序读：

1. `AGENTS.md`
2. `README.md`
3. `reports/Codex新会话交接文档_模型库MVP_2026-06-16.md`
4. `reports/ChatGPT交接文档_模型库MVP_2026-06-16.md`
5. `docs/MODEL_EXTRACTION_WORKFLOW.md`
6. `docs/MODEL_EXTRACTION_RULES.md`
7. `docs/MODEL_CARD_CONTRACT.md`
8. `docs/CHATGPT_HANDOFF_RULES.md`
9. `docs/KNOWLEDGE_ASSET_RULES.md`
10. `docs/INDEX_MAINTENANCE_PROTOCOL.md`
11. `models/model_index.json`
12. `cards/card_index.md`

如果用户带回 ChatGPT 新建议，先按 `docs/GPT_PLAN_LOCALIZATION_PROTOCOL.md` 做本地化计划，不要直接改内容。

## 3. 已验证命令

最近一轮验证通过：

```powershell
python scripts\rebuild_indexes.py --check
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
python scripts\run_selector_regression.py
python scripts\check_model_card_sync.py
```

结果：

- Index check: PASS.
- Unit tests: PASS, 14 tests.
- Card contract: PASS.
- Model library validation: PASS.
- Selector demo: PASS.
- Selector regression: PASS.
- Model/card sync: PASS.
- `reports/index_rebuild_report.md`: `Status: PASS`.
- `reports/validation_report.md`: `Status: PASS`.

## 4. 关键规则

### GPT 规划规则

GPT 规划不是本地可直接执行规则。

必须先转为：

- local rules
- schemas
- workflow gates
- indexes
- validation tools
- owner review points

再进入内容修改。

相关文件：

- `docs/GPT_PLAN_LOCALIZATION_PROTOCOL.md`
- `docs/MODEL_EXTRACTION_RULES.md`

### ChatGPT 交接规则

每次用户从 Codex 回 ChatGPT 时，生成：

```text
reports/ChatGPT交接文档_<topic>_<YYYY-MM-DD>.md
```

相关文件：

- `docs/CHATGPT_HANDOFF_RULES.md`
- `reports/ChatGPT交接文档_模型库MVP_2026-06-16.md`

### 长期知识资产规则

稳定复用知识进入 `knowledge_assets/`。

不要把具体模型卡复制进 `knowledge_assets/` 作为第二 source of truth。

具体模型卡 source of truth 仍在：

- `cards/`
- `models/`

相关文件：

- `docs/KNOWLEDGE_ASSET_RULES.md`
- `knowledge_assets/`

### 索引维护规则

`models/model_index.json` 是机器发现入口。

`cards/card_index.md` 是人读审查入口。

二者不再作为独立手工内容源长期维护，而是从模型 JSON、card 文件和 regression cases 生成或校验。

规则：

```text
每次资产变更必须增量同步索引
+
关键节点必须全量重建或全量一致性校验
```

相关文件：

- `docs/INDEX_MAINTENANCE_PROTOCOL.md`
- `scripts/rebuild_indexes.py`
- `reports/index_rebuild_report.md`

### 内容稳定化规则

工程 contract 通过不等于内容稳定。

本轮新增：

- `docs/CONTENT_STABILIZATION_PROTOCOL.md`
- `sources/evidence_coverage.matrix.json`
- `reports/evidence_coverage_report_v0.2.md`
- `reports/content_review_report_v0.2.md`
- `reports/model_review_status.json`
- `reports/next_action_register_v0.2.md`

当前结论：

```text
QPI: draft / B / pending
Intellectual Archaeology: draft / B / pending
draft-callable: allowed
stable: not allowed
third_model_expansion: not allowed
```

## 5. 当前关键文件

模型资产：

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

schema：

- `schemas/model_card.schema.json`
- `schemas/source_article.schema.json`
- `schemas/source_excerpt.schema.json`
- `schemas/regression_case.schema.json`
- `schemas/model_index.schema.json`
- `schemas/card_index.schema.json`

数据：

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

工具：

- `scripts/validate_model_library.py`
- `scripts/check_card_contract.py`
- `scripts/rebuild_indexes.py`
- `scripts/run_selector_demo.py`
- `scripts/run_selector_regression.py`
- `scripts/check_model_card_sync.py`

知识资产：

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

## 6. 当前已知未决问题

这些问题应由用户 / ChatGPT / CCRA 做产品或质量判断，不应由 Codex 直接拍板：

- QPI 当前字段和边界是否准确。
- 思想考古学是否应保持七层结构，还是需要更强的停止条件表达。
- 是否应引入第三个核心模型。
- 从产品角度看，后续模型抽取是否需要拆成抽取、检验、评分三个环节。
- 如果需要多环节审查，这三个环节的质量标准分别是什么。
- 当前 QPI / 思想考古样板是否已经暴露出需要多角色审查的质量问题。
- regression cases 已按模型拆分，但用例真实性和遗漏边界仍需人工审查。
- selector 已保持规则化并升级到 v0.2；是否未来加入 LLM 判断层仍不是本轮决策。
- 当前索引策略已工程化，不再需要 owner 判断；但模型状态升级仍需要 owner / ChatGPT / CCRA 明确决定。
- QPI 混合案例是否需要更细的主导匮乏物仲裁规则。
- 思想考古 `recommended_max_depth` 是否应与 QPI 输出更强绑定。
- `draft-callable` 是否应进入 schema，还是继续留在 review report。

本地仓库归属判断不交给 ChatGPT：

- agent spec / invocation / evaluation / governance -> `requirements/ccpe/`
- reusable deterministic tools / batch scripts / format transformers -> `requirements/skills-vault/`
- product-specific config, adapters, state, selector behavior -> 本仓库

## 7. 下轮可能任务

用户即将带回 ChatGPT 新一轮讨论结果。

下轮开始时：

1. 先读取用户带回的内容。
2. 判断它是产品判断、内容修复、规则修复、schema 修复、workflow 修复、工具需求，还是 supplier request。
3. 若是 GPT 规划或建议，先做本地化计划。
4. 若是明确内容修改，按现有 contract 修模型卡和 JSON。
5. 修改后运行 `python scripts\rebuild_indexes.py --write`。
6. 再运行 `python scripts\rebuild_indexes.py --check`、`python scripts\run_selector_regression.py`、`python scripts\check_model_card_sync.py` 和验证命令。
7. 若用户要再回 ChatGPT，生成新的 ChatGPT 交接文档。

## 8. 工作区提醒

当前 `git status --short` 显示大量新增文件和修改文件；这些是本轮模型库 MVP 工程化打样产物。

不要把 untracked 文件误认为无关临时文件。

测试运行会生成：

- `scripts/__pycache__/`
- `tests/__pycache__/`

验证后应清理这些缓存目录。

## 9. 不要重复做的事

不要重新初始化目录。

不要重新创建 QPI / 思想考古基础模型资产。

不要把具体模型卡复制进 `knowledge_assets/`。

不要把 GPT 对 agent / tool 归属的意见直接当成本地仓库归属决策。

不要在没有 owner 明确要求时引入数据库、后端服务、前端应用、RAG、认证或平台化能力。
