配额胶囊 deepwerkspace/dws-quota

dws-quota

一个小巧的 DSH 插件，在 Web 客户端输入框下方的 dock 里显示 Deepwerkspace 预估剩余 token 数，就挨着上下文计量器（那个显示 % of context used 的圆环）。

Deepwerkspace 配额接口返回的是剩余输出 token 上限。由于未缓存的输入 token 按 1/10 计入输出 token，输入输出大致五五开时，一个输出 token 大约能「换到」5.5 个总 token（1 个输出 + 10 个输入）。所以预估剩余总 token 预算就是 5.5 × remaining_tokens。如果实际流量比五五开更偏输入，这个估算偏保守（偏低）——方向是安全的。

输出配额为 1,995,521 token 时，胶囊显示类似 ≈ 11M est.（5.5 × 1,995,521 = 10,975,366 ≈ 11M）。悬停可看原始输出 token 数。

胶囊里还带一个始终可见的 Topup 链接（首次轮询成功之前、或配额读不出来时也可见），点击会在新标签页打开 Deepwerkspace 充值页。它指向一个稳定、通用的跳转地址（https://deepwerkspace.com/products/get-more-tokens），这样真实产品 URL 变了也不用更新插件。

文件

| 文件 | 作用 |
| package.json | 包清单 + dsh.bundle（可被管理器安装）+ dsh.client 声明（浏览器半边需显式启用）。 |
| cordis.patch.yml | 该 bundle 自带的补丁层——选中 bundle 时插件管理器加载的内容。 |
| index.js | 宿主半边。 从凭据存储读取密钥，查询配额 API，提供 GET /dws-quota。 |
| client.js | 浏览器半边。 懒加载 CJS bundle；在 conversation.composer.dock 里渲染单个胶囊（预算文本 + 始终可见的 "Topup" 链接）。 |
| .test-harness.js | 宿主半边的模拟测试（运行 node .test-harness.js）。 |
| .test-client.js | 客户端 bundle 的模拟测试（运行 node .test-client.js）。 |

设计 / 安全

- 密钥绝不进入浏览器。 宿主从凭据存储读取密钥并完成 API 调用；只有算好的 JSON（remaining_tokens、estimated）会通过网络传给客户端。
- 无硬依赖。 宿主半边通过 ctx.get()（而非 inject）读取每个服务，所以缺少 webServer / connection / credentials 时，插件会退化为空操作，而不是让 fiber 激活失败。这正是它不会像写错的 inject 列表那样搞坏启动的关键原因。
- 可逆挂载。 它以 bundle 形式挂载：插件管理器把包加进配置档的 dsh.profile.bundles，并加载包自带的 cordis.patch.yml 层。移除 bundle（和包）即可完全还原——bundle 的 cordis.yml 从不被改动。
- 鉴权围栏。 挂载了 connection 服务时，路由在响应前会先执行 connection.requestRejection()（Host/Origin + 浏览器会话检查）。在仅回环的 dsh web 上，这属于双保险。
- 缓存。 宿主把配额缓存 30s，这样客户端一阵轮询也不要猛刷配额 API。客户端每 60s 重新轮询一次。

安装（任意 DSH 实例）

前置条件 —— 把密钥放进凭据存储

把 Deepwerkspace 密钥追加到 ~/.dsh/.credentials.yaml 的 refs: 块（本地凭据服务商会读这个文件）：

version: 1
refs:
...your existing refs...
DEEPWERKSPACE_API_KEY: dws-tRVAvvmTtQVlbw1OkKeayyMmAbml5dTT

ref 名必须严格写成 DEEPWERKSPACE_API_KEY（插件解析的就是这个名字）。值就是 bearer token。如果你改用 Models 设置页添加密钥，就把自定义服务商的路由 id 命名为 deepwerkspace（全小写，不带分隔符）—— 界面会自动把密钥存到 DEEPWERKSPACE_API_KEY 下。

一条命令安装

这个包声明了 dsh.bundle，所以 DSH 插件管理器能端到端装好它 —— 它会在配置档目录里跑 pnpm add，选中这个 bundle（追加到 dsh.profile.bundles），加载本包的 cordis.patch.yml 层，并在 patchReload: live 配置档上通过 HMR 实时生效：

dsh plugin --profile web add dws-quota

（把 web 换成你实际运行的配置档。只要配置档挂载了 webServer、credentials 和 web 客户端，插件就能用 —— 也就是 web 配置档。）

同样的操作也能在 GUI 侧边栏的 Plugins 页面和 plugin_manager 智能体工具（Creator 模式）里完成。如果包不在默认 npm registry 上，就传 tarball URL 或绝对路径，别传 registry 名。

手动兜底（没有插件管理器）

如果你非得手动挂载：把 dws-quota/ 目录放进配置档的 node_modules（cp -r 或 ln -s），然后往配置档的 cordis.patch.yml 追加：

- insert:
- name: 'dws-quota'

注册就这些 —— 不用 inject（插件没有硬依赖），也不用 config。然后重启 dsh web（或者等 HMR 自动接上）。

打开 GUI，启动会话，看 composer dock（输入卡片底部，紧挨上下文环）里的 ≈ 11M est. 药丸。

验证

The Host route (loopback; needs the browser session cookie in a real browser,
but on a bare loopback dsh web the connection fence is the only gate):
curl -s http://127.0.0.1:<port>/dws-quota
-> {"remaining_tokens":1995521,"estimated":10975366}

错误形态（都是 5xx/4xx，绝不会崩溃）：
- {"error":"missing-credential","ref":"DEEPWERKSPACE_API_KEY"} —— 第 1 步没做。
- {"error":"no-credentials-provider"} —— 这个配置档里没有 credentials 服务。
- {"error":"quota-http","status":403} —— API 拒绝了密钥。
- {"error":"quota-failed","detail":"..."} —— 网络或解析失败。

卸载

插件管理器：dsh plugin --profile web remove dws-quota（或者 Plugins 页面 / plugin_manager 工具）—— 它会取消选中 bundle、卸载它的贡献，并跑 pnpm remove。手动挂载：删掉 insert 块从 cordis.patch.yml 里删掉 node_modules/dws-quota 这一项。可选：删掉 DEEPWERKSPACE_API_KEY 引用。重启。不留任何痕迹——插件不会在 bundle cordis.yml 里注册任何东西。

故障排查

- 胶囊始终不出现。 先检查 curl /dws-quota。如果返回 missing-credential，说明第 1 步里的 ref 名称或值写错了。如果路由返回 404，说明插件没加载——确认第 2 步（node_modules）和第 3 步（patch 项），并确认配置档已重启。
- 加上它之后 GUI 启动失败（之前某次尝试的失败模式）：最常见的原因是 client bundle 格式不对（不是懒加载 CJS 的 window.__ModuleLoader__.load({ id, factory }) 形状），或者 dsh.client 声明引用了不在客户端依赖图里的包。这个 bundle 已对照随包发布的 ui-theme bundle 形状验证过，而 dsh.client.inject 这条边（@deepseek-ai/dsh-client-ui-conversation）属于核心 web 客户端包。如果启动失败，删掉 insert 项并重启即可恢复，然后把 client.js 和这个文件做 diff。
- /dws-quota 返回 401。 连接围栏拒绝了请求（Host/Origin 或浏览器会话不匹配）。在真实浏览器里这由会话 cookie 处理；不带 cookie 的裸 curl 会返回 401，这是预期行为。