# Codex 模型资产链路摘要 v0.1

## 1. Current Work Session

Date: 2026-06-16

Task: 根据 GPT 抽取样板和三份中文来源材料，建立 QPI 与思想考古学的第一版模型资产链路。

## 2. Completed Work

- 确认 `intellectual_archaeology` 作为思想考古学的机器 ID。
- 按“字段名英文、字段内容中文”的规则产出 JSON 与 Markdown。
- 新增四类 JSON Schema：model spec、source article、source excerpt、regression case。
- 新增三份来源文章记录。
- 新增十条 source evidence excerpt。
- 新增 QPI 与思想考古学的模型卡。
- 新增 QPI 与思想考古学的机器可读 model JSON。
- 新增十条回归用例，每个模型五条，覆盖正例、边界和误用。
- 新增 data-only selector 规则与示例。
- 新增标准库 Python 校验脚本，并以单元测试覆盖核心校验行为。
- 运行校验并生成 `reports/validation_report.md`。

## 3. Files Created

- `schemas/model_spec.schema.json`
- `schemas/source_article.schema.json`
- `schemas/source_excerpt.schema.json`
- `schemas/regression_case.schema.json`
- `sources/source_articles.json`
- `sources/source_excerpts.json`
- `models/qpi.model.json`
- `models/intellectual_archaeology.model.json`
- `cards/qpi.md`
- `cards/intellectual_archaeology.md`
- `tests/regression_cases.json`
- `tests/test_validate_model_library.py`
- `selector/selector_rules.json`
- `selector/selector_examples.json`
- `scripts/validate_model_library.py`
- `reports/validation_report.md`
- `reports/Codex_模型资产链路摘要_v0.1.md`

## 4. Files Modified

- `README.md`
- `schemas/README.md`
- `models/README.md`
- `sources/README.md`
- `tests/README.md`
- `selector/README.md`
- `scripts/README.md`
- `docs/DECISIONS.md`

## 5. Validation Status

Commands run:

```powershell
python -m unittest tests.test_validate_model_library -v
python scripts\validate_model_library.py
```

Result:

- Unit tests: 2 tests passed.
- Model library validation: passed.
- Validation report written to `reports/validation_report.md`.

## 6. Assumptions Made

- QPI 的主要来源为 `2026-01-07-anchoring-the-void.md`，综合应用说明作为补充来源。
- 思想考古学的主要来源为 `2025-10-26-the-workshop-of-Modelers.md` 的 1.3 节，综合应用说明作为边界规则补充来源。
- 证据片段可以引用原文短段或压缩摘录，但不能替代完整原文；完整来源路径保留在 `sources/source_articles.json`。
- v0.1 schema 保持宽松，仅锁定必填字段和基础类型，不提前引入复杂 enum。
- selector 当前只做规则数据，不做可执行 demo，以避免在模型资产尚未审阅前过早扩展脚本。

## 7. What Does Not Yet Work

- `scripts/validate_model_library.py` 还没有执行 JSON Schema draft 的完整校验，只做当前 MVP 需要的必填字段和引用完整性校验。
- selector 还没有可执行评分脚本。
- 回归用例还没有自动执行器，它们目前是产品稳定性测试数据。
- 模型内容尚未经过项目 owner 的逐字段审阅。
- source excerpts 仍是第一轮人工抽取，后续可以追加更细证据片段。

## 8. Questions for Product / CCRA

- QPI 的 `confidence_level` 是否应从 `medium` 升到 `high`，还是等真实案例回归后再升级？
- 思想考古学是否需要把“七层框架”作为独立结构化字段加入 model JSON，还是暂时保留在 `core_mechanism` 与 card 中？
- selector demo 是否进入下一步，还是先审模型卡和回归用例？
- 是否需要为“源文证据摘录格式”向 `skills-vault` 提出可复用抽取工具需求？

## 9. Suggested Next Tasks

1. 项目 owner 审阅两张模型卡的定义、适用边界和常见误用。
2. 根据审阅意见修订 model JSON 与 cards。
3. 为 selector 增加最小可执行 demo，输入文本后输出推荐模型、分数、理由和 routing notes。
4. 将回归用例接入一个简单检查器，验证每个核心模型至少有五条 case，且覆盖 positive、boundary、misuse。
5. 如果后续需要批量从中文文章抽 evidence excerpt，再向 `requirements/skills-vault/` 写工具需求。
