[开源]关于我给OpenCode弄了个子代理监控插件这件事

OpenCode SubAgent Magazine

像弹匣一样装填！发射！

实时子代理监控 · TUI 侧边栏可视化
自适应主题色 · 低饱和设计语言 · 中/英双语 · 数据持久化

如果你觉得这个插件不错的话，可以帮我点点小星星 ⭐，谢谢！

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

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

复制代码

opencode-subagent-magazine@latest

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

1. 安装插件

bash 复制代码

npm install -g opencode-subagent-magazine@latest

2. 配置 TUI 插件

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

jsonc 复制代码

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

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

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

命令	功能	使用方式
`/subagent-lang`	切换显示语言	从列表选择中文或 English，界面即时切换，无需重启
`/subagent-max`	调整最大可见条目数	输入数字（默认 10），控制面板最多显示多少个子代理条目
`/subagent-session`	查看当前会话 ID	弹出当前 OpenCode 会话 ID
`/subagent-version`	查看插件版本	弹出当前插件版本号
`/subagent-clear-running`	批量清理僵尸条目	一键将所有运行中的条目标记为完成，清理卡住的旧数据

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

更新步骤：

1. 清除 OpenCode 插件缓存

powershell 复制代码

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

bash 复制代码

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

2. 重新安装插件

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

3. 重启 OpenCode

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

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

代码完全模型无关，支持所有 OpenCode 兼容的 AI 模型（DeepSeek / Claude / GPT 等）。

Token 数据和子代理信息均通过 OpenCode SDK 标准接口获取。

MIT