English | 中文
dsh-od-quota
非官方插件：与 Open Design / Powerformer 无隶属关系，仅按公开接口读取你自己账号的额度。
在 DSH 里查看 OpenDesign 订阅额度。三个界面共读同一份读数：
| 界面 | 位置 | 作用 |
|---|---|---|
| 额度页 | 左栏「OpenDesign 额度」图标 → 中央整页 | 5 小时 / 7 天窗口、钱包、登录与批准 |
| 设置摘要 | 设置侧栏「OpenDesign 额度」 | 状态、两条迷你额度条、刷新 / 打开额度页、自动刷新与顶栏开关 |
| 顶栏额度条 | 会话标题栏右侧（「打开应用」箭头左边） | 套餐 + 两条剩余额度条；宽度不够时自动降级；点击打开额度页 |
额度条按剩余百分比着色（绿 = 充足，黄 = 注意，红 = 快用完），数据过期时降透明度并在提示里说明。
它读什么
OpenDesign 云有两个平面，额度只在控制面：
| 平面 | Host | Key | 用途 |
|---|---|---|---|
| 控制面 | amr-api.open-design.ai | vela_ctrl_… | 套餐、钱包、5h/7d 额度窗口、workspace |
| 模型面 | amr-link.open-design.ai/v1 | sk-amr_… | 推理 |
sk-amr_… 读不到额度（控制面不接受它），所以插件走控制面。vela_ctrl_… 不在任何网页上，由 CLI 设备授权（vela login 同一套流程）签发——插件就是替你跑这套流程的。
安装
# npm（推荐，也是插件市场走的路径）
dsh plugin --profile web add dsh-od-quota
# 或直接装仓库
dsh plugin --profile web add github:WuWei-Peng/dsh-od-quota
# 或装 GitHub Release 上的预构建包（不经过 npm，适合内网/镜像受限）
dsh plugin --profile web add https://github.com/WuWei-Peng/dsh-od-quota/releases/latest/download/dsh-od-quota.tgz
装完重启一次 dsh web，左栏出现「OpenDesign 额度」图标，设置页同时提供一个摘要入口。
工作方式
- 进入额度页或设置摘要时若没有 key，插件调用
POST /api/v1/cli/device-authorizations生成批准链接与 6 位码；页面显示码、倒计时和可复制的链接。 - 你在浏览器登录 OpenDesign 并批准，插件轮询到
controlKey，写进 DSH 凭据服务（引用名默认OPENDESIGN_CONTROL_KEY，可改keyRef）。 - 之后每 60 秒读一次
billing/preflight+billing/summary，把结果写回本插件配置的quotaJson；额度页、设置摘要和顶栏都只解析这一份文档。 - 手动刷新写
refreshNonce（时间戳 + 递增序号，连点两次也不会重样），宿主观测到变化立即重读；写入被拒绝时页面会明说并让你重试，而不是「点了没反应」。 - 一个 15 秒的看门狗按墙钟核对上次读取时间：漏掉的 tick、卡住不返回的请求、被设置编辑器拒绝的一次写入，都会在下次看门狗时补上。
设备授权是主路径；也可以直接粘贴 vela_ctrl_…。粘贴 sk-amr_… 会被前端拒绝并说明原因。
界面细节
- 额度页：整页滚动，内容居中 960px。两张大卡（5 小时 / 7 天）显示大号百分比、8px 进度条、剩余 / 上限金额与重置倒计时；钱包单独一张卡；页脚是读取时间与
powered by dsh徽标。倒计时每 30 秒走动。 - 设置摘要：状态行 + 两条迷你额度条 + 刷新 / 打开额度页；下面两个开关映射已有配置项：
autoRefresh（每 60 秒自动读）与enabled（读取 + 顶栏显示）。 - 顶栏额度条：28px 高、无外边框、悬停背景，和头部图标按钮同一套尺寸与 token。宽度由宿主标题栏的实际剩余空间决定，四级降级：完整（套餐 + 两条 44px 条）→ 紧凑（无套餐 + 26px 条）→ 极简（状态点 + 最差百分比）→ 隐藏；点击整块打开额度页。
- 配色与明暗：只使用
--dsw-alias-*/--dsw-radius-*/--dsw-focus-ring-*等宿主 token，深色 / 浅色自动跟随。 - 中英双语：界面文案跟随 DSH 的语言设置（设置 → 通用 → 语言）；文案集中在
client.js的COPY表，其他语言回退到英文。
失败时的行为
- 读失败但有过成功读数：保留上一次数字，标记
status: "stale"，页面显示「数据已过期」+ 原因，额度条降低不透明度；不会把「网络抖了一下」显示成「你没登录」。 - 从没有过读数：显示未连接与具体失败原因，不显示 0%。
enabled: false：不轮询，顶栏额度条不渲染，额度页显示停用提示与「启用」按钮。- 请求卡住（连接黑洞住，既不返回也不报错）：每个请求除了
AbortSignal还有一层外部截止时间，一次卡死最多拖住一轮；超过 2 个请求超时仍未返回的读数会被看门狗丢弃重开，后续刷新不会 join 到一个永不 resolve 的 promise。 - 控制面 401：自动发起一次重新登录，但每 5 分钟最多一次，避免把 60 秒轮询变成设备授权生成器。
- 退出登录：清掉凭据后 Host 立刻发布
unconfigured，页面回到登录态、顶栏额度条消失，不会继续展示已失效的旧数字。 - 宿主不再更新读数：超过 3 分钟没有新读数时，页面和设置摘要会提示「宿主可能没有在轮询」，顶栏 tooltip 也会注明。常见原因是运行中改动安装目录/配置让 Host 半被卸载；重启
dsh web恢复。设置写入本身有 8 秒截止时间，一次卡住的写入不会再把轮询永久挂起。
结构
| 文件 | 作用 |
|---|---|
index.js | Host：设备授权、额度读取、轮询、写回配置 |
client.js | Client：额度页（main）、左栏图标（sidebar.panellist）、设置摘要（settings.section）、顶栏额度条（conversation.session.header.utilities） |
cordis.patch.yml | 插入 od-quota 行及其默认配置 |
locale/*.json | 插件管理页的标题与描述 |
icon.svg | 插件图标 |
配置
| 字段 | 默认 | 说明 |
|---|---|---|
enabled | true | 关闭后不轮询、额度条与页面不渲染 |
keyRef | OPENDESIGN_CONTROL_KEY | 控制面 key 的凭据引用名 |
workspaceId | '' | 留空则用 /workspaces/current 自动解析 |
autoRefresh | true | 是否每 60 秒自动读 |
refreshNonce | '' | 页面刷新按钮写入 |
quotaJson / loginJson | '' | 插件写入的缓存，页面只读 |
反馈
- GitHub Issues：https://github.com/WuWei-Peng/dsh-od-quota/issues
- 邮箱：[email protected]
已知限制
- 控制面接口是私有契约，字段变了只会在页面与日志里显示失败原因（日志只记字段名，不记数值），不会编造数字。
- 顶栏额度条的宽度测量依赖宿主标题栏的布局容器（
container-type+ 标题区 / 工具区两个盒子）；宿主结构变化时会退回完整布局，不会崩溃，但可能不如预期紧凑。 - 金额按
creditsPerUsd折算；接口不给汇率时用 10,000 credits = $1；小于 1 美分显示< $0.01。 - 界面文案集中在
client.js的COPY表，中英双语跟随宿主语言；尚未注册到 Client locale 命名空间，第三方语言包不会提供额外翻译（回退英文）。 - 只支持单账号；多账号需要把
keyRef改成列表。 - 设置页页脚内联了官方
dsh-badge.png（121×20，data URI），离线也能显示。
