dsh-billing

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-billing

DeepSeek Harness 插件：**账户余额** + **会话费用**（人民币），带 Web UI 悬浮显示。

## 功能

| 入口 | 用法 | 说明 |
| --- | --- | --- |
| UI 会话头部双胶囊 | 无需操作，常驻显示 | **余额 + 本会话费用** 并排显示在会话标题旁；点击任一胶囊立即刷新两个 |
| 悬停明细 | 鼠标悬停 | 余额胶囊：充值/赠金/美元；费用胶囊：按模型的 token 与费用拆分 |
| 斜杠命令 `/balance` | 聊天框输入 `/balance` | 查询账户余额（人民币优先，附美元） |
| 斜杠命令 `/cost` | 聊天框输入 `/cost` | 当前会话费用明细 |
| 工具 `deepseek_billing` | 直接问模型"余额多少/花了多少钱" | query = `balance` / `cost` / `both` |

## 结构

- `host.js` — 宿主插件：命令 + 工具 + `/billing/{balance,cost}` RPC 通道（供浏览器胶囊轮询）
- `client.js` — 浏览器 bundle（`__ModuleLoader__` 工厂格式，仅依赖平台共享的 react，无构建步骤）
  - `conversation.session.header.actions` 槽位（负数 order = 静态会话上下文）→ 余额 + 会话费用双胶囊
- `package.json` — 声明 `dsh.bundle`（空 patch）+ `dsh.client`（web 平台）
- `cordis.patch.yml` — 空层；本插件由 profile 的 `cordis.patch.yml` 插入行激活

## 安装（一条命令）

组合包自带激活层（`cordis.patch.yml`），安装后自动生效，无需手改任何配置：

```sh
# 从本地目录安装
dsh plugin --profile web add ./deepseek-billing

# 或从打包产物安装（跨机器分发推荐）
dsh plugin --profile web add ./dsh-billing-0.2.0.tgz

# 或从 npm / git 安装（发布后）
dsh plugin --profile web add dsh-billing
dsh plugin --profile web add github:you/dsh-billing
```

安装后**重启 `dsh web`**，再刷新浏览器页面（F5）使新 boot graph 生效。
宿主侧 API key 使用 `DEEPSEEK_API_KEY` 凭据引用（在 Web 模型设置页保存即可）。

## 配置（全部可选）

`config.pricing` 按模型覆盖单价（元/百万 tokens），支持峰谷价自动切换（见 `host.js` 顶部默认值）。例如：

```yaml
config:
  pricing:
    deepseek-v4-pro:
      cacheHit: 0.025
      cacheMiss: 3
      output: 6
      schedules:
        - effectiveAt: '2026-08-17T00:00:00+08:00'
          timezoneOffsetMinutes: 480
          peakWindows: [[9, 12], [14, 18]]
          offPeak: { cacheHit: 0.15, cacheMiss: 4.5, output: 13.5 }
          peak: { cacheHit: 0.30, cacheMiss: 9.0, output: 27.0 }
```

## 更新频率（事件驱动，空闲零请求）

- **轮次中**：每完成 10 步刷新一次（步号跨过 10 的整数倍时触发）
- **每轮结束**（turn/end）：刷新一次，结算本轮收尾的步（短轮也靠它结算）
- **挂载 / 切换会话 / 点击胶囊 / 页面从后台切回可见**：立即刷新
- **空闲时零请求**：没有定时轮询；只有上述事件发生时才有请求
- 服务端按需从内存会话日志计算，无后台常驻任务

## 价格自动同步（官方改价怎么办）

- 启动时 + 每 12 小时自动拉取官方价格页（https://api-docs.deepseek.com/zh-cn/quick_start/pricing/）解析最新单价（含峰谷价与生效时间）
- 解析失败自动回退：上次成功在线值 → 内置默认值；费用输出会标注当前来源与同步时间
- 优先级：**用户显式配置 > 官方在线同步 > 内置默认**（用户对某个模型写过 pricing 就永远以它为准）
- 可在 `config.priceSync` 关闭或调整：`{ enabled: true, url: "...", intervalMs: 43200000 }`

## 计费口径

- token 取自会话日志中 provider 上报的 `usage`（含缓存命中拆分；失败重试也计入）
- 单价内置官方价格，2026-08-17 起自动按北京时间峰谷价
- 子代理是独立会话，各自单独统计
- 输出为估算值，实际扣费以 DeepSeek 官方账单为准

## 维护提示

- 改 `client.js` 后：客户端 HMR 会自动更新，刷新页面必生效
- 改 `host.js` 后：若热重载未生效（Node ESM 缓存），可改文件名/包名触发重导入，或重启 `dsh web`

官方文档：
- 查询余额：https://api-docs.deepseek.com/zh-cn/api/get-user-balance/
- 模型 & 价格：https://api-docs.deepseek.com/zh-cn/quick_start/pricing/
- Harness 客户端模块：https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/client-modules