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 15071511 不在该基线内。其余功能可按材料描述作为跨平台功能使用。

DSH 仍是 developer preview。如果 DSH 升级后出现兼容问题,先核对已验证版本和 commit,再判断是否为插件侧问题。

安装全部功能

先检查 DSHdsh-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 表达的是最终保留集合,不是单纯追加列表。

参考

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

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

Xiaoye