SuperAPI AI 工具集

knowledge-base-management

办公与效率

查看项目

更新于 10-15 17:34

技能介绍

用途:管理本地 Markdown/Obsidian 知识库的全生命周期。采用三层结构:素材库为不可变原始素材(AI 只读)、wiki 为 AI 编译的结构化知识(须溯源)、产出为按需生成且不持久化的视图。vault 路径通过环境变量 VAULT_DIR 或 --vault 指定,不写死在脚本中。

主要能力:素材入库按 ABC 分级处理,A 级优先编译为选题,B 级作备选,C 级归档;健康检查检测断链、缺 frontmatter/source/summary、孤立笔记、空目录、重复内容与含空格文件名,存在断链时退出码为 1,便于接入 cron/CI;增量索引使用 SQLite FTS5(不可用时回退 LIKE),semantic-lite 仅做本地词语与字符组合排序,不调用模型 API;资料包输出 Markdown 与 JSON,含逐字摘录、source、相对路径、真实行号与 SHA-256;vault_curator 支持归档与知识卡片,默认预览,需 --apply 执行;MCP Server 提供 search_vault、semantic_search_vault、read_kb_note、list_recent_notes、reindex_vault、vault_index_stats 六个工具。

使用方式:健康检查运行 python3 scripts/vault_health_check.py "$HOME/Documents/your-vault",可加 --json 或 --require-source。独立安装后在 skill 目录使用自带工具,如 python3 tools/vault_index.py index "$VAULT_DIR"、search、semantic、recent、read、stats;搜索前需先重建索引,变库后需保持一致数据库。资料包用 python3 tools/evidence_brief.py。MCP 需 Python 3.10+,安装 requirements-mcp.txt 后运行 scripts/mcp_server.py,客户端配置填写真实 Python 与 server 绝对路径,并设置 VAULT_DIR。

适用场景:搜索与整理知识库、批量修复断链与 frontmatter、目录审查与归档、为 Agent 准备可定位引用。

限制:归档不改文件名、不删除素材库文件、每次大清理需创建归档清单;全量重建需显式 --rebuild 并丢弃已有 embedding;资料包导出前需核验来源,来源变动需重新生成;公众号同步、GBrain、GraphRAG、LLM Wiki、Understand-Anything 等属可选外部工具,不随本仓库提供;该技能本身不创建 cron 任务。