dsh-token-rush：DeepSeek Harness 会话消耗与余额实时仪表

前言¶

DeepSeek Harness (DSH) 是一个基于插件架构的客户端工具。在使用 DeepSeek API 时，开发者常面临两个痛点：一是不知道当前会话烧了多少 token 和钱；二是高峰时段（官方双倍价格）容易误操作导致成本激增。dsh-token-rush 是一个挂在 DSH Web GUI 会话页左上角的悬浮仪表，实时显示当前会话的累计 token、按官方单价估算的金额以及账户余额。高峰时段，窗口会自动变橙红色，提示用户当前处于计费加价期。

核心功能¶

该插件主要提供以下能力：

• 左上角悬浮窗：位于会话页左上角，约 216px 宽，默认位置 (12, 56)，不遮挡主要信息。
• 实时统计：通过 DSH 的 tokenUsage 投影实时推送，显示累计总 token（包含输入/输出/缓存分桶）。
• 消耗金额估算：基于 DeepSeek 官方单价表（按模型、高峰/非高峰价）计算，界面标注“≈”。
• 账户余额：代理 DeepSeek GET /user/balance 接口，数据缓存 60 秒。
• 高峰变色：高峰时段（默认北京时间周一至周五 09:00–12:00、14:00–18:00）窗口整体变橙红色，其他时段跟随 DSH 主题。
• 透明度渐变：未开启对话时透明度为 0%，开始对话后 0.8 秒平滑渐变为半透明。
• 随意拖动：按住窗口任意处拖动，位置自动记忆；双击可复位默认位置。

安装与启用¶

安装命令如下：

dsh plugin --profile web add link:E:\万物暂存\AI缓存工作区\dsh-token-rush

安装后，必须重启 dsh web 进程（刷新页面不生效），左侧上方即会出现悬浮窗。

使用方法¶

• 查看状态：重启 dsh web 后，窗口即显示当前会话的 token 总量、估算金额与账户余额。
• 移动窗口：按住窗口任意处拖动，位置会自动保存。
• 复位位置：双击窗口任意处，恢复到默认位置 (12, 56)。
• 高峰提示：在高峰时段，窗口背景色会变为橙红色。

配置说明¶

配置项读取于 dsh web 启动环境变量：

• DSH_HUD_PEAK_WINDOWS：高峰时间段定义，如 "9-12,14-18" 或 "8-10 20-23"（半开区间 [start, end)），默认为 9-12,14-18。
• DSH_HUD_PEAK_TZ：高峰判断时区（IANA 名称），默认为 Asia/Shanghai。
• DSH_HUD_PEAK_HOLIDAYS：法定节假日（全天按空闲时段计价），如 "2027-01-01,2027-02-05..2027-02-11"。留空或无法解析时使用内置 2026 年清单。
• DEEPSEEK_BASE_URL：DeepSeek API 地址覆盖，默认为 https://api.deepseek.com。

计价口径与数据来源¶

• 总 Token：来自 DSH 会话 tokenUsage 投影（uncachedInputTokens / cacheReadTokens / cacheWriteTokens / outputTokens）。
• 消耗金额（估算）：Token 数量乘以官方单价表。价格按模型匹配（如 deepseek-flash 或 deepseek-v4-pro），若模型未知则回退至 Flash 价。高峰价 = 空闲价 × 2。
• 账户余额：通过 host 代理 GET /user/balance 接口获取。

DeepSeek 官方计价口径（单位：元 / 百万 tokens，2026-10 核对）：

注意事项¶

• 消耗金额为估算值：实际扣费以 DeepSeek 账单为准。若一次会话跨越高峰/非高峰时段边界，跨界的部分按当前时段单价折算。
• 节假日限制：内置法定节假日清单仅覆盖 2026 年。其他年份请通过 DSH_HUD_PEAK_HOLIDAYS 手动配置，否则节假日的工作日会被算成高峰。
• 余额查询范围：仅覆盖 DeepSeek 官方 API（含自定义 baseURL 端点）。使用其他 LLM 供应商时余额行显示“余额不可用”。

结语¶

dsh-token-rush 通过视觉化的方式解决了 Token 消耗与计费焦虑，适合需要精细控制 API 成本的 DSH 用户。安装前请确认源码与许可证。