前言¶
DeepSeek Harness（DSH）的理念是“一切皆插件”。當你的配置文件中包含上百個 fiber 時，很難搞清楚智能體實際由哪些組件構成。哪個 fiber 卡在 pending？誰提供了 llm 服務？dsh-session-title-first-prompt-llm 是做什麼的？dsh-constellation 旨在解決這些問題。它提供了一個實時、自組織的星座圖，展示運行中的配置文件中的每個插件和服務 fiber。
這是什麼¶
dsh-constellation 是一個客戶端插件，提供 DeepSeek Harness 插件生態的實時、自組織星座圖。它支持 AI 平衡的 taxonomy、雙語標籤、即時搜索、健康診斷以及一鍵插件操作。
核心功能¶
可視化圖譜¶
插件以圖形化方式展示，支持縮放和搜索。地圖初始狀態爲摺疊：每個能力域顯示爲一個藥丸形狀，大小由成員數量決定，域之間有聚合的依賴邊。
- 點擊域以展開其成員插件（呈徑向佈局），再次點擊以摺疊。
- 大域（成員數超過 12 個）會顯示服務集羣（例如 llm ×8），點擊集羣可過濾插件。
- 懸停或選擇插件可顯示實時依賴邊。
- 按 / 鍵可搜索插件、服務、關鍵詞或域。
AI 原生組織¶
插件生態增長速度快於任何手寫的類別列表。如果配置文件中啓用了 LLM，Constellation 會利用它：
- AI taxonomy：模型提議一個平衡的能力 taxonomy（無巨型域或單例域），並附帶雙語標籤。它爲每個插件分配短標籤。
- AI 描述：爲沒有描述的插件生成一行摘要。
- 一鍵重分類：點擊“AI classify”按鈕重新組織地圖。
詳情抽屜與操作¶
每個插件打開一個側邊抽屜，顯示其標籤、描述、相位以及提供的/消費的服務。
- 啓用 / 禁用：通過 cordis-plugin-loader 樹 API 切換條目狀態，並持久化到配置文件（無需重啓）。
- 移除：停止條目並將其從加載器樹中刪除（需要確認）。
醫生診斷¶
對實時快照進行自動診斷。點擊發現項可檢查詳情：
- ⏳ Stuck pending：等待不存在於活動插件中的服務的 fiber。
- ❌ Failed fibers：加載時崩潰的插件。
- 🧟 Zombie entries：已啓用但 fiber 已被釋放的條目。
- ⚠️ Duplicate providers：兩個插件提供相同服務。
雙語 UI¶
界面支持中文和英語，一鍵切換。
安裝與啓用¶
安裝插件需要運行 Web 配置文件（例如 web profile）。
dsh plugin --profile web add dsh-constellation
安裝完成後，啓動 Web UI：
dsh --profile web
在界面右下角點擊 ✦ 按鈕以打開 Constellation。
典型用法¶
- 按
/鍵搜索插件、域或關鍵詞。 - 點擊域以展開/摺疊成員插件。
- 點擊集羣（例如
llm ×8）以過濾插件。 - 在詳情抽屜中啓用、禁用或移除插件。
要求與注意事項¶
- DeepSeek Harness：版本必須爲
>= 0.1.0-rc.8。 - Node.js：版本必須爲
>= 20。 - 數據安全：數據從未離開 localhost；路由會拒絕非環回 Host 頭。
- 可選：要使用 AI taxonomy 和標籤，需要配置默認模型。
結語¶
dsh-constellation 爲管理複雜的插件生態系統提供了一個可視化的操作檯，使開發者能夠快速定位問題並管理插件狀態。
