DeepSeek Harness（DSH）是一个插件化平台。在处理视觉识别、翻译或语音转写等特定任务时，通常需要专门的模型和工具，而主 Agent 无法很好地处理这些。dsh-agent-router 是一个 DSH 插件，它允许自定义专业 Agent 并将它们绑定到独立的模型。该插件支持多模态账号一键登录、账号池健康路由与实时用量统计。
核心功能¶
该插件主要解决 DSH 主 Agent 能力单一的问题，通过以下方式扩展能力边界：
- Agent 预设默认模型：按 DSH 预设粒度配置主 Agent 与 subagent 的默认模型。新会话或切换预设时，对话框模型选择器会即时跟随显示配置的默认模型。
- 专业 Agent 配置：支持五种执行通路——chat 远端模型、完整子代理、无头 CLI 子代理、图片生成、语音转写。每个专业 Agent 独立配置服务商与模型，未配置时自动复用主 Agent 模型。
- ChatGPT 订阅登录：支持官方 Codex OAuth 授权登录。订阅账号可直接作为主模型调用，OAuth token 由插件自动注入刷新。绑定订阅账号的 agent 也可用于生图。
- 多模态任务路由：支持图片识别（OCR、截图、图表）、图片生成、语音转写。当启用视觉类专业 agent（能力标签含
image）后，输入框会出现「添加图片」按钮，附件图片会被注入上下文。 - 无头 CLI 子代理：支持接入 codex、claude、gemini 等外部 agent 工具。这些工具以无头模式执行多步任务，图片与文件按工作区路径注入。
- 多模态账号与账号池：支持任意服务商 API Key 配置式添加。账号池按健康、用量、轮询策略自动选号与失败切换。
- 实时用量统计：提供分级视图（预设、专业 Agent、账号级、全局），支持按天持久化（默认保留 90 天）及 CSV 导出。
安装¶
前置要求：DSH ≥ 0.1.5-rc.2。
使用标准管理命令安装：
dsh plugin --profile web add github:peterwangze/dsh-agent-router
安装脚本方式需宿主支持，推荐使用上述 dsh plugin 标准管理。离线安装时，必须使用 file: 且带 ./ 前缀，例如：
dsh plugin --profile web add file:./
安装完成后重启 DSH。
使用指南¶
安装并重启后，在 DSH 的「设置 → Agent 路由」打开配置页。
- 启用多模型路由：在顶部总开关启用功能。关闭后
route_agent拒绝调用、统计暂停。 - 配置预设 Agent：在「预设 Agent」卡片中，按 DSH 预设粒度配置主 Agent 与 subagent 的默认模型。配置后，新会话或切换预设时模型选择器会立即跟随显示。
- 配置专业 Agent：在「专业 Agent」卡片中维护自定义专业 agent，包括选择执行通路（chat/agent/cli/image/speech）并绑定对应的模型。
- 配置多模态账号：在「多模态账号」卡片中添加 API Key 或进行 ChatGPT 订阅登录。系统会自动维护账号池，按策略选号。
- 查看统计信息：在「统计信息」卡片中查看分级用量明细。
注意事项¶
- 版本兼容：本插件在 DSH ≥ 0.1.5-rc.2 环境下受支持与实测。
- 离线安装：离线安装时路径必须带
./前缀，否则会被当作 registry 包名。 - 统计持久化：用量统计按天持久化，默认保留 90 天。如需关闭，可设置
router.stats.persist=false。
