用途:kb CLI 用于构建和维护可自我编译的 Obsidian Markdown 知识库,把 LLM 当作编译器,读取原始资料并产出结构化、交叉链接的 wiki 文章。每个主题位于独立顶层文件夹,含 raw/、wiki/、outputs/、bases/ 子树及 log.md、CLAUDE.md,所有主题共享仓库根目录的 Obsidian vault。
主要能力:主题管理(kb topic new/list/info);多源摄取(URL、本地文件、YouTube 字幕、书签、代码库);代码库检查(smells、dead-code、complexity、blast-radius、coupling、circular-deps、symbol、file、backlinks、deps);结构 lint;基于 QMD 的索引与混合/词法/向量搜索。四阶段流程为 ingest → compile → query → lint。
使用方式:先确认 kb version;搜索与索引需 QMD,缺失时执行 npm install -g @tobilu/qmd。代码库分析支持 TypeScript、TSX、JavaScript、JSX、Go。常用命令如 kb ingest codebase <path> --topic <slug> --progress never、kb inspect smells --format json、kb lint <slug> --save、kb index --topic <slug>、kb search "<query>" --topic <slug>。vault 默认位于 <path>/.kb/vault/<topic-slug>/,后续命令会从当前目录向上自动发现。
适用场景:维护跨链接知识库、把问答结果归档回语料、分析代码质量与架构健康、符号关系查询。
限制:代码库分析仅支持上述语言;搜索与索引依赖 QMD;inspect 前必须先运行 kb ingest codebase;--lex 与 --vec 互斥;agent 环境应使用 --progress never 避免进度条污染 stdout;stderr 为结构化阶段日志,不应视为失败。其他收费、平台与效果信息暂未提供。