DeepSeek Harness 插件

991206772-debug/dsh-agentrix

分类 工作流与自动化 收录于 2026-11-10

DSH Agentrix 提供多 Agent 编排与验收,主控拆分任务,子代理按角色模型执行和审查,展示进度并保留验证证据。目前仅在 Windows + PowerShell 7(pwsh)+ Git 环境验证,其他系统未验证。

安装

# Release 预构建包

dsh plugin --profile web add "https://github.com/991206772-debug/dsh-agentrix/releases/download/v1.7.3/dsh-agentrix.tgz"

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:991206772-debug/dsh-agentrix

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

多 Agent 编排与验收。

让主 Agent 负责拆分任务、监督和验收,让子 Agent 按配置的模型执行。

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

当前源码将自动分流交给主控判断:小任务直接完成,需要较多执行工作时委派,复杂任务保留独立审查。模型调用达到 80 次及运行时间达到配置值时仅提醒,不终止、不更换代理。已有模型、并发、返工与启动次数设置继续保留。

模型怎么分工

角色 模型来源 工作
主控 当前对话框选择的模型 理解需求、拆分、监督、执行验证并最终验收
执行者 插件配置的 worker 按任务卡完成具体工作
独立审查者 自动沿用该次任务分发时的主控模型与思考强度 独立上下文,只读检查需求和交付质量

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

普通任务由主控验证,也可以请求独立审查;复杂任务自动安排独立审查。复杂度不会自动切换执行模型。执行模型未配置时暂停派发;每个任务启动后固定模型快照,后续修改配置只影响新任务。

安装

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

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

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

命令行版在自己的 Profile 中安装,命令格式为:

dsh plugin --profile <Profile名称> add <GitHub仓库地址或tgz文件路径>

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

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

第一次使用

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

侧栏负责配置;执行过程中,对话输入框上方持续显示当前任务和工具进度。当前会话的“任务验收”页显示需求、任务、所用模型、验证证据和未完成原因;聊天消息旁的进度按钮也可进入该页。这里展示的模型是 DSH 发给服务商的标识;服务商路由组内部的选型以服务商信息为准。

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

执行规则

设置 默认值
委派策略 自动;也可选择严格、固定预算或关闭
主控业务操作预算 2
共享并发上限 4,支持 1–8
单任务最多执行次数 5,支持 1–10;包含首次执行
单计划启动尝试次数 64,支持 1–256;包含执行、返工和独立审查
运行时间提醒 120 分钟,支持 1–240;仅提醒,不停止

读取文件、固定目录/Git 检查和专用计划记录不占业务修改额度。存在待验收的托管计划时,主控通过专用验证入口检查交付物。

自动模式的评分、文件数与操作次数只提供建议,不强制委派。重复同类错误会通知主控处理;长时间没有新活动只作一次调查提醒,正常读取、模型输出和工具活动不会因没有写文件而被终止。80 次调用与运行时间提醒只显示在页面并记录事件,不唤醒主控、不消耗纠偏次数。输出被截断时在原代理续接,Token 不设插件上限;模型服务自身限制仍由 DSH 管理。默认状态工具只返回摘要,完整报告按任务读取。

任务失败会暂停后续派发,已在运行的任务继续收尾。失败或超时后主控无原因调用整计划取消时,插件会在执行次数仍有额度的情况下沿用原计划自动恢复,不要求新建计划;用户明确取消必须传原因。正常返回的子代理自动释放运行资源,历史子会话保留供回看。

stop 表示取消,必须说明原因。只有全部任务通过实际验收才生成完成回执;失败、阻塞和取消会列出未完成项。遗漏报告或验收时有次数有限的补流程提醒,用户取消后不会自动恢复。

数据和边界

配置与任务记录保存在当前 DSH Home 的 delegation-first/ 目录,按 Profile 区分。记录包含需求、任务说明、报告、验证证据和模型标识;公开问题报告前请检查其中的项目内容。插件没有独立的云同步或模型服务,子代理请求通过 DSH 已配置的服务发送。

任务修改范围用于调度与冲突检查,不是文件系统沙箱。执行模型的能力和价格由用户选择;插件不根据名称猜测能力,也不静默替换不可用模型。配置检查不发送生成请求,不能预先判断服务商额度或网络状态。

详细工具、状态、报告、验收与 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/ui-preview.mjs 使用隔离演示数据展示页面,不连接真实 DSH 或写入用户配置。

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

界面演示

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

模型配置示意(旧版截图,现版审查自动沿用分发者)

当前会话的任务进度与验收

许可证

MIT,署名 991206772-debug。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。