前言¶
DeepSeek Harness(DSH)目前仍處於 developer preview。如果你的日常使用不止於基礎對話和源碼運行,還希望補上 Windows 桌面啓動入口、桌面提醒、社區插件管理、MCP 服務管理、模型輸入類型聲明、最後一條消息修改、子代理開關和官方 Team 監控等能力,dsh-enhanced-plugins 是一個可以整體安裝、也可以按功能 ID 選擇性安裝的增強套件。
它不修改 DSH 核心;已覈實材料說明,所有 Web 功能都通過公開插件擴展點接入。本文只根據已覈實事實介紹它的定位、功能、安裝命令、選擇規則和注意事項。
這是什麼¶
dsh-enhanced-plugins 的倉庫名是 sky-unicorn/dsh-enhanced-plugins,由 sky-unicorn 維護。它由七個可獨立安裝的 Cordis 功能包和一個 Windows companion 組成,適合已經能從源碼運行 DSH Web profile 的用戶。
它的價值主要在三方面:
- 給 DSH 增加一組可選能力,而不是替換 DSH 本身。
- 支持全量安裝,也支持按穩定 feature ID 選擇保留哪些 Profile 功能包。
- 對 Windows 桌面體驗單獨提供 Launcher、聲音提醒和桌面寵物相關能力,同時保留其餘功能的跨平臺使用方式。
功能清單¶
下面列出已覈實的功能。功能 ID 用於安裝命令中的 -Features 參數。
| 功能 | Feature ID | 說明 |
|---|---|---|
| Windows Launcher | windows-launcher |
提供托盤控制入口,可訪問 Web、Headless、profiles、source builds 和 diagnostics。 |
| Desktop alerts and pet | notification |
提供任務聲音、自定義 WAV 庫和原生動畫寵物。 |
| Plugin Community | plugin-market |
搜索、安全預檢、安裝和卸載社區插件。 |
| MCP server manager | mcp-server-manager |
管理 stdio / Streamable HTTP 服務器,並導入本地配置。 |
| pi-ai model request types | model-input-types |
聲明某個模型只接受文本請求,還是也接受圖像請求。 |
| Edit last message | edit-last-message |
修改最後一輪用戶消息,並在同一會話中重新生成。 |
| Product subagents | sub-agent |
即時啓用或禁用 Claude Code / Codex 工具。 |
| Official Team monitor | agent-team-monitor |
按角色分組顯示運行中/歷史子會話,展示原生詳情、Team 依賴和 mailbox counts。 |
windows-launcher 是必需的 global component。它會由後端加入,不需要寫在 -Features 列表裏,也不能通過 feature selection 移除。
安裝前檢查¶
先確認環境和目錄結構,再複製安裝命令。
要求如下:
- Node.js
22.19.x,或 Node.js24及更高版本。 - 一個可以從源碼運行的 recent DSH Web profile。
- 已覈實兼容 DSH
0.1.2-alpha.2,本地 ABI baseline commit 爲0a53fb55bea101816fa226bb964ae2bed71c343b。
Windows Launcher、native sounds 和 desktop pet 需要完整 Windows desktop edition 與 Windows PowerShell 5.1:
- Windows 10 version
1607或更高版本; - Windows 11。
Windows S mode、IoT / reduced-footprint editions,以及 Windows 10 1507、1511 不在該基線內。其餘功能可按材料描述作爲跨平臺功能使用。
DSH 仍是 developer preview。如果 DSH 升級後出現兼容問題,先覈對已驗證版本和 commit,再判斷是否爲插件側問題。
安裝全部功能¶
先檢查 DSH 和 dsh-enhanced-plugins 的目錄關係。
如果兩個倉庫共享同一個父目錄,例如:
<workspace>/
├── deepseek-harness/
└── dsh-enhanced-plugins/
在 dsh-enhanced-plugins 倉庫根目錄執行:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1
省略 -Features,或傳入 -Features all,都會安裝七個獨立 Cordis 包和必需的 Windows Launcher。這條命令只安裝或更新程序文件,不會啓動或打開 Launcher。
如果希望同時創建桌面快捷方式,可以追加 -CreateLauncherDesktopShortcut:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
-CreateLauncherDesktopShortcut
如果 DSH checkout 不是 sibling directory,需要顯式傳入 DSH 源碼路徑:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
-DshCheckout "E:\projects\deepseek-harness"
複製命令前,先確認自己屬於 sibling-directory install 還是 different-directory install。不同目錄安裝時不要省略 -DshCheckout。
安裝部分功能¶
如果只想要部分能力,先列出當前版本暴露的穩定 feature ID:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 -ListFeatures
然後傳入希望最終保留的功能集合。例如只安裝 desktop alerts、MCP management 和 message editing:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
-Features notification,mcp-server-manager,edit-last-message
這裏需要注意:-Features 不是累加列表。它描述的是目標 Profile 最終應保留的 project feature set。
例如:
-Features none會移除本項目對應 Profile packages,但保留 Launcher;windows-launcher是 required global component,不寫入-Features列表;- 選中某個功能後,安裝流程仍會執行依賴安裝、構建、加載驗證,然後清理聚合包、未選中 sibling features、declared legacy conflicts,並清理 retired file-reference plugin。
常用功能組合¶
下面幾組是材料中給出的常見組合,可以直接替換 -Features 的值。
| 目標 | Feature set |
|---|---|
| Windows 桌面體驗 | windows-launcher,notification |
| Agent 和模型增強 | mcp-server-manager,model-input-types,edit-last-message,sub-agent |
| 插件發現與集成管理 | plugin-market,mcp-server-manager |
以“Windows 桌面體驗”爲例:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
-Features windows-launcher,notification
以“Agent 和模型增強”爲例:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
-Features mcp-server-manager,model-input-types,edit-last-message,sub-agent
以“插件發現與集成管理”爲例:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
-Features plugin-market,mcp-server-manager
Launcher 插件管理¶
Launcher 的 control center 提供 Plugin Management 頁面。已覈實材料說明,它支持:
- 動態功能目錄;
- 按 Profile 維護 desired state;
- 單個安裝或移除;
- 聚合包遷移;
- 安全 Git
fetch/merge,或在 Git 不可用時使用 exact-commit source ZIP fallback。
這意味着安裝完成後,不一定要每次都回到命令行選擇功能。若後續想調整 Profile 保留哪些能力,可以從 Launcher 的管理入口進入,再結合 -Features 的“最終功能集合”語義理解目標狀態。
適用場景與注意¶
dsh-enhanced-plugins 比較適合以下場景:
- 你希望在不修改 DSH 核心的前提下擴展 Web 側能力。
- 你主要在 Windows desktop 使用 DSH,需要 Launcher、聲音提醒和 desktop pet。
- 你需要管理社區插件、MCP server、模型輸入類型、最後消息編輯、子代理開關和 Team 監控。
- 你希望按 feature ID 控制某個 Profile 最終保留哪些功能。
使用前注意以下幾點:
- 該插件以當前
dsh進程權限運行,安裝前應檢查源碼與許可證。 - 已覈實材料未提供許可證文本;安裝前應以倉庫當前實際許可證爲準。
Plugin Community提供的是社區插件搜索、預檢、安裝和卸載能力,不要將其理解成官方應用商店。- DSH 仍爲 developer preview,升級 DSH 後若出現兼容問題,先覈對已驗證版本和 commit。
-Features表達的是最終保留集合,不是單純追加列表。