dsh-provider-quota-rings
sumingwang233/dsh-provider-quota-rings
在会话标题旁为已配置的提供商画订阅额度圆环,内环是短周期,外环是周周期。
安装
dsh plugin --profile web add github:sumingwang233/dsh-provider-quota-ringsREADME
订阅额度圆环
DeepSeek Harness 会话标题旁的订阅额度圆环。标题栏只画环,供应商名称和百分比在悬停卡片里。圆环越满,剩余越多。只显示这台机器上 DSH 已经配置的模型提供商;环里没有数字时画虚线轨道,不会凑成 0% 或 100%。这是独立实现,没有复制 OpenBot 的源码。
这是本机实测过的开发版本,client.js 是手写 JavaScript,仓库里没有上游的 TypeScript 源码。
安装方式是把本目录 npm pack 出来的 tgz 加进某个 DSH profile:package.json 的依赖写 "dsh-provider-quota-rings": "file:<tgz 绝对路径>",同时把包名追加到同一份 package.json 的 dsh.profile.bundles。改完宿主代码不用重启整个应用,用插件管理器把 include:provider-quota-rings 关掉再打开即可重载宿主侧;页面侧刷新在 macOS 上是 open -a "DeepSeek Harness" "dsh-app://app/"。
现在能看到什么
- 每组圆环两层:内环是最短周期(例如 5 小时),外环是最长周期(例如 1 周)。只有一个周期时只画外环。中心是供应商标志。
- 标题栏只列宿主检测到的提供商:宿主用
LlmRuntime.listProviders()看这台机器配了哪些模型路由,再按路由名对到 Codex、Claude、OpenCode Go、GLM、Grok。一个都没配到就不占位置。每个提供商只画一个 24px 的环,不写名字也不写百分比,横向排在会话标题后面。读不到llm服务时退回全部行。 - 没有读到真实额度时显示「未知」和虚线轨道,不会显示成 0% 或 100%。
- Grok 固定显示「暂无法读取」,并给出 Grok 官网。这不是接通。
- 有两个已知模型周期时,圆环只保留最短和最长的两个。鼠标悬停或键盘聚焦会打开用量面板:顶部是供应商标志和名称,每个周期一行「周期名 / 剩余条 / 剩余百分比 / 距重置时长」,例如「每周 ▓▓▓▓ 剩余 86% · 2 天 11 小时」。缺字段写「未知」。面板只读缓存,不重新请求服务商。
- 点击仍打开完整详情。工具月额度单独标成「工具(月额度)」,不拿来当模型周窗口。数量只在响应里真有数字时出现。
- GLM 在详情里切换「智谱」和「Z.AI」。两边的缓存分开。
CREDIT_LIMIT显示为「积分(周期未知)」;percentage原样保留,currentValue、usage、remaining只按原始字段名显示,不推断已用/总量,不按number猜小时或月份,也不进圆环。nextResetTime只用于这一类,并且只接受1e12到8.64e15(JavaScriptDate上界)的有限毫秒值;缺失、字符串、秒数、负数或超过上界时会回退到旧的resetsAt/resetAt/resetTime。旧字段沿用既有有限数字解析:-1、0会按早期纪元格式化,只有非有限数字或无法形成有效日期时才显示未知,不影响其它行。 - GLM 和 OpenCode Go 的密钥可以从详情里的密码框写入本机钥匙串,也可以直接沿用宿主已经存好的那把:本地钥匙串没填时,插件按聊天在用的路由去查宿主凭据服务。先按路由 id 拼出引用名(
opencode-go→OPENCODE_GO_API_KEY)取引用,再试几个常见别名,再找 Models 页写下的llm-pi-ai/<路由 id>记录;前几样都没中时,把宿主已存的引用名按供应商词打分,取最匹配的那个——宿主把apiKeyEnv改成MY_OPENCODE_KEY这种名字也能命中;名字结尾像 OAuth 令牌或密码的跳过。自己填过的优先。OpenCode Go 不再接受普通配置里的明文 token;设置文件只记opencodeKeyStored布尔值。 - 设置里新增「额度圆环」一页:开关实时读取、列出检测到的路由、逐个提供商刷新或停用、切换 GLM 平台、填 GLM 与 OpenCode Go 的密钥。
- 宿主每五分钟在内存里刷新一次。圆环挂载后也会每五分钟对
quotaRings.read做一次静默同步,把缓存画到界面,不闪提示,悬停不打服务商。手动刷新、停用、启用、切换平台和保存 GLM 密钥仍走同一条 remote。 - 卡片挂在页面根节点上,出现在圆环右侧并与其重叠 8px,避免空隙里触发 leave。卡片按视口边缘收住,标题栏把溢出裁掉时也不会被切掉。按钮没有原生
title,避免和卡片叠一层提示。键盘从圆环 Tab 进卡片时保持打开,焦点离开整行和卡片后才关闭。 - 插件可以接一个注入的
powerMonitor,也会订阅宿主若发出的dsh/power。当前安装版 0.2.2-rc.2 的恢复事件只跑策略和更新检查,没有把休眠转给插件,因此短休眠不一定补查。提案在docs/host-wake-proposal.md,没有改宿主。 - 某一家返回 429 时,按它的
Retry-After等待。头缺失或无法解析时,这一家保守等 15 分钟,界面不回显原始头。 - 刷新失败、响应缺
limits或为空时,保留上次成功的数据,并标上时间和原因。实验来源可以单独停用。停用会取消这一家正在进行的请求,圆环不再画旧的有效比例。卸载会清掉定时器和未完成的请求。
默认不读账号
liveReads 默认是 false。这个状态下不会启动 codex app-server,也不会请求 GLM、Claude 实验 SDK 或 OpenCode 用量地址,读凭据也不发生。密钥有两个来源:用户自己填的进本机钥匙串,没填时读宿主凭据服务:先按路由 id 推出的引用名调 ctx.get('credentials').resolve()(读托管库,再读继承的环境变量),再找 llm-pi-ai 作用域里的 api-key 记录(listRecords / readRecord),最后把宿主当前的引用名快照按供应商词打分取最佳匹配。自行拼出的引用名只在路由匹配时才会问,取不到就是没有;值不写盘、不进日志、不进 remote DTO。macOS 助手源码是 native/keychain.swift,编译产物是 bin/quota-keychain。助手用父进程的代码签名身份(SecCodeCopyGuestWithAttributes + SecCodeCheckValidity,标识 com.deepseek.dsh 族、Team NAN929V4UM),不再用路径子串。助手还固定只接受服务 dsh-provider-quota-rings 和账户 glm、opencode,其它条目直接拒绝;每次 get/set/delete 都把操作、账户、结果和进程号写到 stderr 审计。同一用户、同一份已签名 DSH 里的其他插件仍共享这个代码身份,所以这是插件级白名单,不是绝对的插件间隔离。本机编译后只发送 {"op":"ping"} 和一条超长坏请求,没有执行 get、set 或 delete。二进制不存在时,存储返回 keychain-helper-not-built,不会落成明文文件。
Windows 的 DPAPI 脚本在 native/dpapi.ps1,目前还没有和 macOS 助手相同的服务/账户白名单。这台 Mac 上没有运行它。完整边界见 docs/security.md。
OpenCode Go 密钥
OpenCode Go 的 token 有两个来源。自己填的时候:token 不从插件配置读取,也不会写进 settings.json、命令结果、remote DTO 或错误文本;用户在 OpenCode Go 详情里输入后,插件把 token 从客户端经 session-free remote 交给主进程,只写入钥匙串账户 opencode,设置文件只保留 opencodeKeyStored: true。没填的时候:刷新前先看本地钥匙串,没有就问宿主凭据服务,按路由 id 匹配 /opencode/i 的引用名(opencode-go → OPENCODE_GO_API_KEY,聊天在用的就是这条)和 llm-pi-ai 记录,宿主改过名字的引用靠供应商词打分兜底。两条路都只取字符串,用于 Authorization: Bearer,请求仍固定 https://opencode.ai/zen/go/v1/usage、redirect: 'error',发送前拒绝 CR/LF。凭据服务不可读、引用未设置、记录不是 api-key 或值为空时按「没有密钥」处理,不报错也不回显。测试使用内存 secret runner、假凭据服务和虚构 token。
Claude SDK 依赖
Claude 适配器不新增运行时依赖。要走真实实验接口,最小依赖是 @anthropic-ai/claude-agent-sdk@0.3.309(与 OpenBot 0.61.0 package.json:421 一致),安装命令是 npm install @anthropic-ai/claude-agent-sdk@0.3.309。本轮没有执行安装,也没有启动真实账号。也可以继续注入 queryFactory,测试就是这样做。
宿主限制
侧栏读取和手动操作调用 ctx.remote.$mount 挂上的 quotaRings。方法不接收会话。宿主网关在没有生成器登记时,会按服务上的 SRC 标记分发;这条路径不经过 commands.execute,因此不会写 command/done。/quota-rings 命令还在,给手动调用留着;它的 recordInput: false 仍然删不掉 settle() 写入的结果。参考树是 0.2.0-rc.2。当前安装版是 0.2.2-rc.2(app.asar SHA256 1535941c163698d68a0cf45dd06e1ce1a18a308108d9b84076074f35a6e9c39d)。自挂契约没有在这个安装版上跑过。旧 0.2.1-rc.5 字节不能证明当前网关。
- 五分钟自动刷新仍在宿主内存里;侧栏另有五分钟静默
read。都不走命令,也不在悬停时打服务商接口。 - 没有会话也可以读缓存。不使用会话列表的第一个 id。
- 生成器
@deepseek-ai/dsh-typert-generator@0.2.0-rc.2没有安装。描述符按参考树InvocationDescriptor手写,codec.mode为strict。 - 系统休眠仍没有转发到插件。提案在
docs/host-wake-proposal.md,没有改宿主。 - GLM 密钥只用详情里的密码框提交。不要把它打进对话。remote 的返回值不带密钥。
- Claude / OpenCode Go 有独立的实验适配器,默认
liveReads=false不会发请求。没有把占位标成接通。未复制 OpenBot 的 PolyForm-Noncommercial 代码。Claude 适配器的最小依赖是@anthropic-ai/claude-agent-sdk@0.3.309;没有安装,详见docs/sources.md。Windows Codex 只在LOCALAPPDATA、APPDATA、ProgramFiles、USERPROFILE的固定位置找codex.exe/codex.cmd,不会从PATH扫描入口。.exe直接启动;.cmd/.bat是 npm shim,不能当 PE 执行,改用系统固定路径的cmd.exe /d /s /v:off /c,并把入口、固定app-server参数和 Node 目录做安全引用,PATH 只加入已存在的固定 Node 位置。Windows 原生还没有实机验证。
本地检查
node --test tests/*.test.mjs
不安装依赖。测试不读取本机钥匙串,也不访问四家账号。