API 状态红绿灯 toposferapro/dsh-status-beacon

dsh-status-beacon

DeepSeek API 的可用性红绿灯，以 DeepSeek Harness（DSH）插件形式提供。

输入框工具行里有一个彩色圆点（位于模型菜单左侧）：

- 绿色 — 所有系统运行正常；
- 黄色 — 性能下降；
- 橙色 — 部分服务中断；
- 红色 — 完全中断，或 API 无响应；
- 灰色 — 状态未知（无法读取状态源）。

点击圆点会弹出一个面板，面板通过一个小箭头锚定在圆点上：API 响应延迟、最新事件及其生命周期阶段（Investigating → Identified → Monitoring → Resolved）、事件开始时间、受影响的组件、事件描述，以及状态页链接。

工作原理

宿主端每分钟做两次独立探测：

1. 可达性 — GET https://api.deepseek.com/models，不带密钥：200/401/403 表示服务器存活，超时、5xx 或网络中断则表示无响应。
2. 状态源 — https://status.deepseek.com/history.rss：最新事件、所处阶段及其影响范围。

颜色沿用 DeepSeek 自己的四态标准。已关闭的事件不会给指示灯染色——只有进行中的事件才会，否则一次已解决的性能下降会让指示灯永远停在黄色。

模型 API 密钥刻意不使用：存活/不存活的信号在未授权的情况下获取，这样即使 DSH 升级挪动了密钥存储位置，插件依然能用。

浏览器端读取 /plugins/dsh-status-beacon/api，每 30 秒刷新一次圆点。样式使用 DSH 设计 token（--dsw-alias-*），因此控件与界面风格一致，并跟随深色主题。

安装

dsh plugin --profile web add github:toposferapro/dsh-status-beacon#<commit>

如果 git 不可用——比如在 DSH 容器内部，那里通常没有 git——github: 这种写法无法解析，因为包管理器会为它调用 git。改用 tarball URL 安装同一个固定 commit：

dsh plugin --profile web add \
https://codeload.github.com/toposferapro/dsh-status-beacon/tar.gz/<commit>

两种写法都会同时添加依赖和 dsh.profile.bundles 条目。执行任何 dsh plugin add/remove 之后，检查 dsh.profile.bundles：本插件必须留在 bundle 列表中。

插件在 DSH 启动时加载，所以安装后要重启 dsh 容器：

sudo docker restart dsh

在重启之前，宿主端没有运行，/plugins/dsh-status-beacon/api 会返回 404。要回滚，执行 dsh plugin --profile web remove dsh-status-beacon，然后再次重启。

要求

- 带 web 配置档的 DSH。
- 能对外发起 HTTPS，访问 api.deepseek.com 和 status.deepseek.com。
- 不需要 API 密钥，不需要额外依赖。

许可证

MIT。