前言¶
用 DeepSeek Harness（DSH）对接 Open Design 模型时，套餐额度分 5 小时与 7 天两个滚动窗口，本会话又会有输入、输出与缓存相关的 token 统计。这些信息分散在 Open Design 控制台或宿主内部投影里，编码过程中要反复切页面核对，容易打断节奏。下面介绍社区维护的客户端 bundle 插件 dsh-opendesign-usage：在 Composer 输入框工具行提供只读读数，并在展开面板里查看钱包与会话 token 明细；仅在当前会话选中 opendesign 模型时显示，避免占用其他 provider 的工具行。
这是什么¶
dsh-opendesign-usage 是独立的 DeepSeek Harness bundle 插件，由 BlanCatOra 维护，在 SkillHub 目录中归类为客户端。它在输入框左下角工具行增加只读读数，展示 Open Design 套餐两个窗口的剩余百分比；钱包余额与本会话 token 用量放在点开后的面板中，不挤占常驻读数。读数只在会话选中 opendesign 模型时出现，切换到其他 provider 时控件不渲染、不占位。插件版本 0.2.0，许可证 MIT；与 Open Design（AMR）官方无隶属关系，属非官方第三方插件。
常驻读数示例（工具行宽度有限，只保留两个额度百分比）：
OD · 90% · 97%
│ └────── 7 天窗口剩余额度
└───────────── 5 小时窗口剩余额度
核心功能¶
套餐额度¶
插件通过宿主侧路由读取 Open Design 控制台的 coding-plan-usage 接口，在工具行显示 5 小时与 7 天两个滚动窗口的剩余额度百分比。点开面板可查看每个窗口的剩余比例、credits 分子分母，以及重置倒计时；倒计时使用上游返回的服务端相对值 resetsInMs，不依赖本地时钟与 resetsAt 相减。某个窗口取不到数据时显示 —，两个位置固定，避免误读。
钱包余额¶
套餐用尽后的兜底余额（订阅额度 + 充值额度）在面板明细中展示。钱包跟随「套餐额度」相关开关：没有套餐语境时单独显示美元数容易造成误解，因此与套餐额度一并控制，且两者都需要凭据。
本会话 token 用量¶
读取宿主的 tokenUsage 投影，在面板中给出合计与分项（输入、输出、缓存读、缓存写）。该部分纯读宿主数据，不需要 Open Design 凭据。
插件详情页开关¶
所有能力可在插件详情页单独开关，改完后点保存生效；「测试连接」可在不保存的情况下用草稿凭据试一次。
| 开关 | 默认 | 作用 |
|---|---|---|
enableComposerUsage |
开 | 是否在输入框显示读数控件 |
enablePlanQuota |
开 | 是否显示套餐额度与钱包余额（需凭据） |
enableTokenUsage |
开 | 是否显示会话 token 用量 |
关闭 enableComposerUsage 后控件不注册、不发请求。关闭 enablePlanQuota 后宿主不会向上游刷套餐接口，不会出现「关了仍在后台请求」的情况。
安装与启用¶
前置条件¶
- DSH 版本 ≥ 0.2.0（README 写明在 0.2.1-rc.2 上开发与验证；
package.json中engines.dsh为>=0.2.0-0）； - Node：^22.19.0 || >=24.0.0；
- 平台：DSH Web GUI（
web）； - 需要查看套餐额度时，需有 Open Design 账号（可免费注册）。
通过插件管理器安装¶
DSH 自带插件管理器，在 GUI 中操作：
- 侧栏点 插件；
- 点 添加插件（或箭头 → 安装第三方插件）；
- 填入下表对应的一行并回车：
| 安装方式 | 填什么 |
|---|---|
| npm（推荐，等发布后可用） | dsh-opendesign-usage |
| Git 仓库 | https://github.com/BlanCatOra/dsh-opendesign-usage |
| 本地目录 | /绝对路径/to/dsh-opendesign-usage |
管理器会通过 pnpm 将包装入当前 profile，并提示「立即启用」。
手动安装（不用 GUI）¶
若不走插件管理器，可在 profile 目录执行：
cd ~/.dsh/profiles/<profile>
pnpm add /绝对路径/to/dsh-opendesign-usage
随后在 ~/.dsh/profiles/<profile>/package.json 的 dsh.profile.bundles 末尾追加 "dsh-opendesign-usage"，然后重启 DSH。
启用与可见条件¶
安装后重启 DSH（新增 bundle 需重新组装 profile）。在会话里将模型切换到任一 opendesign 模型，输入框左下角会出现读数。若未出现，先确认当前会话是否选中了 opendesign provider；其他 provider 下读数不显示是预期行为。
配置凭据与刷新¶
配置入口在插件详情页，不在 DSH 总「设置」页：侧栏 插件 → Open Design Usage → 在插件自己的页面修改并保存。
需要套餐额度或钱包时，需配置 workspaceId 与 sessionCookie；刷新间隔默认 5 分钟，允许 1–60 分钟，且仅在读数可见且套餐开关打开时才会请求上游。
获取 workspaceId¶
登录 Open Design 控制台，从地址栏复制 workspaceId 参数：
https://open-design.ai/cloud/dashboard?workspaceId=<你的 workspaceId>
获取 sessionCookie¶
- 浏览器登录 Open Design 控制台；
F12→ Network → 刷新页面；- 筛选
coding-plan-usage； - 打开该请求 → Request Headers → 找到
Cookie； - 复制
__Secure-better-auth.session_token=之后到分号前的值。
也可整段粘贴 Cookie 头，插件会提取对应 token。该字段为登录凭据，存在 DSH 本地设置中，仅用于向 amr-api.open-design.ai 读取本人额度；界面不回显明文。会话过期后读数可能变为 —，需重新获取。若机器非单人使用，可关闭 enablePlanQuota，仅保留无需凭据的 token 用量。
工作原理简述¶
浏览器中的读数组件请求宿主同源路由 GET /plugins/dsh-opendesign-usage/plan-usage，由宿主携带 cookie 访问上游并归一化后返回，凭据不进入页面上下文。相关路由仅接受本机 loopback 或 DSH 协议来源。额度与钱包对应两个独立上游接口，任一失败不会清空另一项已在面板中的数据。
适用场景与注意¶
适合经常在 DSH 里使用 Open Design 模型、希望在 Composer 内快速扫一眼 5 小时 / 7 天额度、并在同一会话里对照 token 分项的开发者。
安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。DSH 插件以当前 DSH 进程权限运行；配置会话 token 等同于控制台登录态，请仅在信任的环境中启用套餐相关功能。社区目录 SkillHub 插件页 与 DeepSeek、幻方无官方从属关系，安装来源以页面与仓库说明为准。
结尾¶
dsh-opendesign-usage 把 Open Design 双窗口额度读数放进输入框工具行，并把钱包与会话 token 收进同一面板，且按 opendesign 模型选中有条件显示。需要安装步骤与配置细节时，可参考 SkillHub 目录页 与 GitHub README。
