Skip to content

Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.

3.9 KB
Raw Blame

使用智能任务路由

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

下面先展示桌面应用配置路径。Linux 无界面版可以通过 routing preview/apply 发布计划,通过 agents connect preview/apply 接入 Agent,再使用下文的 worker 命令执行任务;请求字段可用 hiroute schema show 查询。

适合委派什么

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

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

为计划启用任务委派

  1. 打开“智能路由”,新建或编辑一份计划。
  2. 在“任务委派”中打开“允许委派任务给执行 Agent”。
  3. 为这份计划选择一个执行 Agent。当前支持 Codex CLI、Claude Code、Qoder CLI、Pi 和 DeepSeek Harness;可用性取决于本机安装和依赖检查。每份计划只选一个,执行失败时不会自动改用另一种 Agent。
  4. 按页面提示检查所需执行环境,然后发布计划。

安装缺失不会阻止保存计划,但真正启动任务前必须让所选执行 Agent 通过依赖检查。计划的名称和使用场景应描述适合的任务及预期交付,帮助主 Agent 做出正确选择。

允许主 Agent 委派任务

打开“Agent”,选择你日常使用且页面支持任务路由的主 Agent,再打开“任务路由”:

  1. 启用任务路由。
  2. 选择委派时机:仅在你明确要求时委派,或默认由 Agent 判断。
  3. 保存配置,并按提示完成任务委派技能检查。

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

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

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

若配置为默认委派,主 Agent 也可以对适合独立执行的工作主动选择计划。任务记录会显示在桌面应用的“任务”页面。

从终端启动任务

安装 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 \
  -- "定位失败、实现最小修复并运行相关测试"

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

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

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

不要换一个提交标识直接重试,以免启动重复任务。更多进度和结果命令见 HiRoute CLI。

权限和取消边界

默认权限策略 approve-all 允许所选执行 Agent 按自身能力读写文件、执行命令和访问网络;它不提供操作系统级沙箱。需要限制权限时,选择页面或 CLI 为该 Agent 提供的策略。若 Agent 无法执行所要求的限制,HiRoute 会在发送任务前报错,不会自动放宽权限。

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