Documentation
README
Knowledge Base Management — 知识库全生命周期管理
核心架构
三层架构
素材库/ → Layer 1: 不可变原始素材(AI 只读)
wiki/ → Layer 2: AI 编译的结构化知识(AI 维护)
产出/ → Layer 3: 按需生成的视图(不持久化)
核心原则:素材库是事实源(不可变),Wiki 是 AI 编译的投影(必须溯源),产出是按需生成的视图(不持久化)。
Vault 配置
vault 路径通过环境变量配置,不写死在脚本里:
export VAULT_DIR="$HOME/Documents/your-vault" # 你的 Obsidian vault 根目录
- 健康检查 cron:建议每周日 9:00 运行
scripts/vault_health_check.py(见第 2 节)
1. 素材入库 (Ingest)
新素材处理流水线
用户丢素材 →
① 判断类型 → 存入素材库/对应子目录
② 提取关键信息 → 决定是否建 wiki 页面
③ 如果值得:建选题(打 SHARP 分)或更新项目页
④ 更新 wiki/index.md 索引
素材分级 (ABC Grading)
| 等级 | 标准 | 处理 |
|---|---|---|
| A | 核心方法论/框架/系统 | 优先编译为选题 |
| B | 有洞察但不够系统 | 备选,作为 A 的补充 |
| C | 水货/重复/与定位无关 | 归档,不主动编译 |
公众号文章处理
This is the opening of the README. Read the full README on GitHub.