dsh-superagent-ptc
Manifest valid★ 4SuperAgent PTC: long-task supervision for DeepSeek Harness - anchors, bounded delegation, independent reviewer, evidence-gated release
SuperAgent PTC
DeepSeek Harness 的长任务监督层——版本化锚点、有界委派、独立验收、证据放行。
SuperAgent PTC 把“模型说自己做完了”变成“独立验收者证明它做完了”。它是 preset-first 插件:在原生 PTC / Agent / Goal / Teams 运行时之上叠加一层监管,不另造 Agent loop、任务板或路由器。
你:把这份调研拆成三项工作,逐个验收后再写总结
PTC:Run + Anchor → 逐项 Mandate 派给 Worker → standard Reviewer 独立核验
→ 证据通过才放行 → super_snapshot 返回可验证的 revision 与 proof

目录
为什么需要它
长任务失败通常不是“模型不会写”,而是四件事没有被约束:
| 常见问题 | 后果 | SuperAgent PTC 的做法 |
|---|---|---|
| 目标在长对话里漂移 | 做到一半换了题目 | 版本化 Anchor:目标、完成定义与义务都有版本,纠正会显式失效旧工作 |
| 模型自报完成 | “done” 却没有验证 | reported_done ≠ accepted,必须先过独立 Reviewer 与证据门 |
| 委派没有边界 | Worker 越权或重复劳动 | Mandate 委派合同:工作项、写域、模型路由与 attempt 在 prepare 时冻结 |
| 崩溃后状态不明 | 不知道哪里可信 | SnapshotProof + RunState v2:先写原生证明,再落存储,最后替换 live core |
特性
- Preset-first:与标准、创造、PTC、极简并列的一个 Agent 预设(
SuperAgent PTC),不改默认模型、权限或其他会话。 - 七项监管工具:
super_run、super_anchor、super_mandate、super_evidence、super_review、super_route、super_snapshot,全部通过 PTC 的run_code调用,不新增脚本工具。 - 原生身份绑定:Worker 与 Reviewer 都是真实原生子 Agent;Host 用原生
sendMessage唤醒绑定的 Reviewer,Lead 无法自己扮演验收者。 - 独立只读验收:Reviewer 必须使用原生
standard预设;守卫对写操作与未知 shell 一律 fail-closed,pwsh的只读命令(含读取$env:)按实际参数分类。 - 分型证据门:证据只有
pass / fail / unknown三态;unknown不放行;构建日志、单测与截图不能替代运行时证据。 - 失败预算与可恢复审计:同一指纹达到预算即阻塞;
super_run recover增加 generation 并保留完整审计链。 - 客户端可视化:右栏监管面板与 composer 入口,只读投影。
- 零全局副作用:普通会话没有
super_*工具、没有提示词段落、没有面板。
明确不做什么
| 不做 | 原因 |
|---|---|
| 不重建 Agent loop、任务板或全局路由 | 原生 Session、Agent、Goal、Teams 才是执行权威 |
| 不提供操作系统级文件权限沙箱 | 写域是协作契约,不是内核隔离 |
| 不做自动模型降级 | 只支持显式、白名单、预算内的有界故障切换 |
不把 reported_done 当作验收 | 只有独立 Reviewer 加证据门才产生 accepted |
双层架构
一句话定位:SuperAgent PTC 在宿主原生 Agent/Session 机制之上叠加一层监管状态机(Run → Anchor → Mandate → Evidence → Decision),把原生 agent 会话按角色(Lead / Worker / Reviewer)绑定进这条监管链;PTC 的原生事件链(run_code 调用与工具回执)是整条链的证据底座——监管层自己不产生第二套事件流。
监管面(Control Plane)只回答“能不能放行”,执行面(Execution Plane)只回答“实际做了什么”,两者之间只有一条契约膜:super_* 工具是状态与证据的唯一写入口。

- A 监督面:Lead 维护 Anchor 与义务账本;Mandate 冻结工作项、写域、路由与 attempt;证据门与预算决定放行。
- 契约膜:任何状态变更都必须穿过
super_*的 CAS 校验,双层之间没有第二套写路径。 - B 执行面:PTC
run_code编排宿主工具、原生subagent创建 Worker 与 Reviewer,回执以reported_done与工具结果的形式返回。 - 共同底座:原生运行时提供身份、生命周期与证明;
storageDomain RunState v2与SnapshotProof让 Run 可恢复。
监督循环

super_run create # 目标 + 完成定义 + 门禁策略
super_run plan # 工作项 / 依赖 / 义务(开放账本)
super_anchor # 版本化锚点;纠正会失效受影响的工作
super_mandate prepare # 冻结工作项、写域、模型路由、attempt
super_mandate bind # 绑定原生 Worker 的 SessionId
super_mandate bindReviewer # 绑定 standard Reviewer 并由 Host 原生唤醒
super_evidence record # 分型、可追溯的证据
super_review evaluate # 门禁评估
super_review decide/release # 门禁通过才放行
super_snapshot # 只读核对 revision / generation / proof
安装
要求 DSH >=0.2.2-rc.3 <0.3.0-0,Node ^22.19.0 || >=24。
# 从 npm 安装到当前 profile
dsh plugin --profile desktop add dsh-superagent-ptc
安装后完全退出并重新启动 DSH,然后新建会话,在预设选择器中选择 SuperAgent PTC。
通过 DSH 插件市场索引安装
在 DSH → 设置 → 插件 → 发现 中添加下面的索引 URL,然后搜索 SuperAgent PTC:
https://raw.githubusercontent.com/BioAIEvolu/dsh-superagent-ptc/main/market-index.json
该索引已通过官方 parseMarketIndex 校验,解析为当前 npm 发布版本(与上方 npm 徽章一致)。
本地开发安装
git clone https://github.com/BioAIEvolu/dsh-superagent-ptc.git
dsh plugin --profile desktop add link:/absolute/path/to/dsh-superagent-ptc
快速上手
- 新建会话,选择 SuperAgent PTC 预设。
- 把目标与完成标准说清楚,例如:
用 SuperAgent PTC 做最小监管闭环:
super_run create 建 Run;plan 两个工作项,W1 读 README 并给 3 条要点,W2 依赖 W1 本阶段保持 held;
Worker 继承 super-agent,Reviewer 使用 agent_preset=standard;
prepare/bind/bindReviewer 后由 Reviewer 独立记录 coverage 证据并 evaluate/decide/release;
最后 super_snapshot 报告真实 Run/WorkItem/Mandate/Evidence/Decision ID 与 revision/generation/proof。
- 点击 composer 上方的 Super Agent 监管,右栏会显示实时 Run 与审计时间线。
工具
| 工具 | 动作 | 说明 |
|---|---|---|
super_run | create plan show recover complete | Run 生命周期;recover 增加 generation 并重新对账 |
super_anchor | show apply history | 版本化锚点;纠正会显式失效受影响的工作 |
super_mandate | prepare bind bindReviewer report show | 委派合同与原生 SessionId 绑定 |
super_evidence | record observe list | 分型证据,带写域与来源角色校验 |
super_review | evaluate decide release | 独立验收与放行 |
super_route | show set inspect switch | 当前 Run 的模型策略与有界故障切换 |
super_snapshot | {} | 只读核对 Run / 门禁 / proof / recovery |
每个写动作都带 expectedRevision 与 expectedGeneration;冲突会被拒绝,而不是静默覆盖。
右栏面板

- 面板是只读投影:目标/Anchor、模型策略与路由审计、工作项、Mandate、证据与门禁、审计时间线、议程与 attempt。
- 面板不写状态;只有
super_*工具能穿过 Host 的 CAS 校验修改状态。 - composer 入口不阻塞输入,普通会话看不到它。
证据门与边界
| 规则 | 行为 |
|---|---|
| 证据三态 | 只有 pass 可能放行;fail 阻塞;unknown 绝不当作成功 |
| 来源角色 | 证据必须来自允许的角色与写域;跨项复用的证据会被标为 stale |
| Reviewer 只读 | 写操作、未知 shell、提权指令一律 fail-closed;只读命令按参数分类 |
| 提交顺序 | SnapshotProof → storageDomain → live core;任一步失败即中止 |
| 恢复 | recover 增加 generation,旧证据不复用;只有 root Lead 能处理 quarantine |
| 沙箱范围 | 本插件不提供操作系统级文件沙箱;写域是协作契约 |
| 信任边界 | SnapshotProof 依赖原生会话日志,不防御恶意宿主或直接篡改日志 |
兼容性
| 项 | 值 |
|---|---|
| DSH | >=0.2.2-rc.3 <0.3.0-0(开发基线 0.2.2-rc.5) |
| Node | `^22.19.0 |
| 宿主 peer | dsh-session、dsh-storage-domain、dsh-tools、react |
| 客户端 | web surface;@deepseek-ai/dsh-client-connection、ui-conversation、ui-sidebar-right、ui-subagent |
验证
- 自动化:176 / 176 通过;
typecheck与build均退出码 0。 - 真实桌面运行:两个独立 Electron 会话完成监督闭环,包含跨代恢复、多次 Anchor 修订、独立 Reviewer 放行与 SnapshotProof 对齐。
- 修复记录:Reviewer 只读守卫曾把
pwsh "$env:NAME"判为写操作,现按参数分类并带回归测试。 - 细节见 docs/VALIDATION.md。
已知未知
- 真实 provider 故障切换、预算耗尽阻塞、
model.select失败分支从未在实机发生,保持 unknown。 - 不提供操作系统级文件沙箱,除会话隔离外没有额外安全边界。
常见问题
选了预设但没有 super_* 工具?
只有 super-agent 会话与已验证的只读 Reviewer 才有工具。确认预设确实切换,并完全重启 DSH。
Reviewer 一直无法 decide?
看门禁返回:missingEvidence / staleEvidence 需要补新证据;REVIEWER_NOT_READONLY 说明 Reviewer 产生过写回执,需要换一个全新的只读 Reviewer。
崩溃后怎么恢复?
root Lead 调用 super_run recover;generation 会增加,旧证据不复用,必须在新 generation 重新取证。
能当全局路由或自动降级用吗?
不能。super_route 只管理当前 Run 的显式策略,没有开箱即用的全局自动路由。
开发
pnpm install
pnpm typecheck && pnpm build && pnpm test
- 目录:
src/core(纯状态机,无 Host 依赖)、src/host(工具、守卫、路由、存储)、src/client(面板与入口)、test/。 - 保持
typecheck、build、test全绿;核心状态机改动需要正反例。 - Issue 与 PR:https://github.com/BioAIEvolu/dsh-superagent-ptc/issues
致谢
这个插件不是凭空想出来的,来自 2026-11-17 一次真实的群聊讨论与源码分享:
- 群友 CC:分享了
dsh-plugin-antidrift插件源码与真实长任务经验(用/goal设置长期目标、单次跑过 30+ 小时、一次开 10 个 agent 并行写)。本项目只做源码取证阅读(未安装、未运行、未复制代码),其“锚点 + 委派 + 审计”思路是重要早期启发。 - 桉:提出“一次性部署多条指令、每几条插入一次小审计、不紧急就继续”,直接对应本项目的工作项 / 证据门 / 失败预算取舍。
- Electron:把这种形态认作 PTC 的延伸,促使我们确认“PTC 只有
run_code,监管必须建立在原生事件链上”。 - KOLA 2:提出定时轮询检查进度、完成即释放下一条命令与审计,以及“主 router 控制 worker”的 SuperAgent 思路,分别影响了 Mandate 的解锁语义与 Lead/Worker/Reviewer 角色划分。
同时感谢上游参考 zouyuanqing/dsh-super-ptc-mode(MIT):参考了其轻量 preset 组合与 Lead 委派理念,persona 与组合已按当前 DSH 契约重写,许可与出处保留在 NOTICE.md。
也感谢群里持续讨论、提问与纠正的每个人——这些对话让“证据放行”从一句口号变成了可验证的状态机。
许可
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.0.0-stage | — | — |
| 0.1.0 | — | — |
| 0.1.1 | — | — |
| 0.1.2 | — | — |
| 0.1.3 | — | — |
| 0.1.4 | — | — |
| 0.1.5 | — | — |
| 0.1.6 | — | — |
| 0.1.7 | — | — |
| 0.1.8 | — | — |
Comments
Loading…
Similar plugins
by lishize20040802-rgb
Deep PTC agent preset for DeepSeek Harness: built-in PTC tooling plus visible progress, confident tool use, and early clarification.
★ 64
↓ 3.3k/wk
MIT
JavaScript
Nov 20, 2026
dsh plugin --profile web add dsh-deep-ptc-modeby Platato-DA
Scheduled Agent execution for DeepSeek Harness: per-task models, workspaces, durable run history and artifacts. Community plugin · public beta.
★ 0
BSD-3-Clause
TypeScript
Nov 2, 2026
dsh plugin --profile web add @dsh-external/dsh-task-centerby pallwalt
Scheduled Agent execution for DeepSeek Harness: per-task models, workspaces, durable run history and artifacts. Community plugin · public beta.
★ 0
BSD-3-Clause
TypeScript
Oct 31, 2026
dsh plugin --profile web add @dsh-external/dsh-task-centerby muyuanjin
A session-bound agent-native REPL for DeepSeek Harness PTC mode.
★ 27
↓ 1.3k/wk
MIT
JavaScript
Nov 20, 2026
dsh plugin --profile web add dsh-ptc-plusby Web0926
DeepSeek Harness plugin that validates and ranks 3/5 independent coding-agent patches before approval-gated apply.
★ 3
↓ 2.1k/wk
MIT
TypeScript
Aug 25, 2026
dsh plugin --profile web add dsh-llm-verifierby Alm-Allen
dsh 插件:把 DeepSeek Harness 的原生「PTC 模式」完整汉化——覆盖 preset-ptc,不新增预设条目。
★ 1
JavaScript
Oct 24, 2026
dsh plugin --profile web add @alm-allen/dsh-cangjie-preset