前言¶
用 DeepSeek Harness 做百炼相关开发时，代金券还剩多少、什么时候到期，往往要切到阿里云控制台或费用中心才能确认。DeepSeek Harness 支持通过插件扩展界面与能力；社区目录里有不少「联网工具」类插件，用来把外部状态接到宿主里。dsh-bailian-voucher 由 Gucciy69 维护，目标很明确：在 DSH 左侧边栏底部用一张小卡片展示阿里云百炼学生 300 元代金券的剩余余额与到期信息，凭 RAM AccessKey 只读查询，密钥只落本机。
这是什么¶
dsh-bailian-voucher 是 DeepSeek Harness 的 web profile 宿主插件（package.json 中版本 0.1.0，MIT 许可，Node >=20）。它不替你在百炼里消费或下单，只做余额展示：调用阿里云官方只读接口，把结果渲染成侧边栏卡片。插件在 SkillHub 目录 归类为「联网工具」；源码与说明见 GitHub 仓库。
核心功能¶
下面介绍插件已经实现、且 README 中写明的行为。
数据来源与兜底
- 优先通过 BssOpenApi 的
QueryCashCoupons拉取代金券列表，请求使用 RAM AccessKey 的 ACS3 签名。 - 若券列表为空，自动改用
GetFundAccountAvailableAmount（资金账户可用金）兜底；展开面板里会注明口径（含 2024-07 之后券并入「优惠券」体系时可能查不到旧接口列表的情况）。
侧边栏展示
- 卡片显示当前余额相对默认上限 300 元的进度条、可用券张数、最近到期日；示例形态如下：
百炼券 ¥279.50 / ¥300
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░
2 张可用 · 2026-12-31 到期
- 点击卡片可展开：每张券明细、「刷新」按钮、进度条上限（默认 300，仅影响比例）、AccessKey 填写区。
凭据与安全
- AccessKey ID / Secret 仅写入本机
~/.dsh/storages/bailian-voucher/credentials.json（权限 0600），不会下发给浏览器，也不会出现在对话里。 - 保存前会先验证一次，填错不会留下长期报错的配置；写接口只接受应用本身发起的请求，跨站
http(s)Origin 拒绝，桌面壳自定义协议放行。 - 查询结果缓存 5 分钟；点「刷新」强制重查。验证通过后除手动刷新外，README 写明之后每 10 分钟自动刷新一次。
- 隐私说明：仅向
business.aliyuncs.com/bssopenapi.aliyuncs.com发签名请求，不采集、不上报用量；余额在本机进程与浏览器之间传递。
安装与启用¶
安装命令须使用 README 原文，任选其一：
# 推荐：预构建 tarball，免构建、最快
dsh plugin --profile web add https://github.com/Gucciy69/dsh-bailian-voucher/releases/latest/download/dsh-bailian-voucher.tgz
# 或者从源码装（会在本地打包）
dsh plugin --profile web add github:Gucciy69/dsh-bailian-voucher
装完后完全退出并重开 DeepSeek Harness（宿主插件进程内加载），侧边栏底部会出现「百炼券」卡片。
首次配置¶
README 给出的流程大约一分钟，可按顺序做：
- 登录阿里云控制台 → 访问控制 RAM → 用户 → 创建用户（勾选「OpenAPI 调用访问」），取得 AccessKey ID / Secret。
- 为该 RAM 用户附加只读策略。完整示例如下；若只用代金券接口，仅
bss:DescribeCoupons即可；bss:DescribeBillingAccount用于「可用金兜底」，不授权也不影响代金券查询：
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": ["bss:DescribeCoupons", "bss:DescribeBillingAccount"],
"Resource": "*"
}
]
}
- 在 DSH 侧边栏点开「百炼券」卡片，粘贴 AccessKey，点「保存并查询」。
- 验证通过后卡片立即显示余额；换账号时在展开面板使用「清除本机密钥」再填新 Key。
适用场景与注意¶
适合谁
- 长期在 DSH 里使用百炼、持有学生 300 元代金券（或需要盯可用额度）的开发者，希望少切控制台、在宿主里一眼看到剩余与到期日。
使用前请知悉
- 插件以当前 DSH 进程权限运行，会向阿里云计费/OpenAPI 网关发起只读请求；安装前建议浏览仓库源码与 MIT 许可证，确认符合你的安全策略。
- RAM Key 须与代金券所在阿里云账号一致；出现
Forbidden.RAM多为未授bss:DescribeCoupons或 Key 账号不对。 - 卡片上的
Balance是券剩余可抵扣金额，不是面额；已过期/已用完的券会被过滤，数字可能与费用中心展示口径不完全相同。
卸载时需从 profile 的 cordis.patch.yml 与 package.json 移除插件条目，并删除本机凭据目录：
rm -rf ~/.dsh/storages/bailian-voucher
（完整三步见 README「卸载」一节。）
结尾¶
dsh-bailian-voucher 把百炼代金券余额接到 DSH 侧边栏：只读 API、本机存 Key、缓存与手动刷新并存。DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录独立于 DeepSeek / 幻方，并非官方应用商店。若要安装或看维护说明，可打开 目录页 与 GitHub：Gucciy69/dsh-bailian-voucher。
