4. 配置 API Key

账户余额需要一个可用的 DeepSeek API Key，解析顺序由 DSH 凭据层决定：

启动环境变量 DEEPSEEK_API_KEY（只读，优先级最高）
~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY（可在「模型设置」页保存）
项目 .env
~/.dsh/.env

Key 只在宿主进程内使用，不会写入前端响应。

配置参考

所有字段都可选，写入插件行（或 bundle 方式下的 - id: session-balance）的 config：

字段	默认值	说明
`balanceEnabled`	`true`	关闭后不再请求余额接口，徽标只显示本地用量与费用
`apiKeyEnv`	`DEEPSEEK_API_KEY`	凭据引用名
`baseURL`	`$DEEPSEEK_BASE_URL` → `https://api.deepseek.com`	DeepSeek API 基址（兼容 OpenAI 网关）
`timeoutMs`	`10000`	余额请求超时
`cacheMs`	`60000`	宿主侧余额缓存时长；前端自然刷新不会穿透缓存
`refreshMs`	`60000`	前端轮询间隔；`0` 表示只加载一次
`rate`	`off-peak`	`off-peak` 空闲时段 / `peak` 高峰时段；高峰按 `×2` 计算
`currency`	`CNY`	费用估算计价币种；仅影响单价表与费用显示（账户余额用它自己的币种）
`pricing`	见下	模型单价覆盖表，单位元 / 1M tokens，按空闲时段基准，高峰时统一 ×2
`showBalance`	`true`	折叠态 / 面板是否显示账户余额
`showTokens`	`true`	是否显示 token 用量
`showCost`	`true`	是否显示费用估算
`showContext`	`true`	是否显示上下文占用

如果你在 dsh-llm-deepseek 里配了自定义 baseURL（自建网关），请在这里填同一个值，否则余额会去官方端点查询。

默认单价（元 / 1M tokens，空闲时段）

模型	缓存命中输入	缓存未命中输入	输出
`deepseek-flash`	0.02	1	4
`deepseek-v4-flash`	0.02	1	4
`deepseek-v4-flash-vision-exp`	0.02	1	4
`deepseek-v4-pro`	0.15	4.5	13.5

单价来自 DeepSeek 官方定价页（中文），会随时间调整；插件内置值只是默认，请按需覆盖：

config:
  rate: peak
  currency: CNY
  pricing:
    deepseek-v4-pro:
      cacheHitInput: 0.3
      cacheMissInput: 9
      cacheWriteInput: 9   # 可省略，默认等于缓存未命中输入
      output: 27

pricing 表里的数值按空闲时段基准填写，rate: peak 时程序会统一 ×2，因此无需手填高峰价。未配置单价的模型只显示 token 数与上下文，不显示费用。空闲时段为高峰时段价格的一半：北京时间周一至周五（不含中国法定节假日）9:00–12:00、14:00–18:00 为高峰，其余时段均为空闲。默认按空闲计，因此高峰期会低估，需要保守估计可设 rate: peak。

dsh-session-balance

설치

문서

4. 配置 API Key

配置参考

默认单价（元 / 1M tokens，空闲时段）