feiyang-dev/dsh-usage-plugin
181最近提交 2026年8月15日
dsh-usage-plugin DSH 插件
dsh-usage-plugin 在 DSH Web UI 中添加了“用量与费用”和“余额查询”标签页。它记录每次模型调用的 token 用量、缓存命中以及使用 DeepSeek 峰谷定价计算的费用。插件还提供价格表编辑、导入/导出功能以及月度用量热力图。
如何安装 dsh-usage-plugin DSH 插件
dsh plugin --profile web add @feiyang666/dsh-usage-plugin复制不会执行命令。安装 dsh-usage-plugin DSH 插件前请核对仓库和版本。
dsh-usage-plugin DSH 插件数据来源
dsh-usage-plugin DSH 插件快照日期：2026年8月16日
discovered
dsh-usage-plugin DSH 插件能做什么
- 记录每次模型调用的 token 用量、缓存命中及费用，基于 DeepSeek 峰谷定价（北京时间 09:00–12:00 和 14:00–18:00 为高峰时段）。
- 显示按费用或调用次数着色的日历热力图，支持查看每日详情及峰谷费用拆分。
- 使用配置的 DEEPSEEK_API_KEY 提供余额查询功能。
- 支持导出为 CSV、JSON 和 PNG 长图（最多 2000 条记录），使用原生文件夹选择器，导出后自动打开文件夹。
- 支持导入 JSON/CSV 文件，并按时间去重。
- 将记录持久化存储到 <session workspace>/dsh-usage/usage-records.json（最多 100,000 条）。
dsh-usage-plugin DSH 插件适合哪些场景
- 监控和分析 DeepSeek Harness 应用的 API 使用费用。
- 跟踪每日 token 消耗及峰谷费用分布。
- 导出用量报告用于计费或审计。
- 直接在 DSH UI 中查询 DeepSeek 账户余额。
- 查看缓存命中历史以优化提示缓存策略。
dsh-usage-plugin DSH 插件适合谁
- 需要跟踪 API 成本和用量的 DeepSeek Harness 用户。
- 管理多个 DSH 配置文件或实例，希望集中监控成本的开发者。
dsh-usage-plugin DSH 插件的限制
- 需要安装 DeepSeek Harness（dsh）并运行 DSH web 服务。
- 余额查询需要在 Settings 中配置有效的 DEEPSEEK_API_KEY。
- 记录条数上限为 100,000 条，超出后可能自动清理旧记录。
- PNG 导出仅限最新 2000 条记录（超出会警告）。
- 定价基于 DeepSeek 官方峰谷时段；无官方价格的模型费用计为零。
dsh-usage-plugin DSH 插件的仓库 README 摘录
以下文字摘自 dsh-usage-plugin DSH 插件的上游仓库 feiyang-dev/dsh-usage-plugin 的 README，版权归原作者，仅作引用。
**English** · [简体中文](./README.zh.md) [GitHub](https://github.com/feiyang-dev/dsh-usage-plugin) · [npm](https://www.npmjs.com/package/@feiyang666/dsh-usage-plugin) · MIT License **A community plugin for DeepSeek Harness** — records token usage and cost for every model call, with peak/off-peak billing, balance query, a calendar heatmap, and CSV / JSON / PNG export.    </div> --- > ## 🔔 Important Notice (2026-08-16): npm package renamed > > The **npm package has been renamed from `@feiyang666/deepseekharnessdesktop` to `@feiyang666/dsh-usage-plugin`** (matching the GitHub repo `feiyang-dev/dsh-usage-plugin`). > > - Use the new package name for install / upgrade: `dsh plugin --profile web add @feiyang666/dsh-usage-plugin` > - The old package `@feiyang666/deepseekharnessdesktop` remains published for a while, but it is **no longer maintained and will not receive updates** — please migrate soon. > - The desktop client ([`DeepSeek Harness Desktop`](https://github.com/feiyang-dev/DeepSeek-H
阅读完整 README仓库许可: MIT
dsh-usage-plugin DSH 插件常见问题
如何安装 dsh-usage-plugin？
推荐在终端中运行 `dsh plugin --profile web add @feiyang666/dsh-usage-plugin`。该命令会自动安装包并配置到 DSH 中。你也可以使用 DeepSeek Harness 桌面版应用的图形化插件安装器。安装完成后需重启 DSH web 服务。
余额查询失败怎么办？
余额查询需要在 DSH 设置 → 模型中配置有效的 DEEPSEEK_API_KEY。请确保密钥已设置且 `api.deepseek.com` 可访问。如果使用代理，请在 DSH 的网络设置中配置代理。
如何导出使用数据？
在“用量与费用”面板的导出部分，你可以选择 CSV、JSON 或 PNG 格式。导出将包含最新 2000 条记录（PNG 限制为 2000 条）。你可以使用原生文件夹选择器选择目标目录，导出后文件夹会自动打开。如果记录超过 2000 条，会显示警告。
如何卸载插件？
在终端中运行 `dsh plugin --profile web remove @feiyang666/dsh-usage-plugin`。这会移除包并清理配置。卸载后重启 DSH。如果是手动安装，请先移除 `cordis.patch.yml` 中的插件行，然后运行 `pnpm remove @feiyang666/dsh-usage-plugin`。
这个插件支持非 DeepSeek 模型吗？
支持。插件会记录实际请求参数中的模型名称，非 DeepSeek 模型会如实显示。但如果模型没有在插件的价格表中对应官方价格，其费用将计为零。你可以在面板中编辑价格表来添加自定义定价。