增强套件合集 sky-unicorn/dsh-enhanced-plugins

dsh-enhanced-plugins

面向 DeepSeek Harness（DSH） 的增强功能套件：7 个可独立安装的 Cordis bundle + 1 个 Windows Companion。

- 不修改 DSH 核心，只使用公开插件扩展点。
- 可一次安装全部功能，也可只保留选中的独立功能。
- Host、Web Client 与 Windows Companion 各自保持清晰的生命周期和安全边界。

功能一览 · 快速开始 · 功能指南 · 兼容性与迁移 · 配置参考 · 开发与验证

功能一览

安装脚本只需要“安装名称”；每项功能也都有自包含的独立发布包。

| 功能 | 安装名称 | 独立包 | 平台与入口 | 解决什么问题 |
| Windows Launcher | windows-launcher | dsh-enhanced-windows-launcher | Windows 开始菜单 | 用托盘控制 Web、Headless、Profile、源码构建与诊断 |
| 桌面提示与宠物 | notification | dsh-enhanced-notification | Windows；设置 → 桌面宠物 | 任务提示音、自定义 WAV 音效库和原生动态桌宠 |
| 插件社区 | plugin-market | dsh-enhanced-plugin-market | Web；设置 → 插件社区 | 浏览社区插件，通过 DSH 原生管理器安装 |
| MCP 服务器管理 | mcp-server-manager | dsh-enhanced-mcp-server-manager | Web；侧栏插件 → 所属包 → 组件配置 | 管理 stdio / Streamable HTTP MCP 服务器并导入本机配置 |
| 编辑上一条消息 | edit-last-message | dsh-enhanced-edit-last-message | Web；最后一条用户消息 | 修改该轮内容并在当前会话重新生成 |
| 产品子智能体 | sub-agent | dsh-enhanced-sub-agent | Web；设置 → 子智能体 | 实时启用或停用 Claude Code / Codex 工具 |
| 执行过程监控 | agent-team-monitor | dsh-enhanced-agent-team-monitor | Web；当前对话输入框右侧监控图标 | 任务派发、队员进度、结果回调及内部步骤／工具详情 |
| 多模型协作 V3 | model-router | dsh-enhanced-model-router | Web；设置 → 多模型协作；会话输入区 | 已配置模型选择、职责卡片、右侧协作详情、职责路由与证据驱动升级 |

聚合包名为 dsh-enhanced-plugins。省略功能选择时，安装脚本会组合上表全部 8 项；选择功能时只安装对应独立包或 Companion。

快速开始

8.1.0：适配 DSH 0.1.7-rc.1

- 非 Beta 独立功能包适配 DSH 0.1.7-rc.1（验证提交 46a7f68b0922371ce7144b668b90e377d8e799f4）；修复图标和消息编辑接口，迁移 MCP／子智能体旧设置，并改进 Launcher 的安装状态与源码变更检测。
- 聚合包、7 个独立功能包及 Windows Launcher 统一为 8.1.0。agent-team-monitor 和 model-router 仍仅兼容 DSH 0.1.7-alpha.1；因此聚合包也仅声明该版本。使用 rc.1 时请按需选择非 Beta 功能。

7.3.0：适配 DSH 0.1.7-alpha.1

- 设置表单迁移到 DSH 0.1.7 的 volatile 配置 API，Agent Team 改用 session projection，工具结果消息改用顶层字段，并保留 edit-last-message 的插件归属信息。
- 聚合包、全部独立 bundle 和 Windows Launcher 统一为 7.3.0，支持已验证提交 c36a83ff6bb95e3f82cf79f9be7c724270a8aa61 的 DSH 0.1.7-alpha.1；Beta 功能 agent-team-monitor 和 model-router 均以此 DSH 版本为目标。

7.2.5：原生插件安装与系统代理

- 插件社区通过 Host 端点调用 DSH 原生插件管理器安装，不再自行预检、维护安装记录或执行卸载；构建授权和安装结果由 DSH 决定。
- Windows Launcher 只在更新／构建 DSH 源码、安装本项目或安装插件时使用当前系统手动 HTTP/HTTPS 代理；网页插件社区的安装请求也通过同一个仅安装作用域。正常 DSH 会话不会接收这项回退，因此会话运行期间切换 Windows 代理不会使会话失效。
- 聚合包、7 个独立功能包及 Windows Launcher 统一为 7.2.5；兼容 DSH 0.1.6-alpha.2，验证基线仍为 ddefc45fbc7f8e46dd73185e68295696d1297887。agent-team-monitor（执行过程监控）与 model-router（多模型协作）标记为 Beta，且仅兼容此 DSH 版本。

7.2.3：适配 DSH 0.1.6-alpha.2

- 修复 Launcher 启动 DSH 后工具调用出现 Cannot read properties of undefined (reading 'prepare')：绑定源码 checkout 时，Web、Headless 和 Profile 通过构建后的 apps/cli/lib/bin.js 启动，避免 tsx 混用源码与构建模块。更新后需重新安装 Launcher 并重启 Web。

- 插件 7.2.3 验证的 DSH 版本为 0.1.6-alpha.2，源码基线为 ddefc45fbc7f8e46dd73185e68295696d1297887。远端表缺少当前插件或 DSH 版本时，安装器会继续查包内兼容表。当前支持范围统一维护在 dsh-compatibility.json。
- model-input-types 已退役：官方 DSH 在“设置 → 模型 → 自定义设置 → 模型选项”中提供逐模型的“文本／图片”输入类型设置。更新安装会移除旧独立包；已有模型设置由官方设置系统保留。
- MCP 配置位于侧栏“插件”页所属组件的配置入口；离开页面时丢弃未保存草稿。独立安装和聚合安装均提供入口。
- 团队监控通过新版 mainView 会话引用识别主会话，成员跳转使用官方 uiWorkspace.openSession()；侧栏独立保留的子会话不会改变主会话监控。6 个独立功能包和 Windows Launcher 使用同一发布版本与源码基线。
- 类型检查拒绝缺少新版插件配置／会话引用接口的旧 DSH 构建产物。
- Launcher 减少切页、滚动和功能筛选的重复布局，切换启动方式后及时刷新按钮文案；执行日志按功能只保留最新一轮，并限制界面读取量。
- Launcher 概览顶部可选择“浏览器”或“源码桌面”，选择会保存，登录自动启动也遵循此选择。旧配置默认仍为浏览器。
- 源码桌面复用已绑定的 DSH checkout 和 Launcher 工具链：“启动桌面端”运行 pnpm run start:desktop，“构建并启动”运行 pnpm run dev:desktop。缺少构建产物时禁用普通启动并提示构建；源码依赖需先通过 pnpm install --frozen-lockfile 安装。启动过程、失败原因和退出码进入桌面日志；“停止”只结束 Launcher 拥有的命令进程树。构建并启动仍在运行时，禁止同时启动 Web 读取共享产物。旧的 DesktopExecutable 字段不再使用，无需选择 EXE。
- 官方源码命令每次重建 apps/desktop/.desktop-build/development/project，数据默认位于同级 home，或使用继承的 DSH_HOME；默认关闭 DevTools，显式设置 DSH_DESKTOP_OPEN_DEVTOOLS=1 可打开。源码模式禁用官方包管理 UI，目前没有公开参数继承 Web bundles，Launcher 不向生成的 profile 私自复制插件。打包后的 Desktop 应用则独立管理保留的 desktop profile，仍不能通过 dsh plugin --profile desktop 操作。
- 编辑消息在持久化 inbox 恢复后仍按替换处理；目标已离开上下文或身份不匹配时明确失败，不把编辑悄悄改为普通追加。

前置条件

- Node.js 22.19.x，或 Node.js 24 及更高版本。
- 可从源码运行的最新 DSH Web profile；可先阅读 DSH Web UI 入门。
- 非 Beta 功能已验证的 DSH 源码基线为 0.1.7-rc.1；两项 Beta 功能仅兼容 0.1.7-alpha.1。各功能限制及其他版本见 dsh-compatibility.json 与各独立包 manifest。
- 此版本 DSH 的 Session 文件锁已不再依赖 fs-ext。原生构建要求以目标 checkout 为准；Launcher 自身使用系统 .NET Framework 的 csc.exe。不要跳过依赖安装脚本。
- Windows Launcher、原生提示音和桌面宠物需要带 Windows PowerShell 5.1 的完整 Windows 桌面版本，即 Windows 10 1607 或更高版本，或 Windows 11。所需系统能力在 Home、Pro、Education / Pro Education 与 Enterprise 上相同；Windows S 模式、IoT / 精简版本以及 Windows 10 1507、1511 不在这一基线内。已经超出微软生命周期的 Windows 功能更新只能尽力兼容，因为所需 Node.js 工具链不保证支持已停止维护的操作系统。安装器不依赖某一个特定的 tar.exe；其余功能可跨平台使用。

[!IMPORTANT]
DSH 仍处于开发者预览阶段。升级 DSH 后若出现兼容问题，请先核对上面的实测版本和 commit。

[!CAUTION]
先确认 DSH 与插件仓库的目录关系，再复制安装命令：

- 同目录安装： 两个仓库位于同一父目录，直接使用下方命令。
- 非同目录安装： 两个仓库位于不同父目录，命令必须额外传入 -DshCheckout "DSH 源码绝对路径"。

安装全部功能

当两个仓库位于同一父目录时，在本仓库根目录运行：

<工作目录>/ ├── deepseek-harness/ └── dsh-enhanced-plugins/

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1

省略 -Features 或传入 -Features all 会安装 6 个独立 Cordis 功能包和必选的 Windows Launcher，不再用根聚合包表示“全选”。Launcher 位于 %LOCALAPPDATA%\DeepSeekHarness\Launcher，默认只创建开始菜单快捷方式；需要桌面快捷方式时添加 -CreateLauncherDesktopShortcut。直接运行安装脚本只安装或更新程序文件，不会自动启动或打开 Launcher；从 Launcher 内执行自更新时仍会完成必要的版本重启和就绪检查。

如果 DSH checkout 不在同级目录，显式指定它：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1
-DshCheckout "E:\projects\deepseek-harness"

按需安装

先查看当前版本提供的稳定安装名称：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 -ListFeatures

再传入最终希望保留的功能集合。例如，只安装桌面提示、MCP 管理和编辑消息：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1
-Features notification,mcp-server-manager,edit-last-message

常见组合可直接替换命令中的 -Features 值：

| 目标 | 功能集合 |
| Windows 桌面体验 | windows-launcher,notification |
| Agent 增强 | mcp-server-manager,edit-last-message,sub-agent |
| 插件发现与集成管理 | plugin-market,mcp-server-manager |

-Features 不是“额外添加列表”，而是目标 Profile 最终保留的本项目功能集合。Windows Launcher 是全局必选组件，不需要写入列表，也不能通过功能选择卸载；-Features none 只清空当前 Profile 中本项目的功能包并保留 Launcher。脚本会：

1. 安装依赖并构建全部所选功能。
2. 安装并验证所选 bundle / Companion 能否加载。
3. 成功后再移除聚合包、未选择的同仓库功能和已声明冲突的旧包。
4. 检测并清理已经退役的文件引用插件。

安装器会先将所选 bundle 打包，再安装到 Profile 内，避免源码目录链接使 DSH 构建入口无法解析插件依赖。按内容哈希命名的 tarball 保存在该 Profile 的 .dsh-enhanced-bundles 目录，供 pnpm 后续重装使用；请勿在仍被 Profile 引用时删除。如果所选归档与已安装包均未变化，安装器会跳过 pnpm add。重新安装会替换旧的源码链接。

Launcher 插件管理

安装脚本会把 DSH checkout、本项目源码路径、Git remote/ref、源码 revision 和每个已管理 Profile 的目标集合写入 %LOCALAPPDATA%\DeepSeekHarness\Launcher\install-state.json。控制中心的“插件管理”页据此提供：

- 从各 packages//package.json 动态生成的功能列表，新增普通功能无需修改 Launcher；
- 首次默认全选、按 Profile 选择、单项安装/卸载、历史聚合包迁移；
- 应用更新源码时，两个 Beta 功能会在每个已管理 Profile 中自动关闭；更新完成后仍可手动重新开启；
- Git 工作区先按插件远端 URL 解析 Windows 系统代理；系统选择代理时，仅通过 Git 单次命令配置应用于带退避重试的安全 fetch，操作结束后自动失效且不修改既有 Git 配置。连接重置时自动改用 HTTP/1.1 重试，成功后仅在本地执行 merge --ff-only，避免 pull 再次访问网络；或没有 Git 时下载准确 commit 的源码 ZIP；无网络时也可手动绑定源码目录或导入源码 ZIP；
- 只有源码 revision 或目标功能发生变化时，才在 sources/runtime- 持久化隔离快照中执行 npm ci、正式 npm run build 和 runtime entry 校验；将构建后的包打成 tarball 安装到 Profile 内，未被任何 Profile 引用的旧源码快照会安全清理；开发期的全仓类型检查仍在源码目录运行，不会因 sibling DSH 类型路径阻止安装；npm 的 stderr 警告保留在日志中，是否失败只看真实退出码；全部完成后才停止 Launcher-owned DSH 并提交更改；
- 外部协调器实时写入安装日志；源码 revision 变化且 Launcher 可执行文件变化时切换版本、等待新版就绪、失败回滚，并恢复此前运行的 DSH；DSH 连续保持 Launcher-owned 状态 15 秒后才报告恢复成功；
- Launcher 重启后继续跟踪仍在运行的协调器；异常中断或状态文件损坏时保留日志/备份并从实际 Profile inventory 重新读取状态。

第一版只支持本地 DSH 源码 checkout 和本项目源码安装，不支持 npx、全局 dsh、npm 发布包或 GitHub Releases。Git 工作区有修改、本地领先或发生分叉时不会 reset、rebase 或覆盖用户改动。

任何前置步骤失败时，脚本都不会提前破坏原有可用组合。安装成功后如果 DSH 正在运行，重启当前 Web profile 一次。

功能指南

1. Windows Launcher

windows-launcher · 开始菜单 → DeepSeek Harness Launcher · Windows 10+

DeepSeek Harness Windows Launcher 概览

独立于 Cordis 插件树的 Windows 控制中心，适合不想长期守着终端的本地 DSH 用户。

- Web 控制： 查看状态，启动、打开、重启或停止 Web；识别外部端口服务并拒绝越权接管。即使关闭了启动时自动打开浏览器，“打开页面”也会使用当前 Launcher-owned DSH 进程的认证入口，启动 token 不会写入 Launcher 日志。
- 任务与 Profile： 运行 Headless 单次任务和后台 Profile，统一保存 UTF-8 结果与日志。
- CLI 启动入口： 绑定源码 checkout 时使用已构建的 apps/cli/lib/bin.js。NVM 运行参数和系统模式的托管启动脚本均使用此入口；构建产物缺失时提示先构建 DSH。更新或修改 DSH 源码后，需要完成构建再启动。源码构建与官方桌面启动仍使用各自的流程。
- Web 运行环境： 概览在标题旁提供紧凑的“浏览器／源码桌面”分段切换，将服务状态与主要操作合并在同一张浅色卡片内，下方依次展示运行环境和启动选项。切换支持左右方向键，窄窗口中的操作按钮会缩排为一行或均衡的两行。运行环境展示 NVM 沙盒/系统模式、Node 与 npm/pnpm/Yarn 的需求及实际版本、检测来源和准备/失败状态。“Node 版本选择”提供“自动选择（最高兼容版本）”和已安装的 NVM 版本；选择后自动保存，供后续 Web／源码桌面启动、DSH 构建和插件源码操作使用，旧设置默认自动选择。“重新检测”可刷新已安装版本列表。手动版本仍须满足项目要求，未安装或不兼容时直接报错，不自动换版本；已保存但被卸载的版本会标注“未安装”，可重新选择或切回自动。运行中显示本次启动记录，切换选择不会重启已有进程，外部服务版本不会被猜测。

每次启动 Web（含托盘、重启、登录自动启动）都会检测 nvm-windows。已安装时，从绑定的 DSH checkout 或可识别的 npm DSH shim 读取元数据：Node 按 .nvmrc、.node-version、volta.node、engines.node 选择，并始终满足 engines.node，自动模式使用 NVM 已安装的最高匹配版本，手动模式只使用已保存的版本。包管理器优先读取 packageManager/devEngines.packageManager，再参考 Volta、engines 和锁文件；锁文件只标识工具种类或 Yarn 主版本系列，不被当作精确版本。缺少的包管理器在首次启动时下载到 Launcher 的 sandbox 目录，后续复用；声明冲突会明确报错。

沙盒直接用所选 Node 调用同一个 DSH CLI，仅隔离该服务的 PATH、npm/Yarn 全局安装目录及 npm/Yarn/Corepack 缓存，不执行 nvm use，不修改系统 Node、NVM 链接或 DSH 源码。pnpm 保留用户／项目配置及原有 store 位置，以复用源码和 Profile 已安装的依赖。Launcher 和候选安装器只清理由旧版本传入、且位于 Launcher 沙盒内的存储覆盖；安装器退出时恢复调用方环境。这是工具链的进程级隔离，不是文件或网络权限沙箱。未检测到 NVM 时保留原启动方式；NVM 中缺少匹配 Node、项目声明无效或下载失败时停止启动并显示原因，Node 需先用 nvm install 安装。无法识别的自定义启动器需重新绑定 DSH 源码。DSH 源码构建和插件源码操作复用概览的 Node 选择与沙盒，包括 DSH 声明的 pnpm 和该 Node 内置的 npm。DSH 拉取后会在清理前重新检测，构建检测不要求依赖或 CLI 产物已存在。插件操作在 npm ci、构建、停止 DSH 或安装 Profile 前校验候选源码的 Node/npm 要求；不兼容时直接报错，不另选 Node。构建／更新日志记录所选运行环境。未检测到 NVM 时，自动模式仍使用系统工具链；已保存的手动选择会报错，直到恢复 NVM 或切回自动。Headless、其他 Profile 沿用原有流程。
- 网络代理： 正常启动 Web、Profile、Headless 或 Desktop 时，Launcher 不再加入 Windows 系统代理。执行 DSH 源码构建、本项目安装、插件安装或网页插件社区安装时，只在对应操作期间读取当前启用的 Windows 手动 HTTP/HTTPS 代理，结束后恢复环境。已有的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 显式配置和 DSH home .env 配置仍按 DSH 原有规则生效。日志只记录操作和来源，不记录地址或凭据；不会修改系统环境、注册表或 .env。操作期间仍遵循 NO_PROXY 与 DSH 的 loopback 直连规则。PAC/WPAD、仅 SOCKS 或只配置单个协议的系统设置仍需在环境或 DSH home .env 中显式配置 HTTP/HTTPS 代理。
- 源码维护： “更新源码并构建”对绑定的 DSH checkout 执行 git pull --ff-only，成功后依次运行 pnpm run clean、pnpm install --frozen-lockfile、pnpm run build。拉取 HTTP(S) 远端前，Launcher 会按远端 URL 解析当前 Windows 系统代理；若系统为该地址选择了代理，则仅通过 Git 的单次命令配置应用到本次拉取，命令结束（包括失败）后自动失效，不会写入或覆盖仓库、用户或系统级 Git 代理设置。SSH 远端不使用这项 HTTP(S) 代理发现。“仅构建”直接使用当前本地源码，跳过 Git 更新，仍执行这三个 pnpm 步骤；无 Git 时，“更新源码并构建”也可经确认跳过拉取。操作期间两个构建按钮均禁用，避免重复启动。清理前会检查 checkout 是否具备 clean/build 脚本和锁文件，以及 pnpm 是否可用。任一步失败即停止后续步骤，锁文件错误不会降级为非冻结安装。Git 进度和 pnpm 警告不会被误判为失败，操作以真实退出码为准。页面会区分拉取、清理、依赖安装、构建与环境错误，放大的日志文字和“打开日志目录”入口便于排查；完整 UTF-8 输出、命令引擎错误及最终结果保存在 logs/dsh-build.log，刷新或重新进入页面不会丢失。运行前请先停止使用此 checkout 的 DSH：清理会删除现有构建产物，后续步骤失败时旧产物不会恢复。本操作不会自动停止或重启 DSH，请在构建成功后手动启动服务。

源码操作进程会临时设置 pnpm_config_verify_deps_before_run=false，防止 pnpm 的脚本前自动安装在明确的冻结安装步骤前改写锁文件；不会修改仓库或全局 pnpm 配置。

- 诊断： 汇总命令、端口、工作目录、运行状态和日志，并提供独立的 DSH 源码页。
- 桌面体验： 系统托盘、可选登录启动、各尺寸统一的居中纵向布局、逐显示器 DPI 缩放，以及不受 Windows 主题影响的统一圆角页面与文本区域滚动条；日志与诊断、任务输入/输出、源码构建日志和插件运行日志均使用相同样式，并支持滚轮、触控板、拖动、轨道翻页与键盘滚动。所有日志视图会过滤文本框无法解释的 ANSI／ECMA-48 终端控制序列，保留可读内容且不改写原始 UTF-8 日志文件。Launcher 会记住最后使用的显示器和正常窗口位置，显示器拓扑或工作区变化后会自动收回可见区域。

进程所有权、退出与后台行为

Launcher 只停止自己启动的 DSH 进程树。端口上出现外部 Web 服务时会显示“外部 Web 服务”，允许打开页面，但不会接管、重启或终止它。

系统托盘提供两个退出动作：“仅退出 Launcher”会保留 DSH 服务；“退出 Launcher”会先请求安全停止 Launcher 自己管理的服务。若检测到外部服务或停止超时，退出会被取消并说明原因。

任务与 Profile 均通过无控制台窗口的子进程运行。用户任务经 UTF-8 请求文件传给 PowerShell 命令引擎，不会拼接进 cmd.exe；隐藏主窗口后会停止前台轮询，但托盘和后台服务仍继续工作。

Web、源码桌面、源码构建和每个 Profile 各自只保留最新一次执行日志；新一轮开始时覆盖上一轮，同一次执行中的各阶段输出、错误和退出码仍写在一起。Launcher 自身日志在新实例取得单实例锁后覆盖，唤起已有窗口不会清空；更新清理日志也只保留最近一轮，插件更新继续复用 updates/current。正在执行的日志不会被另一轮覆盖。Headless 输出在任务结束后显示，下一次任务会替换它。

日志页和构建日志的每次读取最多访问文件末尾 256 KiB，再提取所需行数，避免当前运行产生的大日志在切页或刷新时阻塞界面；读取不改写本轮日志。页面滚动不触发布局，功能筛选复用现有行并保留选择，全选与清空只更新一次变更摘要。切换启动方式会刷新按钮文案，无需滚动页面。

登录启动、部署与源码绑定

登录启动默认关闭。可选择“只启动 Launcher 到托盘”或“先启动 Launcher，等待 30 秒后再在后台启动 DSH Web”，两种模式互斥，也可以全部关闭。

程序使用版本化目录部署，开始菜单和登录启动项在升级后都会指向新版本，不依赖 profile 内的 node_modules。安装器保留用户显式配置的 DSH 命令；使用本地 DSH checkout 安装时，则生成并验证直接调用该 checkout CLI 的安全入口，并将它记录为唯一允许执行源码构建的根目录。

设置、运行状态、安装状态、更新请求与日志统一位于 %LOCALAPPDATA%\DeepSeekHarness\Launcher。托盘更新和应用插件变更复用固定的 updates\current 工作目录；下一次操作开始前会清理其中的旧请求、结果、日志和源码 ZIP，只保留最近一次操作记录。更新协调器仍在运行时不能覆盖该目录，Launcher 重启后仍会继续跟踪操作。打开控制中心读取安装状态后，以及更新操作结束后，会在后台自动删除旧版本不再使用的 GUID 更新目录，包括其中的构建文件、node_modules 和日志；仍有协调器运行、被源码绑定或任意 Profile 引用的目录会保留，稍后打开控制中心或更新结束时再次检查。旧更新目录中的源码绑定会在成功安装时迁移到 sources 快照；活动插件快照仍由 sources 管理。清理支持长路径，不跟随目录链接；无法确认安全或删除失败时保留目录并记录日志，不影响已成功的安装。Launcher 在管理页中始终必选；控制中心不提供自卸载按钮，需要移除程序文件、快捷方式和登录启动项时，在项目源码中运行 migrate-to-enhanced-plugin.ps1 -UninstallLauncher。日志与用户设置默认保留。

2. 桌面提示与宠物

notification · 设置 → 桌面宠物 · 提示音与宠物仅支持 Windows 10+

桌面提示、自定义音效库与宠物设置

- “需要确认”“任务完成”“任务受阻”三类事件可分别关闭，或选择两档默认音 / 自定义 WAV。
- 切换音效会自动试听，也可手动试听；共享增益为 0–100%，100% 约为 +6 dB，并对接近峰值的 PCM / IEEE Float WAV 软限幅。
- 单文件最多 2 MiB，公共音效库最多 64 个文件，全部保存在当前 DSH profile 中。
- 桌宠可选“平面小鲸”“立体小鲸”或“鲸鱼娘”，设置实时生效。

| 汇总状态 | 桌宠表现 |
| 空闲 | 睡眠循环；鼠标接触或拖动时切换为互动动作，可选择空闲时不置顶 |
| 任务中 | 专注游动或操作任务面板 |
| 需要确认 | 惊讶、转头或问号提醒，优先级最高 |
| 已完成 | 仅为顶层任务短暂播放庆祝动作 |
| 任务受阻 | 仅为顶层任务短暂播放疲惫或担心动作 |

桌宠可跨显示器拖动，并按显示器保存归一化位置；分辨率、缩放、工作区或显示器连接变化后会重新换算到可见区域。修改启动角落会清除拖动记录。桌宠不会出现在任务栏或 Alt+Tab 任务切换器中；需要隐藏时请在设置中关闭桌宠。Windows 开启“减弱动画”后，每种状态会使用代表静态帧。

常驻宠物和短生命周期提示音进程都由 DSH subprocess service 管理，关闭功能时会协作式退出；Ctrl+C、插件重载或正常关闭期间的 companion 管道断开会按正常清理处理。若旧配置保存了已经退役的已知桌宠 ID，下次启动会迁移为“平面小鲸”；其他未知值仍会校验失败。

3. 插件社区

plugin-market · 设置 → 插件社区

插件社区页面

1. 浏览、搜索社区插件；目录使用内置快照，可同步 GitHub Actions 发布的最新索引。
2. 点击“通过 DSH 安装”将卡片显示的 GitHub 仓库来源交给市场 Host，再由当前 profile 的 DSH pluginManager.installBundle() 执行。Host 只在这次安装期间使用 Windows 系统手动代理，不再实时预检 GitHub/npm，也不自行判断是否可安装。
3. DSH 负责包安装、bundle 校验、构建脚本授权、失败恢复和启用。市场展示其返回的结果；只有 DSH 返回待授权脚本时，才提供“允许这些脚本并重试”。
4. “管理已安装插件”打开 DSH 原生插件页，由该页面负责查看安装状态、启停和卸载。市场不再维护独立安装记录或“已安装”筛选。
5. 安装目标跟随当前运行的 profile。旧版 profile、cliPath、operationTimeoutMs 和 githubTokenEnv 配置不再参与市场操作；已有插件和凭据不会被删除。

索引发布、网络代理与凭据

索引由 .github/workflows/update-plugin-index.yml 生成到 market-index 分支：完整枚举 topic，只重新验证新增或变化的仓库；异常缩水或生成失败不会覆盖上次结果。插件市场自身是内置的已验证渠道贡献，即使远程镜像尚未收录也会出现，后续不会重复。

内置快照和自动索引同步不需要 GitHub Token，因此已移除市场的 Token 配置入口。索引下载沿用 DSH 已显式配置的全局传输及代理规则。Launcher 管理的源码和插件安装，以及网页插件社区的 Host 安装端点，只在对应操作期间使用当前 Windows 手动 HTTP/HTTPS 代理；正常 DSH 流量保持直连，除非用户显式配置代理。市场提供索引仓库的 github:owner/repo 来源，不猜测同名 npm 包是否已发布。目录收录校验用于索引质量，不能保证插件在当前环境安装成功。

本实现按本地 DSH c36a83ff 的公开 Remote 接口验证。在线发布教程主要描述 CLI 路径；浏览器安装请求由市场 Host 代理到当前版本的 pluginManager，不复制原生 UI 的私有组件或状态。

页面会显示索引生成时间；超过 24 小时未更新时明确提示，同时继续保留上次可用快照。

4. MCP 服务器管理

mcp-server-manager · 侧栏插件 → dsh-enhanced-mcp-server-manager → 配置 mcp-manager

MCP 服务器管理

1. 点击“添加服务器”或已有服务器的“编辑”，在弹窗中设置名称、连接方式和配置；取消或按 Esc 可关闭弹窗并放弃其中的修改。
2. stdio 配置命令、参数、工作目录和环境变量；HTTP 配置 HTTP(S) URL 与请求头。两种连接方式均可设置工具调用超时。
3. 也可由 Host 一键导入本机 Claude Code 与 Codex 配置；重复项会跳过，无法安全转换的项目会说明原因。
4. 在弹窗中点击“添加”或“应用修改”将该服务器放入页面草稿；检查卡片顶部的格式审计后，再点击页面的“保存”。Host 按服务器分别启动、更新或卸载连接。

浏览器读取已有服务器时会掩码环境变量与请求头；编辑时保留掩码即可沿用原值，输入新值可替换，移除对应行可删除。修改变量或请求头名称时需要同时输入新值。Host 在未脱敏的原配置上应用修改，未修改的机密不会从脱敏快照重建或覆盖。切换连接方式会舍弃旧方式的环境变量或请求头。

直接写在 cordis.yml 组合层的服务器可以编辑同名字段；由于 DSH 设置的继承规则，不能从本页面改名或移除，Host 会在写入前拒绝这些操作。

草稿绑定开始编辑时的配置版本。其他页面或外部编辑更新配置后，旧草稿保存会被拒绝，不会删除对方新增的服务器；请离开页面丢弃草稿，再重新打开、查看最新配置后编辑。只有点击保存才提交 MCP 草稿。连接中断时会退出保存状态并保留草稿，写入失败后重新读取 Host 配置；较早的读取响应不会覆盖较新的刷新结果。

在 DSH 0.1.7-rc.1 中，MCP 设置保存在当前 Profile 的 mcp-manager Loader 条目中。首次升级时，插件会把旧 settings.yaml.imported 中的 MCP 服务器合并一次；已有同名服务器保持现状，原文件继续作为备份。之后删除服务器不会在重启时重新导入。

5. 编辑上一条消息

edit-last-message · 当前会话最后一条可编辑的用户消息气泡

编辑上一条消息并重新发送

1. 等待当前会话结束，或先停止正在运行的会话。
2. 点击“编辑上一条消息”，在气泡内修改文本。
3. 点击“重新发送”或按 Ctrl/⌘ + Enter；按 Esc 或“取消”退出编辑。

重新发送仍在当前会话内完成：插件从被编辑的用户消息开始替换当前模型上下文，再通过同一个 AgentLoop 生成后续内容。DSH Session 日志保持追加式审计记录，已经执行的工具副作用不会回滚。上传的通用文件继续使用 DSH 文件卡呈现；包含任意附件或其他非文本块的消息不会提供编辑入口，以免静默丢失内容。

保留已发送引用预览：点击文件标签或该步骤实际加载的 Skill 标签，会在当前会话右侧栏打开预览，不修改文本或重新发送。编辑后的气泡也提供文件预览；Skill 标签只使用编辑所属步骤的调用记录，不沿用被替换轮次的记录。重新发送继续使用插件来源，斜杠文本本身不会被当作新的用户 Skill 调用。

当前 V4 消息使用插件自有的 edit-last-message 来源类型，只保存原始消息 ID，不嵌入事件序号；插件也能识别 DSH 将早期 V3 插件来源迁移到 V4 后的记录。早期嵌套标记及 5.x 的独立 edit-last-message 来源均不被 V2→V3 迁移接受。升级后打开这类旧会话前，请先停止所有 DSH Host，对受影响的日志执行离线修复：

node .\scripts\repair-edit-last-message-session.mjs "C:\path\to\session.jsonl.zstd"
node .\scripts\repair-edit-last-message-session.mjs --write "C:\path\to\session.jsonl.zstd"

第一条命令只检查，不写文件；第二条命令按日志版本写入可迁移的旧插件来源或 V4 自有来源，也能修复 V4 中残留的旧 plugin 包装，并在同目录创建带时间戳的原始文件备份。截断、损坏、格式不符或检查期间发生变化的日志都会被拒绝，不会静默重写。

6. 产品子智能体

sub-agent · 设置 → 子智能体

Claude Code 与 Codex 子智能体开关

打开 Claude Code 或 Codex 后，变更会立即应用到加载了本控制插件的 Agent preset，包括正在运行的会话；关闭开关会实时移除对应工具。本机仍需安装对应产品，并在当前 Profile 中分别安装与 DSH 同版本的官方 @deepseek-ai/dsh-subagent-claude-code 或 @deepseek-ai/dsh-subagent-codex bundle。

升级到 DSH 0.1.7-rc.1 时，旧 settings.yaml.imported 中的产品开关会合并一次到当前 Profile；Profile 中已有的开关值优先。

两个开关默认关闭。写入使用 path-addressed 操作和设置修订号，不会用脱敏或过期快照覆盖其他页面及外部编辑产生的新值。

DSH 0.1.7 的设置按 Loader ID subagent-product-toggles 读写并保存在当前 profile 的配置补丁中；设置页面、实时工具开关和外部编辑刷新使用同一标识。侧栏图标使用当前公开的分支图标，随浅色／深色主题显示。

7. 执行过程监控

agent-team-monitor · 当前对话输入框右侧 → 团队图标

执行流程与节点详情

- 主视图是协作总览：主智能体派发任务，各队员展示“派发 → 执行 → 回传 → 接收”阶段、当前操作、步骤／工具完成数及耗时，返回连线汇合到实际父会话；嵌套派发独立分组。点击队员进入内部执行泳道，点击派发、进度消息或回调查看对应记录。内部流程默认展示步骤，开启“显示工具与轮次”可展开调用记录；可继续打开原生会话。
- 步骤／工具数量是最新轮次已记录的进度，不是预估任务总量。回调只认实际工作流结束事件或父会话收到的完成通知；普通进度消息不算完成，父会话收到也不代表验收通过。原生一次性队员可能只有执行结束记录、没有持久化回调，此时明确显示“无回传记录”，不会补造成功连线。协作事件最多保留最近 1,000 条并提示截断。
- 箭头表示记录的开始顺序，不推测因果或依赖，也不是按时间比例排列的甘特图。父子入口来自原生目录；工作流中实际记录的派发节点可进入对应队员。并行调用分别保留，可对照开始／结束时间查看重叠。暂不生成尚未执行的计划节点或自动归纳业务阶段。
- 每条泳道最多展示 120 个节点，优先保留执行中节点和最近记录，并明确提示截断；更早记录可进入原生会话查看。详情按需读取，每个输入／输出字段最多 6,000 字符，常见凭据字段做展示脱敏。只展示公开文本与工具参数／结果，不额外读取 reasoning、系统提示、私有工具 meta 或 provider 异常原文。没有文本的节点显示空记录提示。
- 入口属于当前会话，在输入框右侧的模型／上下文控件同组显示。检测到执行记录、工作流、Agent Teams 或原生子代理会话后出现图标；点击才展开，切换会话立即关闭并清除旧数据。普通单智能体会话也支持；无需启用官方团队插件。原成员分组、任务板和工作流汇总作为辅助信息保留。
- “角色与子代理会话”按已记录的成员名／创建标签分组，同名角色的多次创建保留为不同会话；没有标签时单列“未标注角色”，不从提示词或会话标题猜测身份。可筛选“全部／正在执行／历史会话”，查看会话标题、ID、模式、创建时间和状态。目录包含当前会话下的子代理及更深层子会话，不跨到其他会话树。
- 点击可用会话行，会按真实父子 ID 和原生目录模式调用 DSH 的 uiWorkspace.openSession()，进入原生会话详情。历史、正在执行、嵌套会话均可跳转；点击前重新核对目录，切换会话或插件卸载后不执行迟到跳转。损坏／缺失的记录显示不可用，不伪造空会话。
- 标准 workflow 与实验性 Agent Teams 是两套机制，分别展示，不再把“Agent Teams 未启用”误当成没有工作流成员。工作流从当前会话自己的 tool-workflow/ 持久事件读取运行名称、实际启动的成员、阶段及完成／失败／取消状态；不会推测脚本未来的角色、任务依赖或邮箱。成员按 runId + seq 配对，fork 继承的父会话工作流不会串入新会话。
- Agent Teams 面板跟随当前队长或 roster 成员会话，显示成员状态、任务依赖/负责人/可领取状态、写入范围重叠提示和待投递消息数量。点击任务查看详情，点击成员打开官方子代理会话。
- Host 读取官方 ctx.agentTeams；冷历史由官方 Agent Teams 运行时注册的 agentTeam 投影和公开 ctx.sessionProjections.restore() 回放。日志通过不提交恢复的 sessionQuery.observeSession() 读取，不激活 Agent，也不创建第二份团队状态。
- 只轮询当前会话（展开时 1.5 秒、收起时 5 秒）；隐藏页面或断线后暂停。后续启动的成员和状态变化会自动刷新，但不会自动打开面板。点击图标、外部区域或 Escape 可收起。切换会话、重连和请求失败不会把旧数据显示为实时状态。
- 监控插件不会启用 Agent Teams 或 workflow，不注册模型工具，不创建/唤醒/中断成员，不编辑任务或调度工作。查看标准工作流无需实验性 Team 包；要查看 Agent Teams 的实时或历史状态，请按官方 Team 文档单独启用实验性运行时，使其拥有并注册投影。
- 使用兼容表中已验证的 DSH 源码 ABI。实验包不由本插件打包或从 npm 获取；Agent Teams 历史回放依赖运行 profile 中已挂载的官方运行时及其投影。成员运行状态不等于任务完成状态：“未驻留”不是“已完成”，任务板状态仍依赖模型更新；流程状态来自实际执行日志。团队汇总不传输邮箱正文。最多显示 256 个成员 / 1,000 个任务，超限时明确提示，汇总仍包含全部记录。
- 工作流最多显示 100 次运行、合计 256 条成员记录，汇总保持完整。未记录结束的冷历史不会冒充实时运行；原步骤或轮次已关闭时标记中断。监控只读取公开记录，不读取／执行工作流脚本，普通子代理不会被伪装成实验性 Team。
- 原生子会话目录来自公开的 subagents.listDescendants，通过只读的 sessionQuery.observeSession() 获取自身标题与轮次结果。实际 Agent 的运行／空闲状态优先，不能用“仍驻留”冒充“正在执行”。历史筛选包含当前未运行的会话，不表示全部成功。目录最多展示 256 条、优先运行中的 Agent；超限时显示已展示／总数，筛选计数只针对已展示条目。目录不可用不会影响主智能体流程和已有 Team／工作流记录的查看。

npm run verify:execution-web 使用临时 profile 和无密钥测试模型，在本地 DSH 页面验证泳道、嵌套队员、工具详情、失败状态、实时完成、会话跳转、窄屏及 light/dark/system 切换。设置 DSH_VERIFY_AGGREGATE=1 可验证聚合包；默认验证独立安装及多功能组合后清理未选功能。

仅安装该 Profile 功能可使用 -Features agent-team-monitor，-ListFeatures 可列出所有选择；Windows Launcher 必选规则不变。浅色、深色、跟随系统和中英文均随 DSH 设置变化。

兼容性与迁移

- 版本对应： dsh-compatibility.json 统一维护各插件版本支持的 DSH 版本及验证提交。聚合包、7 个独立功能包和 Windows Launcher 均使用 8.1.0。
- DSH 0.1.7-rc.1： 已验证的非 Beta 独立功能包可按需安装。agent-team-monitor 和 model-router 仍仅支持 0.1.7-alpha.1；包含它们的聚合包也仅声明该版本。Launcher 和安装脚本会按最终选择的功能检查兼容性，选中不支持的功能时在构建及修改 Profile 前拒绝。
- V3 消息编辑： 替换操作改用 startSeq/endSeq；新来源格式通过原始消息 ID 保持重编号后的关联。旧编辑日志迁移前应执行上文离线修复。附件气泡使用当前公开的 FileTypeIcon，不再引用已移除的 DocumentFileIcon。
- 历史监控： 监控冷读取使用共有的公开 sessionQuery.observeSession()，指定 projectionMode: 'none'，读取后释放 observation，不激活 Agent、不提交崩溃修复。自定义 profile 的历史监控需要 sessionQuery 提供方，标准 Web profile 已包含。Agent Teams v1/v2 历史兼容由当前官方 Team 投影负责；拒绝的历史显示为不兼容，本插件不改写日志。
- 安装前检查： 安装脚本和 Launcher 更新流程在构建、停止服务或修改 profile 之前，优先获取本仓库 GitHub master 分支上的对应关系文件。请求失败、下载超过 8 秒、内容格式错误或过大时，显示警告并回退包内文件；远端有效但没有匹配当前插件及 DSH 版本的记录时也会检查包内文件。只有两处都不支持当前 DSH 版本才拒绝安装。每次检查重新获取，不覆盖本地回退文件。插件包版本混杂也会停止。每个 DSH 版本独立关联提交；commit 未列入该版本记录、源码有本地已跟踪修改或 ZIP 无 Git 信息时显示“未经验证”警告。
- 新版接口： Client 使用 client-store、ui-session、ui-chat 和公开 Remote；不再依赖已删除的 dsh-client-runtime、connection.api 或 hostDescription。Host 设置 owner 使用经校验的 namespace 字面量和 SettingsProvider.installSection()。Session consumer 使用 eventAt() / snapshotEvents()，并把 SessionLogOffset 继承边界与 SessionHeader 分开传递；Team Monitor 从 query observation 到 projection 回放都保留这条精确边界。本项目以上述源码 commit 的公开接口为准。
- 提供方来源： sub-agent 只安装产品开关及工具 Consumer。Codex 与 Claude Code 官方 DSH Provider 是独立可选 bundle，按需安装后由各自的 patch 注册 subagent-codex、subagent-claude-code；本包保留原有的转出入口供旧组合引用，但不再默认加载缺失的 Provider。
- 独立构建： 各功能发布物携带自身源码和构建脚本，可在没有 sibling DSH checkout 的目录执行 npm install --legacy-peer-deps、npm run prepare 和 npm pack；运行时仍由匹配版本的 DSH 提供公开 peer 服务。Windows Launcher 原生重建需要 Windows 与 .NET Framework 4.x 编译器。
- 架构边界： Web 功能通过公开 Service、event、slot 和 settings 扩展；Windows Launcher 是独立 Companion，不进入 Cordis 插件树。
- 文件引用已退役： 最新官方 DSH 已原生支持 @ 文件引用。在输入框键入 @，含空格路径可键入 @"。旧 referenced-file 安装名称和 # 快照语法不再提供。
- 模型输入类型已退役： 官方“设置 → 模型”页面的“模型选项”支持逐模型勾选“文本”和“图片”。-Features model-input-types 会被拒绝；正常运行安装脚本会清理历史独立包或替换旧聚合包，不删除用户已有模型能力设置。
- 从 7.2.1 Launcher 迁移： 若旧 Launcher 的目标集合仍包含 model-input-types，其旧版更新协调器无法识别新版功能目录。先获取新版源码，直接运行新版 migrate-to-enhanced-plugin.ps1 并传入当前希望保留的功能集合（例如 -Features all）；这一步会移除旧包并更新 Launcher，之后可恢复在 Launcher 中更新。
- 自动清理： -Features referenced-file 也会被明确拒绝；正常运行安装脚本会清理历史独立包或旧版聚合包中携带的该功能。

只检查版本对应关系、不构建或安装（非同目录时追加 -DshCheckout）：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 -Features edit-last-message,mcp-server-manager,notification,plugin-market,sub-agent -CheckCompatibility

需要旧版 DSH 时应选择其对应的插件版本，不要仅删除 peer dependency 检查或强行安装新版插件。

验证新版 DSH 仍兼容后，只需编辑根目录 dsh-compatibility.json：保持 schemaVersion: 1，在 releases 中找到精确的 pluginVersion，向其 dsh 数组追加 { "version": "<精确 DSH 版本>", "commits": ["<完整的小写 40 位 Git 哈希>"] }。若只有提交改变，在该 DSH 版本的 commits 中追加即可。保留旧插件版本记录，以服务已有安装器。将此文件推送到 GitHub master 后，使用新安装器的用户无需更新插件代码即可获取新对应关系；旧安装器需要先升级到这套机制。GitHub 缓存可能造成短暂延迟。

peerDependencies 仍是精确的包管理器声明，由兼容表与各功能自身的版本限制共同生成。npm run build（或 npm run sync:compatibility）按包内表同步各源码 manifest 及根锁文件元数据；安装器在构建后按本次选中的远程／本地表再次同步，-SkipBuild 同样适用。非 Beta 独立包可声明 rc.1，两项 Beta 及包含它们的聚合包仍只声明 alpha.1。直接使用 dsh plugin add 或 Desktop 导入会绕过本安装器，采用发布物里的 peer 快照，需按更新后的表重新构建／打包后再走该路径。

默认端点为 GitHub 原始对应关系文件。可用 DSH_COMPATIBILITY_URL 指向 HTTPS 镜像，仅本机回环测试服务器允许 HTTP。文件只能提供数据，不能改变代码、包下载地址或构建命令。-CheckCompatibility 保持只读。

配置参考

默认组合位于 cordis.patch.yml。后应用的 profile patch 会整体替换目标 Loader 行的 config，因此覆盖时必须重述该行需要保留的全部字段。

桌面提示默认配置

| 字段 | 默认值 | 用途 |
| completionSound | subtle | 任务完成提示音：off、subtle、prominent 或上传的 custom |
| confirmationSound | prominent | 需要关注提示音：off、subtle、prominent 或上传的 custom |
| blockedSound | prominent | 任务受阻提示音：off、subtle、prominent 或上传的 custom |
| soundGain | 0 | 默认音和自定义音共用的 0–100% 正向增益；100 约为 +6 dB |
| petEnabled | false | 是否显示原生全局桌面宠物 |
| petCharacter | classic | classic（平面小鲸）、multiview（立体小鲸）或 whale-girl（鲸鱼娘） |
| petIdleTopmost | true | 空闲状态是否仍保持置顶 |
| petSize | 112 | 80、112、144 或 176 设备无关像素 |
| petPosition | bottom-right | top-left、top-right、bottom-left 或 bottom-right |

六个 CustomSoundFile / CustomSoundName 字段由 Host 管理三类提示音的选择引用。共享目录保存在 profile 内的 desktop-notifications/sound-library.json；请通过设置页面上传和选择自定义音，不要手工编辑这些字段。

插件社区 Host 配置

| 字段 | 默认值 | 作用 |
| topic | dsh-plugin | 已校验渠道文档必须匹配的 topic |
| channelUrl | market-index 分支 HTTPS 快照 | “同步最新索引”使用的发布地址 |
| pageSize | 12 | 每页插件数 |

内置 assets/plugins-cache.json 是只读引导快照，也是自动索引首次运行的增量校验种子。市场 Host 管理目录缓存、ETag、索引同步任务和仅安装作用域的安装端点，缓存文件保存在 DSH home；安装状态由 DSH 插件管理器负责。插件社区不会解析 README 中的 shell 命令，也不会启用 dangerouslyAllowAllBuilds。

若只想让部分 Agent preset 获得产品子智能体工具，请禁用或移除根层 subagent-product-toggle-tools 行，再只在目标 preset 中挂载对应入口：

- 聚合包：dsh-enhanced-plugins/sub-agent/preset
- 独立包：dsh-enhanced-sub-agent/preset

同一 scope 不要同时挂载两种布局。

开发与验证

本仓库以只读 sibling checkout 作为 DSH API、类型和真实 Web 组装基准：

D:\work\workspace\github\deepseek-harness

常规验证命令：

DSH 运行时与 lib/types 必须来自同一次源码构建；基于旧声明文件通过 typecheck，不能证明兼容更新后的 checkout。

npm install
npm run typecheck
npm test
npm run build
npm run pack:dry-run
git diff --check

Windows 上可额外运行 npm run verify:compat：在独立临时 DSH home 中逐个安装 6 项功能，检查全量、多功能重选、旧模型包清理和聚合包的真实 Host 启动及 Client 资源；不会修改长期 profile。该命令需要先完成 DSH 与插件构建，验证记录保存在被 Git 忽略的 .verify-dsh-home/。页面交互和 light/dark 视觉验证仍需在真实 Web 页面完成。

需要使用隔离构建时，可将 DSH_VERIFY_CHECKOUT 设置为已验证 DSH commit 的构建副本路径，再运行 npm run typecheck、npm test 或 npm run verify:compat。默认仍使用 sibling checkout，安装器仍会核对声明的版本。

npm run verify:desktop-launcher 用编译后的 Launcher 验证源码命令选择、构建前置条件、重复启动抑制、pnpm 版本失败和进程树清理。npm run verify:desktop-source 通过 Launcher 在临时源码视图执行未经修改的官方 start:desktop 脚本，等待真实 Electron 页面后停止进程树；不会修改 sibling checkout。

npm run verify:desktop-host 在隔离目录中加载官方 Desktop Host 与固定插件发布快照，并验证实际 Client 首页响应；它不构建或修改 DSH checkout。

npm run verify:launcher 在临时目录中验证编译后的 Launcher 和 PowerShell 命令引擎，包括清理、安装、构建的顺序、失败即停止，以及真实 pnpm 对过期锁文件的拒绝。需要 Windows，并在 PATH 中提供 Git 和 pnpm；不会清理或重建真实 DSH checkout。

npm run verify:launcher-tools 将 Launcher 与 MCP 管理包安装到临时目录，通过真实 Launcher 启停 DSH，再由本地测试模型调用官方 read 工具并核对文件内容。它覆盖系统模式和本机有 NVM 时的沙盒模式，无需真实模型或 MCP 密钥。可将 DSH_VERIFY_MANAGER_ROOT 指向已有 pnpm package 目录，复制到临时缓存后由运行时校验版本，避免验证被首次下载耗时影响。

npm run verify:launcher-ui 在隔离目录中编译并验证真实 WinForms 控件：滚动、筛选、批量选择、页面与模式切换、重复布局、UTF-8 日志读取上限及已移除控件的释放。它使用约 64 MB 的日志测量切页耗时，并检查五个页面在普通、紧凑、宽屏与 150% 缩放下的布局；截图保存在 .verify-dsh-home/ui-performance/。输出的耗时是界面处理与离屏绘制基准，不代表显示器实际帧率，也不使用易受机器负载影响的固定耗时阈值判定通过。

npm run test:launcher-toolchain 验证版本检测、NVM 回退、声明冲突和环境隔离（先构建 Launcher）。node scripts/verify-launcher-sandbox.mjs <DSH-checkout> 在 Windows 上使用临时 DSH Home 验证真实 Web 就绪、所选包管理器、缓存重启和停止，可能下载所需包管理器；只读引用 DSH checkout，截图与结果写入 .verify-dsh-home/sandbox-artifacts。

npm run verify:pack 会将独立包打成 tarball，在没有 DSH peer 包的隔离目录重新安装构建依赖、执行 prepare 并检查再次打包的入口；Windows Companion 的这项验证也需要 Windows。

浏览器 bundle 使用 CSS Modules，并且只消费 DSH 的 --dsw-alias- 语义主题 token，会自动跟随 light、dark 与 system 外观。插件架构与公开扩展点可参考 DSH 插件开发文档 和 架构参考。

npm run verify:edit-web 在隔离 profile 安装编辑插件，使用本地 SSE 模型 fixture 驱动真实 Chromium/Web 组合，验证连续编辑、模型历史替换、文件与 Skill 引用预览、刷新恢复和 light/dark 截图，不需要真实模型密钥。默认验证 DSH 的 Messages 协议；设置 DSH_VERIFY_PROTOCOL=chat-completions 可额外验证显式选择该协议的情况。测试关闭会话日志上传，Launcher 文件也只安装到测试临时目录。它使用 DSH 构建副本中的 Playwright，需已安装对应 Chromium。typecheck 会拒绝 Session 声明版本不匹配、缺少 openSkill，或没有新版插件配置与会话引用接口的陈旧构建。Web、Desktop 验证命令均支持 DSH_VERIFY_CHECKOUT 指向隔离构建。

npm run verify:plugin-ui 在真实 Web profile 验证 MCP 保存与草稿丢弃、插件热启停，以及真实 Team 的监控与成员跳转，并检查 light/dark 配色。设置 DSH_VERIFY_AGGREGATE=1 验证聚合包；默认验证两个相关独立包的组合。发布前可将 DSH_COMPATIBILITY_URL 指向隔离测试服务，使验证使用待发布的兼容表；远端没有匹配记录时改用包内表。

DSH 0.1.7-alpha.1 的实际配置入口是 plugins.row.config／plugins.bundle.config；在线设置卡片 cookbook 仍可能展示旧 settings.plugin.item，本版本以已验证提交的源码和类型为准。

License

MIT

多模型协作界面改版

仅配置轻量、普通、强力三个模型，从 DSH 已配置目录中搜索选择；任意一档未配置，设置和会话入口均禁止开启并提示缺少的档位，后端同步拒绝。移除备用选择及故障换备用模型，旧备用引用不再生效。三档职责分别呈现，并发、重试和切换规则按需展开。会话输入区的协作菜单打开右侧详情，采用“任务摘要 → 已调用模型 → 任务分工”的单页信息流，请求明细和会话历史按需展开，避免概览、用量、历史重复展示同一任务。深浅主题沿用 DSH 公共控件。

已移除累计 token 限额与模型报价：旧 token 配置不再阻止请求，不再预留 token、配置报价或估算金额；请求次数与子执行次数只统计，不再设 30/12 或其他累计次数上限；保留实际用量、并发控制、失败重试和记录容量保护。旧设置和历史字段仅为兼容读取保留。

多模型设置修改后自动保存，无需点击保存，不再提供恢复继承按钮；停止输入约 400 毫秒后合并提交，离开设置页会提交待保存修改，失败或冲突保留当前草稿并提示。

设置中的“启用自动协作”关闭时，输入区隐藏“多模型协作”入口；保存开启后自动显示，无需刷新。关闭全局开关会清理已打开的菜单、停止入口轮询，并释放普通选模锁定。会话模式与任务记录保留，再次开启全局开关时按原会话模式恢复。新会话默认关闭协作。输入区按钮采用 DSH 原生模型/权限控件的无底色外观、字号、尺寸和状态样式。协作管理与单模型选择为两个独立控件；开启后原选模位置显示不可点击的“多模型协作中”，关闭后恢复 DSH 原有的“模型／当前值”菜单及供应商分组列表，插件不再重写普通选模菜单；Host 同时拒绝普通模型修改，关闭后恢复原单模型与推理选择且不修改全局默认。设置导航独立图标采用仓库已有的可撤销兼容方式实现，无需修改 DSH 本体。

协作启用后追加主助手分工与子助手职责指引，记录直接处理或派发的具体依据。主助手在编辑、写入、Shell 或代码执行前必须提交带工作类型的分工决策；实现任务要求 NORMAL 子助手，诊断/分析要求 STRONG 专家，Host 会拦截绕过检查点的主任务变更。新增结构化验收报告，执行结束不再等同于验收通过；主助手复核子结果后才能报告根目标通过。交接保留必要约束与可回查历史，文件变化会使只读结果需要重验。新记录使用独立 V5 存储并只读导入 V4/V3/V2/V1 历史。