前言¶
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表达的是最终保留集合,不是单纯追加列表。