前言¶
DeepSeek Harness (DSH) 采用插件化架构，强调功能的模块化与扩展性。在多模型或多账号切换的开发与使用场景中，实时掌握当前 API 的余额或流量使用情况是提升效率的关键。dsh-quota-cards 旨在解决这一痛点，通过在消息输入框左侧提供常驻的额度卡片，让用户无需离开聊天界面即可查看当前模型的额度状态。
简介¶
dsh-quota-cards 是一个 DSH 额度查询插件。它在 composer 的左侧（conversation.input.left）常驻一张额度卡片，该卡片会跟随当前选中的模型自动切换内容，展示对应账号的额度或流量。插件支持手动刷新（带防抖）和按周期自动刷新。
核心功能¶
- 常驻额度卡片：位于 composer 左侧（
conversation.input.left插槽）。 - DeepSeek 余额展示：显示账户余额，包含总额及授予/充值详情（通过 Tooltip 展示）。
- OpenCode Go 用量展示：显示 5 小时（滚动）/每周/每月窗口的剩余代币使用量百分比。
- 跟随模型切换：通过
session.modelsRPC 实时解析当前模型。ID 包含deepseek的显示余额卡片，opencode的显示用量卡片，其他显示占位符。 - 手动刷新：点击立即刷新，绕过缓存。具备 2 秒冷却机制，冷却期间或请求进行中时忽略点击。
- 自动刷新：支持 1/5/10/30/60 分钟间隔，每次获取后重新安排下一次刷新。
安装与启用¶
插件依赖 DSH 已安装运行 (dsh web) 及系统 PATH 中的 pnpm。
- 将插件解压至本地目录，例如
D:/plugins/dsh-quota-cards。 - 执行安装命令将插件添加至 Web 配置文件：
dsh plugin --profile web add file:D:/plugins/dsh-quota-cards
- 重启
dsh web。 - 打开设置，进入「额度查询」页面，确认凭证引用（默认为
DEEPSEEK_API_KEY和OPENCODE_GO_API_KEY），并检查密钥是否存在。 - 返回聊天页面，额度卡片将出现在 composer 左侧。
典型用法¶
- 重启
dsh web。 - 在设置中配置 API 密钥。
- 在聊天界面切换模型（如从 DeepSeek 切换到 OpenCode Go），观察左侧卡片内容的自动变化。
注意事项¶
- 依赖项：主机服务依赖
settings,credentials,sessions,agentDefaultModel，可选webServer；客户端服务依赖slots,connection，插槽包括conversation.input.left和settings.section。 - 提供者匹配：通过 ID 匹配。DeepSeek 官方 ID 为
deepseek-official时显示余额卡片；OpenCode Go 常见 ID 为opencode-go时显示用量卡片。 - 安全性：密钥通过
ctx.credentials.resolve()在主机端解析，浏览器仅接收只读的查询结果。设置写入需要同源 POST 请求。 - 运行时依赖：无第三方运行时依赖，其
peerDependencies包括schemastery和@deepseek-ai系列包。
结语¶
该插件通过常驻 UI 和自动刷新机制，简化了 DSH 用户的额度管理流程。对于需要频繁切换模型或管理多账号的开发者，这是一个实用的工具。
