概览 · 01

知识库整备台 KBFold

约 1 分钟阅读 Apache-2.0 本文基于 v0.1.0（2026-11-01）

一个项目跑三年，资料会散在需求文档、会议纪要、设计稿说明、代码注释，还有一堆「最终版-2.docx」里。想用的时候找不到，AI 更读不进去——它拿到的是一锅乱麻，不是知识库。

KBFold 只做一件事：把这些散的东西编译成一个有索引、可检索、可回滚的知识库目录。

01它不做什么

不改你的原始文件。 全程只读，产物另存，关掉工具你的资料一个字都没动。
不替你猜。 规则接不住的、两条规则打平的，老实列进 _inbox/ 并附候选，让你决定补规则还是手动安置。
不留不可逆的操作。 每次执行都有批次号，改错了 kbfold undo 一键退回去；撤销本身也记账。

02为什么要有「规则」这一层

大多数整理工具给你一堆开关，开关之间怎么互相影响没人说得清。KBFold 把整理动作写成可读的规则文件——你改了什么、命中哪些文件、为什么这个文件落在这个目录，全都能查。

规则是这工具的正文，不是设置项。

03现在到哪一步

v0.1.0 已正式开源（2026-11-01，GitHub 仓库公开）：CLI 四能力（plan / apply / undo 等，--rename-only 只改名不搬家）与 MCP 五个只读工具（kb.scan / kb.plan / kb.search / kb.explain / kb.validate）随 v0.1.0 一并上线；.kb/ 库格式公开规范 FORMAT v0.1 已冻结（见仓库 docs/FORMAT.md），匿名改进反馈默认关闭（见 docs/FEEDBACK.md）。npm 包已上线（https://www.npmjs.com/package/kbfold），npx kbfold … 即用；亦可从 GitHub 克隆。