dsh-deepseek-status:側欄實時 DeepSeek 服務狀態燈

前言

在 DeepSeek Harness 裏跑 Agent 或調試 Web 客戶端時,API 變慢、對話失敗並不總是本地配置問題——上游平臺可能正處於降級或部分中斷。單獨打開瀏覽器標籤頁盯 status.deepseek.com,會打斷你在 Harness 裏的工作流。社區插件 dsh-deepseek-status(維護者 gmchocolate)把公開狀態頁的數據收進 Harness 左側欄底部:一根可掃視的發光燈管,懸停或鍵盤聚焦時展開完整狀態卡片。它不增加 Agent 工具,屬於界面與體驗類擴展;SkillHub 目錄將其歸類爲聯網工具。

這是什麼

dsh-deepseek-status 是一個 DeepSeek Harness 插件 bundle:在左側欄 footer 註冊 sidebar.footer.action 槽位,展示來自 status.deepseek.com 的實時平臺狀態。數據經宿主側同源 JSON 路由提供給前端,瀏覽器不直接跨域請求狀態站。

插件尚未發佈到 npm,因此不會出現在 Harness 應用內「插件中心」(該列表僅一鍵 npm 插件);社區市場仍可用下文 GitHub 源安裝命令收錄。

核心功能

側欄狀態燈

燈管樣式:玻璃邊框內 10 段發光單元,帶柔光與下方 faint spill。寬側欄約 34px 長,摺疊 56px 側欄軌約 25px,位於 footer 行左緣。

顏色對應整體或推導狀態:

狀態 顏色
operational 綠
maintenance 藍
degraded 琥珀,慢速呼吸動畫
partial outage 橙紅
full outage 紅,較快脈衝
status unavailable 灰

在 prefers-reduced-motion 下會關閉 degraded / full outage 的動畫。

懸停與聚焦卡片

鼠標懸停或鍵盤聚焦燈管時,顯示固定定位卡片,內容包括:

  • 平臺整體狀態
  • 按 section 分組的服務組件及各自狀態
  • 進行中的 incident / maintenance 窗口、最新更新、受影響組件與時間
  • 上游來源名稱

文案通過宿主 locale 服務支持 英文與中文;顏色使用宿主主題 token,隨淺色 / 深色主題切換。

數據路徑(爲何需要 Host 半部)

status.deepseek.com 爲 Next.js App Router 頁面,實時數據嵌在 HTML 的 React flight payload 中,且源站 不提供 CORS,瀏覽器無法直接讀取。插件因此拆成兩半:

status.deepseek.com ──fetch(HTML + flight payload)──▶ Host 半部 (index.js)
                                                       │ 歸一化爲一份 snapshot
                                                       ▼
                        GET /plugins/deepseek-status.json  (同源)
                                                       │
                                                       ▼
                                                    Client 半部 (client.js)
  • Host 半部:每 90s 拉取狀態頁,解析 initialData(組件目錄與 active changes,affected_components[].status 爲各組件當前狀態);解析失敗時回退 history.rss。結果在同源精確路由上提供 JSON。
  • Client 半部:註冊側欄 footer,每 60s 輪詢該路由,並在標籤頁重新可見時刷新;繪製燈管與卡片。

對外僅每 90 秒一次 HTTPS GET 到公開狀態頁(失敗時用 RSS),不讀憑據與本地文件。

安裝與啓用

將 web 換成你實際使用的 profile(desktop、web 或自定義)。底層等價於 pnpm add,從 GitHub 檢出包安裝。

dsh plugin --profile web add github:gmchocolate/dsh-deepseek-status

安裝後 重新加載 Harness Web 頁面 一次;客戶端 bundle 按頁加載提供。

本地 checkout 也可通過 Harness plugin_manager 的 install_bundle 安裝絕對路徑目錄;README 同時給出了 git clone 步驟,本文不展開 clone 流程。

典型用法

安裝並重載頁面後無需額外配置即可使用:看側欄底部燈色判斷平臺是否正常;需要明細時懸停燈管。

開發與維護者可用倉庫內腳本驗證解析與渲染(需 Node 18+,與 DSH 自帶 Node 一致):

npm test            # 離線:flight 解析、歸一化、客戶端渲染
npm run test:live   # 可選:對真實狀態頁做一次 live 解析

README 記錄的 live 輸出示例(節選):

live: overall=degraded
live: counts={"operational":4,"maintenance":0,"degraded":3,"partial_outage":0,"full_outage":0}

運行時調參寫在 無 schema 配置 的源碼頂部:index.js 中 REFRESH_MS、ROUTE_PATH、FETCH_TIMEOUT_MS;燈管幾何在 client.js(如 LAMP_CELLS、.dss-cell 寬高)。

適用場景與注意

適合:長期在 Harness Web / Desktop 中開發或運維 DeepSeek 相關 Agent,希望在同一界面內感知官方狀態頁變化,而不額外開標籤。

兼容與要求(來自 README):

項 說明
DeepSeek Harness 在 Desktop runtime 0.2.1-rc.5 開發與驗證;僅用穩定擴展點
平臺 macOS 已驗證;Windows / Linux 預期可用(純 JS),未驗證
依賴 無第三方依賴、無構建步驟
權限 無 Agent 工具、無憑據、無文件系統訪問

安裝前建議:插件以當前 DSH 進程權限運行;安裝前閱讀倉庫源碼與 MIT 許可證。JSON 路由對同源 GET/HEAD 無鑑權,僅承載公開狀態頁數據,且綁定 Harness 監聽器。

已知限制:

  • 上游 HTML 結構變化時先 RSS 兜底,再可能顯示灰色「狀態不可用」。
  • 懸浮卡片使用 position: fixed;若宿主給側欄祖先加了 transform,卡片位置可能偏移。

結尾

dsh-deepseek-status 把 status.deepseek.com 的公開狀態收斂到 Harness 側欄:一眼看燈色,懸停看組件與事件。屬於 DSH「一切皆插件」生態中的社區聯網 / 界面類擴展,目錄由 SkillHub 等獨立站點維護,與 DeepSeek / 幻方無官方從屬關係。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜