dsh-ocg-billing

English | 中文

DeepSeek Harness（dsh）的 OpenCode Go 计费层插件。

在 dsh 已有的用量记录（会话日志中的 TokenUsage）之上增加计费能力：只抓一次官方 OpenCode Go 定价文档，价格表缓存到磁盘，之后主动检查更新而不是每次计费都联网；用默认模型分析账单；并在 Web 输入框下方常驻显示账单行。

社区插件，与 DeepSeek AI / OpenCode 无隶属关系。费用为依据官方文档的估算值，实际扣费以 OpenCode Go 订阅账单为准。

功能

• 常驻账单行（Web） — 挂在输入框下方（conversation.composer.dock）：近 7 天全局成本、月度限额进度、当前会话成本、Top 模型、价格源新鲜度。每 60 秒自动刷新，点击立即刷新。
• 官方价格缓存 — ocg_pricing_check 重新抓取 opencode.ai/docs/go，与缓存比对，仅在价格表变化时更新（force: true 强制刷新）；另有 24 小时后台自动检查。计费永远走缓存，不反复联网。
• 账单计算 — ocg_bill：全局（最近 N 天所有会话）或单会话（scope=session + sessionId），按模型/按会话明细；使用官方每 1M token 单价（含 Cached Read / Cached Write 与阶梯档：GPT 5.6 Luna 272K、Qwen3.7/3.6 Plus 256K）；未知模型按 0 计并列明。
• 默认模型分析 — ocg_bill_analyze：先算账单，再调用默认模型（agent-default-model 选择，如 opencode-go/deepseek-v4-flash）输出摘要、异常点、成本驱动与省钱建议。

安装

预发布说明：DeepSeek Harness 处于 developer preview，peer 版本按当前 mainline 0.1.0-rc.6 声明。

# profile 方式
dsh plugin --profile web add     # 或 link:/绝对路径
# 或 overlay 方式写 ~/.dsh/config.yaml
# - insert:
#     - id: ocg-billing
#       name: '@hiro-nikaitou/dsh-ocg-billing'

重启 dsh web 后，输入框下方出现账单行（浏览器半区激活后生效）。

工具（模型可见）

工具	用途
ocg_pricing_status	价格缓存状态（来源/抓取时间/模型数），不联网
ocg_pricing_check	主动重新抓取官方文档并与缓存比对；仅在有变化时更新（或 force）
ocg_bill	账单计算：全局或单会话，按模型/按会话
ocg_bill_analyze	账单 + 默认模型分析（摘要、异常、省钱建议）

工作原理

• 价格缓存：D:\appdata\dsh\ocg-billing\pricing.json（首次运行以内置的官方文档价格快照作为种子，状态里带 seed 标记）。20 个文档内模型 + 额外种子条目（配置里存在但文档未列的模型，来源标记 models.dev/unknown）。
• 用量来源：依赖 dsh 已有用量记录——各会话日志的 request/header + assistant/message 事件（与 live-stats 同源）。全局范围聚合窗口内创建的会话；单会话范围按 sessionId 计费。
• 抓取通道：ctx.subprocess + curl.exe（Windows 上 bash/shell 通道不可用）；其他平台回退 ctx.shell。
• RPC：客户端轮询 GET /api/ocg-billing/panel?sessionId=...（由 ctx.webServer 注册）；宿主侧全局聚合缓存 5 分钟。