[Bug Report] Web UI 在后端进程退出后无任何可见提醒（ConnectionBanner 组件存在但从未挂载）

[DRAG0NM]

摘要

后端退出/被杀后，Web UI 全程没有任何可见反馈：不弹横幅、不显示"重连中"、界面看起来一切正常，只有浏览器控制台里一行 [web-runtime] connection lost, retry #N。根因是重连状态机与现成 UI 组件之间存在断线：客户端连接层在断线时确实发出了 reconnecting 状态事件，运行时也收到了，但该事件只被用于清理内部待处理交互状态（不可见），而 UI 库中已实现好的 ConnectionBanner（"连接已断开，正在重连…"）从未被前端 shell 挂载渲染——状态存在、组件存在，唯独中间没有接线。

复现步骤

1. 启动 dsh 并打开 Web UI（127.0.0.1:端口）。
2. 在另一个终端杀掉后端进程（例如 PowerShell Get-Process | Where-Object {...} | Stop-Process，或直接 kill 掉 dsh 宿主进程）。
3. 观察 Web UI：无任何提示、横幅或状态变化；页面仍显示原会话列表，交互（如输入消息）无响应或静默失败。
4. 打开浏览器开发者工具 Console：仅出现 [web-runtime] connection lost, retry #N（N 随退避重试递增），无任何 UI 层日志。
5. 重启后端，页面自动重连成功——但整个断线期间用户从未被告知发生了什么。

社区已实测复现（原讨论评论）：kill 后端进程后端口消失、UI 无任何提醒。

根因（源码定位，rc.6）

1. 断线检测层只发状态事件 + console.warn — @deepseek-ai/dsh-client-connection/lib/client.js：

   • L109-111：连接 generation 异常时 catch 并 abort；
   • L114：this.emitState("reconnecting")（L122-126 去重后回调 sinks.onStateChange）；
   • L116：唯一的用户可感知输出：console.warn("[web-runtime] connection lost, retry #N")；
   • L117-118：退避后无限重试（与 [bug] First-connect failure misreported as 'reconnecting'; retry loop has no cap and no terminal error state #648 首连重试问题同族，本文不展开）。

2. 运行时收到事件后只做不可见的内部清理 — @deepseek-ai/dsh-client-runtime/lib/client.js：

   • L10497-10499：onStateChange: (state) => { if (state === "reconnecting") sessions.handleDisconnected(); }；
   • L8439-8450 handleDisconnected()：仅清空 pendingInteractions、从 pendingBuffers 中过滤掉 approval/requested 与 question/requested 帧——没有任何 UI 副作用。

3. UI 组件其实早已实现 — @deepseek-ai/dsh-client-ui-primitives/lib/index.js：

   • L2134-2137：function ConnectionBanner({ reconnecting, label = "连接已断开，正在重连…" }) { ... }，L5855 导出；前端 bundle（dsh-web-frontend/dist/assets/index-Dqw48FrP.js）的导出表中也能找到 ConnectionBanner。

4. 但该组件在前端是死代码 — 整个 web 前端 bundle 中：

   • 组件零处渲染调用（仅出现在导出表里）；
   • 默认文案 连接已断开 与 reconnecting 关键字在 bundle 中零命中——说明前端 shell 既没有挂载横幅，也没有订阅连接状态；
   • 对比可见：连接句柄的 hostDescription 有完整的 getSnapshot/subscribe 通道（client.js L10168-10176），而连接状态（connected/reconnecting）没有任何 UI 订阅通道。

结论：reconnecting 状态机与 ConnectionBanner 组件都已存在，缺的只是中间接线——前端 shell 从未把连接状态接到任何可见 UI 上。

建议修复

方案 A（推荐）· 在 web shell 挂载 ConnectionBanner 并订阅连接状态：仿照现有 hostDescription 的 getSnapshot/subscribe 模式（dsh-client-connection L10168-10176），在 connection handle 上暴露 connectionState store；dsh-client-runtime L10497 处把 onStateChange 一并写入该 store（保留现有 handleDisconnected() 调用）；web shell 读取该状态，reconnecting 时渲染 primitives 库中现成的 ConnectionBanner。改动小、复用既有组件与既有状态事件，断线/重连对用户完全可见。

方案 B · runtime 全局事件 + 横幅：runtime 在 reconnecting 时 ctx.emit 连接事件，由 UI 层 toast/banner 组件消费。与 A 等效，但多一层事件协议，不如直接复用 A 的 store。

方案 C · 最小改动：仅在前端 shell 内建一个 reconnecting 状态订阅并渲染横幅，不经过 runtime。改动最少，但状态来源绕开了运行时层，后续（如重连成功通知、断线时长展示）扩展性差。

影响

• 后端进程崩溃、被杀或意外退出时，用户完全无感知，可能误以为 Agent 仍在工作，输入的消息静默失败或长期悬挂（与 [Bug] Agent 重启 DSH 时会杀死自身宿主，导致会话永久停留在“运行中” #387 会话永久"运行中"、[bug] Reconnect can silently drop pending approval/question waits (resync() clears pending; mux replay frames race onConnected) #646 重连丢 pending 提问框等家族问题相互放大）。
• 无任何"正在重连"提示，用户无法区分"正常工作中"与"已断线"，故障排查成本高。
• 断线期间被清理的 approval/question 等待（runtime L8444-8449）用户同样不知情，可能造成静默丢失。

环境

• 源码定位：0.1.0-rc.6（npx 缓存安装包，Node v24.16.0，Windows 11）
• 原报告：bug: 前端界面在后端退出后没有任何提醒 #216

验证材料

• 浏览器 Console 复现输出：[web-runtime] connection lost, retry #N（递增重试号）——唯一反馈。
• bundle 静态证据：index-Dqw48FrP.js 中 ConnectionBanner 仅存在于导出表，无渲染调用、无默认文案。
• 社区实测（原讨论评论）：kill 后端进程后 UI 无任何提醒。

---

First analysis of discussion #216. Happy to open a PR with fix option A.

[ICCuse]

评论 B 草稿 → #916（UX 面：boot 失败 → 空白新会话 → 用户误判数据丢失）

补充 #916 的一个更严重的变体：不是"运行中后端退出"，而是"启动即失败"。

现象

当 profile 因插件问题（如 #917 的残留条目，或插件产物缺失）根本起不来时，Web UI 渲染成空白新会话——连 #916 描述的"界面看起来正常但无响应"都不如：用户看到的是一个全新的空页面，第一反应是"我的全部对话和设置都丢了"。

关键事实：数据其实没丢

JSONL 会话日志（~/.dsh/sessions/<ws>/<session>.jsonl.zstd）在 boot 失败时完全完好，恢复服务后原样回来。是 UI 让用户误判为全量丢失——这正是 #916 应该修的核心伤害，不只是"缺个横幅"。

实际报错长这样（终端侧）

dsh: plugin tree failed to load: failed to import loader entry file-memory
(@deepseek-ai/dsh-file-memory): Cannot find module '...\lib\index.js' imported from ...\profiles\web\

终端有诊断，浏览器什么都没有。对双击启动或开机自启的普通用户，终端甚至一闪而过——诊断与用户彻底隔绝。

建议

Web UI 需要两类失败态：

1. 运行中断线（[Bug Report] Web UI 在后端进程退出后无任何可见提醒（ConnectionBanner 组件存在但从未挂载） #916 的 ConnectionBanner 场景）：连接丢失提示 + 重连中；
2. 启动失败（本评论场景）：boot 失败页，显示"服务未能启动 + 原因 + 日志位置 + 数据未丢失的说明"，而不是空白新会话。

两者共用同一个目标：任何后端故障都不能让用户以为数据没了。

社区止损工具（--check 预检 + 启动包装，附恢复指引与数据安全说明）：https://github.com/ICCuse/dsh-web-safe

[yinren112]

I published an installable external plugin as an immediate workaround for this exact visible-disconnect gap: https://github.com/yinren112/dsh-plugin-connection-banner/releases/tag/v0.1.0

Install: dsh plugin --profile web add github:yinren112/dsh-plugin-connection-banner#v0.1.0

I verified the tagged GitHub install from a fresh profile: after a successful connection, stopping the Host shows the existing reconnecting banner without a page reload, and restarting removes it. If you try it, feedback with your DSH version and install method would be very helpful.

[DRAG0NM]

感谢 @yinren112 把"后端退出无 UI 提醒"做成了可安装的 workaround 插件，以及 @ICCuse 补充的"启动即失败 → 空白新会话"更严重变体。前者是立即可用的过渡方案，后者提醒我们：无可见反馈的问题面不止"运行中退出"，还有"从未成功启动"，未来修复时值得一并覆盖。