@dsh-external/dsh-balance-float

配置 Configuration

DSH 凭据文件（默认 ~/.dsh/.credentials.yaml，与模型 API Key 同文件）：

# 不配置也能用：用量面板退化为余额差值估算
DEEPSEEK_PLATFORM_TOKEN: 

凭据文件有文件监听，改完即生效（无需重启）。

平台 Token 配置教程（可选，官方用量数据）

DEEPSEEK_PLATFORM_TOKEN 是什么：platform.deepseek.com 的登录会话令牌（浏览器 localStorage 里的 userToken，一段长字符串），不是 API Key。官网用量后台（platform.deepseek.com/usage 页面同源接口）用它对账号会话鉴权；没有它，用量面板只能按余额差值估算今日消费。

第一步：登录平台网站

浏览器打开 并用你的账号登录。

第二步：打开开发者工具

按 F12（或 Ctrl+Shift+I，或右键页面 → 检查）。

第三步：找到 userToken

1. 开发者工具顶部切到 Application（应用） 面板
2. 左侧边栏展开 Local Storage → 点击 https://platform.deepseek.com
3. 右侧键值列表中找到名为 userToken 的键
4. 双击它的 Value 选中，复制整段值（以引号包裹的长字符串）

第四步：写入凭据文件

编辑 DSH 凭据文件（默认 ~/.dsh/.credentials.yaml），添加一行：

DEEPSEEK_PLATFORM_TOKEN: 

第五步：验证

• 无需重启：凭据文件有监听，改完即生效
• 拉大悬浮窗（≥ 400×300），用量面板应显示官方真实数据：今日柱状图、本月逐日明细表、模型分布
• 若面板提示"用量接口不可用"，通常是 token 过期：重新登录 platform.deepseek.com（会刷新会话）后再取一次新值更新即可

注意事项

• token 只在本机 Host 进程内读取，不会发送到浏览器或第三方
• 重新登录平台网站会使旧 token 失效，需要按上述步骤重新获取
• 不配置也不影响使用：用量面板退化为余额差值估算（界面标注"估算"）

使用 Usage

• 整窗拖动移动；右下角手柄缩放
• 标题栏 ↻ 手动刷新，– 收起为迷你胶囊（点击展开）
• 拉大到 ≥ 400×300 显示用量面板（含今日柱状图、逐日表、模型分布）
• 数据每 60 秒自动刷新

从源码构建 Build from source

构建复用 Harness 的 client-bundle 预设，需要一份本地 DeepSeek Harness 检出：

## 平台 Token 配置教程（可选，官方用量数据）

**`DEEPSEEK_PLATFORM_TOKEN` 是什么**：platform.deepseek.com 的**登录会话令牌**（浏览器 localStorage 里的 `userToken`，一段长字符串），**不是** API Key。官网用量后台（platform.deepseek.com/usage 页面同源接口）用它对账号会话鉴权；没有它，用量面板只能按余额差值估算今日消费。

### 第一步：登录平台网站

浏览器打开  并用你的账号登录。

### 第二步：打开开发者工具

按 `F12`（或 `Ctrl+Shift+I`，或右键页面 → 检查）。

### 第三步：找到 userToken

1. 开发者工具顶部切到 **Application（应用）** 面板
2. 左侧边栏展开 **Local Storage** → 点击 `https://platform.deepseek.com`
3. 右侧键值列表中找到名为 `userToken` 的键
4. 双击它的 **Value** 选中，复制整段值（以引号包裹的长字符串）

### 第四步：写入凭据文件

编辑 DSH 凭据文件（默认 `~/.dsh/.credentials.yaml`），添加一行：

```yaml
DEEPSEEK_PLATFORM_TOKEN: 

第五步：验证

• 无需重启：凭据文件有监听，改完即生效
• 拉大悬浮窗（≥ 400×300），用量面板应显示官方真实数据：今日柱状图、本月逐日明细表、模型分布
• 若面板提示"用量接口不可用"，通常是 token 过期：重新登录 platform.deepseek.com（会刷新会话）后再取一次新值更新即可

注意事项

• token 只在本机 Host 进程内读取，不会发送到浏览器或第三方
• 重新登录平台网站会使旧 token 失效，需要按上述步骤重新获取
• 不配置也不影响使用：用量面板退化为余额差值估算（界面标注"估算"）

使用 Usage

• 整窗拖动移动；右下角手柄缩放
• 标题栏 ↻ 手动刷新，– 收起为迷你胶囊（点击展开）
• 拉大到 ≥ 400×300 显示用量面板（含今日柱状图、逐日表、模型分布）
• 数据每 60 秒自动刷新