GPT 执行优先预设 Starlight-bananice/dsh-gpt-agent-preset

dsh-gpt-agent-preset

为 OpenAI GPT-6 系列（gpt-6-astra / gpt-6-sol / gpt-6-luna / gpt-6.1-sol）在 DeepSeek Harness 下调优的智能体预设。

An Agent preset for DeepSeek Harness, tuned for the OpenAI GPT-6 family.

实验性。 阈值是实测得出的起始点，不是定论。如果你发现它误伤了正常流程，下面的配置与调参都是一行就能改的。

它做什么

Harness 自带的标准预设是为 DeepSeek 的推理模型写的。GPT-6 系列在三个地方和它配合不好：

重复空转。 实测：一个会话在 4.5 小时里调了 300 次 todo_write + 164 次 get_goal，没有产出任何实现；另一个在 37 步里把两个文件分别重读了 36 次和 35 次，上下文涨到 355K token 直到 provider 中断流。

工具选择偏差。 同一批会话里 207 次调用有 171 次是 bash —— 连读文件都用 bash ——而 read 只有 12 次。没有任何地方告诉模型哪个工具该干哪种活。

逐步骤的进度播报。 每个 step 前先说一句"我会…"。这条同时也是 OpenAI 的 GPT-6 文档写明的已知行为：它"倾向于详细、结构化的回复"，且在长工具链里会为每一步加一句前言。实测一个会话里连续五步的开场白互相 68%–80% 相似，内容都是同一份计划的复述。

以及官方要求补的那一半： GPT-6"更可能在额外输入会改变结果时向用户提问，这会导致用户期待它做合理假设并坚持时它却停下"。本预设据此明确授权它去执行。

安装

关键前提：0.2.x 不再扫描预设目录

把文件复制到 ~/.dsh/.agent-presets/ 不会有任何效果。 0.1.x 那样发现预设， 0.2.x 已取消：@deepseek-ai/dsh-agent-presets 这个包不存在了，新的 dsh-agent-preset-registry 明确"既不扫描目录也不接受预设路径"。预设现在是 profile 的 bundle patch。

git clone https://github.com/Starlight-bananice/dsh-gpt-agent-preset.git
cd dsh-gpt-agent-preset

python3 install-preset.py --dry-run # 先看会写入什么
python3 install-preset.py # 写入 desktop profile

装完在 设置 → Agent 预设 里选「GPT 执行优先」即可（其他 profile 用 --profile <name>）。

安装脚本幂等，重跑不会产生第二份。它会把 !!js 平台条件解析为本机取值、把插件文件的相对路径改写为绝对路径（profile 补丁没有"预设目录"这个基准），并在写入前先重新解析全文 ——补丁写坏会让整个应用无法启动，所以解析不过就拒绝写入。

它加了什么

三段提示词 + 一层强制。前两段是行为引导，第三层是可强制的。

persona（系统提示开头，稳定）

- 用户指令优先于任何 skill、AGENTS.md 或约定文件；冲突时按用户说的做并说明搁置了哪个
- 明确授权：动作型请求就是授权，做完它，不要停在计划或"要不要我继续"

运行契约（每个 agent 注入一次）

| 段 | 内容 |
| AUTHORIZATION | 动作型请求即授权；两点例外：用户选的模式限制（计划模式下只读探索），以及真正属于用户的决定（改变结果的设计选择、不可逆操作） |
| SILENCE | 不复述请求、不播报"我要去读/搜/跑/验证了"——工具调用本身就看得见。只在有真正新信息时说话：需要用户拍板的决定、阻塞、或答案本身 |
| TOOLS | 明确工具分工，shell 只留给进程、构建、测试、git；优先复用上下文里已有的结果 |
| DONE | 改文件的任务以"落盘并验证"为终点；审查、诊断、解释在结论成立时即完成，不要为了完成感去改文件 |
| STYLE | 先给结论；列表/表格只在内容确实并列或需要对比时使用 |

强制层（针对"无进展"，不是"限制调用次数"）

| 机制 | 阈值 | 为什么 |
| get_goal | 每轮 1 次 | 纯重读已有状态，目标就在上下文里 |
| create_goal | 每轮 1 次 | 一次会话本质上只有一个目标 |
| 完全相同的 todo_write | 拒绝重发 | 列表是模型的工作状态，工具说明要求"完成即标记"；拦的是重发同一份，不是更新 |
| 同一 (路径, 偏移, 上限) 重读 | 每轮允许 2 次 | 实测循环里 91/129 次调用是重读。跨轮重置，且文件被写/编辑后立即释放 |
| 窗口内重复调用 | 同一签名在最近 12 次调用内出现 2 / 4 次 | 实测循环是 bash → read A → read B 交替，连续检测永远不触发 |

update_goal 不在限额内 —— 同一轮 resume → complete 是正常生命周期。

配置与调参

全部阈值在 agent.cordis.yml 的 gpt-guardrails.config 里：

- id: gpt-guardrails
name: ./gpt-guardrails.mjs
config:
budgets:
get_goal: 1
create_goal: 1
加 todo_write: N 可改成"每轮 N 次"的硬限额
repeatThresholds: [2, 4] # 窗口内出现次数；嫌吵可改 [3, 5]
repeatWindow: 12 # 回看最近多少次调用 readBudget: 2 # 同一区间每轮可读次数；0 关闭 injectContract: true # false 则完全不注入运行契约改完重跑 install-preset.py（配置热生效）。改 gpt-guardrails.mjs 的代码需要 重启应用 —— Node 会缓存模块。

上下文压缩阈值

同一文件里的 compaction-basic 是计价设置，不是延迟设置：

GPT-6 全系列对输入超过 272K token 的请求按 2 倍输入/缓存价、1.5 倍输出价计费，且是整个请求。

Sol/Luna 的上下文窗口是 1,050,000，所以本预设用 thresholdRatio: 0.25（≈262K）压在加价线之下。

前提是你的模型声明了 contextWindow。 若 provider 不报窗口，压缩触发点算不出来 ——对 ChatGPT provider 可以在模型条目里加 contextWindow: 1050000，见 dsh-chatgpt-plugin。

验证

node tests/harness.mjs # 61 项行为检查（假 Cordis 上下文，不需要应用/会话/模型）
node tests/check-config.mjs # 每个配置键对 shipped schema 校验（离线，自包含）

两个脚本都路径无关、无外部依赖，clone 下来即可运行；CI 每次 push 都会跑。

行为检查覆盖几条刻意的语义，改代码时别破坏它们：

- 交错循环（复用实测形状）必须在第 2 轮内触发 —— 旧版连续检测在此为 0 次
- 12 次各不相同的调用零误报；把某签名挤出窗口后再发一次也零误报
- todo_write：建清单 / 改状态 / 标完成全部放行，只有重发同一份被拒
- 被拒的提交不构成状态 —— 未落盘的重发仍放行，否则一次基于陈旧状态的拒绝会连锁误伤
- agent/created 不派发时，限额与契约注入仍必须生效（第一版正是死在这里）
- 契约必须抑制逐步骤播报，且授权段不再要求"用一行说出计划"

排障

预设不出现在设置页 —— 确认它真的在 profile 补丁里：

grep -c preset-gpt ~/.dsh/profiles/desktop/cordis.patch.yml # 应为 1

为 0 说明脚本没跑成功。

预设出现了但拦截不起作用 —— 插件每次激活会往 ~/.dsh/gpt-guardrails-activations.log 写一行，并在每次拒绝时记录工具名与原因：

- 文件为空 → 插件的 apply() 从未执行，多半是没重启应用
- 有 activated 但没有 DENIED → 拦截没触发（阈值未达到，或代码未重新加载）

模型报 STREAM_ERROR 且无细节 —— 与预设无关。该错误来自上游发来一个不带 code/message 的 error 事件；实测与推理档位、模型组合有关，换一档再试通常可恢复。

模型话太多或太少 —— SILENCE 段控制逐步骤播报。想让它多说，把 injectContract 设为 false 会移除整个契约（含授权与工具分工）；或者直接改 gpt-guardrails.mjs 里 CONTRACT 的措辞，然后重启。

已知限制

- 仍在实测调参，阈值可能误伤正常流程
- 强制层是可见性/引导，不是安全边界：拒绝是一次普通工具调用结果，模型可以读
- 只在 macOS 桌面版 + chatgpt provider 上验证过
- agent.cordis.yml 里的 !!js 平台条件在安装时解析为本机取值，因此生成的 profile 补丁不可跨平台直接复制
- 不主张官方预设与 GPT-6"天生冲突"。日志能证实的只有"确实存在这种形状的空转"，以及本预设自己的第一版强制层从未激活这两件事

License

MIT