knowledge-base-management

1# Knowledge Base Management — 知识库全生命周期管理
2 
3## 核心架构
4 
5### 三层架构
6 
7```
8素材库/  → Layer 1: 不可变原始素材（AI 只读）
9wiki/    → Layer 2: AI 编译的结构化知识（AI 维护）
10产出/    → Layer 3: 按需生成的视图（不持久化）
11```
12 
13**核心原则**：素材库是事实源（不可变），Wiki 是 AI 编译的投影（必须溯源），产出是按需生成的视图（不持久化）。
14 
15### Vault 配置
16 
17vault 路径通过环境变量配置，不写死在脚本里：
18 
19```bash
20export VAULT_DIR="$HOME/Documents/your-vault"   # 你的 Obsidian vault 根目录
21```
22 
23完整仓库可以统一配置采集、搜索和资料包：
24 
25```bash
26python3 tools/chubby.py init --vault "$VAULT_DIR"
27```
28 
29这里的路径是知识库根目录。采集进入根目录的 `00_Inbox`，默认索引为 `.chubby/index.sqlite`。独立安装本 skill 后，`tools/vault_index.py` 和 `tools/evidence_brief.py` 直接使用 `VAULT_DIR` 或 `--vault`，不读取仓库中的 `chubby.yaml`。
30 
31健康检查可自行加入调度器；安装本 skill 不会创建 cron。
32 
33---
34 
35## 1. 素材入库 (Ingest)
36 
37### 新素材处理流水线
38 
39```
40用户丢素材 →
41  ① 判断类型 → 存入素材库/对应子目录
42  ② 提取关键信息 → 决定是否建 wiki 页面
43  ③ 如果值得：建选题（打 SHARP 分）或更新项目页
44  ④ 更新 wiki/index.md 索引
45```
46 
47### 素材分级 (ABC Grading)
48 
49| 等级 | 标准 | 处理 |
50|------|------|------|
51| **A** | 核心方法论/框架/系统 | 优先编译为选题 |
52| **B** | 有洞察但不够系统 | 备选，作为 A 的补充 |
53| **C** | 水货/重复/与定位无关 | 归档，不主动编译 |
54 
55### 公众号文章处理
56 
57**来源一：可选的 wechat-article-exporter 外部同步**
58如果已自行部署该工具和调度器，可把公众号文章同步到 `素材库/公众号文章/<公众号名>/`。本 skill 不内置该服务或定时任务。
59 
60**来源二：手机保存的文章导入**
61通过手机保存的文章先落到一个待处理目录（按日期），再由一个归类脚本搬入素材库并按领域筛选优质文章做 A+B 深度处理。
62 
63> 归类脚本（如 `sync_notes_to_kb.py`）与各人的目录结构强相关，本仓库不内置，按下面的「工作流」自建即可。
64 
65**工作流**：
66```
67新文章入库 →
68  ① 脚本自动归类到 素材库/公众号文章/<公众号名>/
69  ② URL 去重（跳过已存在的文章）
70  ③ 领域关键词筛选（AI/半导体/消费/电商/品牌/投资/Agent/Skill）
71     跳过纯营销、与用户领域无关的文章
72  ④ 命中关键词的精选文章 → A+B 双轨处理（每日上限 5 篇）
73     A层：观点提取+分类+3条Takeaway → wiki/📡 外部输入/公众号/<公众号名>/<主题>/
74…