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

6.3 KiB
Raw Blame History

我正在搭建个人知识管理与写作工程体系。当前已确认四层架构:

  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 结构是:

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.mdVAULT.mdindexes/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.mdVAULT.md
  2. 先补齐模板:human-model-document.mdderivative-model-document.mdsource-note.mddiscussion-archive.mdsaying-metadata.md
  3. 先补齐索引壳:model-index-human.mdprompt-index.mdsource-index.mdproject-index.mdarticle-index.md
  4. 再生成一份按文件夹执行的迁移方案,优先处理:
    • rules/ 中文主题目录与目标分类的映射
    • prompts/CCPEprompts/CCPE2.0prompts/Others 的归档规则
    • discussions/agents|creative|technology|training 的正式归属说明
  5. 暂不移动 sources/work/ 内容,因为你已说明这两块还没迁入。

我建议下一步先写一版“治理文档 + 模板 + 索引壳”,不移动任何旧文件。确认后再进入第二步:输出可执行的目录迁移清单。

请确认一个关键取向:rules/ 下现有中文目录,你希望最终保持中文可读目录名,还是迁移成英文分类目录名?