SuperAPI AI 工具集

secondbrain-db-edit

办公与效率

查看项目

更新于 10-16 06:13

技能介绍

用途:在 sbdb 管理的知识库(KB)中执行文档创建、更新与删除,要求每次编辑后知识库保持干净状态。v2 中每篇文档是配对文件:<id>.md(内容与 frontmatter)和同目录的 <id>.yaml 完整性边车,两者都提交到 git,没有 data/ 目录和聚合索引。

主要能力与用法:编辑前先确认项目,运行 test -f .sbdb.toml 判断是否为 sbdb 项目;用 sbdb schema list --format json 查看 schema 并比对路径前缀与各 schema 的 docs_dir。schema 管理文档必须用 CLI 操作,不要直接写 <id>.md:创建用 echo JSON | sbdb create -s <schema> --input -;更新字段用 sbdb update -s <schema> --id <id> --field key=value;替换正文用 --content-file body.md;删除用 sbdb delete -s <schema> --id <id> --yes。非 schema 文件(模板、索引、自定义页)用 sbdb untracked create <path> --content-file <file> 创建签名,或编辑后用 sbdb untracked sign <path> 签名。直接编辑 docs/ 下 .md 后必须进入完整性恢复循环,最多 5 次:运行 sbdb doctor check --format json,退出码 0 即完成;若仅 frontmatter_sha/record_sha 漂移则 sbdb doctor fix --recompute;若 content_sha 不匹配需询问用户是否有意修改,是则 sbdb doctor sign --force,否则 git checkout;若 bad_sig 需询问用户;然后回到第一步。

适用场景:需要维护结构化知识库(如 ADR、笔记、讨论)且要求内容与完整性边车一致的场合。

限制:不得跳过完整性检查;不要直接编辑 <id>.yaml 边车;插件 PreToolUse 钩子会拦截 docs/ 下的直接写入;任务完成时 doctor check 必须为零退出码,否则需报告用户。批量操作结束后运行一次 sbdb doctor check --all。上述命令与流程均来自资料,未提供的功能与细节暂未提供。