AikenFra/dsh-alive

A zero-token online status indicator for the DeepSeek Harness (dsh) web UI. 为 DeepSeek Harness (dsh) Web 界面提供零 token 消耗的在线状态指示器。

在会话窗口右上角常驻显示 ● 在线 / ● 离线 状态点，每 15 秒自动检测一次。完全不调用 LLM，零 token 消耗——只是浏览器对本地服务做一次进程内的 HTTP 心跳。

An always-visible ● Online / ● Offline indicator in the conversation header, auto-refreshed every 15 seconds. It costs zero tokens — the browser simply polls a process-local HTTP endpoint.

功能 / Features

• ✅ 会话头部右上角常驻状态点（绿色 = 在线，红色 = 离线，黄色 = 检测中）
• ✅ 每 15 秒自动检测，无需手动刷新
• ✅ 零 token 消耗：纯进程内 ping，不调用任何 LLM
• ✅ 开箱即用，无需任何配置
• ✅ 服务挂了立刻变红点，恢复后自动变回绿点

截图 / Screenshots

● 在线（绿色）| ● 离线（红色） — 会话窗口右上角常驻显示：

在线 / Online	离线 / Offline

工作原理 / How it works

浏览器页面 --(每 15s fetch)--> GET /dsh-alive/ping --> dsh 服务进程（直接应答）
                              | 零 LLM 调用，零 token

• 后端：注册一个进程内 HTTP 端点 GET /dsh-alive/ping，立即返回 {"ok":true}，不经过任何模型。
• 前端：通过 dsh 的 slot 系统注入一个小组件到 conversation.session.header.utilities，用 setInterval 每 15 秒轮询一次 ping 端点，根据响应更新状态点。

安装 / Install

需要已安装 DeepSeek Harness（dsh）。适用于 web profile。

# 装进 web profile（npm 发布后）
dsh plugin --profile web add dsh-alive

# 重启服务
dsh web

重启后打开页面，按 Ctrl+F5 强制刷新，右上角即可看到状态点。

本地/手动安装（未发布时）

把本仓库放到 ~/.dsh/profiles/web/dsh-alive，然后：

1. 在 ~/.dsh/profiles/web/package.json 的 dependencies 加 "dsh-alive": "file:./dsh-alive"
2. 在 dsh.profile.bundles 列表追加 "dsh-alive"
3. 重启 dsh web 并硬刷新页面

卸载 / Uninstall

dsh plugin --profile web remove dsh-alive
dsh web

兼容性 / Compatibility

• 测试于 dsh 0.1.0-rc.6（web profile）
• 依赖 dsh 的 slot 系统（conversation.session.header.utilities）与 webServer 服务注入，要求 dsh web 客户端框架版本匹配

开发 / Development

dsh-alive/
├── package.json        # 插件清单（dsh.bundle / dsh.client）
├── cordis.patch.yml    # bundle 挂载声明
├── dsh/
│   └── index.js        # 后端：/dsh-alive/ping 进程内端点
└── client/
    └── client.js       # 前端：状态点组件 + 15s 轮询

License

MIT