AikenFra/dsh-alive 预览 preview

AikenFra/dsh-alive

Project Overview项目介绍

dsh-alive is a native plugin built exclusively for the web profile of DeepSeek Harness. It adds a persistent online status indicator to the top right corner of every conversation window in the DSH web UI. The indicator automatically checks the DSH service connection status every 15 seconds, and uses different colors to signal the current status: green for online, red for offline, and yellow for when the check is in progress. Unlike most DSH plugins that interact with LLMs, this plugin consumes zero tokens, because all it does is poll a local in-process HTTP endpoint added by the plugin itself.

This plugin is designed for users who run a local DSH web client and want an easy, at-a-glance way to check if their DSH service is still running properly. It eliminates the common frustration of waiting for an LLM response when the DSH service has crashed or stopped unexpectedly without you noticing. After you install the plugin, you just need to restart your DSH web service and force-refresh your browser page to see the new status indicator. No extra configuration or advanced setup steps are required to get it working correctly out of the box.

The plugin has been tested to work with DSH version 0.1.0-rc.6 for the web profile, and requires access to DSH's slot injection system and webServer service extension capability, so it will only work if your DSH framework version is compatible. It is released under the permissive MIT open source license, which means anyone can use, modify, or redistribute it for free. You can install it via the DSH CLI command dsh plugin --profile web add dsh-alive, or install it manually if you want to modify the code before use. Uninstallation is also done via the DSH CLI with a simple command.

这是一款专为 DeepSeek Harness 开发的原生插件,仅适用于 DSH 的 web 客户端配置文件。它会在会话窗口右上角常驻显示 DeepSeek Harness 服务的在线状态点,每 15 秒自动检测一次连接状态,用绿色表示在线、红色表示离线、黄色表示检测中。整个检测过程不调用任何大语言模型,仅通过浏览器轮询插件新增的本地进程内 HTTP 端点,零 token 消耗,开箱即用无需额外配置。

对于使用 DeepSeek Harness web 客户端的用户来说,这款插件可以快速直观地告知当前服务是否在线,避免在服务意外中断后还盲目等待大模型生成回复。用户只需按照标准流程安装插件后,重启 DSH web 服务,再强制刷新浏览器页面就可以正常使用,不需要做任何额外的配置调整。当服务意外崩溃停止后,状态点会立刻变成红色,服务恢复后也会自动变回绿色。

这款插件目前已经测试兼容版本 0.1.0-rc.6 的 DSH web 客户端,依赖 DSH 的 slot 注入系统和 webServer 服务能力,要求 DSH 的框架版本匹配才能正常工作。它采用 MIT 许可证开源,允许任何人免费使用和修改。安装方式既支持通过 DSH 命令行从 npm 一键安装,也支持手动本地安装,卸载同样可以通过命令行完成。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-alive

把 AikenFra/dsh-alive 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-alive · 零 token 在线状态指示器

npm version npm downloads license GitHub stars

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

← 上一个 Prev SinglePlayer 下一个 Next dsh-move-rag →