DeepSeek Harness 插件開發套件 (dsh-plugin-devkit)

DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在開發 DSH 插件時，開發者常面臨運行時狀態不可見、調試環境隔離困難、依賴真實瀏覽器進行契約測試效率低，以及無法預覽客戶端在槽位中的渲染效果等問題。dsh-plugin-devkit 是一套社區維護的開發工具集，旨在解決上述痛點。

它是什麼¶

該插件提供了一套完整的 DSH 插件開發輔助工具，包括運行時檢查器、隔離調試啓動器、宿主契約測試器和客戶端槽位預覽器。它由 CkEFFAF 維護，目前包含 547 個單元測試。需要注意的是，該項目爲社區維護，與 DeepSeek AI 無官方隸屬關係。

核心功能¶

所有四個模塊都打包在同一個 npm 包 @effaf/dsh-plugin-devkit 中：

dsh-debugger (運行時檢查器): 提供對實時組合狀態的觀察能力，支持通過 /debug 命令和 ctx.debugger 接口進行查詢。
dsh-debug-boot (隔離調試啓動): 允許通過 CLI 啓動一個獨立的 DSH 配置文件，確保調試過程不會干擾日常使用的環境。
dsh-plugin-test (宿主契約測試): 提供虛擬 Cordis 宿主，用於斷言宿主行爲，無需依賴真實瀏覽器即可運行測試。
dsh-plugin-preview (客戶端槽位預覽): 將客戶端組件掛載到模擬的槽位環境中進行渲染。

安裝與啓用¶

在目標 DSH 配置文件中掛載插件：

dsh plugin --profile web add @effaf/dsh-plugin-devkit

安裝後，三個命令行工具（debug-boot、dsh-plugin-test、dsh-plugin-preview）會出現在全局路徑中：

npm install -g @effaf/dsh-plugin-devkit

典型用法¶

檢查運行時狀態: 在會話中發送 /debug health 查看組合狀態，或使用 /debug trace <callId> 追蹤端到端的調用鏈路。
隔離測試環境: 使用 debug-boot CLI 創建一個臨時的 DSH 配置文件進行測試。
斷言宿主行爲: 使用 dsh-plugin-test CLI 將插件掛載到虛擬的 Cordis 宿主上進行契約驗證。
預覽客戶端渲染: 使用 dsh-plugin-preview CLI 在模擬的槽位外殼中渲染客戶端組件。

適用場景與注意事項¶

環境要求: 需要安裝 DSH 0.1.5-rc.2 及以上版本，以及 Node.js 22 或更新版本。
安全性: 插件在存儲數據前會對敏感信息進行清理。
權限範圍: 插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。

總結¶

dsh-plugin-devkit 提供了一套專注於觀察、隔離、測試和預覽的工具。它不破壞被觀察的運行時，且所有敏感信息在進入緩衝區前已被脫敏。對於需要在 DSH 生態中進行插件開發的開發者來說，這是一套可以直接集成使用的實用工具。