前言¶
在 DeepSeek Harness（DSH）裏跑插件、服務、工具、會話和 MCP 時，單靠日誌往往只能看到離散事件，很難把「誰在調誰、流量落在哪一層」串成一張圖。dsh-anatomy 把 DSH 運行時畫成從左到右五層、十四個組件域的實時架構圖，並把近時段內真實觀測到的調用畫成連線與沿曲線流動的光點，配合指標、清單、日誌與時間線，便於對照排障與理解調用關係。
這是什麼¶
dsh-anatomy 是由 h2298511604-ops 維護的 DSH 插件，包含 Host 與 Client 兩部分：在左側欄增加「架構透視」入口，主區域打開整頁 DSH 架構透視 · 實時架構；也可在會話右側欄以緊湊 tab 查看，無需離開當前會話。
分類上屬於客戶端類插件（同時依賴 Host 推送運行時快照與事件流）。當前 GitHub 倉庫星標爲 0；package.json 標明版本 1.1.0、許可證 MIT、Node >= 20。倉庫即插件包，Host 與 Client 均爲原生模塊，文檔說明無需單獨構建步驟。
核心功能¶
分層架構與組件域¶
舞臺默認是 組件域視圖：左 → 右五層、共 14 個組件域（協議 id 在 Host 快照裏仍用 organs 字段）。下表摘自插件 README，職責劃分便於對照 DSH 內核概念。
| 層級 | 組件域（id） | 職責 |
|---|---|---|
| 入口層 | Web UI 客戶端（skin）、憑據授權（immune） |
頁面渲染與交互；調用者識別、授權與遙測 |
| 推理層 | Agent Loop（cortex）、LLM 推理（heart）、子代理/工作流（agents） |
會話循環、模型推理與流式生成、子代理與工作流 |
| 執行層 | 工具執行（stomach）、讀取搜索（eyes）、寫入終端（limbs）、網絡/MCP（lungs） |
工具管線；讀/搜/圖；寫/終端/子進程；Web 與 MCP |
| 狀態層 | 會話日誌（intestines）、上下文/Token（kidneys）、記憶技能（marrow） |
日誌持久化；上下文壓縮與 token 計量；技能、Hindsight、MCP 資源 |
| 內核與安全層 | Cordis 內核（spine）、沙盒權限（liver） |
插件纖維、服務容器、Loader、HMR、Web 宿主；沙盒、權限、審批與工具守衛 |
節點卡片彙總所屬域內的插件、服務、工具數量；點擊節點或清單項可在右欄查看詳情。舞臺底部有 CORDIS 內核 · 插件宿主 帶，展示插件（活躍/總數）、服務數、客戶端包數、纖維數及節點/連接數量。
真實調用連線與光點¶
連線只來自真實觀測：按近 120s 事件聚合「來源 → 目標」邊，無流量時節點仍可見，狀態區會提示暫無調用。舞臺右上角根據近 15s 是否有事件顯示等待數據 / 運行中 / 已連接·空閒 / 已暫停 / 離線等狀態，並顯示「最近事件：x 秒前」。
有流量的邊上用沿曲線移動的 SVG 圓點標示方向（源 → 目標）；圓點數量與速度隨近 120s 調用量變化，並按類型着色（例如 LLM=橙、工具=青、Session=紫、文件系統=藍、審批=琥珀、錯誤=紅、插件=品紅）。Host 還會基於觀測事件補畫語義流（如上下文加載、Token 計量、日誌落盤、compaction 回寫等），文檔強調這些同樣來自觀測而非裝飾線。
頂部「視圖」開關可在 組件域視圖 與 工具調用視圖 之間切換：後者左側爲 Top 24 工具卡片，默認只畫 Top 8 有流量工具的連線，可用「顯示全部連線 / 僅 Top 8」切換。
四個底部視圖與右欄詳情¶
整頁佈局包括：Header（版本/連接/會話過濾/暫停等）、左欄 14 域列表與搜索、中間可平移縮放的舞臺、可拖拽調寬的右欄詳情，以及底部四個 tab：
- 運行指標：events/s、工具與模型 calls/min、Token tokens/s、errors/min、平均耗時；約 60s 滾動窗口的 sparkline 與調用熱度排行。
- 組件架構：可搜索的插件（含 fiberPhase）、服務、工具、客戶端包、模型、MCP 等完整清單。
- 調用日誌：實時表格，最多渲染最近 200 行，可過濾與自動滾動；高頻 token 流不逐條刷屏。
- 時間線：近 60s / 近 120s 窗口，按 Session 泳道展示 LLM 與工具調用段。
右欄支持上下游、因果鏈、調用關係詳情，並可跳到調用日誌過濾或時間線；工具詳情含內置常用工具中文說明（文檔寫明內置 59 個）及耗時分佈等字段（Host 提供時顯示）。
首屏與數據流¶
打開面板時 Host 先推送約 5 KB 的 lite 快照（14 域計數 + 會話摘要），骨架消失後舞臺先出；隨後約 200 KB 全量快照補全詳情與連線。狀態區固定顯示 「首屏 xxx ms · 詳情 xxx ms」；底部四個 tab 等全量幀到達後再延遲一幀掛載，避免拖慢首屏繪製。
安裝與啓用¶
任選 README 中的一種方式安裝（安裝或更新後建議 Ctrl+R 刷新；左側欄應出現「架構透視」圖標，否則確認插件已啓用）：
社區插件市場（收錄後）：插件 → 發現 → 搜索 dsh-anatomy → 安裝。
GitHub 源碼安裝：
dsh plugin add github:h2298511604-ops/dsh-anatomy
npm：
dsh plugin add dsh-anatomy
npm 包頁面：npmjs.com/package/dsh-anatomy。
文檔說明卸載時路由、監聽器、定時器與打開的流連接會隨 ctx.effect 清理，不留後臺定時器。
典型用法¶
整頁架構透視¶
- 點擊左側欄「架構透視」圖標（面板 id =
anatomy），主區域打開「DSH 架構透視 · 實時架構」。 - 再次點擊側欄圖標或切換到其他面板即可關閉。
- 用 Header 的「會話過濾」選「全部會話」或某一標題會話；選中後舞臺連線、指標、工具視圖、日誌與時間線均只統計該會話，點「×」或選回「全部會話」恢復全量。
會話內緊湊版¶
不離開當前會話時，可：
- 在會話 header 工具區點擊架構圖標（title「在右側欄打開架構透視」），或
- 右側欄 guide 的「+」→「架構透視」。
同一會話再次點擊會聚焦該 tab；緊湊版頂部有會話下拉（默認同當前會話）、狀態 pill 與「全屏」按鈕；舞臺縮略圖與「全部組件域 · 14」列表可快速點選域並查看最近調用。
排障時常用操作¶
- 在 組件架構 中搜索插件/服務/工具名，點選後在右欄看狀態、方法與最近事件。
- 在舞臺點擊有高流量的連線，右欄打開「調用關係詳情」，使用「在調用日誌中過濾」跳轉。
- 暫停/繼續僅停止圓點動畫與重繪，數據仍接收（README 交互說明）；需要對照靜態結構時可先暫停再截圖。
時間窗口需心中有數：舞臺連線與多數調用明細按近 120s；運行指標 tab 數值來自 Host 約 60s 滾動窗口。
適用場景與注意¶
適合：需要可視化理解 DSH 五層架構、覈對工具/模型/會話/MCP 實際調用路徑、對照指標與日誌做運行時觀測的開發者。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請查看 GitHub 倉庫 源碼與 MIT 許可證，自行評估信任邊界。
- 社區目錄頁 skillhub.cn 插件條目 與 GitHub 爲同一生態內的分發與源碼入口；DSH 理念是「一切皆插件」，該目錄爲社區站點，與 DeepSeek / 幻方無文檔所述的官方從屬關係。
- 需 Node >= 20；客戶端通過
dsh.client注入 UI 槽位、locale 與 theme（見package.json的dsh.client.inject）。
結尾¶
dsh-anatomy 把 DSH 運行時收成一張可交互的分層架構圖：十四組件域、真實調用連線、四視圖觀測與會話過濾，並區分 lite/全量快照以兼顧首屏速度。若要安裝或提 issue，可從插件目錄頁與倉庫入手：
- 目錄頁：https://www.skillhub.cn/plugins/h2298511604-ops/dsh-anatomy
- GitHub：https://github.com/h2298511604-ops/dsh-anatomy
