前言¶

把一本讲义或一本书交给 AI 整理，常见的产出是一份 Markdown 大纲：概念被拆成条目，放进层级缩进里。大纲能看顺序，但看不出概念之间前置、关联、对比的关系；想找“学这个概念之前要先会什么”，多数时候只能靠搜索或翻目录。Synapsis 析域（mathilde1214/dsh-synapsis）是给 DeepSeek Harness（DSH）Web UI 用的面板插件，把概念摊成一张图，按层推进、按距离缩成卡片。下面介绍它做什么、怎么装、怎么用。

这是什么¶

Synapsis 析域由 Mathilde1214 维护，是一个客户端分类的 DSH 插件，当前版本 0.20.0，许可证 MIT。它解决的问题是：当一份材料的体量超过几十个概念之后，纯文本大纲表达不出概念之间的网状关系；它把书本概念展成一张概念图，每层聚焦一个分支，卡上有定义、形式化、直觉、例子、易错点，以及前置和引出的概念。

插件本身不做 OCR，也不解析 PDF；它认的格式是 .mindmap.json。整理讲义、把 PDF 转成图这一步，交给 DSH 的对话完成。

核心功能¶

滚动即进入。 滚轮以光标为锚缩放，每一层钉在可读字号上；继续往前推，光标下最近的子分支成为新的主图根，缩小一半退回上一层。不新开窗口，也不把字糊掉。

每层都是一张完整图。 焦点切换后布局按它重排成完整圆周，子分支展开后是导图，而不是挤在父图某个扇区里。卡片按距离分层：焦点是全卡，子级是标题加摘要，再远只留标题，更远收成一个点。

侧栏概念卡五栏正文。 卡上有定义、形式化、直觉、例子、易错点，另有原文出处、前置、引出、掌握度、个人笔记。空栏显示「点这里写…」，双击进入编辑；形式化一栏编辑时是 LaTeX 源码加实时预览。

连线分四种。 从属是实线，前置是琥珀虚线，关联是青绿点线，对比是玫红双线。父子之间不建关系边，从属关系由树表达。

搜索与就地编辑。 ⌘K / Ctrl+K 按标题、英文名、正文、笔记一起找，回车跳到该概念并正中对齐。Tab 加子概念，Enter 加同级，F2 改名，Delete 删除；删掉有子概念的节点时会询问是一起删还是把子概念上提。改完 0.6 秒自动写回文件，切图前会先落盘未写完的改动，保存失败就不让切走。写文件前把上一版存进 .history/。

学习路径与复习模式。 选中概念点「学习路径」，右侧按硬前置排成有序链；点「A → B」则给一条从任意起点走到它的最短必经链。复习模式一次最多抽 15 个写了正文的概念，先显示标题，回想后翻面，再评「没印象 / 有点模糊 / 会了」，评分写回 mastery，模糊的排在下一轮最前。

导出与大纲。 顶栏导出导出当前这一层：PNG、SVG 矢量图、Markdown 大纲；SVG 放大不糊，Markdown 是缩进大纲，适合贴进笔记软件。大纲视图把画布换成一棵树，双击行跳到那一层，两百个概念的书找东西比缩放快。

两套纸与字。 浅色米黄纸，暗色夜间纸，带纸纹。顶栏「设置」里可换纸（米黄 / 灰白 / 淡绿）、换字体（楷体 / 宋体 / 黑体）、调字号与明暗，选完记住。公式用自带 KaTeX 渲染，$$…$$、$…$、\(…\)、\[…\] 都认，不依赖网络。

安装与启用¶

安装命令来自仓库 README。钉死提交哈希是推荐做法，避免重装时被上游新代码静默替换。

1、先确认 Desktop 的前提。先把 Desktop 正常启动一次，让它初始化 profile；完全退出 Desktop（不是关窗口）；用 Desktop 自带的 CLI 装，而不是全局 npm 装的 dsh：<安装目录>/resources/runtime/cli/bin/dsh（Windows 是 dsh.cmd）。

2、从 GitHub 装：

dsh plugin --profile desktop add github:Mathilde1214/dsh-synapsis#<提交哈希>

提交哈希在仓库提交列表里挑。仓库是纯 JavaScript，构建产物 client.js 已随仓库提交，不需要 prepare 构建，也不用开 pnpm 的 allowBuilds。

3、从 tarball 装（离线、内网）：

pnpm pack            # 在仓库根目录执行，得到 dsh-synapsis-<版本>.tgz
dsh plugin --profile desktop add ./dsh-synapsis-<版本>.tgz

4、从本地目录装（改代码时用）：

dsh plugin --profile desktop add /绝对路径/到/这个仓库

面板里也能装：plugin_manager: install_bundle，target 填这个目录的绝对路径。装完刷新宿主页面（桌面端按 Ctrl/Cmd+R）。

5、卸载：

dsh plugin --profile desktop remove dsh-synapsis

6、兼容性。engines.dsh 是 >=0.2.0 <0.3.0，DSH 安装时和启动 profile 时都会校验，不满足会直接拒绝并说明原因。面板只用到 slots、webServer、connection、tools、systemPrompt 这几个扩展点。

7、从插件索引装。仓库带 plugin-market/index.json，先在「插件 → 实验性插件」里打开 Custom plugin indexes，再到「插件 → 发现 → 添加索引源」填：

https://raw.githubusercontent.com/Mathilde1214/dsh-synapsis/main/plugin-market/index.json

典型用法¶

装好后，侧栏点「析域」，面板打开一张图。首次安装、库里没有图时，会放一张五个节点的示例「示例 · 从这里开始」，删掉不会再生成。

先从浏览开始。滚轮往前推进入子分支，缩一半退回上一层；画布空白处拖拽是平移。点一条关系线选中，顶部出现「A → B」和三个类型按钮，可换类型或删除，⌘Z 撤销；Delete 删线，Esc 取消。

再试整理。按 Tab 加子概念，Enter 加同级，双击正文进入该层就地编辑；按住 Shift 从一张卡拖到另一张建一条 prereq，同一对概念再拖一次变 related，第三次变 contrast，第四次删线；反向拖改方向并重置回 prereq。直接拖一张卡到另一张上可以改归属，拖进自己的子孙会被拒绝。

想从讲义开始。插件自己不解析 PDF，它只认 .mindmap.json；顶栏「导入」会提示把 PDF 拖进左边的对话、把指定那句话发给它、图会落到哪个库目录（那里有一键复制）。生成完切一下面板或按 ↻ 即看到。这样不用在插件里配模型 key，也不重复实现 OCR。

图存在库目录，插件装在 DSH 的 profile 里，两者互不相干；升级或卸载重装动的只是 profile 下那一份代码副本，库目录不会被碰。

适用场景与注意¶

适合想把讲义、书籍、课程整理成概念图、且已经在 DSH Web UI 里工作的人。它处理的是几十到几百个概念之间的前置、关联、对比关系，而不是做全文检索或笔记同步。

注意三点。一是插件以当前 dsh 进程的权限运行，读的是它配置的数据目录，安装前应检查源码和 MIT 许可证。二是安全模型：插件只在 127.0.0.1 上、通过 DSH 自己的 web server 提供一组 /synapsis-api/* 路由，没有独立端口；写操作（/save、/create、/delete）要过 DSH 的连接校验，非 DSH 页面发起的请求会被拒（401），且必须带 content-type: application/json（否则 415），请求体上限 8 MB。不要用 --host 0.0.0.0 之类方式把 DSH 端口暴露到局域网或公网，远程访问走带鉴权的反向代理。三是保存带版本号、冲突时只会提示选「重新加载」或「用我这版覆盖」，多标签页同时编辑同一张图时不会两边互相覆盖。

结尾¶

Synapsis 析域把概念图放进 DSH Web UI：滚动推进、按距离分层、就地编辑、前置链和复习，适合需要长期维护一份讲义知识结构的人。目录页在 https://www.skillhub.cn/plugins/Mathilde1214/dsh-synapsis ，源码在 https://github.com/Mathilde1214/dsh-synapsis 。