前言¶

把一本講義或一本書交給 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 。