前言¶

DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在 Web GUI 開發或使用場景中，側邊欄左下角是一個常見的展示位。如果需要在側邊欄展示實時加密貨幣行情（如 BTC、ETH 等），且不想引入複雜的依賴或配置 API 密鑰，dsh-plugin-crypto-ticker 提供了一個零依賴、免密鑰的解決方案。

插件概覽¶

這是一個由 18569663yz-web 維護的聯網工具類插件，默認安裝在 DSH Web GUI 側邊欄左下角。它顯示 BTC、ETH、SOL、JUP 等主流代幣的價格、24h 漲跌幅和迷你走勢圖。插件在價格跳動時會提供脈衝反饋，並支持多源數據降級和系統代理自動適配。

核心功能¶

• 紅漲綠跌：遵循中文市場的顯示習慣。
• 真實 24 小時數據：通過 OKX 或 Binance 獲取真實的 1 小時 K 線數據，而非裝飾性圖表。
• 價格脈衝反饋：價格上跳標紅、下跳標綠，並伴隨短暫的視覺脈衝，便於快速識別變動。
• 多源降級：數據源優先級爲 OKX → Binance → CoinGecko。全部不可用時，插件會保留最後已知價格並置灰，而不是清空界面。
• 宿主側緩存：多標籤頁共享同一份數據，避免重複請求上游接口。
• 自動適配系統代理：插件運行時會自動探測並適配 Windows 系統代理設置，解決國內網絡直連問題。
• 零依賴、免密鑰：不依賴外部 API 密鑰，開箱即用。

安裝與啓用¶

使用官方命令進行安裝：

dsh plugin --profile web add github:18569663yz-web/dsh-plugin-crypto-ticker

安裝完成後，必須重啓 dsh web 才能生效（桌面端需完全退出後重開）。

配置¶

配置項寫在 profile 的 cordis.patch.yml 中，全部可選。

- id: crypto-ticker
  config:
    symbols: [BTC, ETH, SOL, JUP]   # 要顯示的標的，默認 BTC, ETH, SOL, JUP
    schedule: 15                    # 刷新間隔（秒），默認 15
    cacheMs: 10000                  # 宿主緩存窗口，默認 10 秒
    sparklineCacheMs: 300000        # 走勢序列重取間隔，默認 5 分鐘
    upstreamTimeoutMs: 8000         # 單個信源超時，默認 8 秒
    proxy: false                    # 顯式代理 / false 強制直連 / 不填自動探測

• 添加代幣：通過 symbols 配置項添加其他代幣（如 BNB、XRP 等）。
• 刷新頻率：通過 schedule 配置項調整刷新間隔。
• 代理設置：通過 proxy 配置項控制是否使用代理（僅支持 http:// 代理）。

已知限制¶

• 顯示範圍：僅支持 web / desktop 的 Web GUI 顯示，不支持 headless 或無側欄的 profile。
• K 線限制：CoinGecko 免費 API 不支持 K 線。當只有 CoinGecko 可用時，走勢圖會退化爲本次會話內的實時讀數曲線。
• 文案硬編碼：界面文案爲中文硬編碼，未接入 DSH 的 locale 字典。
• 代理協議：僅支持 http:// 代理，不支持 https:// 代理。
• 數據歸屬：行情數據版權歸各交易所所有，僅供個人參考。

總結¶

對於需要在開發環境中快速查看行情的開發者，dsh-plugin-crypto-ticker 提供了一個輕量級的解決方案。其多源降級和系統代理適配能力，在國內網絡環境下尤爲實用。更多細節可查閱 GitHub 倉庫。