dsh-session-balance

4. 配置 API Key

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

1. 启动环境变量 DEEPSEEK_API_KEY（只读，优先级最高）
2. ~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY（可在「模型设置」页保存）
3. 项目 .env
4. ~/.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。

---