核心用法
KG笔记法是一套针对Obsidian笔记库的结构化整理方法论与自动化工具集,通过四种笔记类型(概念、某物、Skill、关系)将知识图谱化。用户通过kg系列命令触发:
- `kg 笔记名`:全流程整理(检查→分类→命名→链接→关系→去重)
- `kg 完善`:额外执行网络补全计划(⑨步骤)
- `kg 检查`:仅生成检查清单,询问后执行
- `kg 查看`:分层加载笔记(L0 frontmatter → L1 核心段落 → L2 全文)
核心机制是强制清单系统:任务开始前自动生成{任务名}_执行清单.md和{任务名}_检查清单.md,所有文件操作必须照清单执行,每步完成后用patch单字符更新状态码,确保任务可恢复、可追溯。
显著优点
1. 严格的流程控制:10步标准化流程(①内容检查→⑥关联处理→⑦查重→⑩收尾),避免人工遗漏
2. 关系优先设计:强制将正文[[直链]]转为独立关系笔记,构建可查询的知识图谱
3. 分层加载策略:L0/L1/L2三级缓存减少Token消耗,提升大库查询效率
4. 任务可恢复性:检查清单的位图状态码支持会话中断后续接
5. 防呆设计:步0(同名清单检查)和步5(其他任务提示)不可跳过,避免覆盖和遗漏
潜在缺点与局限性
1. 高使用门槛:需严格理解四种笔记类型、命名规范(主体笔记禁 - )、关系笔记单句双链限制
2. 自动化盲区:图片保护仅检查HTTP状态码,不验证内容相关性;网络补全依赖外部搜索质量
3. 关系爆炸风险:概念笔记自动关联其他概念,大库可能产生过量关系笔记
4. 人工干预节点少:除kg 完善外"尽量保留原文",错误分类可能累积
5. 清单系统开销:小任务也需生成双清单,轻量场景显得笨重
适合人群
- 已有500+笔记、出现链接混乱的Obsidian重度用户
- 希望实践Zettelkasten卡片盒笔记法,但缺乏执行框架的知识管理者
- 需要团队协作统一笔记规范的中小型知识库维护者
- 愿意前期投入学习成本以换取长期可维护性的系统性思考者
常规风险
- 误删风险:虽有多重检查,但
mv重命名和关系笔记删除操作不可逆 - 图谱污染:自动生成的关系笔记若语义不准,会造成图谱噪声
- 依赖锁定:深度依赖该skill的格式规范后,迁移成本增高
- 网络搜索合规:⑨补完计划涉及外部搜索,需注意数据来源版权与隐私政策