862930522/opencode-anchored-standard

opencode-anchored-standard

English

一个 opencode 插件，实现两阶段工具目录：每个会话先用最小工具集开局，在会话产生第一次工具调用后自动解锁全部工具。

灵感来自 xiaobright/dsh-anchored-standard（DeepSeek Harness 的两阶段 preset）。本插件是为 opencode 独立实现的移植版——不包含任何 DeepSeek Harness 代码。

为什么

工具目录越大的模型，越容易在第一个回合就过度依赖工具，在还没理解任务时乱选工具。引导阶段强制模型用最小工具集（bash + read）轻装开局，等模型真正开始干活后才给全量装备。阶段状态从会话的持久化历史推导，重启、续聊、压缩都不会丢——不需要插件侧存储。

工作原理（按会话）

1. 当会话历史中还没有任何工具调用记录时，插件：
- 在系统提示词中注入一段引导规则（当前只能用 bash 和 read）；
- 拦截对其他工具的任何调用，返回模型可见的错误信息，说明解锁条件。
2. 第一次调用引导工具（无论成功失败）即晋升该会话。
3. 此后所有工具放行，引导规则从系统提示词中移除（提示词恰好变化一次，与原版一致）。

晋升状态按会话缓存在内存中，并在需要时从消息历史重新推导——插件重启后也能自动恢复正确阶段。

平台说明：opencode 目前没有"按请求过滤工具目录"的接口（发给模型的 tools 数组由核心组装，不可挂钩）。本插件的做法是保持完整目录（保证请求缓存稳定），通过系统提示 + 执行拦截来落实引导阶段。对遵守规则的模型而言效果等价；原版 DeepSeek Harness preset 则是把工具从目录中彻底隐藏。

安装

在 opencode.json 中加入插件：

{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-anchored-standard"]
}

重启 opencode，开一个新会话即可。插件无网络请求、无遥测。

配置

{
"plugin": [["opencode-anchored-standard", { "bootstrapTools": ["bash", "read"] }]]
}

| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| bootstrapTools | string[] | ["bash", "read"] | 引导阶段可用的工具 |

验证

检查某个会话的请求：

- 首个请求的系统提示词包含 Bootstrap phase 段落；
- 在第一次引导工具调用之前，调用任何非引导工具都会收到 "locked" 错误；
- 第一次 bash/read 调用之后，Bootstrap phase 段落消失，全部工具可用。

开发

npm install
npm run check   # 类型检查 + 构建 + 测试

测试针对编译产物用原生 node --test 运行，无需启动 opencode 实例。

许可

MIT。机制借鉴自 xiaobright/dsh-anchored-standard（MIT）；详见 NOTICE。