这个项目能做什么
OpenCode SubAgent Magazine 是一个针对 OpenCode TUI 的插件,旨在提供实时子代理监控与侧边栏可视化。它像弹匣一样装填并发射子代理信息,帮助用户直观地跟踪每个子代理的运行状态、Token 消耗、费用、耗时、模型和进度等关键数据。
插件的主要功能包括:
- **实时状态显示**:通过彩色圆点(绿色已完成、黄色运行中带呼吸动画、红色错误)一目了然地展示每个子代理的状态。
- **Token 与费用追踪**:汇总每个子代理的 Token 消耗和费用,并在标题栏全局显示。
- **展开详情**:点击条目可展开查看 agent 类型、状态、耗时、Token、费用、模型、进度等详细信息,字段值右对齐,便于阅读。
- **一键进入会话**:展开后点击“→ 进入会话”可直接跳转到该子代理的完整对话。
- **会话 ID 展示**:展开明细中显示子代理的 Session ID,点击可弹窗查看完整 ID 并复制。
- **手动标记完成**:对于卡住的僵尸条目,可通过展开区右侧的“- 标记完成”按钮手动终结,或使用 `/subagent-clear-running` 批量清理。
- **折叠面板**:点击标题栏可折叠/展开面板,状态持久化,重启后保持。
- **滚动回顶/回底**:列表底部提供“↑ 回顶”和“↓ 回底”按钮,方向随排序自适应。
- **可配置排序**:通过 `/subagent-order` 支持降序(最新在前)或升序(最早在前)排列。
- **翻页模式切换**:`/subagent-scroll` 可选择“滚轮翻页”或“点击 more 翻页”,解决侧边栏与全局滚动冲突。
- **TTL 自动清理**:可配置数据保留期限(3/7/14/30 天或无期限),每次访问自动续期,过期自动清除。
- **手动清除条目**:`/subagent-clear-entries` 清除当前会话所有记录,防止历史条目扫描重建。
- **语言适配**:支持 `/subagent-lang` 运行时切换中/英文,偏好持久化。
- **可切换边框**:`/subagent-border` 控制面板外边框显隐(默认隐藏),开启后与缓存统计面板风格统一。
- **斜杠命令**:提供 `/subagent-lang`、`/subagent-max`、`/subagent-order`、`/subagent-scroll`、`/subagent-ttl`、`/subagent-clear-entries`、`/subagent-session`、`/subagent-version`、`/subagent-clear-running`、`/subagent-border` 等动态配置命令。
安装方面,插件同时支持 opencode 1.x 与 2.x。对于 2.x,需要在 `~/.config/opencode/cli.json` 的 `plugins` 数组中添加条目;对于 1.x,可通过命令面板安装或手动配置 `tui.jsonc`。注意不要使用 `opencode plugin add` 安装,因为该命令会写入 server 插件配置导致报错。
使用指南中详细说明了斜杠命令的用法、键盘与鼠标操作(如点击标题栏折叠、点击条目展开、滚轮翻页等),以及状态颜色的含义。更新时需清除插件缓存并重新安装,因为 OpenCode 存在已知问题导致插件版本锁定。
插件完全模型无关,支持所有 OpenCode 兼容的 AI 模型(如 DeepSeek、Claude、GPT 等),数据通过 OpenCode SDK 标准接口获取。采用 MIT 许可证。
评论
0 人表达喜爱 · 满10人后显示 Deer Point
登录后参与讨论。