DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-bailian-coupon

t

dsh-bailian-coupon

Manifest valid

Alibaba Cloud Bailian (Model Studio) Voucher Balance: Displays the remaining balance in the DSH sidebar, supports directly entering RAM AccessKey within the panel, with 10-minute caching

UI (client)hasBundlePatchMachine translated

dsh-bailian-coupon

在 DeepSeek Harness(DSH)侧边栏常驻显示阿里云百炼优惠券(代金券)剩余余额的插件。

  • 侧边栏底部徽标:券 ¥xxx.xx,点击打开详情面板。每轮对话结束后自动刷新余额(服务端监听 DSH 的 session/event → turn/end 时强制重查),面板另有 15 秒固定轮询,无需手动点刷新。
  • 详情面板:每次打开都会自动强制刷新(30 秒内重复打开则复用,避免频繁请求阿里云), 显示剩余总额、可用/全部张数、每张券的面值/余额/到期时间/状态、控制台链接。
  • 后台更新:缓存过期时 /overview 会先返回旧数据、同时后台补拉(stale-while-revalidate),下次打开即是最新值。
  • 设置页:填写 RAM AccessKey ID / Secret、刷新间隔,支持"保存并查询"。
  • 面板内也能直接填:未配置时点开徽标,面板里出现 AccessKey ID / AccessKey Secret 两个输入框。
  • DeepSeek 峰谷时段:徽标右侧圆点 + 详情面板顶部显示当前处于峰时还是谷时——峰时红色、谷时绿色,并提示「下次切换」倒计时。
  • 本次会话消耗:详情面板显示本会话开始时的余额与当前余额之差(红字金额 + 已结算轮数),只统计已出账的额度;服务端按会话 id 记账,不会跨会话串账。

插件市场分类:集成与连接 · English: Show Alibaba Cloud Bailian (Model Studio) cash-coupon balance in the DSH sidebar.

它是怎么工作的

模型 API Key(sk-... / sk-sp-...)没有查询余额的接口,控制台之外的唯一官方途径是 BSS OpenAPI 的 QueryCashCoupons(Version 2017-12-14,RPC 风格,HMAC-SHA1 签名):

GET https://business.aliyuncs.com/?Action=QueryCashCoupons&Version=2017-12-14&...

返回的 Data.CashCoupon[] 里 Balance 是该券剩余金额,NominalValue 是面值; 插件只把 Status === "Available" 的券计入"剩余可用",并按 nearestExpiry 找出最近到期时间。

因为 BSS 需要 RAM AccessKey(不是模型 Key),所以首次使用要在插件设置里填一把只读的 RAM 用户 AK/SK,或改用环境变量(优先级更高):

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "LTAI..."
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "..."

最小权限

给该 RAM 用户附加只读策略 AliyunBSSReadOnlyAccess,或自定义策略:

{
  "Version": "1",
  "Statement": [
    { "Effect": "Allow", "Action": ["bss:DescribeCoupons"], "Resource": "*" }
  ]
}

(设置里的"包含现金余额"开关会额外调用 QueryAccountBalance,需要 bss:DescribeAcccount; 不开也能正常看券余额。)

安装

方式一:从 npm / 插件市场安装(推荐)

# 已发布到 npm(0.1.1),一条命令安装
dsh plugin --profile web add dsh-bailian-coupon

也可以直接从 GitHub 仓库安装(要求本机装有 Git;没装 Git 见「方式三」):

dsh plugin --profile web add github:tagayamajin/dsh-bailian-coupon

github: 规格由包管理器用 git ls-remote 解析,要求本机装有 Git。 没装 Git(或 github.com 直连不稳定)请看下面的「方式三」。

装好后重启 DSH(宿主只在启动时扫描插件)。侧栏 Settings 上方出现 券 未配置 徽标, 点开徽标 → 在面板里直接填 RAM AccessKey ID / Secret → 保存并查询;也可以在 设置 → 插件 → 百炼优惠券 里填。首次查询成功后徽标变成 券 ¥300.00(示例)。

方式二:从本地源码 link 安装(本地开发)

桌面版 profile 由桌面应用独占,命令行 dsh plugin --profile desktop add 会被拒绝, 必须从 GUI 安装。

  1. 打开 DSH → 设置 → 插件市场 → 本地安装 / 从路径安装,选择本仓库目录 (link 安装即可,改代码后重启生效)。
  2. 重启 DSH Desktop(宿主只在启动时扫描插件)。
  3. 同上:填 AK/SK → 保存并查询。

方式三:没有 Git 环境(下载 zip 后本地安装)

github: 安装方式依赖本机 git 命令;如果没装 Git,下载源码包再本地安装即可:

  1. 下载源码包:https://github.com/tagayamajin/dsh-bailian-coupon/archive/refs/heads/main.zip
  2. 解压到任意目录,例如 %USERPROFILE%\dsh-plugins\dsh-bailian-coupon
  3. 打开 DSH → 设置 → 插件市场 → 从路径安装,选择解压后的目录(link 安装)
  4. 重启 DSH Desktop,点侧栏 券 徽标填 AK/SK

PowerShell 一条命令搞定下载与解压:

$zip = "$env:TEMP\dsh-bailian-coupon.zip"
Invoke-WebRequest -Uri "https://github.com/tagayamajin/dsh-bailian-coupon/archive/refs/heads/main.zip" -OutFile $zip
Expand-Archive -Path $zip -DestinationPath "$env:USERPROFILE\dsh-plugins" -Force
# 解压目录:$env:USERPROFILE\dsh-plugins\dsh-bailian-coupon-main

配置项

键默认说明
accessKeyId—RAM AccessKey ID,形如 LTAI...
accessKeySecret—RAM AccessKey Secret(保存后只显示掩码;留空保存表示不修改)
refreshMinutes10自动刷新间隔,1–1440 分钟
includeCashNotefalse是否附带查询现金余额 QueryAccountBalance(仅作附注)
endpointbusiness.aliyuncs.comBSS 端点,一般不用改
holidays内置 2026 年表追加节假日 ["YYYY-MM-DD", ...],用于 2027 年等未内置年份
replaceHolidaysfalse为 true 时用 holidays 完全替换内置节假日表

凭据保存在插件目录的 .state/config.json(权限 0600,不提交、不打印);环境变量存在时以环境变量为准, 设置页会显示 envLocked 提示。

DeepSeek 峰谷时段

DeepSeek API 计费分峰谷:高峰时段单价为谷时的 2 倍,谷时是峰价的一半。插件在侧栏徽标与详情面板 显示当前时段,颜色区分:

时段颜色规则(北京时间)
峰时🔴 红色 #dc2626周一至周五 09:00–12:00、14:00–18:00,法定节假日除外
谷时🟢 绿色 #15803d其余全部时间(夜间、午休、周末、法定节假日)
  • 面板会显示「下次切换」的准确时间(如「下一次切换 2026-11-05 09:00 周四 → 峰时(558 分钟后)」)。
  • 规则在客户端本地计算(北京时间固定 UTC+8,不依赖系统时区),不额外发请求、不走网络; 每 30 秒自动重算一次,跨越 09:00/12:00/14:00/18:00 时会自动变色。
  • 内置 2026 年法定节假日表(元旦/春节/清明/劳动节/端午/中秋/国庆)与调休安排;2027 年放假安排公布前, 可通过配置项 holidays 补充,未内置年份会按「仅周末」计算并提示 holidayDataAvailable: false。

HTTP 接口(本机回环,非回环返回 403)

方法路径作用
GET/HEAD/api/dsh-bailian-coupon/overview当前余额(TTL 缓存,正常 10 分钟内不重复请求)
POST/api/dsh-bailian-coupon/refresh强制刷新
GET/HEAD/api/dsh-bailian-coupon/peakDeepSeek 峰谷时段状态(本地规则计算,不请求阿里云)
GET/HEAD/api/dsh-bailian-coupon/config配置状态(AK 已掩码)
POST/api/dsh-bailian-coupon/config保存配置({accessKeyId, accessKeySecret, refreshMinutes, includeCashNote, endpoint},{clear:true} 清空凭据)

所有响应带 cache-control: no-store,不含 Secret。

为什么模型 Key 不行

百炼的模型 API Key 只用于推理调用,阿里云没有开放「按模型 Key 查余额/券」的接口; QueryCashCoupons 属于账号级 BSS 服务,必须用 RAM AK/SK 签名。插件不会读取 DSH 里保存的模型密钥。

测试

& "C:\Users\w\AppData\Local\Programs\DeepSeek Harness\resources\runtime\primary-runtime\dependencies\node\bin\node.exe" tests\bss.test.mjs
& "...\node.exe" tests\peak.test.mjs
& "...\node.exe" tests\routes.test.mjs
& "...\node.exe" tests\client.test.mjs
  • tests\bss.test.mjs:签名算法(含官方示例对拍)、券汇总逻辑。
  • tests\peak.test.mjs:峰谷判定(09:00/12:00/14:00/18:00 边界)、下次切换、2026 节假日、自定义节假日表。
  • tests\routes.test.mjs:stub 宿主上下文 + 本地 HTTP 端到端,覆盖无凭据/方法守卫/配置掩码与落盘/ stub BSS 的刷新与缓存/错误映射/峰谷路由。
  • tests\client.test.mjs:客户端 bundle 注册、插槽、面板渲染、本地峰谷算法。

故障排查

症状处理
InvalidAccessKeyIdAK ID 填错或已删除,重新生成(AK 管理)
SignatureDoesNotMatchSecret 填错,或本机时间偏差过大(签名有效期 31 分钟)
NotAuthorized/NoPermissionRAM 用户缺 bss:DescribeCoupons,附加 AliyunBSSReadOnlyAccess
Throttling被限流,调大 refreshMinutes
余额 ¥0.00 且列表为空该券可能不是代金券(储值卡等不在此接口),去优惠券控制台筛选「代金券」确认
徽标一直是「未配置」环境变量 / 设置页都没读到凭据;保存后点一次「保存并查询」

目录结构

package.json          # dsh.bundle.patch + dsh.client 声明
cordis.patch.yml      # 宿主侧插入点
lib/bss.js            # BSS 签名与查询(node:crypto + fetch,零依赖)
lib/peak.js           # DeepSeek 峰谷规则(北京时间、节假日表、下次切换)
lib/index.js          # 宿主插件:5 条 /api/dsh-bailian-coupon/* 路由 + 配置持久化
lib/client.js         # 客户端 bundle(手写 CJS,仅依赖 react / react-dom/client,含本地峰谷计算)
tests/*.test.mjs      # 离线测试

隐私与权限

  • 插件只做一件事:用你填的 RAM AccessKey 调阿里云 BSS QueryCashCoupons(可选附带 QueryAccountBalance)。
  • 凭据只保存在本机插件目录 .state/config.json(权限 0600,已 gitignore),不上传、不打印;HTTP 接口返回的 Secret 一律掩码。
  • 不读取 DSH 里保存的模型 API Key,不向任何第三方发送数据。
  • 建议单独建一个只读 RAM 用户(附加 AliyunBSSReadOnlyAccess)专供本插件使用。

版本记录

  • 0.1.2 — 打开面板自动强制刷新(30 秒节流);刷新后侧栏徽标金额同步;/overview 增加 stale-while-revalidate(过期缓存先返回、后台补拉);每轮对话结束自动刷新余额(监听 session/event 的 turn/end,1.2 秒去抖)+ 面板 15 秒轮询;新增「本次会话消耗」(/overview 与 /refresh 响应带 session: { id, spent, turns, baseline, remaining })。
  • 0.1.1 — 新增 DeepSeek 峰谷时段(峰时红/谷时绿)与「下次切换」提示;holidays / replaceHolidays 配置项;GET /api/dsh-bailian-coupon/peak 接口。
  • 0.1.0 — 首版:侧栏余额徽标、券明细面板、设置页与面板内填 RAM AccessKey、10 分钟缓存。

许可证

MIT © 2026 dsh-bailian-coupon contributors。见 LICENSE。

Comments

Loading…

Similar plugins

dsh-aliyun-balance

by wai549077

DSH 插件:悬浮一行显示阿里云代金券 + 账户余额(还能花的钱),悬停看券面值/已用/最早失效时间。只读 BSS 存量,不做消费统计。

Tools & CapabilitiesManifest valid

★ 13

↓ 677/wk

MIT

JavaScript

Oct 24, 2026

dsh plugin --profile web add dsh-aliyun-balance

by yangguozhongmax-max

在 DeepSeek Harness 侧边栏显示阿里云代金券剩余额度(只读 BSS DescribeCoupon,AK 只留在宿主凭据库)· Alibaba Cloud coupon balance row for DSH

Manifest valid

★ 0

MIT

JavaScript

Oct 21, 2026

dsh plugin --profile web add dsh-alicoupon

by fvvef121-cell

在 DeepSeek Harness 侧栏显示阿里云代金券余额(BSS OpenAPI 只读查询,凭据只留宿主进程)

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Nov 1, 2026

dsh plugin --profile web add dsh-aliyun-coupon

by tacotuesday22

阿里云余额 + 代金券挂件 | DeepSeek Harness plugin: read-only Aliyun account balance & coupon balance via official OpenAPI, shown in the sidebar

Manifest valid

★ 0

MIT

JavaScript

Oct 31, 2026

dsh plugin --profile web add dsh-aliyun-coupon-api

Shows your Alibaba Cloud cash-coupon balance - the credit that pays for Qwen and DashScope calls - in the DSH sidebar, with an AccessKey form that keeps the key on your machine.

Tools & CapabilitiesManifest valid

★ 0

dsh plugin --profile web add dsh-qwen-coupon-balance

by MrXiongBear

DSH 插件:侧边栏显示 API 余额、消费估算与峰谷时段,附完整用量仪表盘与服务商切换

Manifest valid

★ 0

MIT

JavaScript

Nov 3, 2026

dsh plugin --profile web add dsh-usage-dashboard