DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

54747 /

54747/operator-anchor

Topic repository only

操作者锚定框架:把提示词方法论做成可安装的宿主插件(DeepSeek Harness + WorkBuddy 双端)。Persistent frame at the prompt head, recency anchor at the tail, subagent anchor inside delegations.

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@9813beea

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、腾讯的产品。本项目与二者无关联。

—/ 5

No ratings yet

Manifest verification required

Commit 9813beea7a65

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout