opencode-goal-plugin

给 OpenCode V2 加持久目标：说一次目标，它记住、自己接着干，完成时拿证据说话。

安装

在 opencode.json(c) 的 plugins 里加一行。全局配置是 ~/.config/opencode/opencode.json，也可以在项目根目录放 opencode.json / opencode.jsonc：

{
  "plugins": ["@justsilver/opencode-goal-plugin"]
}

带参数（可用键见配置项）：

{
  "plugins": [
    {
      "package": "@justsilver/opencode-goal-plugin",
      "options": {
        "token_budget": 200000,
        "debug": false
      }
    }
  ]
}

• 要钉住版本（可复现，代价是不再显示有新版）："plugins": ["@justsilver/[email protected]"]
• 本地目录 / git 安装（改代码即热重载、用未发布的提交）见 CONTRIBUTING.md。

用法

在会话里输入：

| 命令 | 作用 | | --- | --- | | /goal <目标> | 直接设定目标：逐字保存 + 起一轮，不询问、不转发给模型；已有未完成目标时不覆盖 | | /goal（或 /goal-status） | 查看当前目标与进度 | | /goal-pause | 暂停 | | /goal-resume | 恢复并立刻激活（仅在会话空闲、且预算还够时；预算已用尽会拒绝并提示改用 /goal-budget 提高预算） | | /goal-clear | 清除目标 | | /goal-budget <正整数\|none> | 改当前目标的 token 预算（none/0/off 取消预算、不限）；把预算从「已用尽」改回可用时会一并激活 | | /goal-rebuild <新目标> | 重建当前目标的正文：只换目标内容，状态、预算与用量记账全保留（不会唤醒模型） |

回执显示：命令结果以 TUI toast 浮条呈现（右上角、自动消失、不打断操作）——不写入对话历史，因此不消耗额外 token、也不污染模型上下文；只有你正看着该会话的窗口会提示。目标停摆（预算用尽 / 用量受限 / 受阻）改用会话内的合成提示（session.synthetic：模型与人都看得到、留在转录里），这类事件罕见且必须让人看到——代价是它会唤醒一轮收尾（让模型简短总结，而不是静默停住）。两者都需要 OpenCode V2 的 TUI（插件自带界面入口，随包自动加载，无需额外配置）；无 TUI 时命令照常生效，停摆提示仍写入会话。

设定后目标会在多轮之间持续：一轮结束、空闲时自动接着干，直到完成、暂停、受阻或超出预算。

• 完成要拿证据：模型必须核对当前状态，才敢说「完成」。
• 受阻 / 预算 / 用量到达时目标会停下并给出回执（留在转录里，不会像 toast 那样消失）：受阻 / 用量受限用 /goal-resume 恢复；预算用尽要先用 /goal-budget 提高预算（或 none 取消），否则 /goal-resume 会拒绝——因为恢复了下一轮末也会立刻再停。
• 恢复只在空闲时激活：会话正在跑时不插队投递（否则会把续跑触发插进当前轮），改为本轮结束后自然续跑。
• 自动续跑有计数：/goal-status 会显示「自动续跑 N 次」，每次续跑的回执带 #N。
• 界面文案默认跟随系统语言，可用配置项 language 切换。

配置项

| 键 | 默认 | 说明 | | --- | --- | --- | | token_budget | 无 | 新目标的默认 token 预算 | | max_goal_token_budget | 无 | 允许的最大预算 | | max_objective_chars | 4000 | 目标注入提示词的截断阈值（超过仍保留全文，模型可完整取回） | | blocked_threshold | 3 | 连续阻塞多少轮算「卡住」 | | empty_threshold | 3 | 连续空转多少轮算「空转」 | | reconcile_guard_minutes | 5 | 启动兜底保护窗（分钟） | | restricted_agents | ["plan"] | 受限 agent（拒改写目标 / 续跑） | | disabled_tools | ["question"] | goal active 期间从模型工具表移除的工具名；设 [] 关闭 | | command_name | goal | 主命令名；状态控制是派生命令 <name>-status / -pause / -resume / -clear | | debug_command_name | goal-debug | 调试命令名 | | debug | true | 注册只读调试工具 goal_debug（设 false 可让模型工具表保持干净） | | language | 跟随系统 | 面向用户文案的语言，"zh-CN" 或 "en"（缺省用系统 locale 探测） |

disabled_tools 默认移除 question：它是阻塞式交互工具，一旦调用会挂起执行直到你回复，而 goal 的自动续跑只在轮末注入，于是 goal 会被无限期停摆。goal active 时模型改为：能自行合理假设就继续，确实需要外部输入则走 goal(op "block")（连续几轮后进入「受阻」）。移除只作用于当次模型请求、不落库；goal 暂停 / 受阻 / 完成后 question 自动恢复。

源码与反馈：https://github.com/Just-Silver/opencode-goal-plugin