突触链接
将以下提示词粘贴到你的 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、只能访问本机笔记目录的自动化脚本作者