MediaCrawler/mac-agent-os-main/03_knowledge/KB_REORG_PLAN.md

知识库全面整理执行计划

创建: 2026-06-17 23:25 | 状态: ⏳ 待确认 目标: 364个文件 → 约100个唯一内容文件，全部正确归类

---

一、原始设计（来自 README.md + CORE-ARCHITECTURE.md）

原始知识库设计为：

• 00_inbox/ — 待提纯收件箱
• 01_submissions/ — 待归集提交箱（按来源分目录）
• 10_concepts/ — 概念知识
• 20_methods/ — 方法技能
• 30_facts/ — 事实数据
• 40_references/ — 参考资料（含系统工具引用）
• 50_resources/ — 资源索引
• 60_opinions/ — 个人观点
• 90_archive/ — 归档
• 没有 99_system/ 和 04_ops/ — 这两个目录是后来新增的

04_ops/ 不在原始设计中，是后来加的 → 移空后可删除。

---

二、审计发现

问题1: 日期前缀副本（~220个冗余文件）

20_methods/ 下有大量同一内容的日期版本：

2026-05-16_xxx.md              ← 原始版本
2026-05-17_2026-05-16_xxx.md   ← 第一次复制（内容可能微调）
2026-06-01_2026-05-17_...xxx.md ← 第二次复制
2026-06-02_...xxx.md            ← 第三次复制
...

结论：文件名越短=越早的版本，文件名越长=被AI采集系统多次重新采集。内容可能相同或略有差异。保留内容最完整的版本（通常是最新日期最长的），其余删除，不存档。

问题2: 系统文档散落在 3 个目录

当前路径	应移至	原因
04_ops/matrix/ (6个)	99_system/matrix/	全部是矩阵系统架构文档
20_methods/Camoufox_集成修复记录.md (+5个副本)	99_system/matrix/	系统集成记录
20_methods/原子化登录管理模块_auth_manager.md (+5个副本)	99_system/matrix/	登录系统模块
20_methods/统一升级引擎_agentos_upgrade.md (+5个副本)	99_system/	升级引擎
20_methods/cross-domain.md 等4协议(+各5副本)	99_system/protocols/	协议，但已存在更完整版本
40_references/matrix-sms-verification.md (+7个副本)	99_system/matrix/	系统引用文档
40_references/cloakbrowser-integration.md (+7个副本)	99_system/references/	系统引用文档
40_references/peekaboo-v3-integration.md (+7个副本)	99_system/references/	系统引用文档

问题3: 协议文档版本对比

协议	99_system版本	20_methods副本版本	结论
cross-domain.md	2001 bytes	1248 bytes	99_system更完整，保留
knowledge-review.md	(待查)	(待查)	保留99_system
meta-thinking.md	(待查)	(待查)	保留99_system
stuck-intervention.md	(待查)	(待查)	保留99_system

这些协议文档有没有用？ 有——cross-domain.md 是跨域联想协议，knowledge-review.md 是知识入库审查流程。这些是智能体思考框架的一部分。建议保留在 99_system/protocols/。

---

三、执行步骤

Step 1: 扩展 99_system/ 结构

mkdir -p 99_system/matrix
mkdir -p 99_system/references

Step 2: 移动系统文档

从 04_ops/matrix/ → 99_system/matrix/:

mv 04_ops/matrix/*.md 99_system/matrix/

从 20_methods/ 去重后移入 99_system/:

• 以 _集成修复记录.md 结尾的 → 99_system/matrix/
• 以 auth_manager.md 结尾的 → 99_system/matrix/
• 以 agentos_upgrade.md 结尾的 → 99_system/
• 协议类（cross-domain, knowledge-review 等）→ 删除（已有更新版本在 99_system/protocols/）

从 40_references/ 移入 99_system/:

• matrix-sms-verification.md 类 → 99_system/matrix/
• cloakbrowser, peekaboo → 99_system/references/

Step 3: 删除日期前缀副本

规则：同一内容只保留文件名最长的那个版本（最新日期），其余删除。 涉及约 200 个文件，主要在 20_methods/ 和 40_references/。

Step 4: 删除废弃目录

rmdir 04_ops/  # 移空后删除

Step 5: 更新 README

更新 03_knowledge/README.md 的文件计数和索引。

Step 6: 写系统指令文件

在 99_system/ 下建 AI_READING_GUIDE.md，告诉智能体：

• 每次启动先读 99_system/AI_READING_GUIDE.md
• 按任务类型查阅对应目录
• 知识库使用规范

---

四、预览：清理后的结构

03_knowledge/
├── 00_README.md              ← 顶层索引（已建）
├── 00_inbox/                 ← 不变
├── 01_submissions/           ← 不变（23个采集文件）
├── 10_concepts/              ← 不变（19个概念文件）
├── 20_methods/               ← 只保留纯方法论（约30个文件）
│   └── ai-video-system/      ← 完整保留（19章）
├── 30_facts/                 ← 不变
├── 40_references/            ← 只保留非系统引用
├── 50_resources/             ← 不变
├── 60_opinions/              ← 不变
├── 90_archive/               ← 不变
├── CHANGELOG.md              ← 不变
└── 99_system/                ← 扩展
    ├── AI_READING_GUIDE.md   ← 🆕 系统指令
    ├── README.md             ← 已建
    ├── architecture/         ← 6个文件
    ├── matrix/               ← ← 6+3个文件（从04_ops + 20_methods + 40_references 移入）
    ├── references/           ← ← 2个文件（从40_references 移入）
    ├── dashboard/            ← 设计文档
    ├── agentos-upgrade.md    ← ← 升级引擎（从20_methods移入）
    ├── pipelines/            ← 1个文件
    ├── prompts/              ← 1个文件
    ├── protocols/            ← 4个文件
    ├── taxonomies/           ← 2个文件
    ├── templates/            ← 4个文件
    └── archive/              ← 3个文件

---

五、确认事项

1. 日期副本去重原则：保留最长文件名（最新日期），其余直接删除，不归档。✅ 你已确认
2. 04_ops/ 移空后删除：原设计没有这个目录 ✅ 你已确认
3. 协议文档：99_system/protocols/ 版本更完整，20_methods/ 的副本删除
4. 40_references/ 移走系统引用后：只剩空目录，保留（原设计有此目录）

确认后我执行，预计半小时完成。