# Knowledge Vault

个人长期知识库。它的定位是“矿山和档案馆”：保存长期知识源、正式文章、面向人的模型文档、历史讨论、资料来源和项目归档。

本仓库不承担 Writing Workbench、CCPE System 或 Delivery Systems 的职责。

## 四层边界

| 层级 | 定位 | 主要内容 | 不做什么 |
| --- | --- | --- | --- |
| Knowledge Vault | 长期知识源与归档 | 日记、讨论归档、模型说明、文章、资料源、项目归档 | 不承载文章生产流水线，不承载 AI 资产工程 |
| Writing Workbench | 写作工地 | 素材整理、提纲、正文、评审、润色、Metadata、发布 | 不做长期知识分类的唯一入口 |
| CCPE System | 造锤子的车间 | Agent、Skill、Runtime、Model Card、Model Index | 不保存面向人阅读的完整知识库 |
| Delivery Systems | 外部交付系统 | 客户或项目级 Agentic 产品 | 不和个人创作体系混放 |

## 当前目录

```text
knowledge-vault/
  README.md
  VAULT.md

  diary/
  discussions/
  sayings/
  rules/
  prompts/
  sources/
  work/
  indexes/
  templates/
```

## 核心原则

- `diary/` 是临时想法和日常记录入口，因此本仓库不设置 `inbox/`。
- `rules/` 保存面向人阅读的模型文档、规则文档、版本说明和模型族说明。
- `prompts/` 保存历史提示词、可复用提示词和从旧库迁入但尚未工程化的提示词。
- `sources/` 合并来源材料，包括 Deep Research、读书笔记、摘抄、网页原文、爬取文章和参考资料。
- `discussions/` 主要归档历史讨论、非工作台讨论和与 Agent 交流的过程记录。
- `indexes/` 由 Codex 按需维护，不要求人工每新增文件都同步更新。
- `templates/` 提供后续人工和 Codex 生成文档时使用的统一格式。

## 命名与层级规则

- 一级目录使用固定英文名称。
- 二级目录优先使用英文分类名，用于稳定检索和跨系统引用。
- 三级目录及以下可以保持中文可读名称，用于保留人的语义习惯和历史上下文。
- 不因为“版本号更高”默认覆盖旧版本；同一模型族可以多版本并存，并在索引或 README 中说明适用场景。

## 与 CCPE System 的双轨关系

面向人的模型文档保存在本仓库 `rules/` 下；面向 AI/Agent 调用的 Model Card 和 Model Index 保存在：

```text
C:\Users\wangq\Documents\Codex\ccpe-system
```

例如 APTC 这类模型应形成双轨：

- `knowledge-vault/rules/...`：基模、衍生模型、版本说明、面向人的解释。
- `ccpe-system/model-cards/...`：AI-Oriented Model Card。

## Codex 维护触发语

可以用以下方式触发维护：

- “请扫描某目录并更新索引。”
- “我新增了某模型，请更新模型索引和版本关系。”
- “请按目录生成迁移清单，不要移动文件。”
- “请执行这份迁移清单。”