dongsheng123132/dsh-cost

Plugin插件 Native原生 ⭐ 2 MIT Usage & Cost用量与计费

面向DeepSeek Harness的以证据为先的令牌成本账本与预算检查

Project Overview项目介绍

dsh-cost is a native plugin built exclusively for DeepSeek Harness (DSH) that tracks token usage cost and enforces budget limits based on actual session evidence. To install the plugin, you can run a single command through the DSH CLI: dsh plugin --profile <name> add github:dongsheng123132/dsh-cost. After installation, it mounts two tools and a bundled stdio MCP server that exposes cost reporting and budget checking capabilities. It parses DSH’s durable session logs, attributes each usage record to the correct provider and model, then calculates costs using your custom price book.

Before you first use the plugin after installation, you need to create your own custom price book. Copy the prices.example.json file from the repository root, replace the zero placeholders with per-million-token prices matching your provider’s contract, then add the absolute file path of your price book to the plugin’s configuration in DSH. This approach works with any LLM provider, adapts to price changes and personal account discounts, and avoids problems from stale baked-in default prices. You can also run dsh-cost offline from the CLI to check costs for a saved session events file.

dsh-cost follows a strict evidence-first approach, so any calls without provider usage or routes that are not in your price book are explicitly marked as missing, rather than being hidden or faked to look complete. It is structured as a DSH namespace plugin that works correctly with the Cordis Loader, and includes multiple test and smoke check scripts for developers. It requires Node.js 22 or newer to build and run from source, and is released under the permissive open source MIT license.

dsh-cost 是专为 DeepSeek Harness (DSH) 开发的原生插件,提供基于实据的 Token 使用成本统计与预算检查功能。它解析 DSH 持久化会话日志,将每条助手消息的用量记录归属到对应的请求提供商和模型路由,再结合用户自定义价目表计算成本,不会对缺失的用量或价格做伪造填充,保证统计结果真实可靠。

插件可通过 DSH CLI 一键安装,安装后会挂载两个内置工具:dsh_cost_report 用于生成持久化会话总成本、模型路由成本拆分、证据完整性、预算状态以及当前上下文 Token 压力快照;dsh_cost_check 用于提供明确的超预算决策。同时,插件还捆绑了一个标准输入输出 MCP 服务端,对外暴露同名能力接口。

用户需要先复制示例价目表文件,替换为自己当前服务商的实际定价填写后,在插件配置中指定价目表路径才能正常使用。插件支持离线对会话事件文件做成本核算与预算检查,采用 MIT 许可开源,不内置服务商定价,适配价格变动与账户折扣差异。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 github:dongsheng123132/dsh-cost

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

READMEREADME

dsh-cost

CI MIT license Node.js 22+ Awesome DSH Plugins

Evidence-first token cost ledger and budget checks for DeepSeek Harness.

dsh-cost folds the durable DSH session log. It attributes each committed assistant/message.usage record to the active request/header provider/model route, then applies a user-owned price book. Missing usage and missing prices remain explicit: partial evidence never becomes a reassuring fake total.

Install

dsh plugin --profile <name> add github:dongsheng123132/dsh-cost

The bundle mounts two tools:

  • dsh_cost_report — durable session cost, route breakdown, evidence completeness, optional budget status, and the current ctx.tokenMeter pressure snapshot.
  • dsh_cost_check — explicit fail-open/fail-closed budget decision. It does not claim to intercept future calls automatically.

The same evidence core is available through the bundled stdio MCP server as cost_report and cost_check. MCP accepts only bounded, sanitized usage rows (provider, model, disjoint token buckets, or an explicit missingUsage marker); it rejects prompts, message bodies, credentials and other extra fields. The formal Codex plugin manifest lives at .codex-plugin/plugin.json.

The DSH entry is a namespace plugin (name / inject / apply) with no default export. This preserves both tools and tokenMeter injection through the real Cordis Loader. Structural and plugin smokes fail if a default export is reintroduced.

Price book

Copy prices.example.json, replace the zero placeholders with prices from your own current provider contract, and pass its path as plugin config:

- id: dsh-cost
  name: dsh-cost
  config:
    priceBookFile: C:/absolute/path/prices.json
    defaultBudget: 5

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-discord-bot 下一个 Next dsh-project-context →