dsh-aliyun-quota
在 DSH 界面里直接查看阿里云账户额度与花费：可用余额、代金券（含大学生 300 元优惠券）面额与剩余、到期提醒、账单趋势、按模型的 token 用量。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:20132556/dsh-aliyun-quota#f4d3ade23f52525657f7533386b286740c47de86Aliyun Quota 以 dsh-aliyun-quota 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 界面侧边栏直接查看阿里云账户的额度和花费：
不用再去控制台翻「我的权益」和「费用账单」。
dsh plugin --profile desktop add dsh-aliyun-quota
装完重启 DSH 桌面端（插件在启动时加载）。
git clone https://github.com/20132556/dsh-aliyun-quota.git
cd dsh-aliyun-quota
dsh plugin --profile desktop add link:<本目录绝对路径>
如果上面的命令不可用，改 profile 的两处配置：
~/.dsh/profiles/desktop/package.json
- dependencies 里加 "dsh-aliyun-quota": "<版本或路径>"
- dsh.profile.bundles 里加 "dsh-aliyun-quota"
然后 cd ~/.dsh/profiles/desktop && pnpm install，再重启 DSH。
面板顶部有两个标签：花费与模型 / 额度与券。
之后每 90 秒自动刷新，也可以手动点「刷新」。
账单接口的数据通常有 1–6 小时延迟，刚花的钱不一定立刻出现。控制台同理。
这个插件要用阿里云官方 BSS OpenAPI 查数据，需要一对 AccessKey。
步骤：
AliyunBSSReadOnlyAccess（只读，足够查余额、代金券和账单）插件会先真的调一次接口验证，验证不过不会保存，避免存进去一堆废密钥。
如果用主账号 AK，需要确认账号没有被限制调用 BSS OpenAPI。
%USERPROFILE%\.dsh\dsh-aliyun-quota\config.json
内容就是明文 JSON：
{
"accessKeyId": "LTAI5t...",
"accessKeySecret": "..."
}
这个文件里是明文密钥。 如果你介意：
setx ALIYUN_ACCESS_KEY_ID "LTAI5t..."
setx ALIYUN_ACCESS_KEY_SECRET "..."
source: env）。面板上的「设置 → 清除密钥」会删掉这个文件。
| 数据 | 来源接口 |
|---|---|
| 账户可用余额（现金） | QueryAccountBalance → AvailableAmount |
| 可用现金 / 信控额度 | QueryAccountBalance → AvailableCashAmount / CreditAmount |
| 代金券列表（面额、剩余、到期、状态、适用产品） | QueryCashCoupons |
| 合计可用（余额 + 券） | 本地汇总 |
| 最近到期提醒 | 本地计算 |
大学生优惠券（云工开物 300 元那类）通常以代金券形式发放，会出现在明细里。
| 数据 | 来源接口 |
|---|---|
| 近 N 个月账期汇总（消费、券抵、折扣） | QueryAccountBill（Granularity=MONTHLY） |
| 逐日花费 | DescribeInstanceBill（Granularity=DAILY，每天一次） |
| 按模型 / 计费项的 token 用量 | DescribeInstanceBill → InstanceID 第 3、4 段 |
| 按产品汇总 | 本地聚合 |
百炼的模型是怎么认出来的：DescribeInstanceBill 返回的 InstanceID 形如
7752890;ws-wlhl9tvtza5rpkd6;deepseek-v4.1-flash-1017;output_token_peak;0
└─ 模型名 ─┘ └─ 计费项 ─┘
第 3 段是模型名，第 4 段是计费项（输入/输出/缓存 × 高峰/闲时）。插件按这两段聚合，所以能精确告诉你哪个模型花了多少钱、用掉多少 token。
非百炼产品（ECS、OSS 等）没有这个格式，退回用产品名分组。
可能的原因：
QueryCashCoupons 里，走的是另外的接口bss:DescribeCoupons（AliyunBSSReadOnlyAccess 已包含）bss:QueryBill / bss:DescribeInstanceBill（AliyunBSSReadOnlyAccess 已包含）出现查不到的情况告诉我，我加对应接口。
node:crypto 和 node:fs，手写阿里云 RPC 签名（HMAC-SHA1），没有装 SDK/api/dsh-aliyun-quota/*，只允许本机回环访问ctx.slots 挂载，无构建步骤aliyun_quota 和 aliyun_usage 两个工具，可以直接在对话里问额度 / 花费GET /api/dsh-aliyun-quota/status?refresh=1 额度总览
GET /api/dsh-aliyun-quota/usage?refresh=1 花费与模型用量（可加 &months=12）
GET /api/dsh-aliyun-quota/config 是否已配置（不返回密钥）
POST /api/dsh-aliyun-quota/config 保存并验证 AccessKey
POST /api/dsh-aliyun-quota/clear 清除密钥
GET /api/dsh-aliyun-quota/health 自检
node test/routes.mjs
会挂一个临时 HTTP 服务，用假 DSH 上下文跑 20 项断言（含"假密钥必须被拒绝且不落盘"和 usage 路由的方法校验）。
| 现象 | 原因 | 处理 |
|---|---|---|
| 侧边栏没有图标 | 插件没加载 | 确认 package.json 的 dsh.profile.bundles 里有它，重启 DSH |
| 保存时报「密钥验证失败」 | AK 错 / 被禁用 / 权限不足 | 去 RAM 控制台检查权限 |
报 SignatureDoesNotMatch | 系统时钟偏差超过 15 分钟 | 校准系统时间 |
| 显示「没有查到代金券」 | 券未到账或类型不是代金券 | 等一会儿；或告诉我加接口 |
| 花费页一直空 | 账单还没出 / 权限不足 | 等 1–6 小时；确认有 AliyunBSSReadOnlyAccess |
| 模型显示成产品名 | 非百炼产品，InstanceID 没这个格式 | 正常行为 |
报 Throttling | 刷太快触发频控 | 等 1 分钟再点刷新 |
# 1. 从 profile 里去掉（两处都要改）
# ~/.dsh/profiles/desktop/package.json
# - dependencies 里删掉 "dsh-aliyun-quota"
# - dsh.profile.bundles 里删掉 "dsh-aliyun-quota"
# 2. 重装依赖
cd ~/.dsh/profiles/desktop
pnpm install
# 3. 重启 DSH
并删掉 ~/.dsh/dsh-aliyun-quota/（里面有密钥）。
MIT