dsh-aliyun-quota
在 DSH 界面侧边栏直接查看阿里云账户的额度和花费：
- 额度与券：可用余额、代金券面额与剩余、到期提醒（学生认证的 300 元券也在这里）
- 花费与模型：本月已花多少、今日花费、近 8 个月账单趋势、每月 token 用量、按模型 / 按计费项的明细
不用再去控制台翻「我的权益」和「费用账单」。
安装
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。
用法
- 重启 DSH 桌面端（插件在启动时加载）
- 左侧边栏点 「阿里云额度」（圆形 ¥ 图标）
- 第一次会看到设置表单，填入 AccessKey
- 保存后立刻显示
面板顶部有两个标签：花费与模型 / 额度与券。
之后每 90 秒自动刷新，也可以手动点「刷新」。
花费页能做什么
- 本月已花：按账期汇总的消费金额，以及其中多少由代金券抵掉
- 今日花费：当天 0 点到现在
- 每月账单趋势：近 8 个月的柱状图，鼠标悬停看明细
- 本月 token 构成：输入 / 缓存命中 / 输出 三段占比，附缓存命中率
- 按模型：每个模型的费用与 token 用量，展开可看计费项（输入·高峰、输入缓存·闲时、输出·高峰…）
- 按产品：账号下多个产品时分别列出
- 本月逐日：每天花了多少、多少 token、几条明细
账单接口的数据通常有 1–6 小时延迟，刚花的钱不一定立刻出现。控制台同理。
先拿 AccessKey
这个插件要用阿里云官方 BSS OpenAPI 查数据，需要一对 AccessKey。
步骤：
- 打开 RAM 访问控制 → AccessKey
- 建议用 「创建 RAM 用户」，不要用主账号 AK（主账号 AK 权限过大，泄露风险高）
- 创建后给这个 RAM 用户授予
AliyunBSSReadOnlyAccess（只读，足够查余额、代金券和账单）
- 把 AccessKey ID 和 Secret 粘进插件面板，点「保存并验证」
插件会先真的调一次接口验证，验证不过不会保存，避免存进去一堆废密钥。
如果用主账号 AK，需要确认账号没有被限制调用 BSS OpenAPI。
密钥存在哪
%USERPROFILE%\.dsh\dsh-aliyun-quota\config.json
内容就是明文 JSON：
{
"accessKeyId": "LTAI5t...",
"accessKeySecret": "..."
}
这个文件里是明文密钥。 如果你介意：
面板上的「设置 → 清除密钥」会删掉这个文件。
能查到什么
额度
| 数据 | 来源接口 |
|---|
| 账户可用余额（现金） | 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 里，走的是另外的接口
- RAM 权限不足 —— 需要
bss:DescribeCoupons（AliyunBSSReadOnlyAccess 已包含）
如果花费是空的
- 账单延迟 —— BSS 出账有 1–6 小时延迟，刚消费的看不到
- 账期边界 —— 每月 1 号刚过，上个月的账期数据可能还在结算
- RAM 权限不足 —— 账单接口需要
bss:QueryBill / bss:DescribeInstanceBill（AliyunBSSReadOnlyAccess 已包含）
出现查不到的情况告诉我，我加对应接口。
技术实现
- 零依赖：只用
node:crypto 和 node:fs，手写阿里云 RPC 签名（HMAC-SHA1），没有装 SDK
- 服务端：注册 5 个路由在
/api/dsh-aliyun-quota/*，只允许本机回环访问
- 客户端：侧边栏条目 + 主面板（两个标签页），用
ctx.slots 挂载，无构建步骤
- 缓存：额度 45 秒，账单 5 分钟（账单一次要发 30+ 个请求，不宜频刷）；并发请求合并
- 并发：账单接口 6 路并发，近 8 个月 + 30 天明细约 2 秒出结果
- 额外：注册了
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/（里面有密钥）。
License
MIT
