前言¶
在 DeepSeek Harness（dsh）的 web profile 中，会话界面通常不会直接显示后端服务是否仍然可用。手动刷新页面可以判断页面能否打开，但如果想持续观察 dsh web 服务状态，额外发起一次模型请求并不合适，也会消耗 token。
dsh-alive 针对这个问题提供了一个常驻状态点：它通过本地进程内 ping 判断服务是否在线，不调用 LLM，也不消耗 token。下面介绍它的功能、安装方式和使用注意点。
这是什么¶
dsh-alive 是 AikenFra 维护的 dsh Web 界面插件，许可证为 MIT。
它的作用是在 dsh web 会话头部右上角显示一个状态点：
- 绿色：在线
- 红色：离线
- 黄色：检测中
当前 package.json 版本为 0.1.1，要求 Node >=18，并测试于 dsh 0.1.0-rc.6 的 web profile。
核心功能¶
dsh-alive 提供的能力比较集中，主要围绕“在线状态可见”：
- 会话头部右上角常驻状态点，绿色 = 在线，红色 = 离线，黄色 = 检测中。
- 每 15 秒自动检测一次，无需手动刷新。
- 零 token 消耗：纯进程内 ping，不调用任何 LLM。
- 开箱即用，无需配置。
- 服务不可用时状态点变红，恢复后自动变回绿色。
工作原理¶
后端在 dsh 服务进程中注册一个进程内 HTTP 端点：
GET /dsh-alive/ping
该端点直接应答，不经过任何模型。
前端通过 dsh 的 slot 系统注入组件，挂载位置为：
conversation.session.header.utilities
前端每 15 秒轮询一次上述 ping 端点，并根据响应更新状态点。
安装与启用¶
先确认本机已安装 DeepSeek Harness（dsh），并且准备在 web profile 下使用。
使用插件安装命令¶
README 标注 dsh plugin --profile web add dsh-alive 适用于 npm 发布后的安装方式。执行后会安装到 web profile：
dsh plugin --profile web add dsh-alive
安装完成后重启 dsh web 服务：
dsh web
重启后打开浏览器页面，并按 Ctrl+F5 强制刷新。会话头部右上角应能看到状态点。
本地或手动安装¶
如果 npm 包发布状态尚未确认，可以使用本地方式安装。
1、把本仓库放到指定目录：
~/.dsh/profiles/web/dsh-alive
2、在本地 profile 的 package.json 中添加依赖：
{
"dependencies": {
"dsh-alive": "file:./dsh-alive"
}
}
对应文件路径：
~/.dsh/profiles/web/package.json
3、在 dsh profile 配置的 dsh.profile.bundles 列表中追加插件名：
"dsh-alive"
4、重启 dsh web：
dsh web
5、打开页面并硬刷新，例如按 Ctrl+F5。
卸载¶
使用插件命令卸载：
dsh plugin --profile web remove dsh-alive
卸载后重启 dsh web：
dsh web
典型用法¶
适合在启动 dsh web 后快速确认服务是否可用：
1、启动 dsh web 服务：
dsh web
2、打开 dsh web 页面。
3、查看会话头部右上角的状态点：
- 绿色表示在线。
- 红色表示离线。
- 黄色表示正在检测。
4、等待约 15 秒，状态点会自动更新，不需要手动刷新。
如果服务恢复，状态点会自动从红色变回绿色。
适用场景与注意¶
适合以下场景：
- 使用 dsh 的
webprofile，希望在不消耗 token 的情况下观察服务在线状态。 - 本地调试 dsh web 时，需要快速发现服务是否挂掉。
- 页面长时间打开，希望状态点持续提示后端服务状态。
需要注意以下几点：
- dsh-alive 依赖 dsh 的 slot 系统
conversation.session.header.utilities与webServer服务注入，要求 dsh web 客户端框架版本匹配。 - 安装后必须重启 dsh web 并硬刷新页面，否则前端组件可能不会生效。
- 该插件会注册进程内 HTTP 端点，并注入前端组件。安装前建议检查源码、依赖和 MIT 许可证。本文资料未提供独立权限模型说明，应以当前 dsh 进程权限为界评估其运行影响。
dsh plugin --profile web add dsh-alive在资料中标注适用于 npm 发布后；如果 npm 包发布状态未确认，优先使用本地或手动安装方式。- 本文不引用星标数、分类或具体目录页地址，因为这些信息未在已核实资料中明确出现。
结尾¶
dsh-alive 的价值比较直接：用一次进程内心跳替代额外模型调用，在 dsh web 界面中常驻显示在线状态。当前可参考仓库为：
https://github.com/AikenFra/dsh-alive
目录页 URL 未在已核实资料中确认，本文不提供具体目录页地址。
