PerryLink/dsh-budget

DeepSeek Harness 的成本治理:按模型、会话和日聚合的令牌/成本计量,预算上限与阈值告警及超限策略,碳足迹估算,按模型延迟基准,设置预算选项卡,以及 /budget 命令。

Project Overview项目介绍

dsh-budget is a native DSH plugin built exclusively for DeepSeek Harness that provides full cost governance for your LLM usage sessions. It can be installed in three different ways: installing the latest main branch from GitHub via dsh plugin --profile web add "github:PerryLink/dsh-budget#main, installing the stable published release from npm with dsh plugin --profile web add dsh-budget, or installing a local built tarball after running pnpm pack in the cloned repository. It works on both the DSH host client and the DSH web client, and is compatible with all DSH versions from 0.1.2-rc.1 up to 0.1.5-rc.2 and newer. It has been verified by monthly compatibility smoke tests to work correctly on all supported DSH versions.

The plugin aggregates your token usage, estimated USD cost, carbon footprint, and per-model latency broken down by model, session, and date. You can set custom session, daily, and monthly budget caps, and configure different policies for when you go over the limit, including just sending an alert, blocking new model requests until you manually unblock them, or guiding you to switch to a cheaper configured model. It provides a dedicated settings tab that displays usage bars, daily usage curves, model breakdowns, and alert settings, plus a full set of slash commands for quick access to budget controls. It is ideal for any DSH user who wants to track and control their DeepSeek API costs and understand the carbon impact of their LLM usage.

dsh-budget requires Node.js version ^22.19.0 or >=24.0.0 to run correctly. If you encounter a PNPM build error related to esbuild platform validation, you can fix it by adding the line allowBuilds: { esbuild: true } to your pnpm-workspace.yaml file, as prompted by the DSH CLI. It is released under the open-source Apache 2.0 license, so you can use it for free for any personal or commercial purpose with no restrictions beyond the license terms. After installation, you just need to restart DSH, and you can run the /budget command to confirm the plugin is working correctly.

这是一款专为 DeepSeek Harness (DSH) 开发的原生成本管控插件,核心功能是对 DSH 会话的 token 使用量、估算花费、碳足迹和模型延迟进行全维度统计与管控。它支持按会话、每日、每月设置预算额度,超过阈值后可触发通知、拦截请求、降级引导等不同策略。你可以通过 DSH 命令行从 GitHub、npm 或本地压缩包安装该插件,同时支持 DSH 主机端和网页客户端。

普通用户可以通过设置侧边栏的预算标签页查看用量统计、每日用量曲线、模型分项数据,也可以通过 /budget 系列命令查询当前预算状态、修改限额或解除请求拦截。对于经常使用大模型调用的开发者和重度用户,它能帮助提前控制成本,避免意外产生高额 API 费用,也能帮关注碳排放的用户了解自身使用的碳足迹。这个插件适配了 DSH 0.1.2-rc.1 到 0.1.5-rc.2 及以上的多个主流版本,经过了兼容性验证。

该插件要求运行环境的 Node.js 版本为 22.19.0 或 24.0.0 及以上,使用 pnpm 安装时如果遇到构建报错,可以按照 DSH CLI 提示,在 pnpm-workspace.yaml 中添加 allowBuilds: { esbuild: true } 配置解决。它采用 Apache 2.0 开源协议,完全免费使用,没有任何付费功能或隐藏收费。首次安装后重启 DSH 即可在设置中看到预算标签,输入 /budget 命令可验证安装成功。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 10 stars - an early-stage project星标 10,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-budget

把 PerryLink/dsh-budget 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

💰 dsh-budget

  • 1024 store channel: npm i -g dsh1024 once, then dsh1024 plugin --profile web add dsh-budget (counts toward the deepseek1024.com install ranking). Gitee dshfind OpenSSF Scorecard

Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.

Know what every session costs — before it costs you.

Official repository. This is the only official repository of dsh-budget, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.

License DSH plugin dsh-doctor DSH Market Node CI Version npm version npm downloads

English · 简体中文 · Español · Português · हिन्दी


Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-rewind 下一个 Next dsh-plugin-background →