前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构。在本地运行智能体或进行开发调试时，频繁切换到 DeepSeek 平台控制台查看余额和今日消费会打断工作流。需要在 DSH 网页界面中直接、实时地获取这些信息。
是什么¶
dsh-deepseek-quota 是一个为 DSH Web GUI 设计的插件，由用户 ricardolicong 维护。它通过右下角的悬浮卡片，展示 DeepSeek API 的额度状态和消费详情，无需离开当前页面。
核心功能¶
- 悬浮卡片显示：卡片固定在页面右下角，不遮挡主界面。
- 关键信息展示：显示总余额、可用状态、当前对话费用以及今日消费。
- 自动刷新：余额每 60 秒自动刷新，对话费用每 5 秒自动刷新。
- 交互与持久化：卡片可拖拽移动，支持最小化；位置和状态保存在本地存储中，刷新页面后保持。
- 错误处理：对 API Key 缺失、网络失败或接口报错有明确的错误状态提示。
- 定价计算：使用官方 DeepSeek 价格表计算当前对话费用。
- 本地安全：API Key 仅在本地处理，不会离开用户的机器。
安装与启用¶
前置条件：已安装 DSH CLI 和 pnpm。
dsh plugin --profile web add dsh-deepseek-quota
安装完成后，按以下步骤启用：
- 重启 Web 应用：
dsh web。 - 打开 http://127.0.0.1:3080 并刷新页面。
- 在设置页面配置
DEEPSEEK_API_KEY，或在环境变量中导出。
典型用法¶
配置好 DEEPSEEK_API_KEY 后，右下角即会出现额度卡片。若需获取官方今日消费数据，可设置可选的环境变量 DEEPSEEK_PLATFORM_TOKEN；未设置时，插件会使用估算值。
注意事项¶
- 插件依赖 DSH CLI 和 pnpm。
- API Key 仅在本地处理，浏览器仅访问本地注册的路由。
- 若未配置
DEEPSEEK_PLATFORM_TOKEN，今日消费将显示为估算值。
总结¶
dsh-deepseek-quota 将额度监控集成到 DSH 界面中，提供了基于官方价格的实时对话成本计算和余额状态展示，适合需要在本地持续监控 API 资源的智能体开发者。
