dsh-conn-dot
A green connection dot on the top-left brand mark of the DSH Web GUI — the
fish logo beside the product name — showing whether the UI is connected to
the dsh web server.
| dot | meaning |
|---|
| 🟢 green | connected — WebSocket live and/or probe answered |
| 🟡 amber | connecting / not yet determined |
| 🔴 red | disconnected, or the server stopped answering HTTP |
Two signals are merged:
- Live socket state — subscribes to
ctx.connection.state (the runtime's
WebSocket recovery lifecycle: connected / connecting / disconnected).
- Background worker — every 30 seconds, a same-origin
HEAD / probe.
Any HTTP response means the server is alive; a network-level rejection
means broken. This catches a hung server whose socket stays half-open.
The dot shadows the sidebar.brand.mark slot at priority −10 and re-renders
the official FishLogo, so the logo itself is untouched; hover the dot for
status and the time of the last check.
Install (web profile)
npm pack # produces dsh-conn-dot-0.1.0.tgz
dsh plugin --profile web add file:/absolute/path/dsh-conn-dot-0.1.0.tgz
Then add "dsh-conn-dot" to dsh.profile.bundles in
$DSH_HOME/profiles/web/package.json and restart dsh web.
Test
node --test test/client.test.mjs
中文说明 / Chinese
在 DSH Web GUI 品牌标记（产品名旁边的鱼形图标）左上角显示一个绿色连接状态点，
表示 UI 与 dsh web 服务器的连接状况：
| 状态点 | 含义 |
|---|
| 🟢 绿色 | 已连接 — WebSocket 在线且/或探测有响应 |
| 🟡 黄色 | 正在连接 / 尚未确定 |
| 🔴 红色 | 已断开，或服务器停止响应 HTTP |
合并两路信号：① 实时订阅 ctx.connection.state（WebSocket 恢复生命周期）；
② 后台每 30 秒发起同源 HEAD / 探测，任何 HTTP 响应都算存活，
网络层失败才算断开——可捕获 socket 半开、服务器假死的情况。
悬停状态点可查看状态与上次检查时间；界面语言为中文时提示自动切换为中文
（依据浏览器语言，zh-* 自动识别）。
