dsh-billing-community-bundle
用于 dsh-billing 主机投影和客户端 UI 的可安装 DeepSeek Harness 捆绑包
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Wanbinyu/dsh-billing#aab89d52085a81f6ea2d8e44e46ca715a1e5858fBilling Community Bundle 以 dsh-billing-community-bundle 发布，当前版本为 0.6.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
v0.6.6 兼容性修复：适配 Harness
0.1.5-rc.2，并通过0.1.1-rc.2回归。修复旧 runtime 模块缺失问题；下方下载链接指向本次修复包。其他宿主版本请先验证兼容性。
面向 DeepSeek Harness 的会话计费与额度插件。
[!NOTE] 这是独立的社区项目，不属于 DeepSeek Harness 官方发行版。费用是本地参考值，不是账单，也不会自动阻止模型调用。
| 包 | 作用 |
|---|---|
dsh-billing | 按 provider/model 统计 token 费用，生成 billing session projection，并支持每会话额度。 |
dsh-client-ui-billing | 在 Web composer dock 显示本轮/会话费用、额度进度、未定价模型提示和模型明细。 |
dsh-billing-community-bundle | 将上面两个包和 cordis.patch.yml 组合成可安装的 DSH bundle。 |
host 侧负责计价和 projection，浏览器侧从 host 已计算的 projection 渲染界面。可安装的根 bundle 同时导出 host 与 Web client 入口，因此从 GitHub 安装不依赖另外发布两个内部包。相同模型 ID 在不同 provider 下会分开统计，例如 deepseek/deepseek-v4-flash 和 openrouter/deepseek-v4-flash。
v0.6.6 已使用 DeepSeek Harness 0.1.2-rc.1 完成类型、测试、完整构建和打包验证，并保留 0.1.0-rc.6 至 rc.8、0.1.1-rc.1 至 rc.2 的兼容分支。
仓库根目录的 bundle 包含 dsh.bundle 声明和两个运行时包。安装到 web profile：
dsh plugin --profile web add https://github.com/Wanbinyu/dsh-billing/releases/download/v0.6.6/dsh-billing-community-bundle-0.6.6.tgz
安装后重启 dsh。bundle 通过一个 billing 配置条目同时启用 host projection 和 Web 费用条，价格优先使用配置，其次使用内置 USD 模型目录。
宿主项目需要自己控制组合层时，可以安装两个包：
npm install ./packages/dsh-billing ./packages/dsh-client-ui-billing
然后在 profile 的 cordis.patch.yml 中加入：
- insert:
- id: billing
name: dsh-billing
config: {}
- id: ui-billing
name: dsh-client-ui-billing
DeepSeek 官方价格有峰谷时段，且可能变化；实际价格请按你的合同或当前官方价格配置。内置 USD 目录包含 deepseek-v4-flash-vision-exp，按 deepseek-v4-flash 的参考价格计入；图片由供应商折算为输入 token 后计费。
- id: billing
config:
models:
deepseek/deepseek-v4-flash:
input: 1
output: 2
cacheRead: 0.02
cacheWrite: 0
currency: CNY
quota:
limit: 5
价格键优先使用精确的 provider/model，例如 openrouter/deepseek-v4-flash；只写模型 ID（例如 deepseek-v4-flash）仍然有效，并作为所有 provider 的兼容回退。如果在 bundle 已插入后修改 billing 行，Harness 的 patch 会替换整段 config，因此需要保留所有希望继续使用的配置字段。
内置目录只使用 USD。使用 CNY 或其他货币时，请为每个模型显式配置价格；没有价格的模型仍会统计 token，但会进入 unpricedModels。它们不会伪造费用，quota.estimated 会变为 true，表示额度进度只包含已知价格，不能当作完整账单。
interface BillingProjection {
currency: string
totalCost: number
models: { provider: string; model: string; cost: number; uncachedInputTokens: number;
outputTokens: number; cacheReadTokens: number;
cacheWriteTokens: number }[]
unpricedModels: string[]
latestTurn?: { turn: number; cost: number; uncachedInputTokens: number;
outputTokens: number; cacheReadTokens: number;
cacheWriteTokens: number; unpricedModels: string[] }
quota?: { limit: number; used: number; remaining: number; percent: number; estimated: boolean }
}
usage 采用 request/header 对 step 进行归属；同一 (turn, step) 的后续样本会同时替换会话累计和本轮数据中的早期样本，避免重复计费；没有前置 header 的 usage 会放入保留的 (unknown) bucket。latestTurn 在首次收到 usage 后出现，供客户端显示最近一轮的费用和 Token 明细。
Web 费用条同时显示“本轮”和“会话”金额。鼠标悬停可查看本轮输入、输出、缓存命中/写入 Token 以及分模型费用；额度达到 50%、80% 和 100% 时会逐级增强提示颜色。
host 配置、projection 去重、额度状态和 Web BillingBar 服务端渲染输出均有自动化测试；真实 Harness Web 安装与视口组合仍按发布检查表手动验证。运行完整验证：
npm run build
npm run verify
内置目录通过以下脚本从 pi-ai model catalog 生成：
node packages/dsh-billing/scripts/generate-catalog.mjs
0.1.0-rc.6 至 rc.8、0.1.1-rc.1 至 rc.2、0.1.2-rc.1；开发依赖固定在 0.1.2-rc.1，但 @deepseek-ai/dsh-client-runtime 仍使用官方 next 发布的 0.1.1-rc.2。MIT。