HiRoute

使用智能任务路由

模型路由决定“这一阶段用哪个模型”，任务路由决定“这项工作交给哪个执行 Agent”。两者可以独立启用，也可以组合使用。

下面以桌面应用说明配置，Linux Web UI 的操作相同。也可以只用 CLI：通过 routing preview/apply 发布计划，通过 agents connect preview/apply 接入 Agent，再使用下文的 worker 命令执行任务；请求字段可用 hiroute schema show 查询。

适合委派什么

委派适合目标、工作目录和交付物相对清楚、可以独立执行的工作，例如实现一个局部功能、检查一组测试失败或整理一份研究结果。主 Agent 负责发现已开放的计划、选择合适场景并取回结果。

协调本身、计划发现、状态查询、等待和结果总结不应再次委派。执行 Agent 也不能递归发起另一层委派。

为计划启用任务委派

  1. 打开“智能路由”，新建或编辑一份计划。
  2. 展开“更多设置”，在“任务委派”中打开“允许委派任务给执行 Agent”。
  3. 填写使用场景。开启任务委派后，使用场景必须填写：说明适合交给这条路由的任务和预期交付，例如“实现范围明确的代码修改，并运行相关测试”。主 Agent 根据名称和使用场景选择路由。
  4. 选择一个执行 Agent：Codex CLI、Claude Code、Qoder CLI、Pi、DeepSeek Harness 或 OpenCode。可用性取决于本机安装和依赖检查。每份计划只选一个，执行失败时不会自动改用另一种 Agent。
  5. 按页面提示检查所需执行环境，然后发布计划。

安装缺失不会阻止保存计划，但真正启动任务前必须让所选执行 Agent 通过依赖检查。

允许主 Agent 委派任务

打开“Agent”，选择你日常使用的主 Agent，在“任务路由”中选择“启用”。Codex、Claude Code、Qoder、Pi、DeepSeek Harness、Hermes 和 OpenCode 都可以作为主 Agent；Hermes 需要先选择它实际使用的配置目录。

  1. 选择“委派时机”：“仅在明确要求时”，只有你要求执行、委派或交给 Worker 时才启动任务；“默认由 Agent 判断”，Agent 可以主动委派适合执行的工作，你仍可明确要求只回答、不执行。
  2. 选择“启用任务路由”，并按提示完成任务委派技能检查。

任务路由只影响委派，不改变主 Agent 自己使用的模型。主 Agent 也可以不启用模型路由，继续使用原有模型和登录，只通过任务路由使用 HiRoute 计划。

可委派的任务路由在“智能路由”中管理；主 Agent 会发现已发布并允许任务委派的计划。

启用后，在日常对话中明确说出 HiRoute 和委派意图，例如：

  • 指定路由：“使用 HiRoute，将当前任务委派给【路由名称】执行。”将占位内容替换为“智能路由”中允许任务委派的路由名称。
  • 由 Agent 选择：“使用 HiRoute 委派当前任务，选择合适的路由。”

若配置为默认由 Agent 判断，主 Agent 也可以对适合独立执行的工作主动选择计划。任务记录显示在“Agent”页面的“任务记录”中。

其他能运行命令的 Agent 也可以直接调用下文的 worker 命令委派任务。

从终端启动任务

安装 HiRoute CLI 后，可以先发现执行器和计划：

hiroute worker executors
hiroute worker plans

再启动任务：

hiroute worker exec \
  --plan <PLAN_ID> \
  --cwd /absolute/path/to/project \
  --title "修复解析器回归" \
  --submission-key parser-fix-001 \
  -- "定位失败、实现最小修复并运行相关测试"

worker exec 提交后会等待任务的下一次进展，最多 30 秒，然后返回当前状态和 run ID；任务已经成功结束时，会直接带上结果。任务继续在后台运行，不受这次等待影响。用 --wait-timeout 调整这段等待（1–30 秒），用 --no-wait 提交后立即返回；--run-timeout 设置任务本身的最长运行时间，默认 1 小时，最长 24 小时。

--submission-key 用来标识这次提交，新的任务应使用新的值。提交前保留它；任务被接受后，再保存返回的 task ID 和 run ID，用于查询进度、继续或取消。

如果连接中断，无法确定任务是否已被接受，先用原来的提交标识查询：

hiroute worker status --submission parser-fix-001 --operation start

不要换一个提交标识直接重试，以免启动重复任务。

任务进行中时，用 hiroute worker status --run <RUN_ID> 查看状态。任务结束后用 hiroute worker result --run <RUN_ID> 读取结果，需要补充要求时用 hiroute worker continue 在同一任务上继续。完整命令见 HiRoute CLI。

权限和取消边界

委派任务使用 approve-all 权限策略运行，不逐项审批工具调用：所选执行 Agent 可以按自身能力读写文件、执行命令和访问网络。它不提供操作系统级沙箱，--cwd 只是任务的工作目录，不是目录授权。请只在可以接受这些操作的环境中委派任务，需要隔离时自行准备容器或独立账号等环境。

取消只停止指定的这次运行（run），不会撤销已经写入的文件或已完成的外部操作。多个任务使用同一工作目录时仍可能同时执行，请自行避免互相覆盖文件。