0.1.0 • Published yesterday

opencode-plugin-goal-dsh

Licence

MIT

Version

0.1.0

Deps

Size

27 kB

Vulns

Weekly

Summary Dependency Versions

opencode-goal-dsh

把 DeepSeek Harness (dsh) 的 packages/goal/ 目标模式移植到 OpenCode 的插件。

给 AI coding agent 一个 /goal 斜杠命令和一组 goal 工具：设定一个持久目标后，agent 在同一会话里自动一轮一轮续跑，直到目标带着证据完成、被阻塞、或轮次用尽。

参考实现是 dsh 的四个子包（goal / goal-round-driver / tool-goal / command-goal），状态机、CAS 修订、权限模型、防作弊阈值都按原设计移植；宿主侧改用 OpenCode 的 plugin hooks。

功能

/goal <objective> 建目标，/goal edit|pause|resume|clear 管理，裸 /goal 查状态
模型工具：get_goal / create_goal / update_goal
会话空闲（session.idle）自动续跑，注入 <goal_round> 轮次提示
完成必须带证据：模型自查后才允许标记 complete，随后注入收尾指令
防作弊：blocked 需同一阻塞条件持续满 N 轮；目标轮次内禁止 edit/pause/resume
安全边界：activation 只存内存，重启后 disarm，人工 resume 才再武装；Esc 中断自动转 paused；Plan agent 不续跑
compaction 存活：压缩上下文时注入当前目标状态

安装

方式一：本地插件目录

把 src/index.ts 复制到 ~/.config/opencode/plugins/goal-dsh.ts（全局）或项目的 .opencode/plugins/ 下即可，重启 opencode 生效。

方式二：转发 shim（推荐开发时用）

插件源码留在本仓库，全局目录只放一个转发文件：

// ~/.config/opencode/plugins/goal-dsh.ts
export { GoalDshPlugin } from "<本仓库的绝对路径>/src/index.ts"

使用

/goal 把所有测试修绿，npm test 全过
/goal                    # 查看当前目标状态
/goal pause              # 暂停（不删除）
/goal resume             # 继续（重启后恢复也用它）
/goal edit <新目标>       # 改目标描述
/goal clear              # 清除

模型侧也可以在人类请求是长任务时自行调用 create_goal（无需用户说"建个目标"），琐碎单轮活不会建。

配置

插件第二参数可覆盖默认值（npm 安装方式支持 [name, options] 元组）：

选项	默认	说明
`maxGoalRounds`	25	自动续跑轮次上限
`blockedAfterConsecutiveRounds`	3	blocked 前需持续的最低轮数
`autoContinue`	true	空闲自动续跑开关
`minRoundIntervalMs`	1500	两轮之间最小间隔（防抖）
`maxConsecutiveErrors`	3	连续出错熔断次数

状态持久化在 ~/.local/share/opencode-goal-dsh/state.json（遵循 XDG_DATA_HOME）。

与 dsh 原版的映射

dsh 子包	本插件实现
`goal/`（状态机 + CAS + 投影）	每会话投影，JSON 原子写持久化
`goal-round-driver/`（续跑调度）	`session.idle` hook → `client.session.promptAsync`
`tool-goal/`（模型工具 + 权限）	`tool` hook 注册三个工具；直人轮次判定用 `<goal_round>` 标记替代 dsh 的消息 source
`command-goal/`（`/goal` 命令）	`config` hook 注入命令模板

与 dsh 的已知偏差

clear 通过 update_goal 工具执行（OpenCode 自定义命令必须经过模型，无法纯本地执行）
没有 dsh 的 inbox 抢占检测，用防抖 + 连续错误熔断替代
无法校验"根 agent 的直人输入"，以"本轮是否为自动续跑轮"近似
token 预算会计未移植（依赖宿主用量事件）