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.
使用智能任务路由
模型路由决定“这一阶段用哪个模型”,任务路由决定“这项工作交给哪个执行 Agent”。两者可以独立启用,也可以组合使用。
下面先展示桌面应用配置路径。Linux 无界面版可以通过 routing preview/apply 发布计划,通过 agents connect preview/apply 接入 Agent,再使用下文的 worker 命令执行任务;请求字段可用 hiroute schema show 查询。
适合委派什么
委派适合目标、工作目录和交付物相对清楚、可以独立执行的工作,例如实现一个局部功能、检查一组测试失败或整理一份研究结果。主 Agent 负责发现已开放的计划、选择合适场景并取回结果。
协调本身、计划发现、状态查询、等待和结果总结不应再次委派。执行 Agent 也不能递归发起另一层委派。
为计划启用任务委派
- 打开“智能路由”,新建或编辑一份计划。
- 在“任务委派”中打开“允许委派任务给执行 Agent”。
- 为这份计划选择一个执行 Agent。当前支持 Codex CLI、Claude Code、Qoder CLI、Pi 和 DeepSeek Harness;可用性取决于本机安装和依赖检查。每份计划只选一个,执行失败时不会自动改用另一种 Agent。
- 按页面提示检查所需执行环境,然后发布计划。
安装缺失不会阻止保存计划,但真正启动任务前必须让所选执行 Agent 通过依赖检查。计划的名称和使用场景应描述适合的任务及预期交付,帮助主 Agent 做出正确选择。
允许主 Agent 委派任务
打开“Agent”,选择你日常使用且页面支持任务路由的主 Agent,再打开“任务路由”:
- 启用任务路由。
- 选择委派时机:仅在你明确要求时委派,或默认由 Agent 判断。
- 保存配置,并按提示完成任务委派技能检查。
可委派的任务路由在“智能路由”中管理;主 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),不会撤销已经写入的文件或已完成的外部操作。多个任务使用同一工作目录时仍可能同时执行,请自行避免互相覆盖文件。