前言¶
在 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 路由提供給前端,瀏覽器不直接跨域請求狀態站。
- 倉庫:github.com/gmchocolate/dsh-deepseek-status
- 目錄頁:skillhub.cn/plugins/gmchocolate/dsh-deepseek-status
- 許可證:MIT(package.json)
- 當前版本:0.1.4
- 能力邊界:僅 UI / 體驗裝飾與 ambient 監控,不註冊任何 Agent 工具
插件尚未發佈到 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 / 幻方無官方從屬關係。