dsh-alive

by AikenFra

UI 增强github 检测到 manifest package.json#dsh 社区精选收录于 08-17

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

Zero-token online status indicator for the DeepSeek Harness web UI: an always-visible online/offline dot in the conversation header, auto-refreshed every 15 seconds with no LLM calls.

安装

$ dsh plugin --profile web add github:AikenFra/dsh-alive

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

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，然后：

在 ~/.dsh/profiles/web/package.json 的 dependencies 加 "dsh-alive": "file:./dsh-alive"
在 dsh.profile.bundles 列表追加 "dsh-alive"
重启 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 轮询