对 Token 缓存可视化感兴趣吗？可以试试 opencode-visual-cache 这个插件！

1. 图片展示

2. 功能

• 实时状态：运行中（呼吸动画）、已完成、错误，彩色圆点一目了然
• Token & 费用追踪：每个子代理的 Token 消耗和费用汇总，标题栏全局显示
• 展开详情：点击展开查看 agent 类型、状态、耗时、Token、费用、模型、进度，字段值右对齐
• 一键进入会话：展开后点 → 进入会话 跳转子代理的完整对话
• 手动标记完成：展开区右侧 - 标记完成 按钮可手动终结卡住的僵尸条目；/subagent-clear-running 批量清理
• 状态字段显示：展开区 状态: 运行中/已完成/错误，颜色与圆点一致，一目了然
• 折叠面板：标题栏点击折叠/展开，状态持久化，重启后保持
• 滚动回顶/回底：列表底部 ↑ 回顶 / ↓ 回底 按钮一键跳转到最新条目位置，方向随排序自适应
• 可配置排序：/subagent-order 支持「降序（最新在前）」和「升序（最早在前）」两种排列方式
• 翻页模式切换：/subagent-scroll 可选「滚轮翻页」或「点击 more 翻页」，解决侧边栏与全局滚动冲突
• TTL 自动清理：超过 3 天的旧数据自动从 KV 中清除
• 语言适配：支持 /subagent-lang 运行时切换中/英文，偏好持久化
• 斜杠命令：/subagent-lang /subagent-max /subagent-order /subagent-scroll /subagent-session /subagent-version /subagent-clear-running 动态配置

3. 安装

3.1 方式一：OpenCode 命令安装（推荐）

在 OpenCode 中按 Ctrl + P 打开命令面板，搜索 install plugin，输入：

opencode-subagent-magazine@latest

回车即可完成安装与配置。

3.2 方式二：手动安装

1. 安装插件

npm install -g opencode-subagent-magazine@latest

2. 配置 TUI 插件

创建或编辑 ~/.config/opencode/tui.jsonc：

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["opencode-subagent-magazine@latest"]
}

3.3 重启 OpenCode

进入任意 session，侧边栏即可看到子代理监控面板。

4. 使用指南

4.1 斜杠命令

插件支持通过斜杠命令或命令面板（Ctrl + P）动态调整配置，所有设置即时生效并持久化：

| 命令 | 功能 | 使用方式 | |------|------|---------| | /subagent-lang | 切换显示语言 | 从列表选择中文或 English，界面即时切换，无需重启 | | /subagent-max | 调整最大可见条目数 | 输入数字（默认 10），控制面板最多显示多少个子代理条目 | | /subagent-order | 切换排序方式 | 选择「降序（最新在前）」或「升序（最早在前）」，即时重排并跳转到最新条目 | | /subagent-scroll | 切换翻页模式 | 选择「滚轮翻页」或「点击 more 翻页」，解决与全局滚动冲突 | | /subagent-session | 查看当前会话 ID | 弹出当前 OpenCode 会话 ID | | /subagent-version | 查看插件版本 | 弹出当前插件版本号 | | /subagent-clear-running | 批量清理僵尸条目 | 一键将所有运行中的条目标记为完成，清理卡住的旧数据 |

4.2 键盘 & 鼠标

| 操作 | 说明 | |------|------| | 点击标题栏 | 折叠 / 展开面板 | | 点击条目行 | 展开 / 收起详情 | | 滚轮 / 点击 ↑ more ↓ more | 翻页查看更多子代理（/subagent-scroll 切换翻页模式） | | 点击 ↑ 回顶 / ↓ 回底 | 跳转到最新条目位置（方向随排序自适应） | | 点击 → 进入会话 | 跳转子代理完整对话 | | 点击 - 标记完成 | 手动终结该条目（仅运行中时显示） |

4.3 状态颜色

| 颜色 | 含义 | |------|------| | 🟢 绿色 | 已完成 | | 🟡 黄色（呼吸动画） | 运行中 | | 🔴 红色 | 错误 |

5. 更新

由于 OpenCode 已知问题 #6774，插件缓存会锁死在首次安装时的版本，不会自动检测 npm 上的新版本。

更新步骤：

1. 清除 OpenCode 插件缓存

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.cache\opencode\packages\opencode-subagent-magazine@latest"

# macOS / Linux
rm -rf ~/.cache/opencode/packages/opencode-subagent-magazine@latest

2. 重新安装插件

在 OpenCode 中按 Ctrl + P → install plugin → opencode-subagent-magazine@latest → 回车

3. 重启 OpenCode

6. 语言设置

6.1 运行时切换（推荐）

在 TUI 中输入 /subagent-lang，从弹窗选择「中文」或「English」即可即时切换，无需重启。偏好会自动持久化，下次启动自动恢复。

6.2 自动检测

默认自动检测系统语言。若不符合预期，用 /subagent-lang 手动切换一次即可，偏好会被记住。

7. 兼容性

代码完全模型无关，支持所有 OpenCode 兼容的 AI 模型（DeepSeek / Claude / GPT 等）。 Token 数据和子代理信息均通过 OpenCode SDK 标准接口获取。

8. License

MIT