前言¶
在 DeepSeek Harness（DSH）裏開發或維護一個工作區時，文件數量一多，單靠目錄樹很難一眼看清「誰 import 誰、文檔鏈到哪些資源」。常見做法是切 IDE 的依賴圖或自己寫腳本掃 import，但那些工具往往只覆蓋部分語言，也不會和 DSH 側欄預覽連在一起。
Connectome 是社區維護者 elalamiimed 發佈的 DSH bundle 插件（npm 包名 dsh-connectome，GitHub 倉庫 elalamiimed/dsh-connectome）。它在 Web UI 裏掃描當前工作區，把文件當成節點、引用當成邊，用單塊 <canvas> 和 d3-force 力導向佈局畫成可交互地圖；點擊節點可在 Harness 右側欄打開對應資源預覽。分類上屬於客戶端插件；數據僅在本地處理，README 明確不寫遙測、不髮網絡請求。
這是什麼¶
Connectome 的定位是：DeepSeek Harness Web UI 裏「活」的工作區地圖——代碼、文檔、PDF、圖片、數據與未分類二進制等 regular 文件都會成爲節點；文件夾以嵌套輪廓疊在佈局後方，不參與力模擬，避免擠亂引用關係。
插件由 Host 半（工作區掃描 + HTTP 路由）和懶加載的瀏覽器模塊（畫布 UI）組成，通過 Cordis patch 掛進 DSH。
核心功能¶
下面介紹 README 中已寫明、且與實現描述一致的能力。
畫布與性能¶
節點與邊畫在同一塊 canvas 上，不爲每個文件創建 DOM 節點。d3-force 負責佈局，插件用 requestAnimationFrame 驅動模擬，空閒後停止，目標是在大量節點下仍保持約 60 fps 的交互體驗。
文件類型與圖例¶
掃描結果按粗粒度家族區分形狀：code（圓）、docs（圓角方）、data（菱形）、assets（環，含圖片/媒體/字體/壓縮包等）、other（小點）。左上角圖例統計各家族數量；節點 tooltip 顯示類型、擴展名與字節大小。
文件夾區域¶
目錄以嵌套輪廓繪製在圖後方並標註文件夾名；頂欄可切換顯示/隱藏。文件夾映射物理位置，不是力節點，不會推開依賴佈局。
可讀的引用邊¶
依賴邊在被引用端帶箭頭：實線表示 JS/TS 的 import / export … from / 動態 import() / require()，以及 CSS @import 等；虛線表示 HTML 屬性、Markdown 鏈接/圖片、CSS url(...) 等資源引用。懸停邊可看到兩端路徑與關係類型。
Host 側用小型、無額外依賴的正則提取鏈接；不會把裸包名展開到 node_modules。僅相對路徑、根相對路徑以及 @/、~/ 等形式會解析到工作區內文件。node_modules、.git、構建產物、緩存與點目錄等會被跳過；lockfile、source map、壓縮 bundle 等也在排除列表中。
鄰域與打開文件¶
懸停節點會高亮其鄰域，並列出直接關聯（→ 其 import、← 被誰 import），條目可點；超出部分有 +N 摘要。單擊節點通過 ctx.sidebarRight.openResource 以 dsh-resource://file/session/… 在右側欄預覽（代碼帶行號、Markdown、PDF、圖片、Office 等，取決於 Harness 預覽能力）。頁腳會對缺失預覽或未選 session 等情況給出說明。
主題與操作¶
畫布顏色讀取運行時 --dsw-alias-* 主題 token，明暗切換會同步改色。支持多工作區切換、重新掃描、fit、縮放、平移、拖拽節點；Esc 或關閉按鈕退出對話框。
掃描上限（Host）¶
README 說明掃描帶有硬上限（例如 2,000 個文件節點、12,000 個目錄項、1,500 個被解析文件等，具體以倉庫文檔爲準）。超大倉庫可能無法完整上圖，需要心裏有數。
安裝與啓用¶
環境要求：DeepSeek Harness 0.2.1-rc.2 或更新（Desktop 或帶標準 Web bundle 的 dsh web 部署）。從源碼構建需要 Node.js 18+；發行版已附帶預構建的 client.js。
在 Web UI 中安裝（推薦）¶
打開側欄 Plugins → Install，輸入下列之一：
dsh-connectome
github:elalamiimed/dsh-connectome
安裝成功後，在側欄面板列表的 More 菜單中選擇 Connectome（README 中帶 🧠 前綴的同一項）。
若 npm 仍停在 0.0.0-stage 佔位包，可能出現 dsh-connectome declares no dsh.bundle。README 建議：安裝對話框選用 Official npm registry，或等鏡像同步後重試，或改用 github: 規格；也可用 npm view dsh-connectome dist-tags --registry https://registry.npmmirror.com 查看鏡像當前版本。
在終端中安裝¶
CLI 將包操作轉發到 profile；裝完後仍需在 Plugins 裏啓用 bundle（Web UI 安裝會一併完成啓用步驟）：
dsh plugin --profile desktop add dsh-connectome
# 或直接從 GitHub：
dsh plugin --profile desktop add github:elalamiimed/dsh-connectome
將 --profile desktop 換成你實際使用的 profile 名稱即可。
許可證：MIT（package.json 與 README badge 一致）。當前 npm 版本爲 1.1.0（以 package.json 爲準）。
典型用法¶
經過上面的安裝與啓用，可按 README 中的步驟操作：
- 側欄 More → Connectome，對話框會掃描當前工作區並將圖 fit 到視口；左上角圖例顯示各文件家族數量。
- 用頂欄切換工作區（若註冊了多個）、開關文件夾輪廓、重新掃描、fit 或縮放；拖背景平移，滾輪在指針處縮放，拖節點調整局部佈局。
- 懸停節點或邊查看關係 tooltip；懸停節點還會強調其文件夾鏈。單擊節點在右側欄打開文件；Esc 或 ✕ 關閉對話框。
支持的依賴語法摘要見 README 表格：JS/TS/JSX/TSX/Vue/Svelte、CSS 系列、HTML、Markdown 相對鏈接、Python import / from . import 等。
適用場景與注意¶
適合：需要在 DSH 內快速瀏覽整個工作區結構、追蹤模塊或「引擎文件」之間如何相連、並從圖上直接跳進預覽的開發者。
注意：
- 插件以當前 DSH 進程權限讀取工作區；安裝前應自行審閱 源碼 與 MIT 許可證。
- 社區目錄頁 skillhub.cn/plugins/elalamiimed/dsh-connectome 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，本文描述的是社區插件行爲，以 README 與發佈包爲準。
- npm 上另有無關插件
dsh-project-brain；本插件發佈名爲dsh-connectome，勿混淆。
結尾¶
Connectome 把「每個文件是神經元、每條引用是突觸、每個文件夾是區域」這一比喻落實爲可操作的 canvas 地圖，並和 DSH 右側資源預覽銜接。若要安裝說明與 API 細節，以 GitHub README 爲準：
- 目錄頁：https://www.skillhub.cn/plugins/elalamiimed/dsh-connectome
- 倉庫：https://github.com/elalamiimed/dsh-connectome
- npm：https://www.npmjs.com/package/dsh-connectome
