前言¶
用 DeepSeek Harness（DSH）做智能体或会话开发时，若后端走 OpenDesign 订阅，额度通常落在控制面：5 小时窗口、7 天窗口、钱包余额等。推理用的 sk-amr_… 密钥无法查询这些额度；控制面 vela_ctrl_… 也不会出现在网页上，需要走与 vela login 类似的 CLI 设备授权。若只在 OpenDesign 控制台或 CLI 里零散查看，和 DSH Web 里的开发节奏容易脱节。
下面介绍社区插件 dsh-od-quota（维护者 WuWei-Peng，GitHub WuWei-Peng/dsh-od-quota）。它是非官方插件，与 Open Design / Powerformer 无隶属关系，仅通过公开控制面接口读取你自己账号的 allowance，并在 DSH Web 客户端提供侧边栏页面、设置摘要和会话顶栏进度条，三处 UI 共用同一份读数。
这是什么¶
dsh-od-quota 是 DSH 的 Web 客户端插件（分类：客户端）。npm 包名 dsh-od-quota，当前资料中版本 0.1.5，许可证 MIT。插件从 OpenDesign 控制面（主机 amr-api.open-design.ai，密钥前缀 vela_ctrl_…）读取 plan、钱包、5h/7d 窗口等信息；模型面 amr-link.open-design.ai/v1 的 sk-amr_… 不能读额度，UI 也会拒绝粘贴该类密钥。
核心功能¶
三处界面解析同一份 Host 写入的 quotaJson：
| 入口 | 位置 | 作用 |
|---|---|---|
| 额度页 | 左侧栏「OpenDesign Quota」图标 → 居中全页 | 5 小时 / 7 天窗口、钱包、登录与授权 |
| 设置摘要 | 设置侧栏「OpenDesign Quota」 | 状态、两条迷你进度条、刷新 / 打开页面、自动刷新与顶栏开关 |
| 顶栏计量 | 会话标题栏右侧（「在应用中打开」箭头左侧） | 套餐名 + 两条剩余条；空间不足时逐级收缩；点击打开额度页 |
进度条按剩余百分比着色（绿 / 琥珀 / 红）；数据过期时会变暗，tooltip 说明原因。额度页为全高滚动、内容宽约 960px，两张大卡展示 5h/7d 百分比、8px 条、剩余/上限金额与重置倒计时，钱包单独一张卡；页脚显示读取时间与 powered by dsh 标识。顶栏计量高度 28px，随标题行可用宽度在 full → compact → mini → hidden 间切换。文案随 DSH 语言设置（设置 → 通用 → Language）切换，中英 copy 在 client.js 的 COPY 表中。
Host 侧（index.js）负责设备授权、调用 billing/preflight 与 billing/summary、默认每 60 秒轮询一次，并写回配置；手动刷新通过写入 refreshNonce 触发立即读取。
安装与启用¶
安装后需 重启一次 dsh web，左侧栏会出现 OpenDesign Quota 图标，设置里会出现对应摘要项。
资料中的安装方式如下（均需 --profile web）：
# 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
package.json 要求 Node ^22.19.0 || >=24.0.0，DSH >=0.2.0-rc.1。
典型用法¶
首次连接（设备授权）¶
- 打开额度页或设置摘要且尚未配置密钥时，插件请求
POST /api/v1/cli/device-authorizations，页面展示 6 位码、倒计时和可复制的批准链接。 - 在浏览器登录 OpenDesign 并批准；插件轮询得到
controlKey，默认存入 DSH 凭证服务，引用名OPENDESIGN_CONTROL_KEY（可用配置项keyRef修改）。 - 之后约每 60 秒读取一次并更新
quotaJson；三处 UI 只读该字段。
也可在 UI 中直接粘贴 vela_ctrl_…；粘贴 sk-amr_… 会被拒绝并说明原因。
设置与刷新¶
在设置摘要中可开关 autoRefresh（60 秒读一次）和 enabled（关闭则停止轮询、隐藏顶栏、额度页显示禁用说明）。点击刷新会写入 refreshNonce；若 Host 拒绝写入，会提示重试而非无响应按钮。
配置项（节选）¶
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
关闭：不轮询、无顶栏、页面不可用 |
keyRef |
OPENDESIGN_CONTROL_KEY |
存放控制面密钥的凭证引用 |
workspaceId |
'' |
空则通过 /workspaces/current 解析 |
autoRefresh |
true |
每 60 秒读取 |
refreshNonce |
'' |
由页面刷新按钮写入 |
quotaJson / loginJson |
'' |
插件写入的缓存，页面只读 |
适用场景与注意¶
适合谁：在 DSH Web 中长期使用 OpenDesign 订阅、需要随时看 5h/7d 与钱包、又不想单独开控制台或反复跑 CLI 的开发者。
运行与信任：插件以当前 dsh 进程权限 运行，会访问控制面 API 并将密钥存入 DSH 凭证服务。安装前请自行查看 仓库源码 与 MIT 许可证；社区目录 skillhub.cn 条目 与 DeepSeek / 幻方无官方从属，DSH 生态是「一切皆插件」的独立社区形态。
失败与限制（资料原文要点）：
- 曾有成功读数时网络失败：保留上次数字并标
stale，不会误报「已登出」。 - 从未成功：显示未连接及具体错误，而非 0%。
- 控制面 401：最多每 5 分钟自动重登一次，避免轮询变成授权风暴。
- 控制面 API 为私有契约，字段变更时页面与日志会反映失败（日志记字段名不记值），插件不伪造数字。
- 若 Host 超过 3 分钟无新读数，页面与设置会提示 Host 可能未在轮询；常见原因是运行中改动了安装目录或配置导致 Host 半卸载，需重启
dsh web。
问题反馈： GitHub Issues，或邮件 18728030920@163.com。
结尾¶
经过上面的步骤，你可以在 DSH 会话开发同一界面里看到 OpenDesign 订阅额度与顶栏余量，减少在控制台与 Harness 之间切换。更多信息见目录页 skillhub.cn/plugins/WuWei-Peng/dsh-od-quota 与 GitHub WuWei-Peng/dsh-od-quota。
