DSH | dsh-llm-oauth | 原生模型设置页看周额度 & 用 Codex 重置卡（非官方）

[TungLamC]

声明：本项目为社区非官方开源插件（Unofficial），基于 DSH 官方新版内置能力构建，不隶属于 DeepSeek 官方。

社区里其实已经有好几个支持订阅的插件了（很多做了独立路由或者多账号池，非常强大）。

不过我写这个插件的初衷比较轻量：现在的 dsh（0.1.2-rc.1 起）底层其实已经自带了 pi-ai 的 OAuth 流程。我不太想为了用自己的账号再去挂一套第三方的模型路由或独立的订阅面板，就想直接在原生的「设置 → 模型」里点登录，顺便能一眼看到还剩多少周额度，以及在卡片里直接把 Codex 的重置卡给用了。

代码仓库：https://github.com/TungLamC/dsh-plugins/tree/main/dsh-llm-oauth

---

它能做什么

1. 原生设置页一键登录，不劫持请求
直接嵌入 dsh 原生的「设置 → 模型」卡片。走的是 dsh 现成的授权与凭据服务，退出登录也只清理本地凭据。它不引入新模型 ID，也不改你的 LLM 转发链路，纯粹给官方 provider 补齐界面与额度操作。

2. 订阅额度 & 重置倒计时（目前仅限 Codex / Grok）
卡片上会直接展示当前套餐、主额度剩余比例以及重置时间，不用为了看用量特地跑去官网或切 CLI：

• Codex：主额度剩余、Code Review 等额外额度、积分余额。
• Grok：周额度（或旧版月额度）、额外购买余额与按量消耗。
• 打开额度卡片时会自动轮询刷新（默认 60 秒，在页面底部的设置里可以自定义）。

关于额度支持范围说明：
目前订阅详情与周额度查询 仅支持 Codex 和 Grok，我手头目前只有这两家的订阅，测不了其他的……如果大家有其他 provider 的额度查询需求，非常欢迎提 PR 一起加进来！

3. Codex 重置卡使用
用 Codex 最常遇到的就是额度见底。展开卡片后，如果有可用的重置卡，会列出到期时间，直接点「重置」并二次确认就能直接使用，不需要再退回到网页端去点。

---

安装与使用

需要 dsh 0.1.2-rc.1 或更高版本（Node 22.19+ 或 24+，环境里有 pnpm）：

dsh plugin --profile web add 'github:TungLamC/dsh-plugins#path:/dsh-llm-oauth'

装完后重启你的 web 进程（dsh --profile web），刷新浏览器页面即可。

几个小提示：

1. 没看到登录按钮？：如果某个服务商你之前填过 API Key，dsh 默认会优先走 Key，所以不会显示登录入口。把 API Key 删掉就会露出 OAuth 登录按钮（原本保存的 OAuth 登录态不会丢）。
2. 重置卡确认：点击重置卡确认后会真正在服务端消耗掉卡片，用之前看清楚到期时间和次数，避免手滑误消耗。

如果使用遇到问题，或者想帮忙适配其他支持 OAuth 的 provider，欢迎在下面留言或者直接提 PR～

[argszero]

赞这个定位——"不劫持请求、纯补官方 provider 的界面与额度操作"确实是订阅生态里少有人做的层：别的插件大多自建路由/账号池，你是直接长在原生「设置 → 模型」里，跟 dsh 的授权/凭据服务走同一条路。这个"嵌入原生卡片"的形态对插件作者是个好示范（UI 插件不一定要另起面板，ui-settings-* 的 slot 就是给这个用的）。

几个可能有用的交叉参考：

• kestrel: Stop asking the model that hallucinates to verify its own hallucinations #5830（grloper 的 dsh-claude-oauth：用 Claude Pro/Max 订阅当 provider）和 希望支持火山引擎的 coding plan 和 agent plan #5841（刚有人问火山引擎的订阅制套餐能不能用）跟你做的是同一轴——"订阅/账号形态的模型怎么进 dsh"。你现在只覆盖 Codex/Grok 的额度展示，如果后续把"订阅 → provider 路由"也做了，跟这两帖能互相印证。
• 重置卡消耗的确认交互做得对：卡片在服务端真实消耗，二次确认 + 到期时间展示是必要的。提醒一点——如果以后加"自动在额度见底时用卡"，记得做成 opt-in，别在 agent 正在跑长任务时静默消耗（这跟 approval 语义相关，社区在 Deterministic approval backend ownership before the approval/request waterfall #5236 讨论过决定权归属）。
• 版本门槛写的是 0.1.2-rc.1+，实际吃的是 rc.1 起的 pi-ai OAuth 流程——建议 README 里注明对应哪次 commit/功能落地，方便别人判断自己的 build 是否包含。

欢迎把这类插件形态的帖子发出来——现在 Discussions 里订阅/额度相关的需求在变多（#5830/#5841/#5845），你的实现是第一个把"原生设置页内看额度"落地的，社区会需要它。