dsh-opendesign-quota-card

在 DSH Web GUI 的侧栏底部（设置项之上）显示 OpenDesign (AMR) 套餐额度，形态与 Command Code 额度面板一致：一个圆环取最紧的窗口，套餐徽标，每个额度窗口一条进度条。百分比是已用（和 Command Code 一致），不是剩余。点开卡片是仪表盘：钱包余额、本机本月花费、每个窗口的已用金额与重置倒计时，以及这些数字来自哪条通道。

……会话列表……
[ ◔ OpenDesign               GO ]
[ 5 小时     $4.44 / $5.00   89% ]
[ 每周      $14.28 / $15.00   95% ]
[ ⚙ 设置 ]

读的是什么

通道	凭据	给出的数字
control 本机登录	vela login / OpenDesign 桌面端写入 ~/.amr/config.json 的 controlKey	billing/preflight 的 balanceUsd + codingPlan.windows[]，每个窗口的 usedCredits / limitCredits / remainingCredits 精确值
area 浏览器会话	OpenDesign 控制台登录保存的会话（与 dsh-opendesign-limit 共用同一个凭据记录）	先读 billing/coding-plan-usage，401/404 时回退 billing/preflight
ledger 本机账本	<DSH home>/dsh-opendesign-go/usage.jsonl	本机在窗口内的花费，按官方的模型 credit 倍率折算，与套餐窗口上限比较。这是估算，卡片上标「估算」

不用 sk-amr-… API Key。 它是推理网关的 runtime key，控制面的每个账单接口都回 401（已对线上服务验证），拿它推算数字等于编造。

百分比在宿主里用 BigInt 由精确的 credits 字符串算出，前端不重算；接口没给出可读配对的窗口会被标注，不会画成 0%。

获取真实数字：在仪表盘点「登录控制台」

三条通道里只有前两条是官网的数字，第三条是估算。估算天生比官网乐观：账本只知道这一台机器，官网知道整个账号，所以同一时刻可能一边显示 99%、一边显示 95%。

与其把估算调得像真的，插件直接给出去拿真数字的路：仪表盘下方有「连接到 OpenDesign 控制台」。点一下，插件会用 Edge/Chrome 打开一个临时窗口（一次性配置目录，退出即删），你自己在里面登录官网（登录页有 Cloudflare 人机校验，任何自动化都过不去，所以必须由人来点）。登录完成后插件通过 CDP 读取官网域的 Cookie，先用它真的请求一次官网接口验证通过，才写入凭据存储——半途的登录态绝不会覆盖已经能用的一次。

登录成功后卡片改成官网口径：5 小时 / 7 天的真实百分比、重置倒计时，标「官方」而不是「估算」。仪表盘也提供「退出并回到估算」。

窗口只开在宿主机屏幕上，所以从别的设备访问这个界面时插件会直接说明不能登录，而不是开一个你点不到的窗口。

若你之前装过 dsh-opendesign-limit 并登录过，插件会直接复用它保存的会话；不需要再登录一次。

三个关键行为

• 极性是「已用」：圆环和进度条都表示用掉了多少，条越满表示越接近上限，与同栏的 Command Code 卡片同一读法。
• 不编数字：接口返回无法解析的结构、凭据被拒、路由 404 都会带上具体原因显示为失败，不会退化成 $0.00。
• 估算通道明说：ledger 通道的每个窗口带 estimated: true，卡片和仪表盘都会标「估算」，并说明其他设备与 OpenDesign 应用自身的用量不在这份数据里。

获取真实数字的前置条件

control 通道需要本机有 AMR 登录态（OpenDesign 桌面端登录一次，或 vela login）。没有登录态时插件会依次回退到浏览器会话，再到本机账本；卡片上会标出来源。装好登录态后点一次「刷新」即可切换，不需要重装插件。

配置

插件行 opendesign-quota 的 config：

字段	默认	说明
sidebarCard	true	是否在侧栏底部画这张卡片
minIntervalSec	60	两次自动读取的最短间隔
refreshOnOpen	true	打开仪表盘时立即读一次
source	auto	auto / control / area / ledger
amrHome	空	覆盖 ~/.amr 的查找位置
workspaceId	空	指定工作区，跳过列表请求
planTier	空	估算通道用的套餐档位（go/plus/pro/max）
monthlyCapUsd	空	覆盖套餐月度上限
ledgerPath	空	覆盖本机账本路径

安装

DSH → 插件 → 添加插件，选择这个目录（或用一个只声明 dsh.bundle.patch 的包安装）。安装后侧栏底部即出现卡片；切到会话之外的任何面板都还在。

从 GitHub 安装：

dsh plugin --profile <你的 profile> add github:QLNPLUS/dsh-opendesign-quota-card

本仓库没有构建步骤，源码即产物，所以这条命令不需要授权 allowBuilds。

限制

• 估算通道只统计本机。换一台机器、或在 OpenDesign 应用里直接用掉的额度，它看不到——登录控制台后不受此限。
• 滚动窗口（5 小时 / 每周）在估算通道里没有固定重置时刻，报告的是「最早释放时间」；官网通道用官网给出的 resetsAt。
• 写入范围只有登录态：插件不改 profile 配置，登录态是唯一写入的凭据记录（dsh-opendesign-quota/browser-session）。退出登录只删这一条——若当前用的是 dsh-opendesign-limit 那条共享会话，插件会在界面上说明，而不是替你把它删掉。