139 lines
4.6 KiB
Markdown
139 lines
4.6 KiB
Markdown
# 项目交接文档：模型库 / 模型管理子系统 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`.
|