@ddtcorex/dsh-maestro-devkit: DeepSeek Harness 通用開發工具包

在 DeepSeek Harness（DSH）的開發流程中，除了常規的代碼邏輯外，前端視圖的快速迭代、樣式調試以及特定組件的隔離測試往往是開發者的痛點。雖然 DSH 本身提供了核心能力，但針對視圖審查、熱更新和特定業務組件（如 Cordis、Govard、Skills）的開發，仍需額外的輔助手段。

@ddtcorex/dsh-maestro-devkit 旨在爲開發者提供一個統一的開發工具集，解決視圖審查、樣式調試和組件隔離的問題。

插件簡介¶

這是一個通用開發工具包，主要面向 DSH 的視圖開發和調試場景。它由 ddtcorex 維護，提供了一系列前端工具，包括可視化審查、熱模塊替換（HMR）、樣式檢查器，以及對 Cordis、Govard 和 Skills 開發的支持。該工具集是隧道感知的，能夠適應本地開發和通過隧道訪問的場景。

核心功能¶

該插件包含以下核心模塊：

1. 視圖捕獲（frontend_capture）
   支持多視口截圖，並捕獲 DOM 結構和幾何信息。它對隧道環境友好，能夠識別 local 或 https://tunnel.example.com 等不同的訪問地址。

2. 熱模塊替換（frontend_hmr）
   利用 chokidar 監聽文件變化，並自動分類變更類型：

   • dist hot-patch：直接熱補丁。
   • build:client：客戶端構建。
   • host-restart：需要重啓宿主。
     在執行替換前，會通過 curl 驗證目標 URL 的可用性。

3. 樣式檢查（frontend_inspect）
   通過客戶端註冊的 RPC 通道，直接從活動瀏覽器標籤頁獲取真實的 getComputedStyle 結果。結果展示爲內聯覆蓋面板，方便開發者實時調試樣式。

4. 組件隔離（frontend_isolate）
   允許開發者將單個插槽（slot）隔離到沙箱環境中進行測試。通過訪問帶有特定查詢參數的 URL 即可進入隔離模式：

    /?__devkit_sandbox=<slot>&props=<json>

在隔離模式下，支持通過 JSON 編輯器修改屬性，並使用視口切換器進行觀察。

5. 會話開發（devkit_session）
   直接通過 ctx.sessions 查看和檢查真實會話列表，便於調試運行時狀態。

6. Govard 與 Skills 支持

   • devkit_govard：提供 Govard 相關命令（僅限允許列表中的命令）。
   • devkit_skills：提供真實的文件系統列表和腳手架功能，用於 Skills 的開發。

安裝與啓用¶

安裝該插件需要使用 DSH 的插件安裝命令。

1、執行安裝命令：

dsh plugin --profile web add @ddtcorex/dsh-maestro-devkit

2、安裝完成後，需要重啓 dsh web 進程以使插件生效。

典型用法¶

開發者通常在以下場景下使用該插件：

• 樣式調試：在頁面中打開開發者工具面板，查看實時計算後的樣式屬性。
• 組件隔離測試：針對某個特定的插槽，通過 URL 參數 /?__devkit_sandbox=slot_name&props={"key": "value"} 快速切換 props 並測試渲染結果。
• 視圖審查：使用多視口捕獲功能，確認不同屏幕尺寸下的佈局表現。

注意事項¶

該插件目前已被標記爲 Retired（已退役）。由於其 UI 和工具未能完成一個完整的、可演示的開發工作流，且存在功能重複的情況，該包不再接受新的運行時版本發佈。

• 無替代品：目前沒有可以直接替換此插件的工具。
• 回滾支持：現有的 0.3.2 版本工件仍然可以安裝，用於回滾。
• 版本變更：在 0.2.0 版本中，devkit_cordis_inspect 和 devkit_plugin 模塊已被移除。這兩個模塊的功能與核心 @deepseek-ai/dsh-tool-cordis 擴展重複，開發者應直接使用核心擴展提供的 cordis_inspect_list、cordis_define 等命令。

結語¶

雖然該插件已停止維護，但其提供的視圖捕獲、樣式檢查和組件隔離思路對 DSH 生態仍有參考價值。對於需要快速調試視圖和組件的開發者，可以參考其實現方式，或直接使用 Chrome DevTools/CDP 等通用工具組合。

• GitHub 倉庫