Skip to content
Back to search

dsh-acp-resume

Resumable ACP subagent backend for DeepSeek Harness — persistent chat pool with session/load reconnect & mid-turn steering. Tested with kiro-cli.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tureen--dsh-acp-resume/badge.svg)](/listings/tureen--dsh-acp-resume)

HTML

<a href="/listings/tureen--dsh-acp-resume"><img src="/api/listings/tureen--dsh-acp-resume/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

需要 DSH `>=0.2.2-rc.3`、Node.js 24 或更高版本。使用默认后端时,请先安装 `kiro-cli`,确保 DSH 能在 `PATH` 中找到它。

从 npm 安装到你的 DSH profile,将 `<name>` 换成实际名称,安装后重启 DSH:

dsh plugin --profile <name> add dsh-acp-resume

升级时在包名后追加 `@<版本>`。如果刚发布的版本被 `minimumReleaseAge` 过滤,也可以这样指定版本安装。桌面 App 可从 Discover 安装,离线环境可从本地 tgz 安装。[市场详情与安装步骤](docs/detail.zh.md#安装)

> ⚠️ **不要从 GitHub 地址安装。** 仓库不含构建产物,也没有安装时编译的 `prepare` 脚本,直接安装会因缺少 `lib/index.js` 加载失败。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 147 lines
  1. # dsh-acp-resume
  2. [English](README.en.md)
  3. ## 为什么需要这个插件
  4. ### Resume · 让同一个子代理记得上轮工作
  5. DeepSeek Harness(DSH)官方的 ACP 后端采用一次性委派,每次都从新会话开始,追问上轮审核的第二条发现也得重新交代背景。Resume 保留同一个子代理会话,你只需说“再查一下第二条”,它就能沿用读过的代码、找到的证据和之前的判断。插件可与官方后端并用,持久会话池会复用进程并保存远端会话号,进程退出或空闲释放后,下次发送仍会尝试恢复原会话。
  6. ### ACP Dispatcher · 在一个对话窗口调度多个子代理
  7. 插件让所有模式都能使用 ACP 工具,ACP Dispatcher 则是可选的纯派工预设。在这个模式下,主 Agent 没有 bash 和文件操作工具,它在一个对话窗口里拆任务、分派给各个 ACP 会话执行,再收回结果。你可以让 kiro 写代码,同时让 Codex 推演边界条件,也可以让两个引擎独立核查同一结论,或把长任务交给子代理,在原窗口跟进。
  8. ### ACP Workflow · 把反复使用的协作步骤写成模板
  9. 如果每次审核都需要两人独立检查、再由一人汇总,可以在工作区的 `.agents/acp-team.yml` 里写好角色蓝图和流程模板。启用工作流后,模型只需调用一次 `acp_workflow`,执行器就按模板先让两个审核角色并行检查,再把结果交给汇总角色。下次审核可复用同一模板,步骤顺序、并行分工和合并方式都由配置确定,模型无需临场记住并派发每一步。
  10. ## 安装
  11. 需要 DSH `>=0.2.2-rc.3`、Node.js 24 或更高版本。使用默认后端时,请先安装 `kiro-cli`,确保 DSH 能在 `PATH` 中找到它。
  12. 从 npm 安装到你的 DSH profile,将 `<name>` 换成实际名称,安装后重启 DSH:
  13. ```sh
  14. dsh plugin --profile <name> add dsh-acp-resume
  15. ```
  16. 升级时在包名后追加 `@<版本>`。如果刚发布的版本被 `minimumReleaseAge` 过滤,也可以这样指定版本安装。桌面 App 可从 Discover 安装,离线环境可从本地 tgz 安装。[市场详情与安装步骤](docs/detail.zh.md#安装)
  17. > ⚠️ **不要从 GitHub 地址安装。** 仓库不含构建产物,也没有安装时编译的 `prepare` 脚本,直接安装会因缺少 `lib/index.js` 加载失败。
  18. ## 选择后端
  19. <a id="配置"></a><a id="后端支持等级"></a>
  20. | 后端 | 支持能力 |
  21. | --- | --- |
  22. | **kiro-cli**(默认) | 自带配置使用 `kiro-cli acp` 和 v3 引擎,支持跨进程恢复会话和在当前轮插话。 |
  23. | **Antigravity**(agy) | 通过 `agy acp` 接入,支持恢复会话和按会话选择模型,推理强度由模型 ID 决定。 |
  24. | **Codex** | 通过私有 `codex app-server` 协议恢复会话、插话并逐项审批,只能配置为命名后端。 |
  25. ### 只用一个后端
  26. 使用 kiro 时,确保 DSH 能从 `PATH` 找到 `kiro-cli`,即可直接快速上手。要换成 agy,在 profile 的 `cordis.patch.yml` 中按同一插件 id 覆盖顶层 `command` 和 `args`,并设 `agentEngine: none` 关闭 kiro 专用的启动参数:
  27. ```yaml
  28. - id: subagent-acp-resume
  29. name: dsh-acp-resume
  30. config:
  31. command: agy
  32. args: [acp]
  33. agentEngine: none
  34. ```
  35. 重启 DSH 后,模型新建会话时就会使用 agy。要固定模型,kiro v3 和 agy 都需同时设置 `modelSelect: session` 和 `model`,并省略 `effort`。只使用 Codex 时也需按下节将其注册为命名后端,建会话时指定 `backend: codex`。
  36. ### 让模型在多个后端中选择
  37. 要用 kiro 作为默认后端、Codex 作为备选,在同一处使用下面这份配置。顶层字段定义默认后端,`backends` 下的键是模型可选择的名称。把 `model` 换成你账号在 Codex `model/list` 中可用的 ID。
  38. ```yaml
  39. - id: subagent-acp-resume
  40. name: dsh-acp-resume
  41. config:
  42. command: kiro-cli
  43. args: [acp]
  44. backends:
  45. codex:
  46. protocol: codex
  47. command: codex
  48. model: gpt-6.2-astra
  49. effort: high
  50. sandbox: read-only
  51. approvalPolicy: on-request
  52. permission: ask
  53. ```
  54. 重启 DSH 后,`acp_chat_start` 会列出可选后端。模型传入工作目录的绝对路径 `cwd`,省略 `backend` 即用 kiro,指定 `backend: codex` 即用 Codex。侧栏徽标显示每个会话的后端;之后用同一个 `chatId` 续聊即可。
  55. Codex 的 `effort` 设置每轮推理强度,`sandbox` 可选 `read-only`(默认)、`workspace-write` 或 `danger-full-access`。`approvalPolicy` 决定 Codex 何时请求审批,各后端的 `permission` 决定如何答复,可选 `allow` 自动允许、`reject` 拒绝或 `ask` 逐次询问。自带配置为默认后端设置了 `allow`,命名后端省略此字段时使用 `reject`。
  56. ## 快速上手
  57. 在有工作目录的 DSH 会话里,依次发两条消息。等第一轮回答后再发第二条:
  58. 1. “请用 ACP 子代理阅读当前项目的 README,指出新用户最容易卡住的一步。”
  59. 2. “请让刚才那个子代理针对这一步写一段更清楚的说明。”
  60. 第一条消息会让模型用 `acp_chat_start` 建立会话,拿到 `chatId` 后用 `acp_chat_send` 派任务。第二条消息复用同一个 `chatId`。打开右侧栏的 **ACP 会话**,点进对应条目,就能看到同一会话里的两轮问答。
  61. ### 在面板里跟进任务
  62. - **看进度。** 列表显示当前 DSH 会话创建的子代理会话。旋转圆环表示运行中,旁边显示已用时长。绿点表示最近一轮正常完成,红点表示出错或重连失败,橙点提示已换用新会话。灰色实点表示空闲,灰色空心点表示进程已释放。点开条目可读每轮问答和重连记录。
  63. - **释放或删除。** 释放会保留记录,下次发送时自动重连。若子代理正忙,面板会先请你确认,因为释放会中止当前轮。删除会同时清除本地会话记录和轮次日志。
  64. - **看 Codex 额度。** 配置 Codex 后,面板顶部会显示各 Codex 后端在最紧限额窗口中的剩余百分比,悬停可看窗口和重置时间。模型也可用只读工具 `acp_backend_usage` 查询套餐、已用比例和重置时间。成功结果缓存 5 分钟,`refresh: true` 可强制刷新(D28)。
  65. ## 进阶使用
  66. ### ACP Dispatcher 模式
  67. 启用 bundle 并重启 DSH,在**新会话的模式菜单**选择 **ACP Dispatcher**。主 Agent 可用 ACP 工具派工、用 web 轻量查证、用 jobs 跟踪任务;它没有 bash 或文件工具,命令执行和文件操作都通过 `acp_chat_send` 派给子代理。任务完成后,主 Agent 收到通知,用 `job_output` 取回结果。适合在一个窗口并行分工、让两个引擎交叉审核,或跟进耗时任务;标准模式同样能用 ACP 工具(D26)。
  68. ### ACP Workflow · 按工作区模板派工
  69. 在插件的顶层 `config` 中设置 `workflow: true` 并重启 DSH,再将以下内容保存为工作区根目录下的 `.agents/acp-team.yml`。两位审核员使用默认后端、各自独立审查,最后把结果交给主模型。要让某个角色改用已配置的 Codex,可在它的蓝图中添加 `backend: codex`。[更多模板,包括由编辑角色汇总的示例](docs/acp-team.example.yml)
  70. ```yaml
  71. roles:
  72. - { name: reviewerA, cwd: ., seeding: "Review for correctness." }
  73. - { name: reviewerB, cwd: ., seeding: "Review for maintainability." }
  74. templates:
  75. - name: dual_review
  76. params: [target]
  77. steps:
  78. - { id: review, parallel: [reviewerA, reviewerB], prompt: "Review {target}." }
  79. - { id: collect, merge: { mode: return_to_model } }
  80. ```
  81. **运行。** 在主对话里说“用 `dual_review` 审核 `src/pool.ts`”,模型会调用 `acp_workflow({ template: "dual_review", params: { target: "src/pool.ts" } })`。本会话首次用到某角色时,插件按蓝图建 chat、先发 `seeding` 交代职责,再登记到花名册并派发审核任务。对话中的进度卡片显示各步骤和成员状态,侧栏**工作流**区块可查看当前步骤及最近五次结束的运行。
  82. | 对象 | 作用域 | 记录什么 |
  83. | --- | --- | --- |
  84. | 流程模板 `templates` | 工作区,同一工作区的会话共享 | 角色怎么协作,包括步骤顺序、并行成员和合并方式。 |
  85. | 角色蓝图 `roles` | 工作区,同一工作区的会话共享 | 角色是谁,包括后端 `backend`、工作目录 `cwd` 和首次派工前发送的 `seeding`。 |
  86. | 花名册实例(roster) | DSH 主会话,每个会话独立 | 插件按 `ownerSessionId` 记录本会话的角色名与 `chatId` 的绑定。 |
  87. 例如,同一工作区的主会话 1 和 2 都运行 `dual_review`,读取同一份模板和角色蓝图。审核员 A(`reviewerA`)在两份花名册中绑定的是两个不同的 chat;在会话 1 用 `acp_chat_send` 指定 `role: reviewerA` 追问,只会续上会话 1 的审核。修改蓝图后,可在当前会话用 `acp_chat_close` 按角色解除绑定,下次派工时按新蓝图创建(D27)。
  88. ## 参考
  89. ### 模型工具
  90. | 工具 | 何时使用 |
  91. | --- | --- |
  92. | `acp_chat_start` | 建立持久会话,返回 `chatId`。配置多个后端后可指定 `backend`。 |
  93. | `acp_chat_send` | 开始下一轮,自动按需重连。同一会话一次只执行一轮,忙时再次发送会报错。 |
  94. | `acp_chat_list` | 找回当前 DSH 会话创建的子代理,包括已释放的会话。 |
  95. | `acp_chat_steer` | 给正在执行的一轮补充指令。后端不支持插话时会返回提示。 |
  96. | `acp_chat_close` | 释放进程以便稍后重连,或用 `purge` 删除本地记录。kiro 远端记录可用 `kiro-cli chat --list-sessions` 查看,用 `--delete-session` 清理。 |
  97. | `acp_workflow` | 开启 `workflow` 后,按模板名和参数执行多角色工作流。 |
  98. **后台任务。** 宿主同时装有 `dsh-jobs-local` 和 `dsh-tool-jobs` 时,发送和工作流会立即返回 `jobId`。模型收到完成通知后用 `job_output` 读取结果,运行中可用 `job_kill` 停止。默认拦截对运行中 ACP 任务的阻塞等待。没有 jobs 服务时同步返回结果,仅有任务注册表而缺少控制器时会报错(D17、D22)。
  99. **会话恢复。** 插件默认在空闲 10 分钟后释放进程。远端会话明确丢失、后端未声明加载能力,或同一池实例中该会话连续三轮出错后再次发送时,会新开会话并提示补充上下文。原因不明的加载失败会保留原绑定并报错。注册表默认位于 `$DSH_HOME/storages/acp-resume/registry.json`,旁边的 `turns/<chatId>.jsonl` 以明文保存最近 200 条轮次记录。[恢复与日志决策(D6、D18)](DECISIONS.md)
  100. **开发与验证。** 运行 `pnpm install`、`pnpm build`、`pnpm test`。缺少官方源码 checkout 时,24 个真实子进程用例会按 D8 跳过。kiro 已验证进程终止后恢复上下文,完整真机冒烟流程仍待走完。Codex 适配已通过 mock 回归,真机联调仍待验证。[架构设计](DESIGN.md) · [验收进度](IMPLEMENTATION-PLAN.md) · [MIT 许可证](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.