knowledge-vault/discussions/technology/Codex/2.重构知识库/1.构建知识库.md

143 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

我正在搭建个人知识管理与写作工程体系。当前已确认四层架构:
1. Knowledge Vault矿山和档案馆。存长期知识源、正式文章、面向人的模型文档、历史讨论、资料来源、项目归档。
2. Writing Workbench用锤子干活的工地。负责文章创作闭环素材整理、提纲、正文、评审、润色、Metadata、发布以及从文章中提炼面向人的模型说明文案。
3. CCPE System造锤子的车间。路径为 `C:\Users\wangq\Documents\Codex\ccpe-system`,负责 AI 认知资产工程Agent、Skill、Runtime、Model Card、Model Index。
4. Delivery Systems外部可部署 Agentic 产品。用于客户/项目系统,如 APTC 医美销售 Agent 系统,和个人创作体系分离。
我们已确认的关键原则:
- Knowledge Vault 不替代 Writing Workbench也不替代 CCPE System。
- Knowledge Vault 按人的长期检索习惯组织CCPE System 按 AI 认知资产类型组织Writing Workbench 按文章项目和生产流程组织。
- `Rules` 下的模型文档是面向人读的 Human Model Document例如 APTC 模型;`Model Card / Model Index` 是面向 AI/Agent 调用的 AI-Oriented 文档。
- APTC 这类模型应形成双轨:
- `Knowledge Vault/rules/...` 保存面向人的基模、衍生模型、版本说明。
- `ccpe-system/model-cards/...` 保存面向 AI 调用的 Model Card。
- 最高版本不一定总是最好;同一模型族中多个版本可以并存,并通过 README 或索引说明适用场景。
- 新文章创作和文章评审流程未来主要进入 Writing WorkbenchKnowledge Vault 中的 `discussions/` 主要归档历史讨论和非工作台讨论。
- `Knowledge Vault` 不需要 `inbox/`,因为我现在临时想法通过手机/PC 都进入 `diary/`
- `sources/``notes/` 建议合并为一个来源材料区,可包含 Deep Research、读书笔记、摘抄、网页原文、爬取文章、参考资料。
- `indexes/` 主要由 Codex 按需维护,不要求我每加一个文件就手动更新。触发方式可以是:“请扫描某目录并更新索引”“我新增了某模型,请更新模型索引和版本关系”等。
- `templates/` 用于统一 Codex 和我后续生成文档的格式,例如 human-model-document、derivative-model-document、source-note、discussion-archive、saying-metadata。
当前建议的 Knowledge Vault 结构是:
```text
knowledge-vault/
README.md
VAULT.md
diary/
2026/
discussions/
historical-article-discussions/
historical-agent-building/
model-extraction/
project-thinking/
committees/
sayings/
2024/
2025/
2026/
rules/
marketing-sales/
cognitive-science/
writing-style/
classification/
agent-methods/
prompts/
ccpe/
article-writers/
reviewers/
metadata/
legacy/
sources/
deep-research/
reading-notes/
excerpts/
clipped-articles/
web-archives/
references/
work/
internal/
client-projects/
sensitive-local-only/
indexes/
article-index.md
model-index-human.md
prompt-index.md
source-index.md
project-index.md
templates/
human-model-document.md
derivative-model-document.md
source-note.md
discussion-archive.md
saying-metadata.md
```
我准备在 `C:\Users\wangq\Documents\Codex\knowledge-vault` 项目下继续完善搭建。
目前除了`sources/`和`work`的内容,其他内容基本上已经从旧的知识库中复制了进来。
其中`discussions/`下增加了几个目录:
* agents我与我的Agent交流的内容过程
* creative涉及到音乐、图片、视频的讨论过程记录
* technology技术相关的讨论过程记录
由于我的旧知识库已经运行了一年半,不算`sources/`和`work`目前已经有2400多个文件所以请先检查当前项目目录再基于上述约定协助我完善 Knowledge Vault 的结构、规则文档和迁移方案。
即使调整也需要按文件夹进行调整。
已完成第一轮目录检查,暂未移动或修改文件。
**当前现状**
`C:\Users\wangq\Documents\Codex\knowledge-vault` 已有目标顶层结构:
- `diary/`300 个文件
- `discussions/`1485 个文件
- `prompts/`275 个文件
- `rules/`60 个文件
- `sayings/`285 个文件
- `sources/`0 个文件
- `work/`0 个文件
- `indexes/`0 个文件
- `templates/`0 个文件
根目录下目前没有 `README.md`、`VAULT.md`。`indexes/` 和 `templates/` 也还是空的。
**主要差异**
当前结构已经接近你确认的四层体系,但还需要治理化:
1. `discussions/` 已新增 `agents/`、`creative/`、`technology/`、`training/`,这些应该正式纳入讨论归档规则,而不是当作临时例外。
2. `prompts/` 仍保留旧库风格:`CCPE/`、`CCPE2.0/`、`Others/`。建议先不大规模移动,先建立 `prompt-index.md` 和分类规则,再按文件夹迁移。
3. `rules/` 下目前是中文主题目录,如 `市场销售/`、`商业职场洞察/`、`洞察力/`、`Wantsong文章风格/`。这和目标目录 `marketing-sales/`、`cognitive-science/`、`writing-style/` 等存在命名体系差异。
4. 这是非 Git 仓库,所以后续实际迁移前最好先生成迁移清单,避免直接移动 2400+ 文件后难以回滚。
**建议路径**
我建议采用“先治理文档,后按目录迁移”的方案:
1. 先补齐根规则文档:`README.md`、`VAULT.md`
2. 先补齐模板:`human-model-document.md`、`derivative-model-document.md`、`source-note.md`、`discussion-archive.md`、`saying-metadata.md`
3. 先补齐索引壳:`model-index-human.md`、`prompt-index.md`、`source-index.md`、`project-index.md`、`article-index.md`
4. 再生成一份按文件夹执行的迁移方案,优先处理:
- `rules/` 中文主题目录与目标分类的映射
- `prompts/CCPE`、`prompts/CCPE2.0`、`prompts/Others` 的归档规则
- `discussions/agents|creative|technology|training` 的正式归属说明
5. 暂不移动 `sources/``work/` 内容,因为你已说明这两块还没迁入。
我建议下一步先写一版“治理文档 + 模板 + 索引壳”,不移动任何旧文件。确认后再进入第二步:输出可执行的目录迁移清单。
请确认一个关键取向:`rules/` 下现有中文目录,你希望最终保持中文可读目录名,还是迁移成英文分类目录名?