dsh-enhanced-plugins:爲 DSH 添加可選擴展功能

前言

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 的用戶。

它的價值主要在三方面:

  1. 給 DSH 增加一組可選能力,而不是替換 DSH 本身。
  2. 支持全量安裝,也支持按穩定 feature ID 選擇保留哪些 Profile 功能包。
  3. 對 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 移除。

安裝前檢查

先確認環境和目錄結構,再複製安裝命令。

要求如下:

  1. Node.js 22.19.x,或 Node.js 24 及更高版本。
  2. 一個可以從源碼運行的 recent DSH Web profile。
  3. 已覈實兼容 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 頁面。已覈實材料說明,它支持:

  1. 動態功能目錄;
  2. 按 Profile 維護 desired state;
  3. 單個安裝或移除;
  4. 聚合包遷移;
  5. 安全 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 最終保留哪些功能。

使用前注意以下幾點:

  1. 該插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。
  2. 已覈實材料未提供許可證文本;安裝前應以倉庫當前實際許可證爲準。
  3. Plugin Community 提供的是社區插件搜索、預檢、安裝和卸載能力,不要將其理解成官方應用商店。
  4. DSH 仍爲 developer preview,升級 DSH 後若出現兼容問題,先覈對已驗證版本和 commit。
  5. -Features 表達的是最終保留集合,不是單純追加列表。

參考

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜