DSH Agentrix

多 Agent 编排与验收。

1.8.2 增加固定编号的原需求清单、逐项证据约定和声明产物版本核对，并区分当前计划验收与完整需求核对；同时修复主控活动漏记和检查点参数纠错。旧计划保持兼容，完整桌面任务仍需实际验收。

小任务由主 Agent 直接完成；需要委派时，主 Agent 负责方案、监督和验收，子 Agent 按配置的模型执行。

插件使用 DSH 原生子代理，提供任务计划、进度展示、并发与启动次数限制、结构化报告和基于实际证据的验收。主控说“完成了”不会直接把任务标为已完成，最终状态由插件保存的验收回执决定。

委派说明区分用户硬要求与实施建议、必读材料与按需参考，减少重复调查和自检。阶段成果需要核对、声明的交付文件首次写出或长时间没有新证据时，插件通知原主控结合实际成果纠偏；原代理和上下文保留。模型持续输出只表示有活动，不能替代实质进展；提醒也不代表失败或已完成。

当前源码将自动分流交给主控判断：比较委派收益与准备、汇报、验收开销，小改或高度共享上下文的连续调整优先直接完成，有独立执行量、隔离或并行价值时委派。普通任务也可交执行模型；执行复杂度看实际未决难点，审查方式按错误后果单独选择。模型调用达到 80 次及运行时间达到配置值时仅提醒，不终止、不更换代理。已有模型、并发、返工与启动次数设置继续保留。

模型怎么分工

选择高模型做主控、合适的低模型做执行者，独立审查自动沿用分发者的高模型。执行模型列表直接读取 DSH 已配置的服务，无需重复填写 API Key、Provider 或模型标识。

新任务应显式填写 reviewPolicy: coordinator/independent 和非空 reviewReason，分别表示主控验证验收或额外独立审查。权限、破坏性数据操作、并发等高风险工作应选择独立审查；长文、调查量大或需要发布本身不足以判为复杂或增加审查代理。按已确定的受众、结构和事实改写全文，可以是普通委派，由主控核对并验收。接口保留兼容：未填写这两个字段时，复杂任务自动审查，普通任务由主控验证，也可请求审查。复杂度不会自动切换执行模型。执行模型未配置时暂停派发；每个任务启动后固定模型快照，后续修改配置只影响新任务。

安装

安装包继续使用原有标识 @local/dsh-delegation-first，已有安装、配置和历史记录可继续使用。

需要支持原生子代理的 DeepSeek Harness。当前验证范围为 Windows、PowerShell 7（pwsh）和 Git；其他系统尚未验证。

桌面版使用应用内的插件管理或插件市场安装。未收录时，可使用本仓库地址或 Releases 安装包作为安装来源。

命令行版在自己的 Profile 中安装，命令格式为：

dsh plugin --profile  add

--profile 位于 plugin 后面。独立安装的命令行版可能不允许管理桌面版保留的 desktop Profile，桌面版应使用应用自身的安装入口。

安装后在插件管理中启用“DSH Agentrix”。配置和任务详情还需要 DSH 的 Web 界面服务。

第一次使用

1. 在对话框选择负责规划与验收的主控模型。
2. 打开侧栏“DSH Agentrix”，只需选择执行模型。独立审查自动沿用各次任务分发时记录的主控模型与思考强度。
3. 保存配置，再向主控提出任务。可先在临时项目中执行一个小任务，检查执行、报告、实际验证和验收回执。

侧栏负责配置；输入框上方的紧凑信息条直接显示执行状态。主控处理时并排显示当前动作、实际模型和本轮工具次数；托管计划显示子任务状态、等待数量和验收进度。点击信息条向上打开详情，输入框位置保持稳定。主控详情按“当前执行、执行判断、本次需求”分区，判断理由与完整需求保留全文；发生异常时单独列出记录。面板随聊天区域宽度调整，窄区域自动改为上下排布。再次点击信息条、点外部或按 Esc 收起详情。主控直接执行时也显示进度；系统建议委派但实际直接执行时，会在详情中明确区分。委派工具缺失或插件接口不可用时显示提醒。当前会话的“任务验收”页是本次需求的只读验收档案，把主控判断、任务、验收标准、实际验证和程序回执放在一页；聊天消息旁的进度按钮也可进入该页。这里展示的模型是 DSH 发给服务商的标识；服务商路由组内部的选型以服务商信息为准。

多 Agent 详情按任务使用手风琴展示：收起时可见任务名、状态和当前角色的模型；展开后查看同一任务的执行者、独立审查、当前活动、报告摘要、异常和验收情况。状态条分别显示总任务数、执行数和等待数；有依赖的任务标为“等待前置任务”。默认展开第一项，也可同时展开多项；自动刷新或阶段变化保留当前展开选择。主控判断折叠放在任务清单后方。

“任务验收”页是当前会话的只读验收档案，只展示当前需求，不提供输入框、签收或控制操作。页头给出需求标题、状态徽标、会话与回执元信息，以及回到聊天、查看协作过程、整理与导出等入口；首屏结论卡按状态回答“做完了吗、凭什么、交付在哪”，已完成和部分完成时额外提供“复制结论”。下方四个折叠分别承载任务与证据、主控判断与执行安排、验收回执详情和运行诊断；任务卡按“验收标准 → 实际验证 → 结论”以手风琴展开，默认只展开第一项，轮询刷新不重置用户开合。协作动态置底、默认收起（直接执行态展开），保留成员筛选和“查看更多”。整页共用同一条内容列与一条纵向滚动条；直接执行、尚无需求记录等状态也有各自的结论卡，不再显示“当前没有托管子代理计划”的缺省说明。补充需求仍在 DSH 原对话进行。

每项任务分别展示计划交付文件、执行报告和独立审查报告的位置。聊天中的任务手风琴可直接查看；验收页的结论卡、任务卡与成员视图可复制路径或结论，并区分计划交付、已提交报告和主控已验收。

更新插件后需由宿主重新加载才会生效。请先让已有任务收尾，再按宿主提示更新。

执行规则

auto 模式下，未托管的读取、修改和命令可直接执行，不会因漏记判断而拦截或额外唤醒模型。delegation_decide 用于保留主控的真实判断，页面缺少记录时显示“未记录”，不会代填理由。strict/fixed 仍保留判断和操作额度要求。读取文件、固定目录/Git 检查和专用计划记录不占业务修改额度。

托管计划保护尚未验收任务声明的 writes 范围，主控可直接修改无重叠文件。当前需求存在受保护产物时，任意 shell 无法可靠确定写入范围，仍须使用 delegation_verify 验证、delegation_inspect 检查目录、Git 或 Node/Python/Docker 版本（runtime_versions）；插件不根据命令前缀猜测安全性，也不是文件系统沙箱。托管中的补充用 delegation_control steer 发给原执行者，taskId 不作为原生 Team 成员名使用。原生自动派单继续通过插件入口，保留配置模型和验收要求。

主控需要同时搭建独立应用或执行其他施工命令时，可用 delegation_execute 明确工作目录与 writes，通过原生工具前台执行。声明范围不能与本计划任务重叠；范围声明是协作约定，宿主既有权限继续生效。已关联为“继续”的真实补充消息也能带编号转交给原执行者，不必省略关联来发送。

主控当前阶段改为直接处理独立工作时，原委派计划继续运行并保留验收要求；状态页分别显示当前决定和建计划时的委派依据，不要求取消正常执行的代理。

主控结合上下文判断消息属于新需求、继续、补充或进度询问，并通过 delegation_decide 记录。程序只登记真实消息，不按“还有”“继续”等关键词、字数或分数决定需求归属。新需求或方案变化时，同时记录直接执行或委派及具体理由；继续和进度询问沿用原决定。建计划可一并记录关联与委派理由，不增加分类代理；确认补充信息可能增加一次短工具往返。

状态标签详情与任务验收页显示主控确认的关联、理由和实际活动。多条消息待处理时须引用真实消息编号分别确认；新需求不会自动取消、改写旧任务，另一项直接需求失败也不会停止原执行者。仍有旧计划运行时，新计划不能覆盖它；旧计划验收回执也不会把另一项新需求冒充为完成。auto 普通操作不为缺少关联增加阻断或模型回合，显式模式的补判断提醒仍有次数限制；用户取消优先。历史缺失显示“未记录”。

不再生成关键词难度评分、预计步数、并行数量或固定百分比置信度；历史快照保留。重复同类错误会通知主控处理；长时间没有新活动只作一次调查提醒，正常读取、模型输出和工具活动不会因没有写文件而被终止。最近 8 次活动中，同一操作和参数至少 3 次返回完全相同结果时，每次执行最多通知主控一次，核对这些操作是否仍有价值；这只是调查提醒，不停止、不换代理、不消耗故障纠偏次数。不同文件、片段、结果和修改后的重新测试分别处理；参数或输出不断变化的低价值操作仍需主控结合需求判断。80 次调用与运行时间提醒只显示在页面并记录事件，不唤醒主控、不消耗纠偏次数。输出被截断时在原代理续接，Token 不设插件上限；模型服务自身限制仍由 DSH 管理。主控验证沿用宿主取消信号，插件不再统一附加 60 秒截止时间。默认状态工具只返回摘要，完整报告按任务读取。

同类工作合批，只有独立产出、判断或并行价值才拆分；主控负责整合已有结果，不为转述报告默认另开代理。验收标准围绕用户要求和必要验证，不自行增加问题数量、篇幅或格式门槛。纯修复的派发和复审默认只提供原问题、相关标准、前次报告和本次修复报告；有新增用户要求时完整检查。最终验收仍覆盖全部原标准。完全相同的问题与证据只保留一个编号，不自动合并措辞相近但证据不同的问题。达标后交付，可选建议不继续触发返工。

单个任务失败只影响该任务及其依赖项，无关任务继续执行、排队和验收；模型错配仍会暂停后续派发。聊天详情保留运行任务的名称、当前动作和异常原因，计数使用“已验收”；单个失败不会替换整份进度。WorkBuddy 的明确通道拒绝显示为“本次请求被服务商拒绝”，不代表同模型的其他请求都不可用；处理限制后明确重试失败项，不自动换模型或重复启动。主控无原因调用整计划取消，不会取消或自动重开任务；整计划取消须提供原因并关联本会话新增真实用户消息。宿主中断会保留原计划，用户明确继续后先确认旧执行已释放，再继续未完成部分；已返回报告和已验收结果不重复执行。正常返回的子代理自动释放运行资源，历史子会话保留供回看。

stop 表示取消，必须说明原因。全部任务通过实际验收后生成本计划回执；多功能交付用固定编号的原需求清单逐项核对，未登记完整清单时明确显示“当前计划已验收，完整需求待核对”。静态读取不能代替实际运行证据，部分实现或未验证不能验收，验证后的声明产物发生变化须重新核对。失败、阻塞和取消列出未完成项。遗漏报告或验收时有次数有限的补流程提醒，用户取消后不会自动恢复。

整计划取消会先通知全部活动执行者和审查者停止，再分别清理资源。一项清理出错不会漏停其他代理；尚未确认释放时显示“取消已请求，资源清理未完成”，保留原错误和已验收成果。处理原因后主控可重复调用取消入口补清理，不需要再次输入取消消息，也不会重开代理。清理未确认前不能覆盖旧计划。

验收完成后，插件先把结论和文件入口展示在聊天里，再结束回合。用户要求直接看文章或报告时，主控可在验收中指定交付文件，正文直接展开，无需再让模型生成一次总结。发送失败保留验收结果，继续同一会话只补发；新交付记录按原回复保存，不会混入后续需求。

模型生成的托管工具参数若不是合法 JSON，插件会在执行前把解析位置和附近片段反馈给原模型，原回合最多自动修正两次。次数持久化，查询状态或重载不会清零；不猜补参数、不换模型、不新开代理。语法修正成功后仍走原有权限、派发和验收检查，服务错误不按参数错误重试。

主控通过 delegation_models 查询托管执行和审查模型，查询与派发共用授权及解析检查，避免原生模型名单与实际托管配置互相矛盾。已记录的会话白名单仍会在启动前检查；没有白名单时使用用户保存的托管配置并标明来源。切换配置只影响后续启动，运行任务保留原模型快照；“检查通过”和“实际请求成功”分别记录。多条继续消息处理完才恢复原计划，旧 direct 判断可在 continue 中给出委派理由修正，不必重建任务卡。

主控直接执行时，文件修改工具失败会留下未完成记录。成功读取文件或生成另一份文件不会清除该记录；原主控结束前最多收到一次补救提醒，成功修改同一目标后清除。仍未修复时保留“修改未完成”提示，不无限续跑。直接执行的进度不属于托管验收回执，也不能证明内容已满足全部要求。

数据和边界

配置与任务记录保存在当前 DSH Home 的 delegation-first/ 目录，按 Profile 区分。记录包含真实消息、需求关联、任务说明、报告、验证证据和模型标识；公开问题报告前请检查其中的项目内容。判定前的主控用量暂存，确认关联后归入对应需求，重载后保留。插件没有独立的云同步或模型服务，子代理请求通过 DSH 已配置的服务发送。

运行状态较小时沿用 .runs.json 的 v1 单文件；超过 8 MiB 后使用 v2 清单，完整会话分片保存在 .runs.json.state/。保存失败保留已提交版本，备份需同时保留清单和分片目录。旧的大文件可直接恢复，不再因超过 16 MiB 拒绝读取，也不再仅恢复最近 100 个会话的判断记录。

补充消息按原文保存和转发，不在 4000 字处截断；模型默认收到摘要，可用 delegation_status({messageId,detail:'full'}) 读取本会话原文。验收准备保存失败会清除临时确认锁，恢复存储后可再次验收。旧子代理清理失败时禁止替代执行，明确清理成功后才能重试。

需求详情显示当前进程的执行策略及运行标识；coordinationPolicyVersion:7 与 executionPolicyVersion:1 表示已加载本轮策略，源码更新不代表当前进程已生效。运行标识用于区分加载逻辑，不是 Git 提交号或安装包校验值。等待宿主自然重载，不打断已有任务。

任务修改范围用于调度与冲突检查，不是文件系统沙箱。子工程派单用 delegation_plan.directory 指定工程根目录，相对产物、保护路径、子代理工作目录和主控检查按同一目录解析；省略时沿用父会话目录。存在相对产物但检查 workdir 指向其他目录时，必须先明确 directory，避免保护和交付指向错误位置。已有计划不会因源码更新而自动更换目录。

执行模型的能力和价格由用户选择；插件不根据名称猜测能力，也不静默替换不可用模型。配置检查不发送生成请求，不能预先判断服务商额度或网络状态。

详细工具、状态、报告、验收与 HTTP 接口见 使用约定。

开发和验证

使用 Node.js 22.3 或更高版本。安装版契约当前核对的宿主版本为 DSH Desktop 0.2.2-rc.1，尚未验证其他版本：

npm test
npm run check
npm pack --dry-run

单元测试包含打包文件范围检查。安装版契约脚本需要本机 DSH，并使用其 Electron 的 Node 模式和 DSH_MODULE_ROOT：

• tests/native-contract.mjs：真实 Cordis、ToolRuntime 和 LlmRuntime，子代理使用替身。
• tests/native-lifecycle.mjs：真实 AgentLoop、ToolRuntime 和 SubagentRuntime，外部模型使用脚本化适配器。
• tests/native-reliability.mjs：上述原生运行时的直接执行、跨需求失败隔离和验收保存失败恢复回放，分别使用 direct、separate-error、acceptance-save 参数。
• tests/native-reliability.mjs cancel-cleanup：两个原生子代理运行中注入释放与备用清理故障，核对全部收到取消、原任务可补清理且没有替代启动。
• tests/native-reliability.mjs delivery-persistence：原生交付记录实际写入 JSONL，关闭后从同一目录恢复，核对交付仅保存一次且不新增模型请求。
• tests/native-reliability.mjs project-directory：父会话位于上层目录时，在指定子工程派单，使用安装版原生 PowerShell 实际读取产物，核对保护、验证和最终交付路径一致，执行者不显示被禁止的普通消息入口。
• tests/package-upgrade.mjs <基线提交>：临时目录内安装基线 tgz、升级当前 tgz、回退基线，校验全部安装文件并对实际安装包运行原生回放；需设置 DSH_EXECUTABLE 和 DSH_MODULE_ROOT。此项不操作真实 Profile，也不代替真实服务商验证。
• node tests/state-upgrade.mjs：使用旧版与当前编排模块，在同一隔离目录验证 v1 到 v2 迁移、长原文和多会话保留、分片损坏保护、完整备份恢复及旧代码配合升级前备份回退。数据全部为测试生成，不读取真实历史会话。
• tests/live-acceptance.mjs <场景>：用安装版运行时和真实模型自行完成任务。场景包括 direct、auto-simple、auto-followup、auto-readonly、parallel-supplement、failure-recovery、rework、cancel-resume，分别检查小改、连续调整、只读答复、并行补充、失败恢复、独立审查与返工、取消后同目录重载恢复。任务给模型自然语言需求，工具调用顺序由模型决定。

真实模型测试会产生服务调用，默认 npm test 不运行它。需显式设置 AGENTRIX_PROVIDER、AGENTRIX_COORDINATOR_MODEL、AGENTRIX_WORKER_MODEL 和 DSH_MODULE_ROOT，通过安装版 Electron 的 Node 模式运行。可选 AGENTRIX_WORKER_EFFORT、AGENTRIX_LIVE_BASE_URL、AGENTRIX_LIVE_RESULT 分别指定执行模型思考强度、兼容服务地址和本地证据文件。测试从现有 desktop Profile 读取 pi-ai 提供方及凭据引用，凭据通过内存传给适配器；不复制凭据文件。文件工具只访问合成工作目录、该测试的报告和本包技能；PowerShell 仅放行已审核的固定只读命令，不提供任意脚本能力。测试采用 DSH 原生有限重试，关闭或持久化失败时测试失败。服务商限流与流程判断问题分别记录。

安装包演练验证安装文件，同目录数据迁移和恢复由 state-upgrade.mjs 单独验证。升级前应停止相关 Profile 的写入并备份其完整任务目录，包括运行清单、.state/ 分片、档案与验证输出；业务交付文件按项目自己的备份方式保留。回退旧代码时恢复升级前备份，不能让旧读取器直接读取 v2 清单。已经被旧版本截断的原文无法由升级重建。

脚本化原生回放、合成数据迁移、真实模型流程分别提供证据，不能互相替代。真实模型测试也不代表业务项目验收或桌面界面端到端验证。tests/ui-preview.mjs 使用隔离演示数据展示页面，不连接真实 DSH 或写入用户配置。

安装包只包含运行文件、说明、技能和展示素材；测试与本机开发记录不进入安装包。

界面演示

以下为隔离测试数据，不代表真实会话或真实模型服务结果。

许可证

MIT，署名 991206772-debug。