前言¶
用 DeepSeek Harness（DSH）接千问平台 API、又用阿里云代金券或账户余额付费时，对话窗口里看不到「券还剩多少、什么时候到期」。账单和消费统计是另一套问题；若只想知道当前还能用的钱，需要单独查阿里云 BSS 存量。下面介绍社区插件 dsh-aliyun-balance（维护者 wai549077），在 DSH 界面上悬浮一行显示代金券余额与账户余额的合计，悬停可看券明细与失效时间；只读 BSS，不做消费统计。
这是什么¶
dsh-aliyun-balance 是 DSH 插件，npm 包名 dsh-aliyun-balance，当前版本 0.1.2，许可证 MIT。在 SkillHub 分类为联网工具；包元数据里还标注了「费用」「Web UI」，支持 host 与 web 两种 surface。
它回答的问题是：还剩多少钱能花（代金券余额 + 阿里云账户余额），而不是花了多少。数据来自阿里云 BSS 的当前存量；与 dsh-cost-meter 互补——后者按 token 估算消费，且无法查代金券明细。
README 写明主要面向领了阿里云 300 元「云工开物」高校认证学生专属代金券、并用千问平台 API 接入 DSH 的用户；仓库内另有从领券到接入的图文教程（docs/阿里云300学生券-千问AI平台-DSH接入教程.md）。
核心功能¶
界面上一行类似：
可用 ☰ ¥128.50
「可用」为可用合计（代金券余额 + 账户余额）。操作要点：
| 操作 | 效果 |
|---|---|
| 悬停 | 展开明细：券余额、面值/已用、最早失效时间、现金/信控等（均为 BSS 直读，非推算） |
| 单击（非 ☰） | 绕过缓存立即刷新 |
| 拖动 / 双击 | 改位置 / 复位默认位置 |
| 点 ☰ | 打开面板：凭据、外观、显示项 |
余额与券默认每 5 分钟刷新一次。插件不统计消费，不看会话事件；想知道花了多少需用 dsh-cost-meter。
可选「计价时段」显示（千问平台闲忙口径，东八区 22:00–08:00 为闲时），仅对 README 列出的部分按闲忙双档计价的模型有意义；用不上可在面板关闭。
网络权限在 package.json 中声明为 https://*.aliyuncs.com；凭据区可改 endpoint，但只允许 *.aliyuncs.com 域名。
安装与启用¶
DSH 从本地目录安装插件：先把含 package.json 的目录放在固定位置（勿放临时目录，移动后需重装），再在桌面端会话里说明本地路径，例如：
把 D:\Plugins\dsh-aliyun-balance 这个本地目录作为插件装上
官方 README 提供的获取目录方式包括：
从 GitHub 克隆（推荐）：
git clone https://github.com/wai549077/dsh-aliyun-balance.git dsh-aliyun-balance
从 npm 安装包到本地：
npm i dsh-aliyun-balance
命令行添加（注意 profile）：
dsh plugin add dsh-aliyun-balance
README 说明：dsh plugin 不能用于桌面端的 desktop profile（该 profile 仅由 Electron 应用管理）。桌面端用对话式本地目录安装，或等插件市场直装后对 DSH 说「把 dsh-aliyun-balance 装上」；web（dsh web） 可用：
dsh plugin --profile web add dsh-aliyun-balance
装完自检：界面应出现那一行；Windows 下日志 %USERPROFILE%\.dsh\.dsh-aliyun-balance.log 中应有 {"event":"apply"}。若未出现，重开一次客户端。实测环境为 DSH Desktop（Windows）2.0.17；web profile 机制同源但 README 标明未经实测。
未配置凭据时，那一行会显示「未配置」。
配置凭据¶
- 在阿里云 RAM 创建子账号（不要用主账号），建议勾选「使用永久 AccessKey 访问」，不勾控制台登录。
- 只读授权：
bss:DescribeAcccount（官方拼写为双c）、bss:DescribeCoupons，或系统策略AliyunBSSReadOnlyAccess。 - 创建 AccessKey，保存 AccessKey ID / Secret（Secret 仅创建时显示一次）。
- DSH 中点 ☰ → 凭据与设置 → 填入 AK/SK → 保存凭据 → 测试连接。
凭据写入 DSH 官方凭据服务；本地 ~/.dsh/.credentials.yaml 为明文 YAML，务必使用只读子账号 AK。插件设置接口不回显密钥，只返回 hasAk / hasSk；查询主机为 business.aliyuncs.com，无写操作。
典型用法¶
完成安装与凭据后，日常使用即：看那一行的合计金额；快到期或想核对券面值/已用时悬停；需要改 AK、外观或关闭计价时段时点 ☰ 进面板。单击一行可强制刷新，适合刚充值或刚扣券后想立刻看存量。
与 dsh-cost-meter 搭配时：本插件盯「还能花多少」，cost-meter 盯「这轮对话大概花了多少」，二者数据来源不同，不重叠。
适用场景与注意¶
适合： 用阿里云代金券和/或账户余额为 DSH（尤其千问 API）付费、希望在 IDE 内常驻看到存量与券失效信息的开发者。
安装前： 插件在 DSH 进程权限下运行，会持有你配置的 AK/SK 并访问阿里云 BSS；安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认只读 RAM 策略满足你的安全要求。
读数注意： BSS 存量相对实际扣减可能有延迟，不宜用对话前后余额差反推单次消费。插件不上传界面上的阿里云数据到第三方（README「关于」一节说明）。
故障排查可参考 README：Forbidden 多为 RAM 缺 bss:Describe* / bss:Query*；位置异常可双击复位或取消「锁定位置」。
结尾¶
dsh-aliyun-balance 把阿里云代金券与账户余额收成 DSH 里可拖动的一行挂件，只读 BSS、只报存量，和消费统计类插件分工明确。目录与详情见 SkillHub 插件页，源码与完整安装说明见 GitHub：wai549077/dsh-aliyun-balance。
