前言¶

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 仓库。