OpenDesign 额度 WuWei-Peng/dsh-od-quota

dsh-od-quota

非官方插件：与 Open Design / Powerformer 无隶属关系，只按公开接口读取你自己账号的额度。

在 DSH 里查看 OpenDesign 订阅额度：设置页完成浏览器登录，展示 5 小时 / 7 天窗口与钱包；会话标题栏右侧（「打开应用」箭头左边）常驻套餐标识和两条剩余额度进度条（绿 = 充足，黄 = 注意，红 = 快用完）。

它读什么

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 同一套流程）签发——插件就是替你跑这套流程的。

安装

直接装仓库（无需发版）
dsh plugin --profile web add github:WuWei-Peng/dsh-od-quota

或装 GitHub Release 上的预构建包（更快，不需要构建环境）
dsh plugin --profile web add https://github.com/WuWei-Peng/dsh-od-quota/releases/latest/download/dsh-od-quota.tgz

装完重启一次 dsh web，设置侧栏出现「OpenDesign 额度」。

工作方式

1. 进入设置页时若没有 key，插件调用 POST /api/v1/cli/device-authorizations 生成批准链接与 6 位码；页面显示码、倒计时和可复制的链接。
2. 你在浏览器登录 OpenDesign 并批准，插件轮询到 controlKey，写进 DSH 凭据服务（引用名默认 OPENDESIGN_CONTROL_KEY，可改 keyRef）。
3. 之后每 60 秒读一次 billing/preflight + billing/summary，把结果写回本插件配置的 quotaJson；页面和标题栏都只解析这一份文档。
4. 手动刷新写 refreshNonce（时间戳 + 递增序号，连点两次也不会重样），宿主观测到变化立即重读；写入被拒绝时页面会明说并让你重试，而不是「点了没反应」。
5. 一个 15 秒的看门狗按墙钟核对上次读取时间：漏掉的 tick、卡住不返回的请求、被设置编辑器拒绝的一次写入，都会在下次看门狗时补上。

设备授权是主路径；也可以直接粘贴 vela_ctrl_…。粘贴 sk-amr_… 会被前端拒绝并说明原因。

失败时的行为

- 读失败但有过成功读数：保留上一次数字，标记 status: "stale"，页面显示「数据已过期」+ 原因，胶囊降低不透明度；不会把「网络抖了一下」显示成「你没登录」。
- 从没有过读数：显示未连接与具体失败原因，不显示 0%。
- enabled: false：不轮询，标题栏胶囊不渲染。
- 请求卡住（连接黑洞住，既不返回也不报错）：每个请求除了 AbortSignal 还有一层外部截止时间，一次卡死最多拖住一轮；超过 2 个请求超时仍未返回的读数会被看门狗丢弃重开，后续刷新不会 join 到一个永不 resolve 的 promise。
- 控制面 401：自动发起一次重新登录，但每 5 分钟最多一次，避免把 60 秒轮询变成设备授权生成器。
- 退出登录：清掉凭据后 Host 立刻发布 unconfigured，页面回到登录态、顶栏额度条消失，不会继续展示已失效的旧数字。

结构

| 文件 | 作用 |
| index.js | Host：设备授权、额度读取、轮询、写回配置 |
| client.js | Client：设置页（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 | '' | 插件写入的缓存，页面只读 |

已知限制

- 控制面接口是私有契约，字段变了只会在页面与日志里显示失败原因（日志只记字段名，不记数值），不会编造数字。
- 顶栏显示套餐标识（Go / Plus / Pro / Max）+ 两条 96×6 进度条，按剩余百分比着色：>50% 绿、20–50% 黄、≤20% 红；数据过期整块降不透明度，退出登录后整块消失。
- 金额按 creditsPerUsd 折算；接口不给汇率时用 10,000 credits = $1；小于 1 美分显示 < $0.01。
- 界面文案暂为中文硬编码（接入 client locale 服务是后续项）。
- 只支持单账号；多账号需要把 keyRef 改成列表。
- 设置页页脚内联了官方 dsh-badge.png（121×20，data URI），离线也能显示。