使用超级模组注入器（开发热加载）

dev_inject_plugin {"dir": "/path/to/dsh-task-router"}


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

```yaml
- 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       # typecheck + test + build

目录结构

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 参与声明
本项目许可证与版权声明

配置