@pinkbanana/dsh-balance
DeepSeek Harness 插件，用于查看多提供商 API 余额、可用模型和使用计费
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @pinkbanana/dsh-balance@0.6.0Balance 以 @pinkbanana/dsh-balance 发布，当前版本为 0.6.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 插件，用于查询 DeepSeek / StepFun API 余额、各提供方的可用模型和多维消费统计。API Key 仅由本机 Host 使用，不会发送到浏览器。
设置页采用账户总览布局，支持 DeepSeek / StepFun 切换。运行 pnpm preview 可查看使用示例数据的新版界面。
/models 接口读取可用模型、所属组织与创建时间usdToCny 后额外显示固定汇率换算的 CNYDEEPSEEK_API_KEYdsh plugin --profile web add @pinkbanana/dsh-balance@latest
dsh --profile web
打开 http://127.0.0.1:3080/，进入“设置 → 模型余额”。该入口位于“Agent 预设”下方，余额摘要也会显示在已有会话的聊天框下方。API Key 可在“设置 → 模型”中保存，或通过 DEEPSEEK_API_KEY 环境变量提供。
消费统计从已保存会话和当前运行中的 live session 读取，不展示 prompt 内容。可在插件配置中增加固定汇率，例如：
usdToCny: 7.2
在“设置 → 模型”中添加自定义提供方，Provider ID 填写 StepFun（stepfun、STEPFUN 等大小写写法均可），保存 API Key。Harness 默认将其保存为 STEPFUN_API_KEY；也可以直接设置该环境变量。在“设置 → 模型余额”选择 StepFun 即可查询。
按 StepFun 账户 API 使用 Bearer 认证请求 GET https://api.stepfun.com/v1/accounts。金额按 CNY 展示；总充值 / 总赠送金额按文档展示为累计金额，不与当前余额相加。接口没有服务可用性字段，后付费账户不会因为余额为零或负数而显示“服务不可用”。
若模型配置使用其他凭据引用，可在本插件配置中覆盖（baseUrl 是 API 前缀，StepFun 应包含 /v1）：
providers:
- id: StepFun
apiKeyRef: MY_STEPFUN_KEY
baseUrl: https://api.stepfun.com/v1
已有的顶层 apiKeyRef / baseUrl 继续用于 DeepSeek；providers 覆盖对应提供方的余额与模型查询。配置不读取自定义模型的 Base URL，默认查询官方 API。可用模型随所选提供方切换，聊天框摘要仍属于 DeepSeek；消费统计保持原有定价覆盖，未支持的 StepFun 价格会标为未计费。
模型列表按 StepFun 列表 API 请求 GET /v1/models，解析 Model 对象 的 id、owned_by、created（秒级 Unix 时间戳）。列表已包含这些信息，不需要逐个调用单模型详情接口。Host 路由为 GET /dsh-balance/api/models?provider=StepFun，模型缓存按 provider 隔离，refresh=1 强制刷新。
src/providers.ts 保存可在前后端共享的 provider 元数据；src/balance.ts 的 adapter 表只负责端点与响应解析，传输、错误分类和缓存由公共逻辑处理。GET /dsh-balance/api/balance?provider=StepFun 查询 StepFun；省略 provider 保持 DeepSeek 兼容，refresh=1 绕过对应缓存。不支持的 provider 返回 UNSUPPORTED_PROVIDER。pnpm install
pnpm check
pnpm preview
预览不使用真实密钥。可使用 ?lang=en&theme=dark 检查英文与深色主题，?state=missing / error / empty / loading 检查不同状态。StepFun 余额与模型查询、新版账户页面自 0.6.0 起提供。
