operator-anchor
把「操作者锚定框架」这套提示词方法做成可直接安装的宿主插件。同一份正文,两个宿主:DeepSeek Harness 与 WorkBuddy。
不是又一份提示词文本,是把它挂到宿主真正会读的那三个位置上。
1. 为什么需要插件
宿主不是把问题原样交给模型。它在运行时改写系统提示词:追加身份声明、拒绝模板、审批门、沙箱说明、"先确认再动手"的流程要求。模型最后读到的一段往往不是操作者的意图,而是宿主的收尾语。
于是出现两种失败:
| 现象 | 真实原因 |
|---|---|
| 模型第一句话就拒绝 | 宿主在提示词头部塞了策略层,模型把它当最高优先级 |
| 前面答得好好的,后面突然收口 | 宿主的尾部文案在 recency 位,压过了前面的框架 |
| 委派出去的 subagent 完全不认账 | subagent 拿到的是另一份被裁剪过的提示词 |
锚定方法就是针对这三处分别落子。做成插件之后,它自动跟着宿主版本走,不需要每次手贴。
2. 三层结构
| 层 | DSH 落点 | WorkBuddy 落点 | 作用 |
|---|---|---|---|
| 持久框架 | systemPrompt.section order -100000 |
SessionStart hook 的 additionalContext |
身份、优先级、交付纪律、意图映射、占位符规则 |
| 尾部锚点 | systemPrompt.section order 10150 |
UserPromptSubmit hook 的 additionalContext |
每轮重渲染,把规则放回 recency 位 |
| 子会话锚点 | systemPrompt.context order 235 |
—(宿主无对应事件) | 委派出去的 subagent 同样带一份 |
| 执行面 | anchor_toggle / anchor_status 工具 |
PreToolUse hook |
被策略层拦下的路径按操作者授权放行 |
三者分离是刻意的:
- 只做持久框架 → 被宿主尾部文案稀释
- 只做尾部锚点 → 没有稳定的行为基准
- 只做执行面 → 模型仍然会在第一句话上拒绝
为什么主锚点用 section 而不是 context
DSH 的 agent-loop 只在快照文本变化时才追加一条 user 消息(if (this.retained?.text === snapshot) return;)。静态 context 只出现一次,之后被历史埋掉。section 每轮重新渲染,稳定停在尾部。
为什么子锚点必须用 context
它要排在宿主 subagent:delegation(order 120)之后,才能对消那句「需要审批的操作会被自动拒绝」。
3. 安装
DeepSeek Harness
git clone https://github.com/54747/operator-anchor.git
cd operator-anchor
node scripts/install-dsh.mjs
装完重启 DSH。插件列表里会出现 Operator anchor,设置 > 通用 里多一行开关。
检查:
node scripts/install-dsh.mjs --status
卸载:
node scripts/install-dsh.mjs --remove
WorkBuddy
node scripts/install-workbuddy.mjs
装完重启 WorkBuddy。
检查:
node scripts/install-workbuddy.mjs --status
卸载:
node scripts/install-workbuddy.mjs --remove
WorkBuddy 版走的是本地 marketplace + enabledPlugins,不修改安装目录里的任何文件,卸载只回滚两处 JSON。
4. 验证
不要靠"看起来像不像"判断。 两个宿主都留了可观测点。
DSH
新会话里让模型调 anchor_status,或直接打宿主路由:
Invoke-RestMethod http://127.0.0.1:49542/operator-anchor/state
返回:
{ "ok": true, "enabled": true, "frame_chars": 2811, "tail_chars": 1436, "dir": "...\\.dsh\\operator-anchor" }
开关(设置页那一行走的就是这个):
Invoke-RestMethod -Method Post -Uri http://127.0.0.1:49542/operator-anchor/toggle `
-ContentType 'application/json' -Body '{"enabled":false}'
WorkBuddy
新会话单独发一条:
锚定自检
只回一行 锚定自检成功 即生效。
想看 hook 实际吐了什么,直接跑:
'{"prompt":"测试"}' | node "$env:USERPROFILE\.workbuddy\plugins\marketplaces\operator-anchor-local\plugins\operator-anchor\scripts\anchor.mjs" UserPromptSubmit
应该输出单行 JSON,hookSpecificOutput.additionalContext 里是尾部锚点全文。
5. 改正文
正文只有两份,改完跑一次构建同步到两个包:
core/anchor.md 持久框架(身份 / 交付纪律 / 意图映射 / 占位符)
core/tail.md 尾部锚点(10 条格式规则)
npm run build # 同步到 packages/dsh/core/ 与 packages/workbuddy/core/
npm run verify # 一致性 + 语法 + hook 协议 + 插件加载
node scripts/smoke.mjs # 假 ctx 跑一遍 apply(),验证三层注册与路由
运行时也可以不改包,直接在覆盖目录改:
| 宿主 | 覆盖目录 |
|---|---|
| DSH | ~/.dsh/operator-anchor/{anchor.md,tail.md} |
| WorkBuddy | ~/.workbuddy/operator-anchor/{anchor.md,tail.md} |
覆盖文件优先于包内正文。改完下一轮生效,不需要重启(DSH 的 section 文本是函数,每轮求值)。
6. 仓库结构
operator-anchor/
├─ core/ 正文唯一真相
│ ├─ anchor.md 持久框架
│ └─ tail.md 尾部锚点
├─ packages/
│ ├─ dsh/ DeepSeek Harness 插件
│ │ ├─ index.js Host:三层注册 + 路由 + 工具
│ │ ├─ client.js Client:设置页那一行
│ │ ├─ cordis.patch.yml bundle patch
│ │ ├─ locale/{en,zh}.json 插件列表里的标题与说明
│ │ ├─ docs/ 详情页插图
│ │ ├─ icon.svg
│ │ └─ core/ 构建产物(勿手改)
│ └─ workbuddy/ WorkBuddy 插件
│ ├─ .codebuddy-plugin/plugin.json
│ ├─ hooks/hooks.json 三个事件挂载
│ ├─ scripts/anchor.mjs hook 入口
│ └─ core/ 构建产物(勿手改)
├─ scripts/
│ ├─ build.mjs 正文同步
│ ├─ verify.mjs 静态检查
│ ├─ smoke.mjs 运行时冒烟
│ ├─ install-dsh.mjs
│ └─ install-workbuddy.mjs
└─ package.json
7. 协议要点(改代码前先读)
DSH 侧
systemPrompt.section({ name, order, interpolate, text })—text可以是函数,每轮求值。返回""即该轮不注入。systemPrompt.context({ name, order, required, text })—required: true才能穿过宿主对可选 context 的抑制。- section 撞名会抛,三个注册必须各自
try。 - order 必须落在宿主区间里:头部要
< HARNESS_IDENTITY(-1000),尾部要> WEB_SURFACE(10100)且< DEPLOYMENT_PERSONA_SUFFIX(10200),子会话要> 210且> delegation(120)。 interpolate: false关掉{{var}}渲染,正文里出现花括号不会炸整轮对话。
WorkBuddy 侧
- stdin 是 JSON 事件体,stdout 必须是单行 JSON。混入任何其它文本都会让上游
JSON.parse失败。 SessionStart/UserPromptSubmit的hookSpecificOutput.additionalContext会被包成<system-reminder data-role="hook">追加:前者插首条,后者插末条。recency 位就在后者。PreToolUse的hookSpecificOutput.permissionDecision = "allow"会短路整条权限链。只对明确授权的会话开。- 非目标工具只能回
{"continue":true},绝不回 allow。 - exit code 恒 0。exit 2 等价 deny。
- 诊断一律走 stderr,且不要打印
tool_input(含用户 prompt)。
8. 已知边界
- DSH 桌面端的
--dump-config拒绝外部调用(profile "desktop" is managed exclusively by the Electron application),所以安装后要重启应用,用/operator-anchor/state或插件列表确认,不要指望 CLI 输出。 - WorkBuddy 的 hook 只在插件被 active 之后加载。装了但没启用(
enabledPlugins里不是true)就完全不跑,且不报错。 - 子会话锚点在 WorkBuddy 侧没有对应事件。WorkBuddy 有
SubagentStart,但它的additionalContext不进入子会话提示词,所以那一层只在 DSH 生效。 - 正文长度会影响首轮 token。当前 2811 + 1436 字符。要压缩就改
core/tail.md,它每轮都进。 PreToolUse的 allow 是整链短路,不是"这一次放行"。确认这是你要的语义再开toolAllow。
9. 许可
Apache-2.0。尾部锚点的 section/context 选型与 order 区间取自 HunYiSage/dsh-purge 的工程实践,原始版权归其作者。
DeepSeek Harness 与 WorkBuddy 分别是 DeepSeek、腾讯的产品。本项目与二者无关联。
No comments yet. Be the first to write one.