OpenCode SubAgent Magazine
为 OpenCode TUI 提供实时子代理监控侧边栏，让每个子代理的运行状态、Token 与费用一目了然。
- Star 数
- ★ 134
- 最近更新
- 17 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 并行运行多个子代理的 OpenCode 用户，想在终端里随时看到哪个在跑、哪个出错
- 不适合
- 不使用 OpenCode 的用户（插件仅在 OpenCode TUI 中运行）
- 想用 opencode plugin add 命令安装的 TUI 插件场景（会导致 server 插件报错）
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
OpenCode SubAgent Magazine 是一个 OpenCode TUI 插件（npm 包 opencode-subagent-magazine），在终端界面侧边栏实时展示子代理的运行状态。它通过 OpenCode SDK 标准接口读取 Token 数据和子代理信息，以彩色圆点标记运行中（呼吸动画）、已完成、错误三种状态。面板支持展开查看 agent 类型、状态、耗时、Token、费用、模型和进度，并可一键跳转子代理完整会话。它内置数据持久化、TTL 自动清理、多实例原子合并写入、漏事件兜底恢复等机制，中英文界面可运行时切换。代码模型无关，支持所有 OpenCode 兼容模型（DeepSeek / Claude / GPT 等），同时支持 OpenCode 1.x 与 2.x。
插件作为 OpenCode TUI 插件加载后，在侧边栏显示子代理监控面板：实时用绿/黄/红圆点展示已完成/运行中/错误状态；通过 OpenCode SDK 获取每个子代理的 Token 消耗和费用并全局汇总显示在标题栏。点击条目可展开 agent 类型、状态、耗时、Token、费用、模型、进度，点 → 进入会话 跳转子代理完整对话，点 Session ID 弹窗查看完整 ID 便于复制，点 - 标记完成 手动终结卡住的僵尸条目。通过斜杠命令动态配置：/subagent-lang（中英切换）、/subagent-max（最大条目数）、/subagent-order（升降序）、/subagent-scroll（滚轮/翻页模式）、/subagent-ttl（3/7/14/30 天数据保留）、/subagent-clear-entries、/subagent-clear-running（批量清理僵尸条目）、/subagent-border、/subagent-refresh（流畅 100ms/省电 1s）、/subagent-cost、/subagent-time、/subagent-tokens、/subagent-time-format（short/decimal/clock/compact/seconds）、/subagent-config、/subagent-sections 等。所有设置即时生效并持久化，多开 TUI 时采用原子合并写入防止条目互相覆盖，并通过周期性校正 + 历史扫描 + 发现轮询兜底漏事件。
- 并行运行多个子代理的 OpenCode 用户，想在终端里随时看到哪个在跑、哪个出错
- 关注 AI 调用成本的开发者，需要按子代理追踪 Token 消耗和费用汇总
- 同时处理多个会话的工程师，想点击直达某个子代理的完整对话记录
- 长期使用 OpenCode 的团队，需要限制监控数据保留期（3/7/14/30 天）自动清理
- 多开 TUI 实例的重度用户，担心监控条目互相覆盖或事件丢失
- 中文/英文混合团队，想在终端内即时切换监控面板语言
如何安装或部署这个 Agent？
本插件同时支持 opencode 1.x 与 2.x。
opencode 2.x：创建或编辑 ~/.config/opencode/cli.json，在 plugins 数组中追加条目（不要使用 opencode plugin add，那会写入 opencode.jsonc 导致 TUI 插件加载报错）：
{
"plugins": [
{
"package": "opencode-subagent-magazine@latest",
"options": {
"enabled": true
}
}
]
}opencode 1.x 方式一（推荐）：在 OpenCode 中按 Ctrl + P 打开命令面板，搜索 install plugin，输入：
opencode-subagent-magazine@latestopencode 1.x 方式二（手动）：先安装 npm 包：
npm install -g opencode-subagent-magazine@latest然后创建或编辑 ~/.config/opencode/tui.jsonc：
{
"$schema": "https://opencode.ai/tui.json",
"plugin": ["opencode-subagent-magazine@latest"]
}安装后重启 OpenCode，进入任意 session 即可在侧边栏看到监控面板。若插件未生效，可清理插件缓存（V2 在 ~/.cache/opencode/npm，V1 在 ~/.cache/opencode/packages）后重启。
如何使用这个 Agent？
重启 OpenCode 进入任意 session，侧边栏即显示子代理监控面板。折叠/展开面板：点击标题栏；查看详情：点击条目行展开 agent 类型、状态、耗时、Token、费用、模型、进度；点 → 进入会话 跳转子代理完整对话；点 ses_xxx… ⎘ 复制完整 Session ID；点 - 标记完成 手动终结运行中的僵尸条目。翻页：滚轮或点击 ↑ more / ↓ more（/subagent-scroll 切换）；点击 ↑ 回顶 / ↓ 回底 跳转到最新条目。所有配置通过斜杠命令或 Ctrl + P 命令面板完成：/subagent-lang（切中英文）、/subagent-max（最大条目数，默认 10）、/subagent-order（排序）、/subagent-scroll、/subagent-ttl（保留期）、/subagent-clear-entries、/subagent-clear-running、/subagent-border、/subagent-refresh（流畅/省电）、/subagent-cost、/subagent-time、/subagent-tokens、/subagent-time-format、/subagent-config、/subagent-sections（设置菜单）。状态颜色：🟢 已完成、🟡 运行中（呼吸动画）、🔴 错误。
这个 Agent 有哪些优点和局限？
- 在 OpenCode TUI 内原生实时监控子代理，状态、Token、费用、模型、进度一站式展开查看
- 健壮性设计明确：多实例原子合并写入、漏事件兜底（周期性校正 + 历史扫描 + 发现轮询）、可配置 TTL 自动清理
- 高度可配置：十余个斜杠命令控制排序、翻页、刷新模式、耗时格式、显示开关，设置即时生效并持久化
- 中英双语运行时切换（/subagent-lang），偏好自动持久化，低饱和自适应主题色设计
- 模型无关，通过 OpenCode SDK 标准接口获取数据，兼容 DeepSeek / Claude / GPT 等所有 OpenCode 兼容模型
- 仅适用于 OpenCode 生态，不适用于 Claude Code、Codex 等其他 agent 运行时
- OpenCode 已知问题 #6774 导致插件缓存锁死在首次安装版本，升级需手动清缓存重装
- opencode 2.x 下不能使用官方
opencode plugin add命令安装，必须手动编辑 cli.json，否则 server 插件加载报错 - 数据价值依赖 OpenCode 子代理功能本身；单独使用 OpenCode 不跑子代理时意义有限
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenCode SubAgent Magazine 当前 | 63 · 存在缺口 | Agent 插件 / 技能免费 | ★ 134 | 17 天前 | TypeScript | — |
| abtop 智能编码会话监控器 | 57 · 缺口较多 | 命令行工具免费 | ★ 3.8k | 1 个月前 | Rust | Codex · Claude Code |
| OpenCode 目标模式插件 | 73 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 514 | 2 天前 | TypeScript | — |
| ccusage | 67 · 存在缺口 | — | ★ 19k | 今天 | Rust | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示这是本地 TUI 监控插件：通过 OpenCode SDK/本地数据库读取数据并写入本地 KV，无网络外发迹象，权限面窄，故 least_privilege 给 2。README 声称 /subagent-clear-entries 需确认后删除，但未提供实现源码佐证，user_confirmation 仅按声明记 1。数据流向（本地 DB→侧边栏→本地持久化）在 README 与测试中有描述，给 2；但持久化内容包含用户提示词（仅截断前缀，未见脱敏），sensitive_data_handling 记 1。peerDependencies 显式声明且多数可选，CI + npm trusted publishing（id-token），dependency_security 给 2。无外部副作用证据（本地读写为主），给 2。rollback 仅靠手动清缓存重装说明，无版本回退机制，给 1。仓库与作者署名清晰，source_attribution 给 2。
package.json 与 README 中名称、版本、安装方式一致；tests 显示多实例安全、漏事件兜底、缓存降级等自洽设计，self_consistency 给 2。peer 依赖声明为可选并有测试覆盖 bun:sqlite 不可用时的静默降级（tests/db-index.test.ts），dependency_availability 给 2。README 含排障章节与明确的报错场景（如误用 plugin add 的报错文案），failure_messages 给 2，但核心 src 未提供，无法核实运行时错误处理质量。
受众（OpenCode 用户）与场景（子代理监控）界定清晰，中英双语、可配置项丰富，audience_and_scenarios 给 2；兼容性章节声称模型无关并依赖标准 SDK 接口，capability_boundaries 给 2。斜杠命令语义明确、配置即时生效并有持久化，trigger_precision 给 2；覆盖 OpenCode 1.x/2.x、Windows/macOS/Linux 缓存路径与 XDG 环境变量（测试佐证 findDbPath），environment_fit 给 2。
README 结构完整（安装/使用/更新/兼容性/License），information_architecture 给 2。安装章节极为详尽，含 1.x/2.x 双路径、误装纠正步骤与缓存排障，install_notes 给 3。命名稳定一致（/subagent-* 前缀），naming_stability 给 2。有截图与命令表格但无 FAQ 与场景示例，examples_and_faq 给 2。已知问题 #6774 与缓存锁版本限制被明确披露，known_limitations 给 2。LICENSE 全文为 MIT 且与 package.json 一致，license 给 3。版本号 1.7.4 存在但仓库中未见 CHANGELOG，versioning_changelog 记 1。有 CI 与 npm 发布工作流，作者可识别，但无明确维护承诺或治理说明，maintenance_responsibility 给 2。
输出可用性体现在大量显示/格式/排序选项与持久化偏好，README 描述充分但未经执行验证，output_usability 给 2。作为实时子代理监控侧边栏，对多子代理工作流具有真实增量价值，marginal_value 给 2。提供省电刷新模式、TTL 清理与低频重绘选项，成本考量明确，cost_benefit 给 2。
本次审查仅有 README、LICENSE、package.json、CI 工作流与三个测试文件；src/ 未提供，README 的多数功能声明无法在源码中追溯，claim_traceability 记 1。测试与 README 部分声明（清除名单、持久化截断、降级行为）可相互印证，cross_source_corroboration 给 2。README 混合了营销语言（'像弹匣一样装填'）与事实陈述，未见明确区分，fact_inference_separation 记 1。
- 本次为静态审查，仅提供 README、package.json、CI 与测试文件，核心 src/ 未见；所有运行时行为均未经执行验证。
- 插件会把子代理提示词持久化到本地 KV（仅做前缀截断），未见脱敏处理；若会话包含敏感内容，请评估本地存储风险。
- README 声称 /subagent-clear-entries 需确认后执行，但无源码佐证，删除操作前请自行备份 OpenCode 数据。
- 未提供 CHANGELOG，升级 1.7.4 时的行为变化只能靠提交历史判断。
- 发布者未经企业注册表验证，安装来自 npm 公共源时请核对包名 opencode-subagent-magazine 与仓库指纹。
- 依赖 OpenCode 的已知问题 #6774，插件缓存可能锁死旧版本，更新需手动清理缓存。