成本预算治理PerryLink/dsh-budget

💰 dsh-budget
- 1024 商店渠道：npm i -g dsh1024 一次，然后 dsh1024 plugin --profile web add dsh-budget（计入 deepseek1024.com 安装排名）。
Gitee

DeepSeek Harness 的成本治理：预算、碳足迹和延迟，尽在一个面板中。

在成本找上你之前，先了解每个会话的成本。

官方仓库。 这是 dsh-budget 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库均无关联。

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

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

兼容性

| 界面 | 状态 |
|---|---|
| Harness | DeepSeek Harness dsh-v0.1.6-alpha.2（GitHub 标签，适配于 2026-09-18；peer 范围 >=0.1.2-rc.1 =0.1.5-alpha.1 =0.1.6-0 =24.0.0 |
| 界面 | 宿主 + Web 客户端（设置预算标签页）；/budget 命令 |

你将获得

dsh-budget 将会话事件流转化为四合一成本治理循环：

- 聚合计量 — 按模型、会话和日期统计 token（未缓存输入 / 输出 / 缓存读取 / 缓存写入）、估算美元成本和碳足迹，通过内置的每百万 token 美元价格表与你的 config.prices 合并定价。
- 预算治理 — 会话/每日/每月上限；一个警告比例阈值告警（webhook POST + 桌面通知标志）以及三种超限策略：alert（仅通知）、block（短路新的模型请求，直到用户解除封锁）、degrade（封锁并提供纠正性指引，指明你的 degradation 映射中更便宜的模型）。
- 碳与延迟 — token→碳桥接（tokens × kWh/token × PUE × 区域电网强度，移植自 AI-Carbon-Footprint-Calculator）以及每模型延迟百分位数。
- 界面 — 设置预算标签页（用量条、每日用量曲线、模型细分、告警、上限编辑器、解除封锁按钮）以及 /budget 命令（/budget、/budget models、/budget unblock ）。

快速开始

1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-budget#main"

or from npm (published releases)
dsh plugin --profile web add dsh-budget

2. restart and verify the row
dsh --profile web --dump-config | grep -A2 'id: budget'

然后向 agent 询问：/budget — 并观察设置标签页填充内容。

安装与卸载

- git 渠道（最新 main）：dsh plugin --profile web add "github:PerryLink/dsh-budget#main" — prepare 脚本仅使用生产依赖进行构建。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-budget。
- tarball 渠道：在本仓库中运行 pnpm pack，然后运行 dsh plugin --profile web add ./dsh-budget-.tgz。
- 卸载：dsh plugin --profile web remove dsh-budget。

如果 pnpm 对此包报告 ERR_PNPM_IGNORED_BUILDS（esbuild 无害的平台二进制验证），请在你的 pnpm-workspace.yaml 中添加 allowBuilds: { esbuild: true } — dsh CLI 会打印确切的代码片段。

配置

所有可调项都是 Schemastery Config 字段（可从 cordis.yml 更改）。cordis.patch.yml 以内联方式记录了每个键。

| 键 | 默认值 | 含义 |
|---|---|---|
| prices | {} | 每 1M tokens 的每模型美元价格，合并到内置表之上 |
| defaultPrice | 未定价信号（priced: false，数值为零） | 对两张表中都不存在的模型的回退：默认值对计费贡献 0，并显示为“未定价”；设置数值并配合 priced: true 以显式定价未知模型 |
| budgets.session / daily / monthly | 10 / 50 / 500 | 每个作用域的预算上限（美元）；省略则为无限制 |
| warnRatio | 0.8 | 当用量达到上限的这一比例（0..1）时告警一次 |
| overLimit | alert | 超过上限后的 alert / block / degrade |
| degradation | {} | 模型 id → 同一提供商的更便宜模型 id |
| webhookUrl | （无） | 用于阈值告警的可选 webhook URL（POST JSON） |
| webhookTimeoutMs | 5000 | Webhook 请求超时 |
| alertsEnabled | true | 阈值告警的总开关 |
| alertCooldownMs | 3600000 | 同一作用域两次告警之间的最小毫秒数 |
| desktopNotifications | false | 标签页打开时的浏览器桌面通知 |
| refreshIntervalMs | 5000 | 设置标签页轮询间隔 |
| carbon.enabled / region / pue / energyKwhPerToken | true / global / 1.58 / 0.000007 | 碳桥接（区域：global、us、eu、china、india、uk、france、iceland） |
| latency.enabled / windowSize | true / 200 | 按模型的延迟百分位数及其窗口 |
| currency | {code: USD, rate: 1.0, decimals: 2} | 显示货币（成本以 USD 计算） |
| outputLanguage | en | /budget 输出语言：en / zh |
| historyDays | 30 | 面板快照中保留的每日使用历史 |
| persistence.enabled / intervalMs | true / 10000 | 跨重启的持久化日/月数据（存储域）；当域不存在时降级为内存存储 |

工具与界面

| 界面 | 类型 | 说明 |
|---|---|---|
| /budget | 命令 | 按范围概览（使用量、比率、碳、阻止状态） |
| /budget models | 命令 | 按模型细分及延迟百分位数 |
| /budget unblock  | 命令 | 解除被阻止的范围（session / daily / monthly） |
| 设置 → 插件 → Budget | 设置标签页 | 使用量条、每日使用曲线、模型细分、警报、上限编辑器、解除阻止按钮 |
| budget/status、budget/setSettings、budget/unblock | Typert Remote | 客户端通道（标签页使用这些） |

权限与数据

- 权限：network:outbound（仅用于可选的警报 webhook）、session:append（审计事件）、native-code:none。
- 数据：显示的所有内容均来自会话事件流；唯一的主机侧网络调用是配置的 webhook，其 URL 在加载时验证，并在任何日志记录前剥离凭据。提示或负载绝不会离开主机。
- 会话日志：budget/alert 和 budget/block 是仅记录日志的审计事件，携带范围名称和 USD 金额（通过微任务延迟以绕过 session-append 重入保护）。在 0.1.2-rc.1 及更高版本的 harness 上，它们不会被写入——故障关闭事件词汇表拒绝未注册事件类型的日志，且不提供外部注册接口——因此审计跟踪仅降级为预算日志记录器和 webhook。

安全边界

- 不伪造：预算阻止会在 llm/stream 瀑布上产生纠正性错误结束——插件绝不会虚构模型输出。
- 不重写请求：循环构建的请求被冻结；因此 degrade 在纠正消息中指明目标模型，而不是替换请求。
- 大声失败：无效的价格、URL、比率、区域和边界会导致挂载失败。
- 诚实范围：来自面板的运行时编辑是会话范围的；重新加载会恢复 cordis.yml 的值。

已知限制

- 聚合是进程本地的：harness 重启时使用量会重置（每日/每月桶从当前会话日志视图重建）。
- block/degrade 依赖 llm/stream 瀑布流；没有该接缝的 harness 构建无法拦截请求（告警仍然有效）。
- 内置价格会漂移；通过 config.prices 覆盖条目。

开发

pnpm install        # node ^22.19 || >=24
pnpm run typecheck  # tsc: src + tests against the local harness checkout
pnpm run typecheck:ci  # tsc against the published types (no paths)
pnpm test           # vitest
pnpm run build      # tsc declarations + tsdown bundles (lib/)
pnpm run verify:self-contained  # dependency specs resolve from the registry
pnpm run verify:artifacts       # built ESM face + typert manifest + client bundle
pnpm pack           # the published tarball

主题

dsh、dsh-plugin、deepseek-harness、deepseek、cordis、budget、cost-tracking、carbon-footprint、latency-benchmark、token-usage

贡献者

- @PerryLink — 创建者与维护者：聚合、预算治理、碳与延迟移植、设置选项卡，以及五种语言的文档。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也会：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认故障关闭 | |
| dsh-background-agents | 持久化后台子代理，带 Web UI 侧边栏、消息传递与中断 | |
| dsh-checkpoint-rewind | 等同于 Claude Code /rewind：快照、会话分叉、一次性恢复 | |
| dsh-claude-move | 将 Claude Code 会话、记忆、技能和 CLAUDE.md 迁移到 DSH | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 编辑器的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查与引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱和密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 面向 DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入均需审批把关 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 基于语言服务器的 LSP 诊断、格式化、补全、代码操作与重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置选项卡，含状态、工具与错误 | |
| dsh-memento | 审批把关的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 等效于 Claude Code outputStyles 的运行时风格切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） | |
| dsh-plugin-guide | 以按需智能体技能形式提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与封存版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | 面向 DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | 面向 DeepSeek Harness 的语音优先会话循环：与它对话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离式安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 | |
| dsh-translate | 面向 DeepSeek Harness 的供应商参数转换与确定性 JSON 修复。 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 | |
| dsh-autotier | 自动进行强/廉价模型层级路由，具备确定性风险防护和 /tier 命令 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，公开认证注册表：评级、快照和五维证据 | |
| dsh-kit | 一键安装核心系列的一站式入门包 | |
| dsh-plugin-certification | 社区认证注册表，提供可复现检查的评级和徽章 | |
| dsh-plugin-kit | 面向 PerryLink DSH 插件的共享零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为一个页面 | |
| dsh-plugin-upgrade-015 | 合并的 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件均可在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → paste https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → select it。安装仍需经过 Market 的 npm 身份验证和你的确认。

许可证

Apache License 2.0 © 2026 dsh-budget contributors