快速了解
它能做什么
在 DSH 上下文弹层内查看 Token、缓存与预估费用的 Web 插件。
本站提供的是中文说明，不代表该项目或 Plugin 自身提供中文界面；语言支持请以上游文档为准。
Web Profile
Not declared in supplied evidence
证据已验证
核对日期 2026/9/13 UTC 14:13
有代码证据的贡献
它为 DSH 增加什么
在 DSH 上下文占用弹层中显示当前步骤、当前轮次和会话的费用与 Token 统计。
机制证据 ↗选择前先看
虾算账嵌入 DSH 现有的上下文占用弹层，不会新开独立页面。它展示当前步骤、当前轮次和整个会话的费用，并拆分缓存输入、未缓存输入和输出；同时显示基于会话事件计数的上下文指标与 Token 总量。设置页支持从已配置的供应商和模型中选择、使用价目目录或手动价格、设置峰谷价，以及仅调整弹层字号。
适合谁
希望了解当前 DSH 对话的缓存 Token 构成和预估成本的用户。
常见任务
- 比较当前请求、当前轮次或整个会话的缓存输入、未缓存输入和输出成本。
- 查看轮次、步骤、工具调用、图片、剪枝、注入和压缩等会话事件计数。
- 选择或自定义供应商/模型价格，包括峰谷价及人民币、美元条目。
权限与数据
该插件作为 DSH Web 插件运行，可能使用已配置的供应商/模型信息、会话事件、Token 用量、价格条目和汇率数据来展示费用估算。
权限- 注入 DSH Web 客户端的 settings-plugin UI。
- 通过 bundle patch 在 profile layer 中启用。
- 使用会话日志事件生成上下文指标及 Token/费用展示。
- README 表示会在本地缓存汇率和价目目录数据。
- 向 open.er-api.com 请求汇率；README 表示无法取得汇率时会并列显示币种。
- 提供的证据未声明需要凭据。
局限
- 未声明确切的 DSH Harness 版本兼容范围。
- 费用结果依赖已配置或目录中的价格，以及汇率是否可用。
- 本次整理未实际执行安装、重启或运行时验证。
DSHub 已核对
- 固定提交中的 DSH bundle patch 已通过结构验证，并会启用该插件。
- manifest 声明 Web 客户端注入及构建后的库文件导出。
- 固定提交的 Git bundle 分发已验证。
DSHub 未核对
- 未测试实际安装、重启、界面渲染及计算准确性。
- 未测试真实汇率请求、本地缓存和回退行为。
固定版本安装
安装 Axia Cache Billing
这个Plugin Bundle没有 DSH Plugin 安装操作，请根据源码文档使用真实交付方式。
维护者原文
项目 README
虾算账 · dsh-axia-cachebilling
Token 计费 & 缓存监控 —— 挂在 DSH 上下文弹层里的实时账单。
DSH 里聊得越久，上下文越长，钱就越花在缓存上：一算下来，账单里 90% 以上可能都是缓存读取。 虾算账把这件事实时摊开给你看 —— 每次请求、每一轮、整个会话，命中多少、未命中多少、输出多少，各花了多少钱；再配上按会话事件真实统计的上下文指标。
它是什么
一个 DSH Web 插件（宿主半身 + 浏览器半身），把自己贴进 DSH 自带的上下文占用弹层里，不新开页面、不挡聊天。
弹层里看到什么
| 区块 | 内容 |
|---|---|
| 当前会话统计 | 三档账单：当前步 / 当前轮 / 本会话，每档给出合计与 命中 / 未命中 / 输出 三笔明细；底部一行模型胶囊（provider/model · 谷价/峰价 · 货币） |
| 上下文统计 | 8 项按会话日志事件真实计数的指标：轮次、步数、工具调用、图片、剪枝、注入、压缩（+ 预估费用）；不是估算、不是占比推算 |
| Token 统计 | 总 token 一行 + 缓存输入 / 未缓存输入 / 输出三行，给百分比与绝对量 |
金额口径：
- 多币种自动统一：按实时汇率把「元」与「美元」折算成当前条目计费币种单一展示（汇率取自
open.er-api.com，带本地缓存与失败回退；取不到就退化为并列展示，绝不瞎算）； - 峰谷价：支持按峰谷时段分别计价；
- 第三方中转同样计费，按价目表匹配模型。
设置页能做什么
- 供应商 / 模型从 DSH 已配置的列表里挑，可一键拉取模型清单；
- 价目目录：内置 Open Code / Command Code / GLM / Kimi / MiniMax / MiMo 等模型价格，新增条目或改动模型时自动填价，也可手动「刷新价格」；
- 自定义条目（一口价 / 峰谷价、元或美元），改完即时生效，无需重启；
- 弹层字号档位（标准 / 大 / 超大 / 巨大）——只作用于弹层，设置页保持标准大小。
安装
dsh plugin --profile web add github:Animal2404/dsh-axia-cachebilling
装完重启 DSH，打开任意会话的上下文占用弹层即可看到账单。
给维护者
- 构建只在 GitHub Actions 进行：
.github/workflows/build.yml在main的 push 上执行npm install+npm run build（esbuild），把产物lib/回写进仓库并上传为 artifact；本地只需git pull拿产物，不需要本地构建。 - 源码：
src/index.ts（宿主投影：按会话事件流计价与计数）、src/client.ts（弹层 UI）、src/settings.ts（设置页 UI）、src/prices.ts（价目目录拉取与匹配）； - 价目目录：仓库根
price-catalog.json，客户端按需拉取并缓存。
贡献者
| 贡献者 | 角色 |
|---|---|
| @Animal2404 | 本仓库维护者 |
| @Phant0Meow | 最初 dsh-cache-billing 的作者（三档账单思路与实现基础） |
| @better-er | 大幅重写者（三级账单、第三方中转支持、缓存失效统计） |
致谢与出处
本插件基于同生态下的 MIT 项目演进而来，特此注明：
- 最初的
dsh-cache-billing（作者 Phant0Meow）：三档账单的原始思路与实现基础； - better-er 的大幅重写：三级账单、第三方中转支持、缓存失效统计等。
按 MIT 许可要求，上游版权声明保留在 LICENSE 中。
许可
MIT —— 见 LICENSE。
有意识地管理
安装与管理
前置条件与目标 Profile
目标： Web Profile
交付方式： Git Bundle — Animal2404/dsh-axia-cachebilling#deade1327ef098f4a15d6b2cafb0995bbada7dff。
验证、更新与移除
显示生命周期命令
dsh plugin --profile web list兼容性与访问范围
DSH web client bundle; exact Harness range not declared： Not declared in supplied evidence。
风险事实
证据与编辑审查Manifest、Bundle patch、分发与新鲜度
不可变证据
审查状态与源码活动
采用 MIT 许可证。由于提供的证据未找到该 npm 版本，建议使用固定提交对应的 Git bundle 来源。
AI 审查于 2026/9/13 UTC 14:14。GitHub 事实核对日期： 2026/9/13 UTC 14:14。
自当前证据基线以来，没有记录到重要源码变化。