mmzm0808 / dsh-deepseek-usage

📊 dsh-deepseek-usage

DeepSeek API 用量监测插件 —— 右侧悬浮球显示充值余额，点击展开面板展示开放平台真实余额、累计消费、今日消费、API 请求次数、Tokens、分模型今日用量，并实时计算 8 月 17 日后的实际涨价倍率 R0。

✨ 特性

分类	说明
🟢 悬浮球	默认停靠右侧，可拖动上下移动，拖到左半边自动吸附左侧
📋 用量面板	充值余额、赠金余额、累计消费、今日消费、API 请求次数、Tokens、分模型用量
📈 R0 涨价倍率	实时计算 A2 / A1，其中 A1 为 8 月 17 日前每 Token 平均消费，A2 为 8 月 17 日起每 Token 平均消费
🔐 登录机制	未配置 userToken 时，可打开本地 Edge 登录开放平台，自动读取并保存 userToken
🚪 退出登录	一键清除本机保存的 userToken，方便切换账号重新登录
🖱️ 交互	点击面板外部自动收起；支持键盘 Esc 关闭；支持 reduced motion

🚀 安装

Git 安装

dsh plugin --profile web add github:mmzm0808/dsh-deepseek-usage

本地开发安装

dsh plugin --profile web add "<本仓库本地绝对路径>"

• 仓库已提交完整 lib/ 构建产物，安装无需执行构建脚本（pnpm ≥10 的 allowBuilds 门禁不影响本插件）
• 安装后重启 dsh（新 bundle 层在启动时加载）
• DSH 插件开发使用 pnpm；GitHub 分发不要求发布 npm

📖 使用

1. 查看：右侧悬浮球直接显示充值余额，点击展开用量面板
2. 拖动：按住悬浮球上下拖动；松手时根据位置自动吸附左侧或右侧
3. 登录：未登录时点击面板底部「登录」，在打开的 Edge 窗口中登录 DeepSeek 开放平台
4. 退出登录：点击面板底部「退出登录」，清除本机 userToken 后重新登录
5. 收起：点击面板外部任意位置、Esc 或面板右上角 ✕ 均可收起

🔑 登录与配置

✅ 推荐方式：面板一键登录

不需要手动复制任何 token。

1. 打开悬浮球面板
2. 点击面板底部 「登录」
3. 插件会打开本地 Edge 窗口进入 DeepSeek 开放平台
4. 你在窗口中正常登录
5. 登录成功后插件自动读取并保存 userToken，然后自动刷新数据

手动配置（可选）

userToken 是平台 Web 登录态，只作为配置项，不写入插件源码/包内。

在 profile 的 cordis.patch.yml 中配置：

- id: deepseek-usage
  config:
    platformUserToken: '你的 userToken'

也可以设置环境变量：

DEEPSEEK_PLATFORM_USER_TOKEN=你的 userToken

手动获取方式：登录 https://platform.deepseek.com/usage → F12 → Application → Local Storage → https://platform.deepseek.com → userToken → 复制 JSON 里的 value 字段。

🗂️ 数据与安全

• 数据全部来自 DeepSeek 开放平台私有 API，与官方用量页同源，不使用本地价格表，不估算消费
• userToken 只保存在本机用户配置中，不进入插件源码或 Git 仓库
• API：/api/deepseek-usage/state | refresh | login/start | login/status | logout（loopback-only，仅本机可访问）
• 响应统一 Cache-Control: no-store

🛠️ 开发

pnpm install
pnpm build      # host tsc + client tsdown
pnpm typecheck
pnpm verify

📄 许可证

MIT License · Copyright (c) 2026 mmzm0808