dsh-synapsis

Synapsis · 析域

[English](README.en.md) · 中文

给 [DeepSeek Harness](https://github.com/deepseek-ai) 桌面端用的概念地图插件（技术上是 DSH 的 web 平台插件，同时适用于桌面版与 dsh web）。

它做的事很简单：把一本书的概念摊成一张能走进去的图。滚轮往前推，子分支就长成新的主图；缩回来，又退回原来那一层。每个概念是一张卡，卡上有定义、形式化、直觉、例子、易错点，还有它需要的前置和它引出的东西。

效果图

总览层。十章铺成一圈，再外面是章节里的主题点。

点一个概念，右侧展开卡片。公式是 KaTeX 排的，暗色主题下是「夜间纸」。

双击任意一栏就能改。形式化那栏给出 LaTeX 源码，下面实时预览。

「学它之前要先会什么」——按硬前置排成一条链，链上的卡片描金边，其余让路。

⌘K 搜概念名、定义里的词、甚至公式的写法。

点一条关系线即可选中，顶部出现换类型和删除的按钮。

怎么用

侧栏点「析域」，整页面板打开一张图。

滚动即进入。 滚轮以光标为锚缩放，每一层都被钉在可读的字号上；再往前推，就走进离你最近的子分支，它成为新的主图根。缩小一半退回上一层。不开新窗口，也不会把字糊成像素。

每层都像一张独立的图。 换焦点时布局会按它重排成完整圆周，所以任何子分支展开后都是完整的导图，而不是挤在父图某个扇区里。

卡片按距离分层。 焦点是全卡（标题、摘要、定义），子级是标题加摘要，再远只留标题，更远收成一个点。

侧栏概念卡分五栏正文，加原文出处、前置、引出、掌握度、个人笔记。空栏会显示「点这里写…」，双击就进编辑；形式化那栏编辑时是 LaTeX 源码加实时预览。

连线分四种。 从属是实线，前置是琥珀虚线，关联是青绿点线，对比是玫红双线。

面包屑和小地图让你知道自己站在哪儿，也知道整张图有多大。

搜索按标题、英文名、正文、笔记一起找。回车跳过去，那个概念会正中对齐并成为新的根。

就地编辑：Tab 加子概念、Enter 加同级、F2 改名、Delete 删除。删一个有子概念的节点时会问：一起删掉，还是只删它、把子概念上提。改完 0.6 秒自动写回文件；切图、新建、删除之前会先把没写完的改动落盘，保存失败就不让你切走。写之前把上一版存进 .history/，不是只留一份 .bak。

连边：按住 Shift 从一张卡拖到另一张，松手建一条 prereq。同一对概念再拖一次变 related，第三次变 contrast，第四次把线删掉。反向拖会改方向并重置回 prereq。父子之间不建关系边——从属关系已经由树表达了。

改边、删边：点那条线就选中，线会亮起来，顶部出现「A → B」和三个类型按钮。换类型或删除立刻落盘，⌘Z 能撤销。按 Delete 删的是线，按 Esc 或点空白取消。从属实线不可选，它由树决定。

学习路径：选中一个概念点「学习路径」，右侧按硬前置把「学它之前得先会的」排成有序的链（无环时就是拓扑序）。点「A → B」则给一条从任意起点走到它的最短必经链。打开时整张图会铺开，让整条链都在视野里。

两套纸：浅色是米黄纸，暗色是夜间纸，都带纸纹。顶栏那个「日光纸 / 夜光纸」按钮就地切换，会记住你的选择；第一次装好时跟着宿主的明暗走。

换图和删图：顶栏最左边是图库下拉，切换就换一张图（会自动重新取景），下次打开面板会回到你上次看的那张。旁边的「删除」要连点两下，第一下只是举枪，4 秒不点就放下。删掉之后底部会出一条提示，6 秒内点「撤销」就能捞回来（文件本来就在库目录的 .trash/ 里）。

历史与回收站：顶栏「历史」里有这份图的版本（每次保存留一份，另有每五分钟一个检查点）和回收站。选一版点「回到这一版」，当前内容会先存进历史，所以后悔还能再回去；回收站里的图点「放回来」就回库，名字被占会自动加 -2，不会覆盖现有的图。

从空图开始：下拉左边的「+ 新建」长出一张只有根节点的空白图，按 Tab 就能往下加概念。讲义在手上、想自己动手整理的时候用它。

拖卡片改归属：直接拖一张卡，松手落在一另一张卡上，它就挂到那张卡下面。拖进自己的子孙里会被拒绝（那样树就断了）。画布空白处拖拽仍然是平移。

导出：顶栏「导出」有五项。PNG / SVG 各有「当前层」和「整张」两份——当前层就是你正看着的那一支，整张从根排，201 个概念也能一张出完（文件会大不少）。需要放大看细节就选 SVG，它是矢量的，放多大都清楚。Markdown 导出的是整棵树，从根开始写缩进大纲，适合贴进笔记软件。

大纲视图：顶栏「大纲」把画布换成一棵树，从整份图的根开始排，跟画布当前停在哪一层无关。点行选中它（右侧照常出概念卡），双击行跳到那一层；左边三角收起分支，右边小圆点是它的掌握度。两百个概念的书，找东西比缩放快。

复习模式：顶栏「复习」抽一批概念过一遍——先标题，回想，再翻面看定义、形式化、例子、易错点，然后给自己评「没印象 / 有点模糊 / 会了」。评分会顺手排下一次复习：没印象明天再来，模糊三天后，会了按上次间隔翻倍（7 天起、120 天上限）。所以到期的排在前面，卡头还会写「到期 N 个」。想先跳过某张就点「明天再问」，它会被推到明天。一轮最多 15 个，只收「写了正文」的概念（只有标题的章、主题不进队列）。选中某一章再点侧栏的「复习这一支」，队列就只从这一支里收；一轮走完如果里面有没印象/模糊的，完成页可以直接「再来一遍刚才模糊的」。卡片可以按住顶部那条拖开，不挡底下的图。

纸与字：顶栏「设置」里换纸（米黄 / 灰白 / 淡绿）、换字体（系统 / 楷体 / 宋体 / 黑体，默认「系统」，楷体在 Linux 上常缺字）、字号三档，再用「深浅」那条滑杆把纸整体提亮或压暗一点。夜光纸另有它自己的一套配色，不跟这三套走。选完就记住，下次打开还是这套；「恢复默认」一键回去。

导入 PDF：插件自己不解析 PDF，它只认 .mindmap.json。真正的活交给 DSH 的对话：顶栏「导入」会告诉你三件事——把 PDF 拖进左边的对话、把哪句话发给它、图会落到哪个库目录（那里有一键复制）。生成完切一下面板（或按 ↻）就看见了。好处是不用在插件里再配一个模型 key，也不会为同一本讲义重复实现一遍 OCR。

快捷键

| 键 | 作用 |

| --- | --- |

| ⌘K / Ctrl+K | 搜索 |

| 双击卡片 | 进入该层（它成为新的根） |

| 双击侧栏正文 | 编辑这一栏 |

| Tab / Enter | 加子概念 / 加同级概念 |

| F2 | 改名 |

| Delete | 删节点（有子概念会问）或删选中的线 |

| 拖拽卡片 | 改归属（挂到另一张卡下面） |

| Shift + 拖拽 | 连一条关系边 |

| ⌘Z / Ctrl+Z | 撤销（连续打字合并成一步） |

| ⌘/Ctrl + 点卡片 | 加入/移出多选，选中后可一次性删掉或批量打掌握度 |

| Shift + 在空白处拖 | 框选一片概念（框住中心点的都算） |

| Esc | 依次收起搜索、编辑、删除询问、多选、选中的线、导出菜单 |

安装

仓库根目录就是插件包：package.json 里带 dsh.bundle.patch，engines.dsh 声明兼容的 DSH 版本。装完刷新宿主页面（桌面端按 Ctrl/Cmd+R）。

先确认 Desktop 的前提（用桌面版的人最常卡在这一步）：

1. 先把 Desktop 正常启动一次，让它把 profile 初始化好；

2. 完全退出 Desktop（不是关窗口）；

3. 用 Desktop 自带的那份 CLI 装：<安装目录>/resources/runtime/cli/bin/dsh（Windows 是 dsh.cmd）。用 npm 全局装的 dsh 改不到 Desktop 的 profile。

如果不想碰命令行，Desktop 的「插件」页面里也能装，效果一样。

从 npm 装（推荐）

dsh plugin --profile desktop add dsh-synapsis