wantsong
/
knowledge-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
knowledge-vault/discussions/technology/Codex/2.重构知识库/1.构建知识库.md

16 KiB
Raw Blame History

1

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

  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 Workbench；Knowledge 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.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/ 下现有中文目录，你希望最终保持中文可读目录名，还是迁移成英文分类目录名？

2

  1. 我增加了git，并提交到远程库https://git.wantsong.life/wantsong/knowledge-vault.git了。

    1. 这个本身是从就知识库复制过来的，原始数据我有备份
    2. 我增加了Git，首次提交完成，所以，改错了可以回滚。

  2. 关于rules/下的目录是否迁移成英文分类： 按照这个规则：rules是一级目录，rules/xxx/是二级目录，rules/xxx/xxx/是三级目录；我希望所有的三级目录可以保持中文可读目录名。 其他目录也是这个方式。

  3. 我同意你的计划：先写一版“治理文档 + 模板 + 索引壳”，不移动任何旧文件。确认后再进入第二步：输出可执行的目录迁移清单。

已按你确认的方案新增治理文档、模板和索引壳，没有移动或重命名任何旧文件。

新增文件：

  • README.md：定义 Knowledge Vault 定位、四层边界、目录原则、命名规则、与 CCPE System 的双轨关系。
  • VAULT.md：定义目录职责、rules/、prompts/、discussions/、sources/、索引维护和迁移规则。
  • 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。

验证过：

  • 用 UTF-8 显式读取确认中文内容正常。
  • 用 rg "TBD|TODO|待定|稍后|以后补" 检查新增文档，没有占位词残留。
  • git status --short --untracked-files=all 显示这些文件为新增未跟踪文件。
  • 你原本已有的修改文件 discussions/technology/Codex/2.重构知识库/1.构建知识库.md 我没有触碰。

下一步可以进入第二阶段：生成“按文件夹执行的迁移清单”，先只输出清单，不实际移动文件。

3

说明：

  1. discussions/就是记录我和AI的讨论的过程，这个1.构建知识库.md记录的是本次会话——我会在这个文件里（通过VS Code）编辑好我的提示词，你回答后再将你的回复复制进来。所以这个文件是持续更新的。
  2. 我所有的文件应该都是UTF-8编码，每次你调用powershell时都会乱码一次，再用UTF-8查看。所以，这里你能不能记录一下，默认用Utf8看。

现在进入第二阶段。

已进入第二阶段并完成“只出清单，不移动文件”。

我做了三件事：

  1. 已把你的偏好写入记忆：以后在 knowledge-vault 里查看 Markdown/文本文件时，默认用 Get-Content -Encoding UTF8。
  2. 已更新 VAULT.md，补充说明：discussions/ 可以包含当前会话这种持续更新的过程文件，不需要迁出。
  3. 已新增迁移清单：migration-plan-2026-06-02.md。

迁移清单里包含：

  • sources/ 和 work/ 空目录骨架补齐方案。
  • rules/ 中文二级目录迁移到英文二级分类、中文保留为三级目录的方案。
  • rules/ 根目录散文件归档方案。
  • prompts/CCPE、prompts/CCPE2.0、prompts/Others 的目录级迁移方案。
  • discussions/ 当前不迁移的理由。
  • sayings/LargeShaft/ 暂缓处理的原因。
  • 建议第一批执行项和不建议第一批处理的项目。

验证过：

  • 迁移清单用 UTF-8 读取正常。
  • rg "TBD|TODO|待定|稍后|以后补" 没有命中。
  • 没有执行任何 Move-Item。
  • 你持续编辑的 discussions/technology/Codex/2.重构知识库/1.构建知识库.md 仍保持为你自己的修改，我没有碰。

4

  1. sayings/LargeShaft/ 这部分不用调整。 当前sayings的结构对应的是我的个人博客hugo，LargeShaft/的内容是不发到hugo上的，我专门摘录出来了。

  2. 关于Rules的目录

我做了部分调整，主要是二级英文目录和三级中文目录重复了：

批次 当前路径 目标路径 文件数 理由 风险
R1 rules/市场销售/ rules/marketing-sales/ 8 市场、销售、商业化模型归入英文二级分类 中：APTC 后续需要补模型族索引
R2 rules/商业职场洞察/ rules/business-workplace/ 10 组织、角色、文化、职场洞察归类 中：可与 marketing-sales 有交叉
R3 rules/Wantsong文章风格/ rules/writing-style/Wantsong文章风格/ 14 写作风格、文章结构、元风格归类 低
R4 rules/洞察力/ rules/cognitive-science/洞察力/ 5 认知、洞察、知行合一模型归类 中：部分内容可能更接近 philosophy
R5 rules/教育/ rules/education/ 6 教育模型与教学框架归类 低
R6 rules/建模者/ rules/agent-methods/ 2 建模者、智能体委员会建造方法归类 中：后续可能与 CCPE 双轨
R7 rules/Templates/ rules/agent-methods/Templates/ 5 当前内容更像 Agent Studio、MVP 模型和底层逻辑模板 中：其中部分文件可能应进入 templates/ 或 rules/cognitive-science/

我想的是先调一版出来，后面再慢慢调，尤其是文件分类，有时确实不好确定。

  • 当前的商业职场洞察与marketing-sales没交叉。
  • 市场销售/里面其实是2套，高客单价的APTC模型及其衍生模型，市场销售蓝图及其衍生模型（娱乐主播、垂直领域直播运营等）
  • rules/目录下的那些文件，比如权力的理论框架.md现在要分类比较困难。就按照你的建议 rules/ 根目录散文件归档 来执行好。

分类这件事的本质是先得有一套MECE的分类树做指导，但是现在做这个有点大炮打蚊子。所以可以考虑先临时分一下，等后面积攒起来，再下功夫做重构。

migration-plan-2026-06-02我看完后，除了上面两点澄清外，其他没问题，按照你的计划执行。

已按你确认后的计划执行，未触碰 discussions/technology/Codex/2.重构知识库/1.构建知识库.md 的内容。

完成的迁移：

  • prompts/CCPE/ → prompts/ccpe/legacy-ccpe/，160 个文件
  • prompts/CCPE2.0/ → prompts/ccpe/legacy-ccpe-2.0/，56 个文件
  • prompts/Others/ → prompts/legacy/others/，59 个文件
  • rules/市场销售/ → rules/marketing-sales/，8 个文件
  • rules/商业职场洞察/ → rules/business-workplace/，10 个文件
  • rules/Wantsong文章风格/ → rules/writing-style/Wantsong文章风格/，14 个文件
  • rules/洞察力/ → rules/cognitive-science/洞察力/，5 个文件
  • rules/教育/ → rules/education/，6 个文件
  • rules/建模者/ → rules/agent-methods/，2 个文件
  • rules/ 根目录散文件已按清单进入 Sayings规则/、提示词工程/、综合认知模型/

保持不动：

  • rules/Templates/ 仍在原位，5 个文件
  • sayings/LargeShaft/ 仍在原位，12 个文件

还做了这些配套更新：

验证结果：

  • 目标目录文件数符合迁移预期。
  • 旧中文 rules/市场销售、rules/商业职场洞察、rules/教育、rules/建模者 已不存在。
  • prompts/CCPE2.0、prompts/Others 已不存在。
  • rg "TBD|TODO|待定|稍后|以后补" 无命中。
  • 当前分支是 main，所有变更尚未提交。Git 状态里大量 D 和 ?? 是这次目录迁移造成的删除/新增对；执行 git add -A 后 Git 才会把它们识别成重命名/移动。

5

  1. 如果本次迁移整理完毕，你可以执行远程库的提交动作。git push -u origin main
  2. 我们是否可以开始进入下一个，原notes进入到sources的迁移，notes下有460多个文件，我们是在当前会话窗口，还是启动新会话？

回答以上问题后，我根据你的建议来执行。

可以提交远程，但我建议顺序是：

  1. 先由我在当前会话执行：

    git add -A
git commit -m "chore: organize vault governance and first migration"
git push -u origin main

    这会把治理文档、索引、模板、rules/ 和 prompts/ 的第一批迁移一次性固化。

  2. notes -> sources 建议开新会话做。原因很简单：460+ 文件已经是第二个独立迁移批次，最好在一个干净上下文里重新盘点 notes/ 的目录结构、文件类型、主题分布，再生成迁移清单。这样不会和本次 rules/prompts 迁移混在一个提交里，也方便回滚和审计。

我的建议：当前会话只负责把本次迁移提交并 push；新会话开始时你直接说“继续 Knowledge Vault 第二阶段：迁移旧 notes 到 sources”，我再从当前仓库状态重新扫描。

已完成提交并 push 到远程。

提交信息：

ee08548 chore: organize vault governance and first migration

远程结果：

main -> origin/main
branch 'main' set up to track 'origin/main'

最终工作区状态只剩你持续编辑的会话记录文件未提交：

M discussions/technology/Codex/2.重构知识库/1.构建知识库.md

这符合预期，我没有把它纳入本次提交。现在可以开新会话做 notes -> sources 迁移。