Agent Skills
返回列表
突触链接

突触链接

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ee2f9a3e/synaptic-link。

技能介绍

问题背景

在 Obsidian、Zettelkasten 或团队 Wiki 里攒了几百篇 Markdown 之后,把整库塞进上下文既不现实,也容易让模型抓错段落。你需要的是按查询命中具体章节,再决定是读全文还是只用片段。

工作原理

Synaptic Link 在本地用 SQLite FTS5(trigram 分词)为整个 Markdown 库建索引,并按章节标题切分成块,检索结果会带上 § Section 级别的上下文,便于做段落级召回。

典型流程:

  • 对指定目录执行索引,生成默认位于 ~/.synaptic-link/synapse.db 的数据库(可用 --db 或 SYNAPTIC_DB 覆盖)
  • 用搜索命令查询;输出中的章节信息用来判断是否还要 read 整文件
  • 索引、搜索、读取路径零额外依赖;仅 watch 监听变更时需要 watchdog

边界与注意点

  • 文件名以 _draft_ 开头的笔记不会进入索引
  • Trigram 要求查询串至少 3 个字符;一两个字的 CJK 词往往匹配不到,宜改用更长短语(例如用「knowledge base」而不是「kb」)
  • 需 SQLite 3.35+ 才支持 FTS5 trigram;近年 macOS / 主流 Linux / Windows 发行版一般可满足

使用场景

  • Obsidian 笔记库上千篇,智能体需先搜到含某 API 说明的章节再决定是否读整篇
  • 团队 Wiki 全是 Markdown,对话中要按关键词定位到具体小节而非盲目打开目录下所有文件
  • 维护 Zettelkasten 卡片库,查询命中后根据 § Section 判断片段是否足够回答用户问题
  • 本地 Vault 持续更新,配合 watch 监听后让索引与新增章节保持可检索状态

适合人员

  • 用 Obsidian/纯 Markdown 管理技术文档的个人,希望助手只在命中章节里读内容
  • 为 RAG 或 Agent 搭建本地知识库的工程同学,需要不依赖云端搜索的 FTS 索引方案
  • 维护内部 Wiki 与草稿分离(`_draft_` 前缀)的知识管理员,要避免草稿被误检索
  • 在离线或内网环境跑 Agent、只能访问本机笔记目录的自动化脚本作者