夜雨聆风学习资料网

ARTICLE · 1330377

OpenCode技巧:分享侧栏插件opencode-subagent-statusline

OpenCode技巧:分享侧栏插件opencode-subagent-statusline
相信大家使用Agent工具时都有种感觉,让agent并行执行任务时最难受的不是它慢,而是没有看到足够的信息反馈,导致我们觉得subagent是处于黑盒的状态去执行任务的。

举个简单的栗子:派两个subagent,一个遍历文件,一个找最大的。主会话打完一行"两个subagent已并行派出",屏幕上只剩两行转圈加偶尔可能会回调过来几条零散的消息。哪个Agent跑完了或者到底跑了多久不知道,甚至中间流程某些命令卡住导致的空转也不知道。这样只能干等,或者干脆切去干别的,然后忘了回来看。

今天分享的插件专门解决这个问题:opencode-subagent-statusline,作者给它起的名字叫Subagent Monitor,MIT协议。



它解决的是什么问题

opencode里多agent并行时,一句"分头去做"就能派出几个subagent。这些子任务默认在后台跑,主会话只留一行状态。

问题就出在这个"后台"。子任务不是没在干活,是你手上没有观察它的窗口,除非你自己翻回去找它。

插件做的事很单一:把子任务的运行状态搬到屏幕上,用一副常驻侧栏放着。不改变agent怎么干活,改的是你观察它的成本。

它长什么样

装好之后有subagent执行中是这个样子:

右侧那一栏是它的主体产出。上面一行汇总写 1 run · 1 done · 0 err,下面两条:

  • [ ] 统计文件数(general)
    ,在跑,一行耗时加token
  • [✓] 找最大文件(general)
    ,已完成,同样一行耗时加token

每条再跟一行模型。设了思考强度变体的会连变体一起显示,所以你能看出哪个子任务开的是高档。

底部还会在subagent活跃时补一句紧凑提示。

它能显示什么信息

running / completed / failed 三类状态每条任务的耗时每条任务的 token 用量每条任务用的模型与变体顶部一行汇总:N run · N done · N err活跃期的底部紧凑摘要

对着清单说能少做什么:不用切回去翻会话看哪个卡住,不用等全部跑完才知道有一个早就失败了,也不用凭感觉猜这一轮烧了多少额度。



怎么装

先说清楚版本线。这个包有两条线,2.x只支持v2,1.x是给老版本用的。两条线的装法不一样:2.x写 cli.json,1.x写 tui.json,而且1.x得把版本钉死,装 opencode-subagent-statusline@1.3.1,直接装latest拿到的是2.x。我按v2写。

还有个更容易踩的:别用 opencode plugin add装它。README里明写了不要这么装,那个命令会顺手把包注册成 opencode.json里的服务端插件,而它只提供终端实现。我第一次就是这么装的,日志里入口是 dist/server.js、角色 role=server,而包自己的默认入口是 dist/tui.js,侧栏当然不会出现。

第一步,配置文件放 cli.json(文档默认路径,实际以 debug paths为准)。v2把插件分成两层:服务端插件写 opencode.json,终端插件写 cli.json,老的 tui.json在v2里不再被读。这个插件只有终端实现,所以要写进 cli.json:

~/.config/opencode/cli.json{  "$schema": "https://opencode.ai/v2/cli.json",  "plugins": ["opencode-subagent-statusline"]}

第二步,确认这个路径是不是你真正生效的配置目录。

第三步,重启,打开交互式TUI,派个子任务给它看。正常的话在opencode窗口拉宽一点就能看到侧边栏(见文章上方的opencode窗口截图)。

对你有用吗

如果你习惯一次只让agent干一件事,侧栏大部分时间空着,装了意义不大。

如果你经常需要执行多agent并行任务,那你可以安装试一下。

它不提升agent的能力,提升的是你对它的掌握程度。


往期精选:

AI Coding Plan、Token Plan 套餐怎么选?我做了个纯静态比价网站

OpenCode 技巧:权限怎么配,四套模板参考

OpenCode小技巧:agent配置的用法

Hermes接Jev:Jev要钱?可以尝试免费开源替代方案

📮

📈 据说关注我的人都升职加薪了

 #插件 #效率工具

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料