本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-subagent-monitor

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @leetoners/dsh-ui-subagent-monitor

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• id: ui-subagent-monitor

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

刷新页面后面板会消失吗？

不会。面板是组合中的常驻行，每次页面加载都会自动恢复（src/client/panel.tsx:301-323 每秒轮询节点半身的快照路由）。

面板状态点中「完成」和「已结束」有什么区别？

「完成」（绿点）是面板实时观测到的成功结局；「已结束」（灰点）是服务重启前历史记录的子代理，结局未观测，归类为中性状态（src/client/panel.tsx:96-105）。

面板最多能保留多少条记录？

每个根会话最多保留 200 条，已结束的行超出后按最旧淘汰（src/index.ts:45 MAX_PER_ROOT）。

面板的位置和高度会被记住吗？跨会话共享还是按会话隔离？

都会记住，但策略不同：位置写入 localStorage 单键 dsh-smn.panel-position.v1，所有会话共用同一位置；高度按会话分别写入 dsh-smn.panel-height.v2.，切换会话互不影响（src/client/panel.tsx:179-181, 234-248）。

这个面板访问的接口安全吗？需要鉴权吗？

轮询路由 GET /api/subagent-monitor/snapshot 直接挂在 DSH Web 服务端口下、面向回环地址、无鉴权；仅建议本地或内网环境使用（README.md:113）。

子代理行能直接跳到对话吗？怎么回主会话？

卡片右侧的「打开对话」按钮会调用宿主会话服务打开该子代理的会话；进入子代理会话后面板头部会出现「← 主会话」按钮，可一键返回（src/client/panel.tsx:470-478, 497-508）。

移动端能用吗？

视口 ≤768px 时面板默认不弹出，但侧栏「子代理」入口仍可手动打开（src/client/panel.tsx:167 MOBILE_QUERY 与 325-330 自动打开逻辑）。

怎么卸载？

运行 dsh plugin --profile web remove github:Mombrane/dsh-subagent-monitor，再重启 dsh web 即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.0+
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则