前言¶
在 DeepSeek Harness（DSH）里写智能体、调模型时，API 是否可达、官方是否在报障，往往要另开浏览器查状态页或自己 curl 探测。排障时若界面里没有统一信号，容易把「模型配置问题」和「平台侧降级或中断」混在一起。dsh-status-beacon 是社区维护的 DSH 联网类插件，在 Composer 工具栏（模型菜单左侧）放一颗可点击的状态点，把可达性探测与 DeepSeek 官方状态 RSS 合成同一套四档颜色，便于在写 Harness 时一眼判断环境是否正常。
这是什么¶
dsh-status-beacon 由 toposferapro 维护，定位为 DeepSeek API 可用性「红绿灯」，面向已启用 web profile 的 DSH 实例。它不替代官方 status.deepseek.com，而是在 DSH Web UI 内提供轻量指示与详情面板；插件以当前 DSH 进程权限运行，安装前宜自行查看 GitHub 源码 与 MIT 许可证。
社区插件目录见 SkillHub 条目（与 DeepSeek / 幻方无官方从属关系，DSH 生态遵循「一切皆插件」的扩展方式）。
界面上的状态含义¶
Composer 工具栏左侧的彩色圆点含义如下（与 DeepSeek 官方四档状态对齐）：
- 绿色：All Systems Operational（一切正常）
- 黄色：Degraded Performance（性能降级）
- 橙色：Partial Outage（部分中断）
- 红色：Full Outage，或 API 无响应
- 灰色：未知（无法读取状态 feed）
点击圆点会打开锚定在圆点旁的面板，可查看 API 响应延迟、最新 incident 的生命周期阶段（Investigating → Identified → Monitoring → Resolved）、开始时间、受影响组件、描述，以及指向官方状态页的链接。
核心功能与工作机制¶
下面介绍主机侧与浏览器侧如何配合（事实均来自插件 README）。
主机侧：每分钟两次独立探测¶
-
可达性（Reachability）
对https://api.deepseek.com/models发起 不带 API Key 的GET。返回200/401/403视为服务存活；超时、5xx 或网络中断视为无响应。 -
状态 feed
读取https://status.deepseek.com/history.rss，解析最新 incident、阶段与受影响范围。
颜色遵循 DeepSeek 四档规则：已关闭（closed）的 incident 不会染色——只有活跃事件才会影响指示灯，避免已解决的降级长期把灯留在黄色。
插件故意不使用模型 API Key 做存活探测，以便在 DSH 升级、密钥存储位置变化时仍能工作。
浏览器侧：30 秒刷新¶
前端请求 DSH 上的 /plugins/dsh-status-beacon/api，约每 30 秒 刷新圆点。样式使用 DSH 设计 token（--dsw-alias-*），与界面及暗色主题一致。
安装与启用¶
安装命令须 pinning 到具体 commit（README 中的 <commit> 需替换为你要固定的 Git 提交哈希）。
在宿主机等具备 git 的环境：
dsh plugin --profile web add github:toposferapro/dsh-status-beacon#<commit>
若环境没有 git（例如 DSH 容器内常见情况），github: 形式无法解析，可改用 tarball：
dsh plugin --profile web add \
https://codeload.github.com/toposferapro/dsh-status-beacon/tar.gz/<commit>
两种形式都会添加依赖并在 dsh.profile.bundles 中登记。每次 dsh plugin add/remove 后，请确认 dsh-status-beacon 仍在 bundle 列表中。
插件在 DSH 启动时加载，安装后需 重启 dsh 容器，否则主机侧未运行，/plugins/dsh-status-beacon/api 会返回 404：
sudo docker restart dsh
回滚可执行：
dsh plugin --profile web remove dsh-status-beacon
然后再次重启容器。
典型用法¶
安装并重启后，无需额外配置项或 API Key：
- 打开 DSH Web Composer，在模型菜单左侧查看状态圆点颜色。
- 若怀疑平台侧问题，点击圆点打开面板，对照延迟、incident 阶段与官方链接。
- 若圆点为灰色或长期红色，可结合主机出站网络（见下文「适用场景与注意」）与官方状态页排查。
package.json 标明插件版本 0.1.0，运行时要求 Node.js >= 22.19.0（由 DSH 宿主环境满足即可，使用者通常只需完成上述 plugin 安装流程）。
适用场景与注意¶
适合谁
- 长期在 DSH web profile 下开发 Harness、需要快速区分「本地配置 / 网络」与「DeepSeek 平台状态」的开发者。
- 希望在不打开额外标签页的情况下，跟随官方 RSS 与简单 HTTP 探测做日常可用性感知。
环境与权限
- 需要 DSH web profile。
- 出站 HTTPS 须能访问
api.deepseek.com与status.deepseek.com。 - 不需要 DeepSeek API Key，无额外 npm 依赖声明。
安全与运维
- 插件以 当前 dsh 进程权限 运行；安装前应阅读仓库源码与 MIT 许可证，确认符合你的部署策略。
- 未重启容器时 API 路由不可用，属预期行为，勿误判为插件损坏。
结尾¶
dsh-status-beacon 把「无 Key 的 models 探测」和「官方 history RSS」合成 Composer 里的一颗灯，点击可看 incident 与状态页链接，适合作为 DSH 日常开发时的联网侧参考，而不是替代官方运维通道。
