DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-superagent-ptc

B

dsh-superagent-ptc

Manifest valid★ 4

SuperAgent PTC: long-task supervision for DeepSeek Harness - anchors, bounded delegation, independent reviewer, evidence-gated release

UI (client)hasBundlePatch

SuperAgent PTC

English 简体中文

npm 版本 npm 下载量 许可 MIT DSH 测试

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

快速上手

  1. 新建会话,选择 SuperAgent PTC 预设。
  2. 把目标与完成标准说清楚,例如:
用 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。
  1. 点击 composer 上方的 Super Agent 监管,右栏会显示实时 Run 与审计时间线。

工具

工具动作说明
super_runcreate plan show recover completeRun 生命周期;recover 增加 generation 并重新对账
super_anchorshow apply history版本化锚点;纠正会显式失效受影响的工作
super_mandateprepare bind bindReviewer report show委派合同与原生 SessionId 绑定
super_evidencerecord observe list分型证据,带写域与来源角色校验
super_reviewevaluate decide release独立验收与放行
super_routeshow 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
宿主 peerdsh-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。

也感谢群里持续讨论、提问与纠正的每个人——这些对话让“证据放行”从一句口号变成了可验证的状态机。

许可

MIT,见 LICENSE。上游 DSH 组件声明记录在 NOTICE.md。

Versions

Latest versionPublishedSize
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

dsh-deep-ptc-mode

by lishize20040802-rgb

Deep PTC agent preset for DeepSeek Harness: built-in PTC tooling plus visible progress, confident tool use, and early clarification.

Workflow & AutomationManifest valid

★ 64

↓ 3.3k/wk

MIT

JavaScript

Nov 20, 2026

dsh plugin --profile web add dsh-deep-ptc-mode

by Platato-DA

Scheduled Agent execution for DeepSeek Harness: per-task models, workspaces, durable run history and artifacts. Community plugin · public beta.

Workflow & AutomationManifest valid

★ 0

BSD-3-Clause

TypeScript

Nov 2, 2026

dsh plugin --profile web add @dsh-external/dsh-task-center

by pallwalt

Scheduled Agent execution for DeepSeek Harness: per-task models, workspaces, durable run history and artifacts. Community plugin · public beta.

Manifest valid

★ 0

BSD-3-Clause

TypeScript

Oct 31, 2026

dsh plugin --profile web add @dsh-external/dsh-task-center

by muyuanjin

A session-bound agent-native REPL for DeepSeek Harness PTC mode.

Sessions & MessagesManifest valid

★ 27

↓ 1.3k/wk

MIT

JavaScript

Nov 20, 2026

dsh plugin --profile web add dsh-ptc-plus

by Web0926

DeepSeek Harness plugin that validates and ranks 3/5 independent coding-agent patches before approval-gated apply.

Security & AuditDevelopment & InfrastructureManifest valid

★ 3

↓ 2.1k/wk

MIT

TypeScript

Aug 25, 2026

dsh plugin --profile web add dsh-llm-verifier

by Alm-Allen

dsh 插件:把 DeepSeek Harness 的原生「PTC 模式」完整汉化——覆盖 preset-ptc,不新增预设条目。

Sessions & MessagesManifest valid

★ 1

JavaScript

Oct 24, 2026

dsh plugin --profile web add @alm-allen/dsh-cangjie-preset