前言¶
在 DeepSeek Harness(DSH)里长时间跑会话或接 API 时,官方服务若出现中断或性能下降,往往在报错之后才知道。自己盯着 status.deepseek.com 不现实;把 RSS 挂到别的通知渠道,又和 DSH 界面脱节。下面介绍的插件由 BI4PYM 维护,在 DSH 插件体系里以 Host 轮询官方状态 Feed、在 Web UI 里弹出可配置的通知,并可选常驻健康状态 pill。
这是什么¶
dsh-deepseek-status-monitor 是 DeepSeek Harness 的插件:按设定间隔读取 DeepSeek 官方服务状态源(默认 RSS / Atom),把中断、降级、恢复等变化以气泡、横幅或 pill 形式展示在 DSH Web UI;可点击查看详情,也可保留小型常驻状态指示器。
- 仓库:https://github.com/BI4PYM/dsh-deepseek-status-monitor
- npm 包名:
dsh-deepseek-status-monitor(package.json版本 1.0.0,MIT,要求 Node>=20) - 社区目录页:https://www.skillhub.cn/plugins/BI4PYM/dsh-deepseek-status-monitor
核心功能¶
展示与交互¶
通知形态包括 bubble、banner、pill;每种有六种位置、三种尺寸,另可单独配置常驻状态 pill 的位置。内容包含彩色状态点、事件类型(outage / degraded / recovered)、事件标题与相对时间;未解决事件会持续显示。点击通知可查看当前健康度、进行中事件、近期变更与历史、状态页链接、上次检查时间。
常驻指示器可选:绿为健康,琥珀为降级/维护,红为中断;无法校验时 pill 为琥珀色「check failed」。关闭弹窗后 pill 仍可保留。Host 按配置间隔读 Feed;页面每 10 秒同步 Host 缓存,避免反复请求上游。
语言与容错¶
界面语言跟随 DSH,或在插件设置里强制中文/英文。RSS 失败会回退 Atom;两者都失败时保留上次快照,超过 10 分钟后显示「状态检查失败」通知,pill 转琥珀而非误报健康。
通知触发规则¶
| Feed 中的变化 | 通知 |
|---|---|
| 新出现(或重开)且标题含 中断 / unavailable / outage / interruption 的未解决事件 | 服务中断(红) |
| 新出现(或重开)且标题含 性能下降 / degraded / 异常 / error 的未解决事件 | 性能降级(琥珀) |
事件状态变为 resolved |
服务恢复(绿) |
| Feed 或 Host 路由失败超过 10 分钟 | 状态检查失败(琥珀) |
启动时 Feed 里已有的历史事件不会重复弹窗;仍未解决的事件会作为进行中通知展示。仅状态文案推进(investigating → identified → monitoring)或仅时间戳变化不会再次公告。
安装与启用¶
npm 发布后,在目标 profile 上执行:
dsh plugin --profile <profile> add dsh-deepseek-status-monitor
也可将本仓库目录或打包的 .tgz 作为 bundle 安装到当前 profile:
plugin_manager action: install_bundle target: <absolute path to this directory or .tgz>
bundle 会通过 cordis.patch.yml 插入 deepseek-status 行及默认配置。插件在 Host 进程中用全局 fetch 访问网络,权限与当前 dsh 进程一致;安装前宜自行审阅源码与 MIT 许可证。
Profile 级配置(cordis.patch.yml)¶
bundle 行支持下列键(资料原文默认值):
| 键 | 默认 | 含义 |
|---|---|---|
feedUrl |
https://status.deepseek.com/feed.rss |
读取的 Feed;官方 RSS/Atom 互为回退;自定义镜像不会静默回退到官方源 |
refreshIntervalSeconds |
60 |
两次网络检查的最小间隔(15–3600) |
requestTimeoutMs |
10000 |
单次请求超时 |
maxIncidents |
20 |
响应中保留的事件条数 |
noticeTopOffsetPx |
90 |
顶部锚定通知相对框架顶部的偏移(0–400),通常贴在会话标题栏下方 |
demo |
false |
外观演示:循环位置/尺寸,不改动真实状态或已保存设置 |
应用内设置与典型用法¶
路径:Settings → Built-in plugins → DeepSeek status,或某条通知详情里的设置区。
- Display language:Auto / 中文 / English
- form:bubble / banner / pill
- position:气泡与 pill 为六处角点,横幅为顶/底;锚定在对话内容列(不含侧栏与停靠右栏)
- size:small / medium / large(含常驻 pill)
- 检查间隔:15–3600 秒
- 自动隐藏:N 秒后隐藏(
0表示需手动关闭;进行中事件、常驻 pill、检查失败通知不自动隐藏) - 通知类型:勾选 outage、degradation/maintenance、recovery、failed checks
- 常驻状态 pill 开关及独立位置
- Test notice 预览与 Restore defaults
偏好存在当前浏览器的 localStorage(dsh.deepseek-status.settings.v1);已关闭的通知记录在 dsh.deepseek-status.dismissed.v1。这些仅影响展示,不会改写 profile 的 patch 文件。
日常用法:安装并启用后保持默认 Feed 与 60 秒检查即可在 UI 侧感知官方状态变化;若 Harness 顶栏高度变化,可在 profile 里调整 noticeTopOffsetPx。
适用场景与注意¶
适合在 DSH Web UI 内开发、调试或长时间使用 DeepSeek 服务、希望与官方状态页同步、又不想离开界面的用户。发布身份与 cordis.patch.yml 中的 deepseek-status 行、client.js 中的模块 id 一致;社区 awesome-dsh-plugin 分类为 notify。
需要注意:
- Host 无
fetch时会在 payload 中报告失败;浏览器保留上次快照,超过宽限期后指示器进入琥珀「检查失败」,而非假装健康。 - 通知锚定在对话列;全屏或浮动右栏未参与测量时,通知可能与之重叠。
- 状态变迁历史在内存中;重启 Host 会重新建立基线,停机期间的变化不会再次公告。
- 路由只读公开状态数据,不接受配置写入。
结尾¶
dsh-deepseek-status-monitor 把官方状态 Feed 接到 DSH 前端:可配置的通知、详情面板与可选常驻 pill,并带有 Feed 回退与长时间拉取失败的明示。更多信息见 GitHub 仓库 与 SkillHub 目录页。