子智能体与委派
omdsh 的委派建立在 Harness 的 subagent 服务之上,而不是产品私有的任务运行器。何时委派由模型决定;你可以用键盘跟进子代理、就地打开本地子转录,并引导支持继续的运行。
传输通道
三种 transport 并存,按每次委派选择而不是全局配置。随包发布的 persona 会把重度或可并行的自包含工作路由到隔离通道,把可能需要引导或继续的工作留在进程内。
| Transport | 运行位置 | 继承父对话 | 派发后可引导 | 适用场景 |
|---|---|---|---|---|
subagent | 进程内,与 TUI 同一事件循环 | 否 | 是 | 你可能需要引导或追问的工作 |
subagent_fork | 进程内,与 TUI 同一事件循环 | 是——父会话已完成的回合作为子会话前缀,保持缓存可复用 | 是 | 需要父会话上下文的工作 |
subagent_isolated | 独立进程,通过 ACP | 否 | 否 | 不应占用渲染循环的重度或并行自包含工作 |
隔离通道以功能换取隔离:它不接受 model、persona 或 tool filter,没有父级强制的递归上限,派发后也无法引导或追问。它从独立的 home 启动自己的 Harness profile,因此需要 PATH 上有一个能提供 acp profile 的 dsh;OMDSH_ACP_COMMAND 与 OMDSH_ACP_ARGS 可以覆盖启动方式。
宿主 subagent 设置段的 maxDepth 默认为 1,供继承它的工具使用:直接孩子不能再通过这些工具委派。工具显式配置的深度(包括 provider-managed)优先。maxActiveSubagents 默认为 8,限制同一 activation tree 中活动或正在创建的本地与外部孩子;根父代理不占名额。等待、待处理输入和正在停止的孩子仍计入名额,清理后才释放。调高设置可以接纳更多孩子;调低会保留现有孩子,并在占用下降前拒绝新的创建。超过上限的委派会被拒绝,而不是排队。
每次委派会先返回 activation id,执行、结束与结果回传由 Harness 运行时负责。本地孩子可接受追问;ACP 等外部执行没有本地 Session 转录,其结果返回父对话。管道模式下,EOF 会等待仍在推进的孩子及其引发的父级工作完成后退出。会话释放时先清理受管理的后代,再释放父代理。
跟进与引导
Codex 与 Claude Code bundle 随 omdsh 安装且初始关闭,可从 /settings → Plugins 或 /plugins → Bundles 启用和配置。它们使用自带的固定版本运行时及原生登录/设置,向所有 preset 提供全局 subagent_codex 和 subagent_claude_code 工具,执行不支持追问的独立纯文本任务。Model and Permissions 编辑其原生权限策略,独立于父级 Access。Installation status 只报告注册状态;认证与运行时启动成功仍需真实委派验证。见插件。
子代理运行时,队列与 composer 上方的名册会跨全部委派层级显示子代理名称(深层委派使用斜杠分隔路径)、任务说明与生命周期状态,恢复会话时也会包含尚未加载的冷后代。“可继续”表示可继续对话的子代理能够接收新消息,“已停止”与“失败”分开显示。模型侧通过 send_message、wait_agent 与 list_agents 与可继续子代理协作,interrupt_agent 默认关闭,将中断控制保留给人类 Ctrl+C(可通过 overlay 显式开启)。composer 为空时按 ↓ 选中一行,↑/↓ 移动,Enter 就地打开该子会话的实时转录。名册重新排序时,选中项仍跟随同一个子代理。历史一次性转录保持只读;外部执行没有本地转录,结果返回父对话。
检视子会话时,底部状态栏和 Access 角标显示该子会话的信息。活动计数和 token 总量只统计其自有事件,上下文用量包含继承的对话上下文;缺少的模型或权限数据不借用父会话值。返回后恢复父会话信息和目录,终端标题和生命周期通知仍跟随根会话。
查看可继续对话的子代理时,运行中的 Enter 沿用主会话的排队或插话偏好。Alt+Enter 始终排入下一回合,Alt+S 插入下一步;空闲时 Enter 发送新一轮消息。文本、图片和文件共用同一条投递路径,已接收消息显示在子代理 composer 上方。在子代理视图中,Alt+Q 或 /queue 打开该子代理自己的队列,支持编辑、撤回、排序以及将排队消息转为插话。Alt+Up 将最新的下一回合消息取回 composer;Enter 始终将取回的消息重新排队,即使运行中输入偏好设为插话。队列操作要求子代理已在本地加载;尚未加载时,先发送消息继续该子代理。父子会话的草稿相互独立;接收前取消或投递失败的消息回到原子代理草稿,即使你已经返回主会话。
composer 为空时,Ctrl+C 停止正在查看的子代理并保留其已接收队列,不会中断父回合或父会话的 Shell 命令。Esc 先清空子代理草稿,再返回主会话;连续第二次 Ctrl+C 退出应用。本地子代理的审批请求会标明请求者,名册在请求结束前显示“需要审批”。Harness 不允许受委派子代理直接向用户提问,未解决的问题必须随结果交回父代理。完整按键见键盘与快捷键。
已记录的 Workflow 运行与子代理共用名册和有限高度的预览区。按 ↓ 选中工作流,再按 Enter 浏览阶段与成员;←/→ 折叠分组,直接输入可筛选列表。名称与成员归属来自会话日志,状态更新保留当前选中项。只有成员及其所属的本地子代理都在运行时,Enter 才能打开成员;已完成、不可用和外部成员仍可查看,但不会触发冷恢复。Esc 关闭工作流列表并恢复之前的视图与草稿。
普通回合结束不会使后台工作流停止。只有发起回合因崩溃恢复或分叉边界而关闭时,未结束的运行才显示为“已中断”;这只改变呈现,不修改工具结果。只有顶层 workflow_run 调用生成这些记录;完整事件历史仍可通过 /trajectory 查看。
编排工具
挂载的 Harness 组合在普通委派之外还提供编排与共享任务工具:
workflow_run接受一段 JavaScript 脚本,把工作按阶段扇出到多个子代理并收集结构化结果。脚本运行在 worker 线程而不是宿主事件循环上,因此大规模扇出不会卡住界面。ralph用一茬茬新 agent 迭代同一个目标,直到某个 worker 报告完成或遇到阻塞。它默认关闭,与上游 base bundle 一致:工具描述本身已把它限制在你明确要求的运行上,而是否完成是 worker 的自述而非独立评估。home overlay 在其行上写disabled: false即可恢复。team_task_create、team_task_list、team_task_get与team_task_update为主代理及其进程内可继续子代理提供基于 Compare-and-Set 的共享任务面板(@deepseek-ai/dsh-agent-team,每棵会话树最多 256 项任务),跟踪前置依赖(blockedBy)、任务归属与建议性写入范围(writeScopes)冲突提示。团队模式在每个会话中默认关闭;运行/team on(或运行/team打开交互式任务面板)即可从下一步起开放team_task_*与协作指引,运行/team off则隐藏工具并保留会话日志中已记录的任务。
code(PTC)preset 会 deny workflow_run:PTC 把工具注册表呈现为 run_code 之上的生成 SDK,否则就会暴露第二个由模型编写的编排面。
使用 /plan 进入规划,/plan off 返回直接工作。Plan 状态与工作流编排独立。见命令。
后台任务
回合结束后继续运行的长任务会出现在 /jobs 中,带状态与已用时间;/jobs kill <id> 停止其中一个。后台任务完成时会在会话里发布一条完成通知。任务属于会话作用域,切换或恢复会话后不会保留。