opencode-plan-cards-plugin

让原版 OpenCode（桌面端 + CLI）获得更强的 plan 卡片问答流程，无需替换 opencode-cli.exe。

功能

• 提供会话命令：
  • /plan card on
  • /plan card off
• 开启后仅在 plan 会话注入“先澄清、再确认、再输出完整计划”的系统约束。
• 强化 question 工具描述，推动 2–3 选项 + 权衡说明的卡片提问格式。
• 安装后默认自动开启卡片模式，可按会话临时关闭。

兼容性

• OpenCode: 1.2.x（桌面端 / CLI）
• 插件形态：file:// 与 npm 包均可
• 一键安装器：Node.js 18+

安装（方式 A：npm 一键写配置，推荐）

npx -y opencode-plan-cards-plugin@latest setup

默认会自动：

• 备份 ~/.config/opencode/opencode.json
• 写入 plugin: ["[email protected]"]
• 写入 agent.ask.hidden = true

可选参数：

npx -y opencode-plan-cards-plugin@latest setup --plugin [email protected]
npx -y opencode-plan-cards-plugin@latest setup --config "C:\Users\<you>\.config\opencode\opencode.json"

安装（方式 B：Git + file://）

git clone https://github.com/SAKURA1175/opencode-plan-cards-plugin.git opencode-plan-cards-plugin
cd opencode-plan-cards-plugin
npm install
npm run build

在 ~/.config/opencode/opencode.json 中配置插件：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "file:///ABSOLUTE_PATH_TO/opencode-plan-cards-plugin/dist/index.js"
  ],
  "agent": {
    "ask": {
      "hidden": true
    }
  }
}

Windows 路径需要使用 file:///，空格写成 %20。

安装（方式 C：npm 手动配置）

发布后，用户配置：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "[email protected]"
  ],
  "agent": {
    "ask": {
      "hidden": true
    }
  }
}

使用

1. 安装并重启后，在 plan 会话中默认启用卡片澄清与确认流程
2. 需要关闭当前会话卡片模式时输入：/plan card off
3. 需要重新开启当前会话卡片模式时输入：/plan card on

验证清单

1. 桌面端：进入 plan 会话后默认出现卡片问答流程
2. CLI：同样默认生效
3. /plan card off 后恢复原始 plan 行为
4. agent.ask.hidden=true 后 UI 默认不显示 ask

发布 npm

npm run build
npm publish --access public

限制说明

• 插件层是“流程引导增强”，不等于内核级强约束。
• 如需硬拦截（例如强制 plan_exit 前置条件），仍需维护内核分支。