DeepSeek Harness 插件

Oyyyyyy-y/dsh-presets-plan-native-act-ptc

Star 数 ★ 0 下载量(近 30 天) 301 分类 工具与能力 收录于 2026-11-16 npm dsh-presets-plan-native-act-ptc

Agent 预设 + 路由插件:计划阶段使用原生工具,批准后把会话切回原始 PTC(只剩 run_code),让计划审批不再受程序预算约束。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-presets-plan-native-act-ptc

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

dsh plugin --profile web add github:Oyyyyyy-y/dsh-presets-plan-native-act-ptc

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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

DeepSeek Harness 的 ptc-hybrid 预设:计划阶段自动切到原生工具,批准后自动切回 PTC(只剩 run_code)。以 dsh.bundle 组合包分发,用 dsh plugin add 安装。

起因:PTC 预设下,计划审批发生在 run_code 程序内部,程序预算(默认 120s、上限 600s)会把等人的时间也算进去,于是审批卡被超时杀掉。本预设把“计划”整体移出程序预算,而不是把预算调大。

English

A DeepSeek Harness agent preset that routes tool execution by phase. While plan mode is active the session runs the native tool catalog (read, grep, glob, pwsh, edit, exit_plan_mode, …), so the plan review waits inside an ordinary tool call with no program budget. Once the plan is approved the session switches back to the stock PTC executor (run_code only) with the runtime's original budget.

Distributed as a dsh.bundle package: dsh plugin --profile <name> add github:Oyyyyyy-y/dsh-presets-plan-native-act-ptc.

效果

阶段 执行器 模型看到的工具 程序预算
计划(进入 plan mode) NativeToolExecutor read / grep / glob / pwsh / edit / write / exit_plan_mode 等(0.2.2-rc.3 实测 89 个) 无(计划阶段没有 run_code)
执行(批准之后) PtcExecutor 只有 run_code 运行时原值(实测 Default 120000; capped at 600000)

未进入过 plan mode 的会话完全不装路由,行为和原始 ptc 预设一致。

阶段分工

安装

组合包声明了 dsh.bundle.patch,安装后由 profile 启动时合并,不需要手工改 profile 文件。

# 从 GitHub
dsh plugin --profile <profile> add github:Oyyyyyy-y/dsh-presets-plan-native-act-ptc

# 从 npm(发布后)
dsh plugin --profile <profile> add dsh-presets-plan-native-act-ptc

# 本地 checkout
dsh plugin --profile demo add ./dsh-presets-plan-native-act-ptc
dsh --profile demo --dump-config        # 应看到 "# == dsh-presets-plan-native-act-ptc" 层

桌面端安装后重启 DSH,在会话的预设选择里选 PTC 混合(计划=标准,执行=PTC)。

验证

动作 期望
随便发一句话 request/header 只有 1 个工具 run_code,描述 Default 120000; capped at 600000
输入 /plan 下一个请求变成 89 个工具,含 exit_plan_mode;系统提示出现 plan:policy
计划卡停留 5 分钟以上再批准 正常返回批准,没有 TOOL_TIMEOUT
批准后的下一个请求 工具表回到 1 个 run_code;出现“执行阶段”提醒

日志里可直接核对:request/header 的 tools 数量 1 ↔ 89;system/message 长度(PTC ≈ 105k 字符,plan ≈ 9.6k);plan/mode 事件与 runtime-context 的 phase:mode 段;tool/ptc-dispatch 只应出现在非 plan 窗口。

node scripts/check-context-integrity.mjs --preset ptc-hybrid
node scripts/check-context-integrity.mjs --session <id>
node scripts/check-context-integrity.mjs --all

它按 agent-preset/selected 投影判断预设(会话 header 记录的是创建时的预设,不能单看它),报告 system 节点 replace 次数、每次 plan/mode 切换后请求的缓存命中、每个 plan 窗口内的 ptc-dispatch 数。

原理(摘要)

  1. 按 scope 选执行器:ToolsService.setExecutor() 把执行器登记在调用方的 scope 上,selectExecutor(agent) 沿 agent 的 scope 链找最近的登记。宿主本来就按 agent 建了 scope,所以在 agent scope 上装一个路由器,只影响这一个会话。
  2. 路由器按阶段委托:plan 阶段 describe/execute 委托给原生执行器,其余阶段委托给私有 PtcExecutor。路由器常驻、永不 dispose——上游实现里释放登记会留下“不可用”而不是回退到预设执行器。
  3. 阶段来源:plan 会话投影(sessionProjections.snapshot(session, ['plan']))。ctx.planMode 在预设的 isolate: { planMode: true } 域里,插件在域外读不到;直接扫事件日志的 Session.eventAt 已被上游明确禁止新调用。
  4. 阶段提醒:systemPrompt.context 注册 phase:mode 段,文本随阶段变化;DSH 只在文本变化时追加一条 <system-reminder>,因此请求前缀保持完整。

细节与取舍见 docs/design.md,实测方法与数字见 docs/verification.md。

与内置 ptc 预设的差异

  1. 计划阶段换执行器:在 agent scope 上挂一个路由器,plan 阶段把 describe/execute 交给原生执行器,其余阶段交给私有 PtcExecutor;
  2. 计划提示词改写:内置 ptc 预设写的是“工具表不变”,这里改成“计划阶段是原生工具、执行阶段只剩 run_code”,避免模型在计划阶段去找 run_code;
  3. 阶段提醒:systemPrompt.context 的 phase:mode 段随阶段变化,说明当前处在哪个阶段;DSH 只在文本变化时追加,不破坏请求前缀;
  4. 其余部分(插件清单、planning 分组、isolate: { planMode: true }、角色与技能)与内置 ptc 预设一致。

兼容性与升级

  • 在 DSH 0.2.2-rc.3(Windows 桌面端)实测通过;engines.dsh 声明为 >=0.2.2-rc.1 <0.3.0-0。

  • 依赖的内部契约:tools.setExecutor/selectExecutor 的 scope 语义、dsh-scope 的 createScope、plan 投影、plan/mode 事件、runtime-context 的追加语义。这些不是公开稳定 API,升级 DSH 后请重新验证。

  • 预设插件清单来自内置 ptc 预设。升级后重新生成:

    # 先把内置预设导出成文件(asar 需要 Electron 或 asar 工具解开)
    node scripts/gen-cordis-patch.mjs --source <导出的 ptc.patch.yml> --out cordis.patch.yml
    

    生成器只做文本替换,不会重排 YAML,也不会丢掉 !!js 标签与注释。

已知取舍

  • 缓存:工具表是请求前缀的第一段,切换阶段必然整段失效。实测进入 plan 的那一次请求重算约 13 万 tokens,之后恢复命中;退出 plan 时通常还能命中进入 plan 之前的前缀。
  • DSH 的 plan mode 是提示词约束,不是权限门:计划阶段仍然列着 write/edit,只是规则要求不要用。本预设不改变这一点(与 DSH 内置 standard 一致,与 ZCode 的 deny 门不同)。
  • act 阶段完全原始:不覆盖运行时预算、不加看门狗,审批等待照常计入程序预算(计划审批已经不在这个作用域里)。
  • 只对 ptc-hybrid 预设生效,其他预设零改动。

卸载

dsh plugin --profile <profile> remove dsh-presets-plan-native-act-ptc

目录结构

index.mjs                       # 路由器:阶段判定 + 执行器切换 + 阶段提醒
cordis.patch.yml                # dsh.bundle.patch:注册 ptc-hybrid 预设与其路由行
package.json                    # dsh.bundle manifest
scripts/gen-cordis-patch.mjs    # 从内置 ptc 预设重新生成 cordis.patch.yml
scripts/check-context-integrity.mjs
docs/design.md                  # 设计依据与上游引用
docs/verification.md            # 实测方法与结果

License

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

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