dsh-codex-auth
DeepSeek Harness 客户端插件：在设置面板中管理 Codex 订阅（ChatGPT OAuth）授权，无需 API key 使用 Codex 订阅内的 GPT 模型。
功能
- 设置页「Codex 订阅」：授权状态徽章（已授权 / 已过期 / 未授权）、有效期倒计时、账号邮箱、订阅类型（Plus/Pro）
- 一键授权：点击后宿主进程运行完整 OpenAI OAuth 浏览器流程（PKCE S256，
localhost:1455回调，与 Codex CLI 同端口），成功后把 grant 凭证写入~/.dsh/.credentials.yaml的llm-pi-ai/openai-codex记录 —— 与 dsh-llm-pi-ai 读写的是同一条记录，模型目录即时刷新 - 过期自动弹窗：当前会话选中的模型路由到
openai-codex且凭证过期时，弹出重新授权对话框（可稍后，10 分钟内不再打扰）
架构
双面插件（模板来自 dsh-balance-panel）：
- 宿主面
lib/index.js：loopback RPC 通道/dsh-codex-auth（status / login / logout），OAuth 常量与@earendil-works/pi-ai的 openai-codex 适配器一致 - 客户端面
lib/client.js：settings.section（idcodex-subscription，order 25）+shell.overlay过期弹窗；通过ctx.connection.rpc.call与宿主通信；订阅credentials/record-updated事件实时刷新状态
凭证记录由 llm-pi-ai 的自动 refresh 机制维护（access token 约 10 天过期，refresh 自动续期）；refresh 也失效时本插件的弹窗接管。
构建 / 安装
npm run build # src/*.ts -> lib/*.js
cd ~/.dsh/profiles/desktop
# package.json: dependencies += "dsh-codex-auth": "file:/Users/sunshaobei/.dsh/dsh-codex-auth"
# dsh.profile.bundles += "dsh-codex-auth"
npm install # 以 symlink 方式安装本地插件
# 重启 DeepSeek Harness 客户端生效
文件
src/index.ts— 宿主：OAuth 流程 + RPCsrc/client.ts— 设置页 + 弹窗src/vendor/— vendored schemastery/cosmokit（link 安装时解析不到内部包）cordis.patch.yml— profile 层 insert 配置
授权状态与验证
登录请求立即返回，授权期间面板每秒查询进度，窗口重新获得焦点时立即刷新。回调只有在 token 交换、凭证保存和读取校验成功后才显示成功，并尝试打开 dsh://open；浏览器拦截自动唤起时可点击返回按钮。交换请求设有 30 秒超时，授权等待为 5 分钟，失败原因同时显示在回调页和订阅面板。
运行 npm test 验证回调状态校验、保存成功、磁盘写入失败、token 交换失败、拒绝授权、重复登录和端口占用。测试使用模拟 OAuth 服务，不读取个人凭证。构建后重启 DeepSeek Harness 加载新的宿主插件。
授权有效时，插件通过宿主 settings.mutate 自动提交 openai-codex 提供商，使用宿主内置目录并验证模型数量。已有提供商配置会保留，配置写入或目录加载失败会显示在订阅面板；不会切换当前默认模型。当前设置导航不提供自定义图标接口，因此插件仅对自身导航按钮添加 ChatGPT 图标样式，并在卸载时清理。图标来自 Simple Icons v14 的 OpenAI 标志（CC0）。
