前言¶
DeepSeek Harness（DSH）採用插件化架構。在使用過程中，除了模型切換和對話交互，開發者往往需要直觀地查看當前資源狀態與本地調用記錄。dsh-signal 專注於視覺展示與只讀狀態監控，不涉及登錄邏輯或路由修改。
是什麼¶
dsh-signal 是一個獨立的 Web UI 與觀測插件，由 Ricardo-WJP 維護。它爲 DSH 增加了水面折射品牌動效、真實餘額與剩餘額度顯示、模型工作說明翻譯以及本地 Token 用量統計。
核心功能¶
dsh-signal 提供以下能力：
- 品牌與視覺：提供點陣水流、隨指針響應的藍色折射效果。支持淺深主題切換與減少動態選項。外觀參考 Magic UI Border Beam 與 Aceternity Glowing Effect，以原生 CSS 實現。
- 資源監控：顯示品牌/訂閱身份與可信資源數據。額度條長度代表剩餘多少。支持 DeepSeek、OpenCode Go、OpenRouter、Moonshot/Kimi、SiliconFlow 等供應商。Codex 額度需配合 Codex Connect 使用。
- 工作說明：將工具類別翻譯爲通俗動作，不展示參數。
- 本地統計：提供 Token 日曆、篩選、周視圖和累計統計。不讀取聊天正文，不根據 Token 猜測費用。
安裝與啓用¶
使用前請確保系統已安裝 Node.js 22+ 和 DeepSeek Harness。
推薦使用 npm 安裝當前版本 0.6.12：
npx @deepseek-ai/dsh plugin --profile web add dsh-signal@0.6.12
如需從 GitHub 安裝已構建版本：
npx @deepseek-ai/dsh plugin --profile web add github:Ricardo-WJP/dsh-signal#v0.6.12
使用其他 profile 時，請將 web 替換爲對應名稱。
數據與隱私¶
- 憑據安全：餘額憑據由 DSH Host 讀取，僅向固定或嚴格允許列表內的官方 HTTPS 端點發送。瀏覽器不會得到原始憑據。
- 本地統計：用量統計僅讀取本地會話的結構化 Token 記錄，不上傳統計數據。
- 刷新機制：前臺調度約 45 秒輪詢一次，展開頁面、切換模型或任務完成時觸發刷新。後臺暫停非必要刷新。請求合併、節流和失敗退避可能延後讀取。供應商緩存仍可能導致延遲，這不是實時推送。
開發¶
插件包含純邏輯與刷新調度迴歸測試。如需自行構建：
npm ci
npm run build:client
npm run check
npm pack --dry-run
適用場景¶
適合需要直觀視覺反饋和本地調用統計的開發者。注意：這不是登錄插件，不修改模型路由，不自動切換模型。
