📁
文件为真相
纯 Markdown + YAML frontmatter,索引是派生物随时可重建。卸载工具,笔记毫发无损;拷走目录,带走整个系统。
npm install -g kb-metabolism
cd ~/notes && kb init第一次运行就会给现有 Markdown 知识库做体检:哪些笔记仍在参与工作,哪些长期沉睡,哪些需要你重新判断。它不会自动删除任何内容。

这段回放来自 2026-07-29 的真实运行:276 条 Markdown 笔记,17 条待分诊、9 条复审候选、5 条消化候选。仅保留聚合统计,标题、路径、正文和用户名均已脱敏;在人工判决前退出,0 条被选择,0 条被移动。
| 适合 | 暂时不适合 |
|---|---|
| 已有一批 Markdown / Obsidian 笔记 | 想找一个新的云端笔记编辑器 |
| 正在用 Claude Code、Codex 或其他 MCP agent | 希望 AI 无人值守地整理和删除一切 |
| 旧内容开始污染搜索与 AI 上下文 | 笔记很少,还没有维护压力 |
| 在意本地优先、可审计和可撤销 | 不想接触本地文件或命令行 |
先理解,再安装
想先看知识的一生,打开设计全景;想看 Agent 如何在回答前安全检索笔记,打开hooks 交互演示。