前言¶
在 DeepSeek Harness（DSH）里长时间跑对话或智能体任务时，花费往往分散在官网「用量」页、各轮次的 token 统计和账号余额之间，很难在写提示词的同时一眼看到「这轮花了多少、今天还剩多少预算」。社区插件目录里有不少客户端扩展；skyrocks/dsh-deepseek-cost 由维护者 skyrocks 发布，分类为客户端，目标是把 DeepSeek 账号余额 与 本轮 / 今日 / 本周 / 本月 / 累计 花费固定在对话输入框下方，悬浮可看明细，点击可刷新。
这是什么¶
dsh-deepseek-cost（npm 包名 @skyrocks/dsh-deepseek-cost，当前版本 0.2.3，MIT 许可证）是 DSH 的 Host + 客户端插件，要求运行环境 dsh 版本 >=0.2.1-rc.2 <0.3.0。显示区域与样式沿用同作者 dsh-go-quota 的输入框下方 dock（同一 conversation.composer.dock 槽位、同一套主题变量）。插件通过 GitHub 分发；npm 上另有同名包 dsh-deepseek-cost（作者 miaoxintechnology），与该项目无关。
核心功能¶
安装并选用官方 DeepSeek 模型后，输入框下方会出现一行摘要，例如：
DS -¥0.49 │ 轮 ¥0.02 │ 日 ¥0 │ 周 ¥0 │ 月 ¥18.77 │ 总 ¥129.65
鼠标悬停可打开明细面板，展示余额（含充值与赠送拆分）、本轮 in/out token 与估算金额、日/周/月/累计及更新时间；点击可立即刷新。
显示条件： 仅在当前会话 provider 为 deepseek-official 或 deepseek-account 时出现。使用 opencode-go、自建中转等非官方订阅渠道时，整条 dock 隐藏。
数据来源概览：
| 显示项 | 来源 |
|---|---|
| 余额 | 官网 GET /api/v0/users/get_user_summary（充值 + 赠送；透支可为负） |
| 累计 | 同上接口的 total_costs（官网账号维度累计，含其它客户端与更早历史） |
| 今日 / 本周 / 本月 | 官网 GET /api/v0/usage/by_api_key/cost，按本机时区切天，周一为周起点 |
| 本轮 | 本地估算：当前会话最新一轮 assistant usage × 内置官方价目表（官网无此粒度） |
未登录官网账号时，余额可回退到 DSH 配置的 API Key 调用 /user/balance；日/周/月/累计显示 —（官网侧数据需要登录态）。「本轮」是唯一本地算出的项，会随对话落账更新，不与官网逐条一一对应。
安装与启用¶
DSH 生态采用「一切皆插件」思路；社区目录站点 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，安装前建议自行查看 GitHub 仓库 源码与许可证。插件以当前 DSH 进程权限访问官网接口与本地会话数据。
桌面端（推荐）¶
- 打开 DSH 设置 →「插件」→「添加插件」。
- 粘贴仓库标识：
github:skyrocks/dsh-deepseek-cost
- 完全退出 DSH 再重新打开（Host 插件只在启动时加载）。
- 在会话中选择官方 DeepSeek 模型，确认输入框下方出现
DS 余额 … ｜ 轮 … ｜ 日 …。
命令行（可选）¶
桌面版 profile 示例：
dsh plugin --profile desktop add github:skyrocks/dsh-deepseek-cost
若使用 dsh web，将 --profile desktop 换成 --profile web。装完后同样需要完全退出并重启。
配置（可选）¶
在 profile 的 cordis.patch.yml 中按插件 id deepseek-cost 覆盖，例如：
- id: deepseek-cost
config:
cacheMs: 60000
prices:
deepseek-flash: { input: 2, cacheRead: 0.04, output: 8 }
常用字段：refreshMs（默认 30000，轮询间隔）、cacheMs（默认 60000，官网数据缓存）、prices（仅影响本轮估算，单位每百万 tokens）、currency、cnyToUsd、timeoutMs、clientVersion。默认价目表覆盖 deepseek-flash 与 deepseek-v4-pro，并按北京时间工作日高峰/空闲双档计价。
典型用法与排错¶
看不到 dock： 确认当前模型走官方路由（deepseek-official / deepseek-account），而非中转或第三方订阅。
日/周/月为 —： 在 设置 →「账户」 登录 DeepSeek 官网账号；仅配置 API Key 时只能看到 Key 余额路径。
余额、累计与官网不一致： 文档说明这两项直接读官网同源接口；若仍异常，可在 dock 上点击刷新，并核对登录态与网络。
「本轮」与其它工具不同： 属预期行为，该项按本地价目表估算，高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00（法定节假日本地无法判断时按高峰处理）。
结尾¶
dsh-deepseek-cost 把官网余额与多时间维度的花费收到输入框下方，适合需要在 DSH 里持续开发、又不想反复打开官网用量页的开发者。目录页：https://www.skillhub.cn/plugins/skyrocks/dsh-deepseek-cost；源码与 README：https://github.com/skyrocks/dsh-deepseek-cost。
