前言¶
DeepSeek Harness（DSH）支持通过插件扩展功能，但目前官方未提供直接查看余额和平台用量的入口。在使用过程中，若要掌握账户状态和成本消耗，通常需要离开 DSH 或依赖外部工具。dsh-deepseek-monitor 插件将 DeepSeek 平台的余额与用量监控能力移植进 DSH，集成在设置卡片和输入工具行中，方便在开发过程中实时掌握资源情况。
这是什么¶
dsh-deepseek-monitor 是 DeepSeek Harness 的 Web 插件，由 HaoyueQin 维护。它将 DeepSeek 平台的监控能力引入 DSH 界面，解决用户在开发过程中无法直观查看余额和 Token 消耗的问题。插件基于 MIT 许可证发布。
核心功能¶
设置集成
插件集成到「设置 → 模型 → DeepSeek」供应商卡片中。卡片内包含「账户明细」按钮，点击后展开面板显示详细信息。
输入框实时余额
在输入框工具行（模型名称左侧）显示实时余额。余额芯片会根据数值颜色变化（绿色为正，红色为负），并支持在设置中开关显示。
账户明细面板
展开面板包含以下内容：
- 余额卡：显示今日消耗、本月费用及低余额警示。
- 模型用量行：列出各模型的官方产品名，包含进度条、缓存命中率、费用等数据。
- 每日堆叠柱状图：展示每日用量分布，支持月份切换。
平台 Token 配置
提供两种获取 Token 的方式：
1. 一键复制控制台抓取脚本，在平台页粘贴运行。
2. 手动在浏览器控制台（F12）粘贴获取。
配置前会进行接口验活，保存后凭据仅写入不回显。
设置选项
支持配置输入框余额显示开关、自动刷新间隔（最小 60 秒）、低余额提醒阈值，以及重载或清除缓存。
安装与启用¶
使用官方安装命令将插件添加到指定配置文件。
dsh plugin --profile <name> add dsh-deepseek-monitor@latest
典型用法¶
- 安装插件后，进入「设置 → 模型 → DeepSeek」。
- 点击「账户明细」按钮，查看余额卡和模型用量行。
- 在输入框左侧查看实时余额，或使用设置中的 Token 配置功能。
适用场景与注意¶
本插件适用于需要频繁监控 DeepSeek API 使用情况、成本控制和资源规划的 DSH 用户。
注意：
- 插件不存储 API Key，所有解析均通过 dsh 凭据缝完成，不上屏、不入日志。
- 平台 Token 经 fenced 路由写入（write-only），任何接口不回显。
- 抓取脚本纯本地运行，不向第三方发送数据。
- 偏好与缓存持久化存储于 storage-domain deepseek_monitor。
短结尾¶
dsh-deepseek-monitor 为 DSH 用户提供了无需离开界面即可查看余额和用量的能力。所有数据交互均遵循本地化和安全原则，适合需要精细化成本控制的开发者使用。
