dsh-selective-subagent

dsh-selective-subagent

给 DeepSeek Harness (DSH) 的子代理加一层"人来选模型"的环节：AI 拆分任务、准备派子代理时，先弹窗让你为该任务指定 provider / 模型；60 秒无操作则保持 DSH 原本的子代理路由继续。

这不是独立网页，也不是第三方 Desktop 插件的安装脚本。本项目是标准 DSH bundle，只使用当前版本公开的 agent/created、agent.model.select() 与 Connection RPC 接口。

功能

• 逐任务选择模型：子代理创建时等待你的回答，回答前不会发起第一次模型请求。
• 任务栏与序号：1 / 3 在行首，长条下拉切换待选任务；任务名后以蓝色圆角标签显示已确认的模型。
• 真实模型目录：从已配置的 LLM Provider 读取，支持搜索与滚轮滚动。
• DSH 默认策略：选择它表示完全不覆盖原路由，而不是强制跟随父级模型；60 秒无操作时同样走这条路径。
• 复用选择：可把某次具体模型选择应用到同一父会话后续子代理；"默认策略"不会建立复用。
• 跟随主题：使用 DSH 主题 token，支持明暗主题；字体优先微软雅黑。
• 动效克制：下拉逐项展开、选中圆角底色 180ms 淡入淡出，遵循系统的减少动态效果偏好。

实际运行截图

以下图片于 2026-11-09 从已经安装 1.0.1 的 DSH Desktop 窗口截取；仅裁剪插件区域，没有重绘界面。面板使用实心表面 token，模型标签使用业务蓝色 token。截图中的模型来自测试环境的真实 Provider 配置，不代表安装插件后会自动获得这些模型。

模型选择弹窗

任务历史浮层

点击底部紧凑的「子代理模型」按钮，会在入口上方打开独立浮层。任务名称、蓝色模型标签和完成状态在浮层内展示，输入框本身不改变高度。条目沿用任务下拉的阶梯式淡入动效。

收起	打开浮层

上面两张对比图使用同一窗口的同一裁剪坐标。此前另一次路由小测试已确认，用户选择 deepseek-official / deepseek-flash 后，标准 model/selection 和第一次 request/header 均记录了新模型，任务成功返回。

详见 运行验证记录。

早期交互设计稿（不是实际运行截图）

以下是实现前的独立设计预览，保留作设计参考；请以上面的实景截图为准。

深色主题设计稿	任务栏标签设计稿

环境要求

• 依据 DSH 0.2.2-rc.1 的公开契约编写；接口签名随版本变化的可能始终存在。
• 无第三方运行时依赖，不需要构建工具链（client.js 已随仓库提供）。

安装

只能用官方插件入口安装。不要手工改写 profile 的 package.json / cordis.patch.yml，也不要执行旧版第三方插件那种 junction 安装脚本。

• Agent / 工具：plugin_manager 的 install_bundle，target 指向本仓库目录或对应的 tarball。
• Web GUI：侧栏 Plugins / 插件 页面添加本地包。
• CLI：dsh plugin --profile <profile> add <本目录或 tarball>。

安装会占用 profile 的写入锁 <profile>/package.json.lock。若报 atomic-write: timed out waiting for the writer lock，说明另有插件安装/更新正在持有该锁：等它结束，必要时重启 DSH 释放锁，再重试；不要删除仍由活进程持有的锁文件。

安装后核验：

1. Config.listConfigs 出现 bundle dsh-selective-subagent；
2. Client Slots.listSubTree 的 shell.overlay 与 conversation.composer.dock 出现本插件条目；
3. 新建一个会派子代理的任务，弹窗出现且子代理在回答前不发起模型请求。

使用

1. 发起一个需要创建子代理的任务。
2. 弹窗中为当前任务选择模型，或选择"使用 DSH 默认策略"。
3. 勾选复用后，具体模型会应用于同一父会话尚待选择的任务和后续同级子代理。
4. 连续 60 秒无操作，Host 按各任务原有 DSH 路由继续。弹窗内的鼠标、键盘、输入、滚轮操作会续期同一根会话的全部待选任务。
5. 输入框下方仅显示紧凑的「子代理模型」入口。点击后，任务历史以锚定浮层弹出，不占用页面布局、不抬升输入框；浮层条目从上到下依次淡入，点击空白处或按 Escape 收起。

已经开始运行的子代理不会中途换模型。

配置

bundle 默认配置：

config:
  enabled: true          # 总开关
  idleMs: 60000          # 无操作回退毫秒数（1000–3600000）
  askOncePerParent: false # 默认不自动复用；弹窗内可显式复用

实现概要

• Host：host/index.js + host/engine.js

  • 在 agent/created（serial，AgentLoop 会在所有监听器结束后才处理排队输入）中等待用户。
  • 具体选择通过公开的 agent.model.select() 提交，写入标准 model/selection，保证会话头与实际请求路由一致。
  • 不监听已移除的 agent/request，不在 llm/stream 中私自换模型，不注册 Tool/命令。
  • 默认与超时路径完全不调用 select，原路由原样保留。

• Client：client-source.js + ui.css → 由 build.mjs 打包成 DSH ModuleLoader 使用的 client.js。

  • 两个扩展位：shell.overlay（模型选择弹窗与任务历史浮层）、conversation.composer.dock（只渲染固定高度的紧凑入口）。浮层不在 composer 内展开，避免合成层和布局挤动输入框。

• 通信：通过 connection.fetch.register() 注册 /api 下三个独立的精确 POST 路由，使用 Connection Client 的通用 RPC 信封；不占用或覆盖 DSH 的共享 /api 拦截器：

  端点	作用
  selective-subagent/state	读取快照；afterRevision + waitMs 长轮询（≤25s）
  selective-subagent/activity	续期同一根会话的全部待选任务
  selective-subagent/choose	提交具体模型，或 route: null 表示 DSH 默认策略

  快照包含稳定 instanceId、revision、serverNow、timeoutMs、模型目录与任务状态。

• 权限：选择与续期只接受 principal.kind === 'owner' 且 interactions === 'answer' 的已认证 Peer；插件不注册任何能替用户确认的 Agent Tool。

已知限制

• 只覆盖本进程创建的子代理（spawn / fork 等 in-process provider）。ACP、Claude Code、Codex 等外部子进程执行器不受控。
• 正在运行的子代理不会因首次安装而被重新询问；选择只发生在安装后新建的子代理上。
• 已完成任务为当前 Host 进程内的有界缓存（最多 200 条已完成/取消），模型选择本身仍记录在 DSH 标准会话日志。
• 弹窗按页面会话显示对应根会话的任务；切换会话或收起弹窗不会暂停 Host 的 60 秒超时。
• 模型目录取决于你的 Provider 配置；插件不创建凭据、不新增模型、不修改允许模型列表。

开发

node build.mjs            # 从 client-source.js + ui.css 生成 client.js
node --test test/*.mjs    # Host 与 Client 逻辑测试（37 项）

client.js 是构建产物且随仓库提交，安装时无需构建。修改 client-source.js / ui.css 后必须重新构建，CI 会校验构建产物与源码一致。

状态

• 源码层：Host 23 项（含精确路由激活、认证及请求信封检查）+ Client 14 项逻辑测试通过（node --test）。
• 运行层：2026-11-09 已在 DSH Desktop / DSH 0.2.2-rc.1 安装启用，并完成一次用户手动选择模型的小测试；标准选择记录与第一次真实请求头一致，任务成功返回。
• 默认回退：另一次测试在约 60 秒后按原路由继续，未发生模型覆盖。
• 该结果仅代表上述环境和流程，不代表外部子进程 provider、所有 DSH 版本或所有主题都已覆盖测试。详细步骤见 运行验证记录。

许可证

MIT，见 LICENSE。

---

English

Pick a model for each DSH subagent before it starts. A modal waits for the user at agent/created, commits the choice through the public agent.model.select(), and falls back to the untouched DSH route after 60 idle seconds. Blue rounded model badges appear in the plugin's own task bar and task dropdown. In-process subagents only; no third-party runtime dependencies.