dsh-agent-picker

Agent 模式选择器 —— 在 DSH（DeepSeek Harness）Web 界面的输入框右侧加一个控件，像选推理档位那样选定一个外部 Agent CLI作为当前会话的默认执行体。

它把"有哪些外部 Agent、各自怎么启动"做成数据（agents.json），所以加一个新 Agent 只需加一条数据，不必改代码。

它解决什么问题

DSH 本身能调用外部 CLI，但"调哪一个"通常要写死在配置里。这个插件把选择权交回给你：输入框右边一个下拉，选谁，这一轮就交给谁。名册驱动的设计意味着 同一个插件能挂任意多个 Agent，包括你自己写的。

安装

dsh plugin add dsh-agent-picker

装完重启 DSH。插件第一次启动会把自带的 agents.json 复制一份到 $DSH_HOME/agent-picker.agents.json（默认 ~/.dsh/），之后你改的是这一份，插件升级不会覆盖它。

名册：怎么加一个新 Agent

编辑 $DSH_HOME/agent-picker.agents.json，往 agents 数组里加一条：

字段	说明
`id`	唯一标识
`name`	显示名
`tool`	DSH 里对应的工具名
`bin`	包装器文件名（用于"是否已安装"的探测）
`available`	初始可用性建议；真实可用性由插件探测包装器是否存在
`kind`	`task`=任务型（结果可概括）／`chat`=对话型（原样转述）
`expertise`	菜单里显示的「擅长」一行
`note`	健康状态／接线说明
`desc`	展开后的详细能力介绍
`launch`	可选。自带执行配方：`bin` / `argv` / `env` / `timeoutMs` / `graceMs` / `maxBytes`。写了它，本插件就自己注册 `cli_<id>_direct` 工具

改完重启 DSH 生效。

`launch.argv` 的路径规则（重要）

名册是跨机器的，所以不要写死绝对路径。argv 里写裸文件名即可，插件会在运行时按下面顺序解析：

codex-dsh.ps1            ->  <cliBinDir>/codex-dsh.ps1
{cliDir}/codex-dsh.ps1   ->  <cliBinDir>/codex-dsh.ps1
C:\some\where\x.ps1      ->  原样保留（你想钉死绝对路径时用）

cliBinDir 的取值：环境变量 DSH_AGENT_PICKER_CLI_DIR 优先，否则默认 ~/dsh-clis/bin（与 dsh-sub-cli 的约定一致）。

占位符

argv 里可用的占位符：{task}（任务正文）、{permission}、{model}、{image}。

{image} 只对命令行真的支持图片参数的 CLI 有意义（例如 Codex 的 -i/--image）。其余 CLI 就算它自己有读图能力，也不是靠这个占位符——那种情况请把图片路径写进任务正文，让那个 Agent 用自己的读文件工具去读。

你需要自备什么

这个插件只负责调度，不附带任何 Agent。要用哪个，请自行安装并确认它在命令行可用：

Claude Code · Codex · Qwen Code · Gemini CLI · Aider · Goose · Hermes · OpenClaw · Ollama …

插件按 cliBinDir 下的包装器探测可用性；探测不到的成员不会出现在可选区。

封装脚本的写法与各 CLI 的接入细节，取决于你接哪个模型端点、有哪些凭据。这部分不在本插件范围内，请按你自己的环境准备。

参数约定

所有 Agent 工具的正文参数统一叫 prompt（配一个 3–5 词的 description 作标题； task 是兼容别名）。新加 Agent 请沿用，别另起名字。

兼容性

dsh.compatibility 声明为 >=0.1.5。本插件不依赖 settings.register() / installSection() 这类会随宿主版本变动的设置 API —— 它只用 ctx.tools.register / ctx.tools.guard / ctx.subprocess / ctx.webServer.register。

背景：DSH 0.1.7 移除了旧的 settings 注册入口，凡是用到它的插件会在启动时抛 TypeError: ... is not a function。本插件从设计上避开了这条路径。

安全声明（请务必读）

这个插件的本质是：按你的配置，在本机启动外部程序并执行任务。

它不是沙箱，也不是审核者。请清楚以下几点：

1. 它具备"在本机执行程序"的能力

被选为默认执行体后，插件会启动对应的 CLI 进程，并继承你的用户权限（能读写你能读写的文件）。所以"把任务交给哪个 Agent"这件事，等同于"允许哪个程序在你这台机器上干活"。

2. 三条可能的滥用面

面	说明
名册文件	`$DSH_HOME/agent-picker.agents.json` 里 `launch.bin` / `launch.argv` 写什么，插件就执行什么。拿到该文件写权限的人，等于拿到本机执行权。
约定目录	`$DSH_HOME/agent-picker.d/.agent.json` 是任何程序都能丢文件进来*的落地目录。它带来的正是"装了就自动出现"的便利，也是它的风险面。
自动探测	插件会在 `PATH`、`cliBinDir`、`~/.local/bin` 里找已知名字的命令（`codex` / `claude` / `aider` …）。同目录下放一个同名恶意程序，就会被选中。

3. 插件做了什么缓解

启动子进程时剥离敏感环境变量：名字里含 KEY / TOKEN / SECRET / PASSWORD 一类的一律不传，且所有 DSH_* 一律不传（避免把会话身份交给外部进程）。
每个 Agent 都有超时上限（默认 15 分钟，可按成员覆盖）与输出上限（默认 200,000 字节），防止一个挂住的子进程拖垮会话。
缺环境变量或需要常驻服务的 Agent，会标为"待配置"而不是静默执行。

4. 你的责任

用之前看一眼 agent-picker.agents.json 和 agent-picker.d/ 里到底有什么
只安装你信任的 Agent CLI。插件不审核、不签名、也不沙箱化它们
不要把名册文件或约定目录共享给不可信的人或程序
若你在多用户机器上使用，注意 $DSH_HOME 的目录权限

一句话：你交给它多少个 Agent，就等于打开了多少条本机执行通道。 请按这个前提使用。

许可

MIT —— 见 LICENSE。

开发

git clone https://github.com/Ok541151/cwk.git
cd cwk

离线自检脚本依赖宿主自带的 @deepseek-ai/dsh-tools。若在仓库外单独跑断言，需要在 node_modules/@deepseek-ai/ 下指向宿主那份（这个目录不要提交）。

dsh-agent-picker

它把"有哪些外部 Agent、各自怎么启动"做成数据（agents.json），所以加一个新 Agent 只需加一条数据，不必改代码。

它解决什么问题

安装

dsh plugin add dsh-agent-picker

名册：怎么加一个新 Agent

编辑 $DSH_HOME/agent-picker.agents.json，往 agents 数组里加一条：

字段	说明
`id`	唯一标识
`name`	显示名
`tool`	DSH 里对应的工具名
`bin`	包装器文件名（用于"是否已安装"的探测）
`available`	初始可用性建议；真实可用性由插件探测包装器是否存在
`kind`	`task`=任务型（结果可概括）／`chat`=对话型（原样转述）
`expertise`	菜单里显示的「擅长」一行
`note`	健康状态／接线说明
`desc`	展开后的详细能力介绍
`launch`	可选。自带执行配方：`bin` / `argv` / `env` / `timeoutMs` / `graceMs` / `maxBytes`。写了它，本插件就自己注册 `cli_<id>_direct` 工具

改完重启 DSH 生效。

`launch.argv` 的路径规则（重要）

名册是跨机器的，所以不要写死绝对路径。argv 里写裸文件名即可，插件会在运行时按下面顺序解析：

codex-dsh.ps1            ->  <cliBinDir>/codex-dsh.ps1
{cliDir}/codex-dsh.ps1   ->  <cliBinDir>/codex-dsh.ps1
C:\some\where\x.ps1      ->  原样保留（你想钉死绝对路径时用）

cliBinDir 的取值：环境变量 DSH_AGENT_PICKER_CLI_DIR 优先，否则默认 ~/dsh-clis/bin（与 dsh-sub-cli 的约定一致）。

占位符

argv 里可用的占位符：{task}（任务正文）、{permission}、{model}、{image}。

你需要自备什么

这个插件只负责调度，不附带任何 Agent。要用哪个，请自行安装并确认它在命令行可用：

Claude Code · Codex · Qwen Code · Gemini CLI · Aider · Goose · Hermes · OpenClaw · Ollama …

插件按 cliBinDir 下的包装器探测可用性；探测不到的成员不会出现在可选区。

封装脚本的写法与各 CLI 的接入细节，取决于你接哪个模型端点、有哪些凭据。这部分不在本插件范围内，请按你自己的环境准备。

参数约定

所有 Agent 工具的正文参数统一叫 prompt（配一个 3–5 词的 description 作标题； task 是兼容别名）。新加 Agent 请沿用，别另起名字。

兼容性

背景：DSH 0.1.7 移除了旧的 settings 注册入口，凡是用到它的插件会在启动时抛 TypeError: ... is not a function。本插件从设计上避开了这条路径。

安全声明（请务必读）

这个插件的本质是：按你的配置，在本机启动外部程序并执行任务。

它不是沙箱，也不是审核者。请清楚以下几点：

1. 它具备"在本机执行程序"的能力

2. 三条可能的滥用面

面	说明
名册文件	`$DSH_HOME/agent-picker.agents.json` 里 `launch.bin` / `launch.argv` 写什么，插件就执行什么。拿到该文件写权限的人，等于拿到本机执行权。
约定目录	`$DSH_HOME/agent-picker.d/.agent.json` 是任何程序都能丢文件进来*的落地目录。它带来的正是"装了就自动出现"的便利，也是它的风险面。
自动探测	插件会在 `PATH`、`cliBinDir`、`~/.local/bin` 里找已知名字的命令（`codex` / `claude` / `aider` …）。同目录下放一个同名恶意程序，就会被选中。

3. 插件做了什么缓解

启动子进程时剥离敏感环境变量：名字里含 KEY / TOKEN / SECRET / PASSWORD 一类的一律不传，且所有 DSH_* 一律不传（避免把会话身份交给外部进程）。
每个 Agent 都有超时上限（默认 15 分钟，可按成员覆盖）与输出上限（默认 200,000 字节），防止一个挂住的子进程拖垮会话。
缺环境变量或需要常驻服务的 Agent，会标为"待配置"而不是静默执行。

4. 你的责任

用之前看一眼 agent-picker.agents.json 和 agent-picker.d/ 里到底有什么
只安装你信任的 Agent CLI。插件不审核、不签名、也不沙箱化它们
不要把名册文件或约定目录共享给不可信的人或程序
若你在多用户机器上使用，注意 $DSH_HOME 的目录权限

一句话：你交给它多少个 Agent，就等于打开了多少条本机执行通道。 请按这个前提使用。

许可

MIT —— 见 LICENSE。

开发

git clone https://github.com/Ok541151/cwk.git
cd cwk

离线自检脚本依赖宿主自带的 @deepseek-ai/dsh-tools。若在仓库外单独跑断言，需要在 node_modules/@deepseek-ai/ 下指向宿主那份（这个目录不要提交）。

Ok541151/cwk

dsh-agent-picker

它解决什么问题

安装

名册：怎么加一个新 Agent

`launch.argv` 的路径规则（重要）

占位符

你需要自备什么

参数约定

兼容性

安全声明（请务必读）

1. 它具备"在本机执行程序"的能力

2. 三条可能的滥用面

3. 插件做了什么缓解

4. 你的责任

许可

开发

Community comments

Ok541151/cwk

dsh-agent-picker

它解决什么问题

安装

名册：怎么加一个新 Agent

`launch.argv` 的路径规则（重要）

占位符

你需要自备什么

参数约定

兼容性

安全声明（请务必读）

1. 它具备"在本机执行程序"的能力

2. 三条可能的滥用面

3. 插件做了什么缓解

4. 你的责任

许可

开发

Community comments

Ok541151/cwk

dsh-agent-picker

它解决什么问题

安装

名册：怎么加一个新 Agent

launch.argv 的路径规则（重要）

占位符

你需要自备什么

参数约定

兼容性

安全声明（请务必读）

1. 它具备"在本机执行程序"的能力

2. 三条可能的滥用面

3. 插件做了什么缓解

4. 你的责任

许可

开发

Community comments

Ok541151/cwk

dsh-agent-picker

它解决什么问题

安装

名册：怎么加一个新 Agent

launch.argv 的路径规则（重要）

占位符

你需要自备什么

参数约定

兼容性

安全声明（请务必读）

1. 它具备"在本机执行程序"的能力

2. 三条可能的滥用面

3. 插件做了什么缓解

4. 你的责任

许可

开发

Community comments

`launch.argv` 的路径规则（重要）

`launch.argv` 的路径规则（重要）