dsh-multi-agent
kiritoko1029/dsh-multi-agent
按可配置的自然语言规则将独立任务派发给 DSH、Codex、Kimi Code 或 Antigravity 子代理,支持会话续接和统一任务面板。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
dsh plugin --profile web add github:kiritoko1029/dsh-multi-agentREADME
DSH 多 Agent 派发
把独立任务按自然语言规则派发给 DSH 自身、Codex、Kimi Code 或 Antigravity(agy),并通过 DSH 原生子代理完成通知把结果送回主会话。
安装(DSH 用户)
-
确认 DSH 版本为
0.2.2-rc.3,不要通过版本豁免强行安装。 -
从 GitHub Releases 下载稳定版的 TGZ 安装包,可同时下载同名
.sha256文件核对传输完整性。TGZ 不需要解压。 -
把 TGZ 文件或它在 DSH 所在电脑上的绝对路径发给 DSH,并发送:
请通过插件管理器安装这个多 Agent 派发插件 TGZ。先检查 DSH 版本和安装包,不要手动修改 profile,不要开启版本豁免,也不要替我把权限策略改成 allow 或 full-access。安装后请核验状态,并告诉我是否需要重启。
-
按插件管理器返回结果应用或重启 DSH。刷新页面后,点击会话顶栏右侧的 多 Agent 派发图标(新建会话的开始页在 Workspace / Agent 预设行右侧显示带文字的同一入口),配置模型、路由规则、CLI 路径与权限策略。
完整升级、CLI 和安全说明见 安装与安全说明。从旧 dsh-multi-agent 升级到 scoped 包时,先备份配置并按插件管理器提示处理旧包;包名也是插件安装身份,不要让新旧两个包同时启用。不要在 profile 目录手动执行 npm install / pnpm install;npm 包与 GitHub Release 提供的是同一种 TGZ 安装产物,不是需要全局安装的 CLI。
使用边界
- 需要哪个外部 Agent,就自行安装并登录对应 CLI;插件不提供账号或模型额度。只用 DSH 子代理时不需要外部 CLI。
- Kimi / agy 新安装默认
permission: main-session:权限申请送主会话审批;批准操作可能允许写文件与执行命令,这不是操作系统级只读沙箱。 - 不包含账号、密钥、会话、任务报告、备份或 node_modules;安装依赖需要联网。
- 任务面板使用 DSH 原生右侧栏与文件预览,无需安装第三方侧栏扩展。
- macOS 是当前验证平台;Linux / Windows 未作实机安装和 CLI 执行验收,不承诺跨平台即装即用。
版本变更只记录在 更新日志,不在 README 重复维护。0.9.3 起稳定版同步到 npm 包 @kiritoko1029/dsh-multi-agent;历史版本不追溯发布。
DSH 版本兼容
0.10.0 起仅支持 DSH 0.2.2-rc.3,engines.dsh 已同步收窄。RC1/RC2 不再属于兼容性或交付验收范围,不要通过版本豁免强行安装到这些版本。
- 插件仍根据注入的 Host 服务能力检查接口;不识别或混合的接口组合会拒绝启动,不在派发失败后换参数格式重试,避免重复创建任务。
- 仓库中保留的历史适配代码与 RC 契约脚本仅供旧版本维护和诊断,不构成对 RC1/RC2 的兼容承诺;默认测试不再运行真实上游双版本矩阵。
- 三个官方 Subagent 依赖仍固定为 rc.1 的 Provider/helper 基线;这是实现依赖,不代表支持 rc.1 Host,也不替换注入的 Host 服务。
升级安全: 新版 DSH 创建具名子代理后可能写入旧版无法读取的会话记录。升级前备份会话存储,不要让不同版本进程同时读写同一份存储,也不要直接在新版记录上降级。已有路由配置、报告路径和任务身份无需手工重置。
设计
主 Agent
│ dispatch_agent(description, task, expected_output, agent?, report_path?)
▼
路由层(本插件)
├─ 按设置中的自然语言规则选择 Agent
├─ 歧义时或始终询问用户(可配置)
└─ 组装自包含任务契约
▼
DSH Subagent Manager
├─ dsh → 原生 spawn Provider,支持 provider/model/reasoning effort
├─ codex → 官方 Codex app-server,支持默认模型
├─ kimi-code → ACP → kimi acp,session/new 后设置默认模型
└─ agy → ACP → agy acp,复用本机登录,设置会话模型与思考强度
▼
主会话收到 activation id;完成后收到最终文本 / 报告路径 / 失败诊断
- 不 monkey-patch 现有
subagent,不复制一套进程和会话管理。 - 向所有可调用
dispatch_agent的主会话注入全局主动派发提示词:面对多步骤或大范围任务,主 Agent 应主动识别并默认派发可独立、可并行、适合专长 Agent 或可隔离上下文的子任务,无需等待用户明确要求;琐碎单步任务仍直接完成,不为凑数量而派发。 - 路由由主 Agent 根据设置中的自然语言规则决策;插件不额外调用分类模型,也不把规则硬编码成关键词评分。
- Kimi Code 使用 ACP,负责初始化、会话创建、模型设置、prompt、取消和权限请求。
- Codex 复用官方 app-server 协议与结果选择逻辑,默认模型在每次启动前读取;未配置时使用 Codex 原生模型配置。
- DSH 自身使用原生
spawnProvider。可在路由页设置默认 provider/model/reasoning effort,也可在单次调用中覆盖;模型路由受当前 Session 的授权列表与 LLM 能力校验约束。 - 外部子代理每轮仍由独立 managed activation 执行:完成后可用
continue_agent恢复同一 Codex thread / Kimi 或 agy session 并开始下一轮。运行中暂不追加指令。首次派发仍需自包含;续接会保留子会话自己的上下文,不继承主会话全文。 - 工具只对 root/main Agent 开放。DSH 内部子代理不能继续调用它,从而不会绕过原生派发深度,也不会触发无效的子代理用户问答。
- 父 Session 保留 external child 的归属与终态。已接收的子任务由 DSH 管理,路由组件重载不再立即取消它们;每个任务原有的超时计时和完成回传继续有效。Host 进程退出/崩溃后的续跑不在此保证内。
- 从
run_code派发时,交接竞争按以下规则处理:调用方取消信号只控制启动阶段,接收成功后解除监听,避免 PTC 正常结束时的清理误杀后台任务。是否已接收由 DSH 管理器裁决;返回成功的 activation 不再因交接瞬间的调用方取消而被销毁。任务超时独立计时,不会被启动取消状态屏蔽;接收后的父子中断遵循 DSH 原生管理机制。
普通派发与原生例外
独立的“派发路由约束”组件在 root 会话中执行以下规则:
- 普通新任务统一使用
dispatch_agent,包括分配给 DSH 自身的任务。直接调用subagent/subagent_codex会在创建子任务之前被拒绝,并提示正确入口。 - 持续协作成员通过
dispatch_agent(agent: "dsh")创建,再使用原生消息与已启用的 Team 任务板;declare_delegate_exception例外仅用于继承已完成上下文的subagent_fork。 - 例外必须填写闭合的
purpose、具体reason,以及与原生调用完全一致的description;一次声明只允许本轮的一次匹配尝试,失败也会消费。声明记录由会话日志重放,不能跨会话或 Fork 继承复用。 - 已有成员/子代理的
send_message、等待、中断、查询和任务看板操作不受影响。不要为了并行普通任务而创建 Team。 - 非 root 子代理不受此策略阻塞;当前工具集中没有本插件的
dispatch_agent时放行原生派发。这是派发工作流约束,不是权限安全边界,不改变审批、沙箱和模型授权。
例外示例:
{
"tool": "subagent_fork",
"purpose": "context_inheritance",
"description": "复核既有决策",
"reason": "需要继承本会话已完成轮次中的设计讨论,完整搬运这些上下文会造成大量重复。"
}
声明成功后调用原生 subagent_fork,并使用相同的 description。
前置条件
- 使用 DSH
0.2.2-rc.3,在自己的 DSH 中配置可用模型。只有使用外部 Agent 时才需要对应 CLI;不必把全部 CLI 装齐。 - 使用 Codex 时,在本机安装并登录 Codex CLI。本插件独立注册
codex-routerProvider,不要求启用官方 Codex 工具 bundle。 - 使用 Kimi 时,在本机安装并登录新版 Kimi Code CLI。优先检测当前用户的
~/.kimi-code/bin/kimi,然后搜索 PATH;可用KIMI_COMMAND覆盖检测路径。 - 使用 Antigravity 时,在本机安装并登录
agy,通过agy --version和agy acp --help检查。优先检测当前用户的~/.local/bin/agy,然后搜索 PATH;可用AGY_COMMAND覆盖检测路径。 - 可视任务面板使用 DSH 原生右侧栏;无外部侧栏依赖。
- Codex、Kimi Code 和 agy 使用各自原生的认证和项目配置;DSH 子代理使用当前 DSH 的模型与工具组合。本插件不复制或保存 API Key。
参考文档:
设置
点击会话顶栏右侧的 多 Agent 派发图标(无文字、背景或边框;新建会话的开始页在 Workspace / Agent 预设行右侧提供带文字的同一按钮,发送第一条消息后回到顶栏),在弹出的宽敞面板中完成全部配置。三个组件的配置统一迁移到这个入口,DSH 设置页与插件详情中的独立配置入口不再提供这些字段(组件启停仍由插件管理器负责)。面板按“模型与思考强度”“派发策略与规则”“运行参数”分组,集中配置 DSH、Codex、Kimi 和 Antigravity(agy)。
底层保留原有三个配置项及其保存值,无需重填或手工迁移。统一“保存更改”逐项调用 DSH 原生配置通道,每项均带 revision 冲突保护;这些写入不是跨组件事务。部分保存失败时保留失败项的编辑,不重复提交已成功的项。更改应用于后续派发,已运行的任务不受影响。
模型与思考强度均可从建议列表选择,也可手动输入。选项来自所选模型的目录;切换模型会清空旧强度覆盖值。留空表示继承原生默认值。不可用 Provider 的区域显示禁用状态,不影响 DSH 设置保存。
模型目录读取失败时可点击重试,或直接手动输入模型;不会因目录不可用而清空已有配置或阻止保存。
外部 CLI 只读取环境变量代理,不读取 Windows/macOS 的系统代理设置。每个 Provider 在“运行参数”中提供 proxyMode:system(默认,读取系统代理并注入 HTTP(S)_PROXY 与 NO_PROXY)、none(写入 NO_PROXY=*,忽略继承的代理)和 custom(填写 http://127.0.0.1:7890 这类地址)。Provider env 中的同名变量优先于注入值。Windows 读取当前用户 Internet Settings,macOS 读取 scutil --proxy,结果缓存 30 秒;系统未启用代理时不注入任何变量。
Multi-agent router / 多 Agent 派发
selectionModeauto:主 Agent 按路由规则给出agent;未选择时使用defaultAgent,未配置默认值则报错,不会静默乱派。ask-if-ambiguous:明确匹配时自动执行,未给出agent时弹出选择。always-ask:主 Agent 可以推荐,但每次由用户最终选择;续接旧任务时也会重新询问 Agent,并在同一张卡片中选择复用旧会话或新建会话。
defaultAgent:可选的自动路由兜底 Agent。routes:表单中可增删的Agent + 提示词规则行,直接用自然语言描述哪类任务适合哪个 Agent。additionalInstructions:补充路由偏好,例如“用户明确点名时优先”。taskPreamble:附加到每个子任务的通用要求,例如代码规范或回复语言。timeoutSeconds:单次任务墙钟超时,默认 1800 秒,覆盖启动握手与执行阶段;超时由 DSH 取消 activation,并按aborted结算,不是 CLI 退出码。dsh.defaultProvider/dsh.defaultModel:位于“模型与思考强度”分组的 DSH 默认模型路由;留空继承主会话。通过remote.session.modelCatalog()读取实际 provider/model 建议,provider 变化时过滤模型列表,也可手动输入。dsh.defaultReasoningEffort:DSH 子代理默认推理强度;选中模型后显示该模型实际支持的 effort 建议,留空使用模型默认值。
高级字段 codex / kimiCode / agy / dsh(Provider 名、显示名、说明和启用状态)保留在 Cordis 配置中,默认分别绑定 codex-router、kimi-code、agy 与 spawn,一般无需修改。
Codex Provider
model:位于顶栏“多 Agent 派发”面板顶部的默认 Codex 模型;通过可用性检测到的本机当前 Codex CLI 执行debug models(不使用--bundled静态快照),读取与交互/models一致的公开模型(visibility: list),可下拉选择或手动输入;留空使用 Codex 原生配置,后续每次启动都会读取最新值。reasoningEffort:默认思考强度;建议取自 Codex 目录的supported_reasoning_levels,执行时明确发送到 app-server 的turn/start.effort。留空时不覆盖原生默认值。permissionPolicy:子代理权限请求策略,默认main-session。主会话审批 / 人工审批 / 允许所有时线程使用 ask-request 参数(无自动审查器),真实升级请求按策略决定;主会话有效权限为“不再询问 + 完全权限”(never + danger-full-access)时,改用 Codex 原生完全权限线程并自动允许其申请,避免策略自动拒绝。拒绝所有与子代理控制的auto沿用下方permissionMode。subagentPermissionMode:子代理控制等级(auto/full-access/ask-request),仅策略为subagent时生效,映射到 Codex 原生线程模式。permissionMode:Codex 原生线程权限模式,默认approve-for-me(自动审查 + workspace-write);策略为拒绝所有或子代理控制 auto 时直接作为线程模式使用。env:Codex 子进程环境覆盖。disposeGraceMs:进程退出宽限时间。
Kimi Code ACP
-
model:位于顶栏“多 Agent 派发”面板顶部的默认 Kimi 模型别名;通过kimi provider list --json读取实际配置别名与显示名,可下拉选择或手动输入;留空使用 Kimi 原生配置。设置时在 ACPsession/new成功后、session/prompt前调用session/set_config_option。 -
reasoningEffort:默认思考强度;建议取自模型的supportEfforts。模型设置成功后,按会话最新返回的thinking选项验证并设置强度;不支持的值会在发送任务前报错,不会静默忽略。 -
command/args:默认<本机 kimi 路径> acp。 -
permission:子代理权限请求策略,默认main-session(主会话审批)。main-session:申请送主会话审批链;主会话轮次已结束时降级为交互卡片。若主会话有效权限恰好为“不再询问 + 完全权限”(never + danger-full-access),子代理继承该组合并自动允许申请;其他组合仍按原审批链处理,用户主动拒绝不会被改写为允许。权限状态在每次任务启动时读取,本次启动后保持不变。human:每次申请弹交互式审批卡片。allow:自动选择 ACP 返回的首个allow_once/allow_always选项。reject:拒绝子代理发出的权限请求,可能导致报告写入或任务执行失败。subagent:子代理控制,配合subagentPermissionMode等级(auto接受其内部规则过滤后的申请;full-access自动允许全部——kimi acp 没有公开的跳过参数;ask-request逐次送主会话审批)。
-
subagentPermissionMode:子代理控制等级,仅permission: subagent时生效。 -
env:显式子进程环境覆盖。不要在这里填写不再需要的密钥;子 Agent 原生认证通常已经足够。 -
disposeEofGraceMs/disposeGraceMs:进程退出与强制终止的宽限时间。
Antigravity(agy)ACP
在顶栏“多 Agent 派发”面板配置 Antigravity(agy)。它有独立的模型、思考强度和运行参数,不会覆盖 Kimi 的 ACP 配置。
command/args:使用本机自动检测到的 agy 路径和["acp"];可在顶栏面板中修改命令,特殊安装位置需同步设置AGY_COMMAND,供 DSH 启动时检测。model/reasoningEffort:留空沿用原生默认值;指定后通过 ACP 会话配置设置。思考强度使用 agy 的thought_level,与 Kimi 的thinking分开处理。不要把普通 CLI 的--model/--effort直接追加到agy acp参数。- 模型建议来自
GET /multi-agent/model-catalog/agy:通过短暂 ACP 会话读取实际模型族及各模型支持的强度,15 秒超时并回收进程,不执行任务 prompt。不要把agy models中带强度后缀的组合 ID 当作模型族填写。可选模型以当前账号和 ACP 返回值为准。 permission:子代理权限请求策略,默认main-session(主会话审批),选项与 Kimi 相同(main-session/human/allow/reject/subagent)。继承主会话“不再询问 + 完全权限”时,agy 会追加原生--dangerously-skip-permissions;Kimi 没有公开跳过参数,通过自动允许其 ACP 权限申请实现。subagentPermissionMode:子代理控制等级。agy 与 Kimi 的差异在full-access:agy 会追加原生--dangerously-skip-permissions启动参数,彻底交由其内部权限体系;其余等级语义一致。env与退出宽限参数:语义与 Kimi ACP 相同;已有登录无需额外填写密钥。proxyMode/proxyUrl:agy 是 Go 程序,只认HTTP(S)_PROXY环境变量,不读系统代理。默认system会把系统代理注入子进程;custom可填自己的地址(如http://127.0.0.1:7890)。目录查询与任务使用同一份代理设置。- 可在路由规则、默认 Agent 中选择
agy,或直接调用dispatch_agent并指定agent: "agy"。结果、工具活动和报告进入同一任务面板。 - 完成后的任务通过
continue_agent复用原 ACP 会话。agy 使用session/load检查原用户或助手历史是否存在;缺少加载能力或历史为空时在发送新任务前拒绝,不静默新建会话。原生数据库锁等原因可能导致 CLI 未保存历史,适配器不会修复或改写 CLI 数据库。历史回放不混入当前任务正文。
{
"description": "用 Antigravity 检查实现",
"agent": "agy",
"language": "zh-CN",
"task": "检查当前工作区的实现,指出具体问题并说明验证方法。",
"expected_output": "中文审查结论、相关文件位置和验证结果。"
}
本机可用性与回退
- 插件挂载时检测本机原生
codex、kimi与agy。Kimi / agy 没有检测到命令且未手动配置时不注册 Provider;Codex 还可使用依赖包内的原生二进制,不再要求 PATH 中必须存在外部命令。 - 可用
CODEX_COMMAND、KIMI_COMMAND、AGY_COMMAND指定检测路径;也可在顶栏“多 Agent 派发”面板手动覆盖。Kimi 默认检测~/.kimi-code/bin/kimi,agy 在 POSIX 检测~/.local/bin/agy、在 Windows 检测%LOCALAPPDATA%\agy\bin\agy.exe。手动命令与 Providerenv同时用于目录查询和任务。 - 运行期间若选中的 Codex/Kimi/agy Provider 不可用,
dispatch_agent自动回退到本机 DSH,并在结果中返回route: "fallback";不会把外部 Agent 不可用静默当成任务成功。 - DSH 子代理不依赖外部 CLI,始终作为本机兜底。模型选择仍遵守当前 Session 的模型授权和能力校验。
- 新安装外部 CLI 后需要重载插件或重启 DSH,让 Loader 重新计算组件可用性。
安全边界: Kimi 和 agy 非交互任务可以写文件、执行 Shell。任何批准类策略(主会话审批中点了允许、人工审批、允许所有、子代理控制)都可能批准这些操作,且都不是操作系统沙箱。主会话选择“不再询问 + 完全权限”是有意的完全授权:使用默认 main-session 策略时,Codex / Kimi / agy 会继承该权限,不再逐项询问;如需逐项审批,请把主会话审批改回“询问”,或为对应 Agent 选择人工审批等显式策略。请只在受信任工作区使用;需要隔离时使用独立 worktree、容器或操作系统沙箱,不要仅靠提示词声明“只读”。
主 Agent 调用契约
dispatch_agent 参数:
| 参数 | 必填 | 含义 |
|---|---|---|
description | 是 | 使用主会话语言的简短任务标题 |
language | 否 | 主会话语言,例如 zh-CN、en。全局提示要求每次显式传入;省略时取最近真实用户消息的有界语言线索,约束子任务进度、最终回复及报告 |
task | 是 | 完整目标、要做的工作、约束和相关路径 |
expected_output | 是 | 主会话需要的准确返回内容 |
agent | 否 | dsh、codex、kimi-code 或 agy;按选择模式可省略或作为推荐 |
provider + model | 否 | 仅 DSH:单次覆盖模型路由,必须同时提供并通过 Session 授权与能力校验 |
reasoning_effort | 否 | 仅 DSH:单次覆盖推理强度 |
context | 否 | 背景、已有发现、依赖,避免子代理重复探索 |
report_path | 否 | 自定义报告路径;相对路径基于子任务 cwd。缺省自动使用固定目录 .dsh/agent-reports/ 下的唯一 Markdown 文件 |
cwd | 否 | 子任务初始目录,缺省继承主会话 |
route_reason | 否 | 简短路由理由 |
示例:
{
"description": "修复解析器回归",
"agent": "codex",
"task": "定位并修复 parser 在空输入上的回归,补充边界测试并运行相关测试。",
"context": "回归出现在上次 tokenizer 重构之后;不要修改公开 API。",
"expected_output": "返回根因、修改文件、测试命令和结果;若有遗留风险单独列出。"
}
DSH 子代理指定模型示例:
{
"description": "审查解析器改动",
"agent": "dsh",
"provider": "magpie",
"model": "kimi/k3.1-pro",
"reasoning_effort": "highspeed",
"task": "使用 DSH 原生工具审查当前工作区的解析器改动并运行相关测试。",
"expected_output": "返回问题列表、验证结果和报告路径。"
}
报告存放位置
每次派发都会生成一个默认报告路径:
<子任务工作区>/.dsh/agent-reports/<UTC时间>-<任务名>-<唯一id>.md
例如:/path/to/project/.dsh/agent-reports/20261110T012345Z-fix-parser-a1b2c3d4.md。
- 每次任务使用独立文件,避免并行覆盖。
- 子代理收到该绝对路径,必须实际写入报告,并在最终回复中给出准确路径。
- 启动工具结果也包含
reportPath,主会话完成后可以直接读取。 - 显式传入
report_path时才覆盖默认位置;相对路径基于子任务 cwd。 - 报告由子代理写入;启动成功不代表文件已存在,失败或取消时要以完成通知和文件实际状态为准。
子代理的最终回复必须直接满足 expected_output。主会话需要报告细节时应读取该文件,而不是把路径当作报告内容。
并行与结果
独立任务可以在同一 assistant 消息中多次调用 dispatch_agent。工具调用本身只返回:
started codex subagent <childId>
Result status: pending; this start acknowledgement is not the task result. If dependent work remains, end the turn and wait for the completion notice.
Report path: <absolute-report-path>
最终答案通过后续 DSH completion notice 回到主会话。started 回执和报告路径只表示任务已启动,不代表结果已经就绪。
主 Agent 必须先判断后续工作是否依赖子任务结果:
- 存在依赖时构成完成屏障:例如先派子 Agent 分析调用链,再根据分析修改代码。主 Agent 启动所有独立派发后必须立即结束当前 turn,等待完成通知;不得自己重复分析、提前修改或继续验证,也不能嘴上说等待却在同一 turn 内继续调用工具。
- 只有真正独立的工作才能继续:不得消费子任务结论、重复子任务职责或修改重叠文件。子任务完成后,主 Agent 读取结果或报告,再恢复依赖它的工作。
- 只有等待结果时,主 Agent 应结束当前 turn,不要轮询或睡眠。
任务标签面板与完成卡片
派发新的 Codex/Kimi/agy 任务后,当前主会话的原生右侧栏会自动打开 Agent 任务 面板;也可以从开始页的 Agent 任务入口打开。界面使用 DSH 原生页面与文件预览,原生 Team 任务面板仍保留。后台会话的新任务不会误开到当前页面。
当前主会话有子任务运行时,顶栏派发图标旁显示旋转图标与运行数量;出现异常时增加警告图标与未读异常数量。点击状态区域会打开对应主会话的 Agent 任务面板,点击原派发图标仍只打开设置;只有任务面板实际可见且页面处于前台时,异常才标记为已读。正常完成或全部空闲后状态自动隐藏,减少动态效果偏好会停用旋转动画。
- 每个子任务独占一个标签页,按创建时间倒序排列,最新任务在前;标签及任务标题区显示本地日期和时间,不显示“创建时间”文字前缀,耗时仍保留。同一 Agent 的多次派发分别展示,支持键盘切换,完成通知可定位对应标签。
- 子任务正文按连续消息流完整展示,不逐条使用卡片、消息标签或摘要/全文两层展示。相邻工具活动按发生顺序分组,穿插在正文之间,默认折叠为紧凑列表;工具输出可进一步展开,展开时不强制跟随滚动。与最后一条正文完全相同的最终结果不重复展示。
- 消息和最终结果统一渲染标题、强调、列表、引用、表格、代码块及链接。文件链接点击后使用当前任务工作区和父会话的文件查看入口;代码与原始 HTML 按文本显示,危险链接不会执行,图片不自动加载。Markdown 解析器随 Client bundle 本地打包,不访问 CDN。
- 新派发的任务标题沿用主会话语言;子任务的进度消息、最终回复和报告也遵守传入的语言约束。保留代码、路径和专有名词,尊重明确指定的交付物语言。已有英文标题和报告不自动翻译。
- 每个子任务独立记录阅读位置及自动跟随状态。在消息区底部时,新消息、已有消息追加内容或最终输出更新会自动跟随;向上滚动暂停,回到底部恢复,也可点击向下箭头回到最新。不显示底部“正在跟随”或“已暂停跟随”状态条。
- 切换标签后保留各任务阅读位置;刷新任务列表和新任务出现不会强制切走当前标签。消息到来时不会为了保持固定条数而主动移除正在阅读的内容。
- Codex 记录已完成的正文消息和工具项;Kimi 和 agy 记录 ACP 正文片段、工具开始及更新。不会展示或编造内部推理,也不把这些活动自动塞入主模型上下文。
- 完成通知以任务卡片展示,提供“打开任务面板”“查看报告”和原始通知全文;点击面板入口会选中对应子任务标签。
- 报告按钮调用原生文件查看功能。没有监控记录的旧通知,会将其中明确的
.dsh/agent-reports/绝对 Markdown 路径提供为“查看报告(来自原通知)”,不宣称已核验文件存在。 - 关闭/隐藏面板会停止列表刷新;只有当前选中的可见子任务读取详细活动,没有可显示的当前会话时不强行打开。
- 主模型可用
agent_tasks查询自己派发的任务状态与活动,不能查询其他主会话。
任务摘要、归档状态、输出与真实外部会话引用保存在 DSH 原生存储域 multi_agent_task_history,不保存凭据。进程重启时,未结束的记录标为已中断并归档,等待明确续接,不会自动重跑。活动流水仍仅保存在当前 Host 内存中:每任务最多 500 项活动、256K 字符活动正文,单条正文最多 16K 字符;恢复后的历史可查看摘要、报告和续接能力,不能补录之前的流水。最多保留 200 条任务记录,运行中的任务不因达到数量限制被淘汰;超过上限时最早终态记录会被淘汰。
更新时使用保持启用状态的 profile 增量协调,不再采用关闭整个 bundle 后重开的方式。路由组件卸载不取消已接收任务,原有 deadline 继续执行;Host 重启仍会终止进程。本地 Client 源码改动后先运行 node scripts/build-client.mjs 生成合并入口,再协调加载。
模型与 token 用量
任务详情标题区显示模型、思考强度及 token 用量,历史详情使用同一信息区,不给每条消息增加卡片。
- 模型和思考强度优先取后端返回的实际值;只能获得请求配置时明确标为“配置”,不是运行结果确认。没有数据时显示“未提供”,不猜测默认模型或强度。
- Token 只展示后端提供的消耗数据,不用文本长度估算,不把上下文窗口占用冒充消耗。未提供与真实的
0分开处理。 - 优先展示报告的总量;只在输入与输出两项均已知时相加计算总量。缓存和思考 token 如有明细单独展示,不再重复加到总数。
- 标签区分任务累计、会话和本轮用量,避免把不同统计口径混为一谈。续接沿用同一逻辑任务,重复累计通知不重复加总。
- 旧任务可能没有新字段;不会根据当前全局设置补造历史模型或 token 数。采集能力取决于当前 CLI / ACP 协议实际返回的数据。
- DSH 从自身子会话事件记录模型、思考强度及真实 usage,按事件序号去重。Codex 使用
thread/tokenUsage/updated.tokenUsage.total的线程累计快照,标为“会话 Token”,重复快照不累加;不将last猜成整轮用量。 - Kimi/agy 从 ACP 会话配置读取模型和思考强度;只有 prompt 响应包含
usage才显示消耗。usage_update.used/size表示上下文窗口占用,不计作消耗;未提供实验性 usage 的 CLI 仍会显示“—”。
历史归档、清理与续接
- 已完成、已中止和错误任务自动归档。顶部“历史任务”入口打开独立的历史视图,列表独立滚动,不与当前任务消息区上下叠放;查看历史详情时收起列表,并可返回先前活动任务、恢复阅读位置。正在查看的任务结束时保留详情,不会自动打开历史列表。历史提供查看、恢复到活动标签和清理;恢复标签本身不会启动模型。
- 清理只从面板列表隐藏终态任务并释放活动流水,保留磁盘报告和底层会话。主 Agent 可按仍保留的逻辑 childId 查询、恢复或续接;清理不等同于删除会话,历史上限淘汰的记录不保证仍可通过本插件访问。
- 面板“继续指挥”或主 Agent 的
continue_agent({ childId, message, expected_output?, language? })调用同一业务入口。续接开始后回到活动区,下一轮结束再次归档。只允许本父会话的终态任务,拒绝重复并发续接。always-ask下会先在同一次询问中选择 Agent 与会话方式;选择新建时创建独立任务和新报告,不携带旧会话标识,Agent 或 Provider 不兼容时不会静默复用。 - DSH:通过原生
sendMessage唤起同一子会话。Codex:新任务使用持久 thread,后续thread/resume复用它。Kimi:按能力优先session/resume,兼容session/load。agy:使用session/load确认保存的历史存在;两者均屏蔽旧消息回放。 - 外部续接会创建新的 managed activation,但面板保持同一个逻辑任务,通过内部别名关联各轮;不能把新 conversation 当成旧会话复用。缺失原始 ID、远端历史已被删除、能力不支持或工作区不匹配时直接报错,不静默重新派发。
- 升级前的 Codex 临时线程不落盘、Kimi 原始 ID 未记录;这些旧任务无法通过本插件可靠恢复。新持久记录才提供外部续接能力。外部恢复沿用原工作区和模型,当前审批策略仍逐轮执行。
- 历史存储初始化失败时显示明确不可用错误并阻止任务操作;不删除或重置损坏数据,卸载失败也不会形成未处理拒绝。
- 报告和完成通知保留,超时与取消不回滚已发生的文件修改或外部副作用;跨 Host 同时续接的分布式锁、运行中外部 steer 不在当前范围。
开发
以下命令供完整开发工作区使用,不是接收者的安装步骤。分享 TGZ 已包含构建产物,但不包含开发测试目录;完整测试需在保留测试的开发工作区运行。首次安装请按 INSTALL.zh.md 使用插件管理器。
# 本地 link 安装前,先在插件目录安装依赖;不要在 profile 目录执行 pnpm。
pnpm install --ignore-scripts
node scripts/build-client.mjs
node scripts/check.mjs
node --test test/*.test.mjs test/client.test.js
# 可选的真实 agy 验证:使用本机登录,消耗两轮模型请求,验证原会话上下文恢复。
node scripts/smoke-agy.mjs
# 可指定 CLI 路径,也可用 AGY_SMOKE_MODEL / AGY_SMOKE_EFFORT 指定测试模型与强度。
历史 RC 契约工具
RC1/RC2 不再属于当前兼容性或交付验收范围。默认 node --test test/*.test.mjs test/client.test.js 不运行、也不会跳过真实上游双版本矩阵。
仓库暂时保留 scripts/verify-runtime-contracts.mjs 作为历史诊断工具;仅主动维护旧版本时才需要 Node 24+(使用内置 TypeScript 去类型 API)及两份官方固定版本源码:
node scripts/verify-runtime-contracts.mjs \
--rc1-source /path/to/rc1-source \
--rc2-source /path/to/rc2-source
该脚本不自动下载、不安装依赖、不调用模型。无参数时查看 node scripts/verify-runtime-contracts.mjs --help。真实 CLI、原生页面注册与桌面渲染仍以对应运行环境中的实际操作为准。
本地链接包更新后需要由 Plugin Manager 协调重新加载。以返回的 application 和 nextStep 为准:applied 后仍需验证实际任务;restart-required 表示新代码需重启 DSH 才会加载,不能将磁盘版本更新说成正在运行的新版本。若返回 failed to import,先排查 Host 导入错误。前端源码修改后需重建 Client bundle;浏览器页面刷新本身不会重启 Host。
发布维护
维护者的 GitHub Release、OIDC Trusted Publishing 与 npm 发布流程见 PUBLISHING.md。普通 main 提交、本地安装和手动 npm pack 都不会触发 npm 发布。