Tiko9527/task-router

dsh-task-router

简体中文 | English

这是一个由 AI 工具大量参与制作的插件。
本项目在开发过程中使用了 GLM、DeepSeek、Qwen 等 AI 工具辅助设计、编码、测试与文档撰写。

dsh-task-router 是一个 DeepSeek Harness (DSH) 插件：让主模型从“事必躬亲”变成“规划者 + 验收者 + 复杂问题亲自动手者”。

主模型可以把网页搜索、网页浏览总结、图片转述、图像生成、代码实现、结果核查等任务委派给子模型或外部 API，从而降低主模型 token 消耗，并保持主模型对核心决策的控制权。

功能特性

- 任务委派工具
- task_search：Tavily 搜索，返回精简摘要，主模型不接触原始网页。
- task_browse：Tavily Extract 抓取网页，交给子模型总结转述。
- task_image_describe：把 DSH 图片引用交给视觉模型转述。
- task_image_generate：OpenAI 兼容 /images/generations，也支持自定义 REST 模板。
- task_code：把代码实现/修改任务委派给代码子代理。
- task_verify：把成果交给核查子代理，返回结构化问题清单，并支持机械问题自动回炉。
- 信息隔离
- 主模型默认不直接接触原始网页内容。
- 子代理默认禁止再次调用 task_*，防止递归委派。
- 可视化设置
- DSH 设置栏中的“任务配置”页面。
- 简单 / 高级模式切换。
- 预设厂商、Provider / Model 下拉、API Key 凭据写入 DSH 凭据库。
- 全局启用 / 禁用开关。
- 暗色模式与移动端适配。
- 安全边界
- 子代理默认有 toolFilter，禁止递归委派。
- code / verify 子代理会按角色钉入沙箱模式（code 默认 workspace-write，verify 默认 read-only）。
- 配置只保存凭据引用，不保存明文 API Key。

安装

前置要求

- Node.js >= 20.3
- 已安装 DeepSeek Harness（DSH）环境
- 已准备的 API Key：
- Tavily（搜索 / 浏览）
- 代码 / 核查 / 图片转述模型对应的 Provider API Key
- 图像生成 API Key（可选）

构建

npm install
npm run build

装配到 DSH

使用 DSH 的插件注入或 bundle 装配机制加载 @dsh-external/dsh-task-router。

常见方式：

使用超级模组注入器（开发热加载）
dev_inject_plugin {"dir": "/path/to/dsh-task-router"}

或在 DSH profile 中通过 cordis.patch.yml 注册：

- insert:
- id: dsh-task-router
name: '@dsh-external/dsh-task-router'
config: {}

lib/ 是构建产物，默认不提交到 Git。安装或打包时会通过 prepare / prepack 自动构建。

配置

配置存储在：

~/.dsh/task-router/config.json

API Key 不写入该文件，而是通过 apiKeyEnv 引用 DSH 凭据库中的凭据。

默认角色：

| 角色 | 用途 |
|---|---|
| main | 主模型：规划、验收、核心决策 |
| search | Tavily 搜索 |
| browse | 网页抓取与总结 |
| code | 代码实现 / 修改子代理 |
| image-describe | 图片转述 |
| image-generate | 图像生成 |
| verify | 成果核查子代理 |

工具

| 工具 | 说明 |
|---|---|
| task_search(query, max_results?) | 调用 Tavily Search，返回精简结果。 |
| task_browse(url, instruction?) | 抓取网页并可选的子模型总结。 |
| task_image_describe(image_ref, instruction?) | DSH 图片引用 → 视觉模型文字转述。 |
| task_image_generate(prompt) | 生成图片并保存到本地。 |
| task_code(requirement, context?, allowed_paths?, allowed_commands?) | 委派代码子代理实现 / 修改。 |
| task_verify(output_ref, requirement) | 委派核查子代理并返回结构化结果。 |

已知限制

- allowed_paths / allowed_commands 目前只是提示词建议，不是系统级强制限制。子代理仍可能访问工作区外或执行未列出的命令。
- task_image_describe 只接受 DSH 图片 attachment JSON 引用，暂不支持本地文件系统路径。
- 设置页没有模型搜索 / 分页，模型很多时下拉会较长。
- 实时模型调用日志 / 实时任务状态指示器已移除（该功能存在稳定性问题）。
- 暂无 i18n 多语言支持。

安全说明

- 本地 HTTP API 的写操作（配置、凭据）会校验请求来源，只允许同源 / loopback 请求。
- 配置与凭据分离：配置中不保存明文 API Key。
- 对外错误信息经过脱敏。
- 代码子代理默认运行在可写工作区沙箱，核查子代理默认只读；但请勿把敏感工作区交给不可信模型运行。

更多细节见 SECURITY.md。

开发

npm run typecheck   # TypeScript 类型检查
npm test            # Vitest 单元测试
npm run build       # tsc + tsdown 构建
npm run check       # 类型检查 + 测试 + 构建

目录结构
text
src/
index.ts          # host 插件入口、HTTP API、prompt hooks
config.ts         # 配置 schema、校验、预设
tools/            # 委派工具与子代理工具
adapters/         # Tavily / LLM / Image / REST 适配器
client/           # React 设置页
tests/              # 单元测试
docs/               # 技术文档

相关文档

- 更新日志
- 安全说明
- 贡献指南
- 行为准则

许可证

BSD-3-Clause

本项目允许任何人二次修改、传播、商用，只要求保留原项目署名及本声明。没有“禁止盈利”之类的限制。

AI 参与声明 / 高度 AI 属性

本项目具有高度 AI 性质：

- 本项目由 TIKO 发起。
- 设计、编码、测试、文档整理均由 GLM、DeepSeek、Qwen 等 AI 工具大量参与完成。
- 连项目提交都是 DeepSeek 操作的。
- 这不是一个“纯手工作品”，而是一个高度 AI 协作生成、并由 AI 完整执行发布流程的开源项目。

任何人若基于本项目二次修改或传播，请保留：

- 原项目名 dsh-task-router
- 原作者署名 TIKO
- 本 AI 参与声明
- 本项目许可证与版权声明