282 lines
8.5 KiB
Markdown
282 lines
8.5 KiB
Markdown
# 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、认证或平台化能力。
|