前言¶
DeepSeek Harness（DSH）采用插件化架构，旨在通过模块化扩展提升开发效率。在智能体开发场景中，开发者常面临两个痛点：一是缺乏官方的用量/账单/日志查询接口，导致成本控制困难；二是需要频繁切换页面查看余额。
dsh-deepseek-console 是一个为 DSH Web GUI 打造的 DeepSeek 账户控制台插件。它通过 DeepSeek 官方 GET /user/balance 接口同步余额，并在本地监听 llm/stream 事件统计 Token 与费用，最终以一个全局悬浮球的形式展示在界面右下角。
核心功能¶
该插件提供以下能力：
- 实时余额监控：直连官方接口，分离显示现金余额与赠送余额，支持 5 秒缓存与强制刷新。
- 本地用量统计：由于官方未提供用量 API，插件通过监听本地任务流，按任务和按日累计 Token、费用及缓存命中情况。
- 全局悬浮 HUD：右下角常驻可拖拽悬浮球（
● DS ¥xx.xx），实时显示当前任务费用与余额摘要。悬停展开详情，点击跳转控制台。 - 预算与成本保护：支持设置每日消费硬限制（超限拒绝新调用）、预算告警（HUD 标注）与成本保护（超限自动降级低成本模型）。
- 财务推算：基于历史数据推算余额可用天数与消费速度。
- 可视化图表：提供 SVG 折线图展示消费趋势（今日/7天/30天）及模型消费占比。
- 请求日志与诊断：统一请求日志存储在本地 SQLite 数据库，支持按状态、模型筛选；提供 API 健康诊断功能（成功率/错误分类）。
- Agent 工具：内置
deepseek_usage_report工具，允许 Agent 在会话中直接查询余额与用量。 - 模型管理：展示官方模型清单（上下文/价格）及本地启用/禁用开关。
- 安全与隔离：Key 仅存于本机后端凭证库，浏览器端仅见脱敏字符串；后端使用
subprocess + curl直连，无第三方 SDK 依赖。
安装与启用¶
通过 DSH CLI 安装该插件：
dsh plugin --profile web add @hzjjxc/dsh-deepseek-console
安装完成后，重启 dsh web 进程。插件会自动加载，右下角将出现悬浮球，并在「设置 → DeepSeek」中生成控制台入口。
使用方法¶
- 查看余额与费用：
- 移动鼠标至右下角悬浮球，查看当前余额、本次任务费用及预算状态。
- 点击悬浮球打开控制台，在「概览」页查看详细的消费趋势与余额变化历史。
- 配置预算与限制：
- 进入「设置 → DeepSeek → 高级设置」，配置每日消费硬限制或预算告警阈值。
- 开启硬限制后，当日估算费用达到上限将拒绝新的 DeepSeek 调用。
- Agent 会话查询：
- 在 Agent 会话中，直接询问余额或用量，模型将自动调用
deepseek_usage_report工具返回结果。
- 在 Agent 会话中，直接询问余额或用量，模型将自动调用
技术细节与安全¶
- 数据来源：余额数据来自官方 API，用量与费用数据完全由本地统计生成。由于官方未提供相关接口，本插件数据与官方账单可能存在细微差异（如价格档位）。
- Key 安全：API Key 仅存储于宿主进程的凭证库
~/.dsh/.credentials.yaml中。所有 POST 写操作（保存配置、刷新等）均校验 Origin，防止跨站 CSRF 攻击导致 Key 外泄。 - 存储：请求日志持久化在
~/.dsh/storages/deepseek_requests.db，数据不足时不显示财务推算。
总结¶
dsh-deepseek-console 解决了 DSH 环境下 DeepSeek 账户管理的痛点，将官方余额查询与本地用量统计集成到一个统一的控制台与 HUD 中，帮助开发者实现精细化的成本控制与监控。
