dsh-codex-login-dock
已验证@suqingsq/dsh-codex-login-dock · v0.2.0 · MIT · Web 界面
Session login card, Settings page, and Host auth status for Codex subscription in DeepSeek Harness.
安装
dsh plugin add @suqingsq/dsh-codex-login-dock 用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。
源码
发布到 npm 但没有公开仓库。安装前请检查包内容。
标签
说明文档
dsh-codex-login-dock
English | 中文
DeepSeek Harness 的 Codex 订阅会话登录卡、设置页与 Host 认证状态。本包不注册 LLM adapter，也不实现 PKCE、refresh 或第二套凭据存储。
当原生模型选择器选中 openai-codex（展示名「Codex 订阅」）且凭据未就绪时，composer 上方出现登录卡。设置里也有独立的「Codex 订阅」页，登录成功后仍显示已连接。主路径是 dsh-openai-codex-oauth 的 silent 浏览器 PKCE。登录成功后会话卡片消失，后续对话仍走原生 DSH。
Host 与 Web client API 对齐 @deepseek-ai/[email protected]。fixture 测试覆盖状态、silent 登录、退出登录、取消、端口占用映射、脱敏、dock 显隐、composer block 和设置页。这不是真实 DSH Web / Headless E2E。
依赖
同一 profile 需要安装本仓库的 dsh-openai-codex-oauth。本包运行时查找 ctx.openaiCodexOAuth。该 silent 面不存在时状态为 missingPlugin，不会自行启动浏览器登录。退出登录调用同一面上的 logout()。
完整 OAuth JSON 使用 OPENAI_CODEX_OAUTH_CREDENTIAL，当前 access token 使用 OPENAI_CODEX_ACCESS_TOKEN。默认文件是 $DSH_HOME/.credentials.yaml。本包不写 ~/.codex。
Web
登录卡挂在 conversation.input.dock。不占用 conversation.input.model，也不自绘模型选择器。
| 状态 | 卡片 | 输入区 |
|---|---|---|
| 未登录 | 标题「Codex 订阅需要登录」；主按钮「打开浏览器登录」；次按钮「稍后」 | 发送被 block；模型座位仍可点 |
| 登录中 | 标题「正在等待浏览器授权」；主按钮「取消」 | 发送保持 block |
| 过期 / 异常 | 标题「登录已过期」或「Codex 订阅登录失败」；主按钮「重新登录」 | 发送保持 block；错误码可见 |
| 缺少 OAuth 插件 | 标题「未安装 OAuth 插件」；没有登录按钮 | 发送保持 block |
| 已连接，或其他 Provider | 不渲染卡片 | 本包不 block 发送 |
「稍后」会收起卡片并保持发送 block。切走 openai-codex 后卡片消失，block 解除。
设置页注册独立的 settings.section，导航名是「Codex 订阅」，不嵌进原生模型那一行。已连接时页面仍在。
| 状态 | 设置页 |
|---|---|
| 未登录 | 标题「Codex 订阅需要登录」；主按钮「打开浏览器登录」；没有「稍后」 |
| 登录中 | 标题「正在等待浏览器授权」；主按钮「取消」 |
| 过期 / 异常 | 标题「登录已过期」或「Codex 订阅登录失败」；主按钮「重新登录」 |
| 缺少 OAuth 插件 | 标题「未安装 OAuth 插件」；没有登录按钮 |
| 已连接 | 标题「Codex 订阅已连接」；主按钮「退出登录」 |
设置页和 dock 的登录留在各自界面里。它们不执行 /codex-login，不把输入区换成提问卡，也不依赖 live agent。
命令
| 命令 | 行为 |
|---|---|
/codex-auth-status |
打印无密钥快照：未登录、登录中、已连接、已过期、缺少插件或异常 |
/codex-auth-login |
通过 ctx.openaiCodexOAuth 启动 silent 浏览器 PKCE |
/codex-auth-cancel |
取消进行中的浏览器登录 |
/codex-auth-logout |
通过 ctx.openaiCodexOAuth 清除凭据 |
OAuth 插件自己的 /codex-login、/codex-status、/codex-logout 仍然保留。/codex-login 仍是交互式斜杠命令，可以继续弹出提问卡。本包不替换这些命令。
Web 卡片和设置页通过 codexLoginDock/status、codexLoginDock/login、codexLoginDock/cancel、codexLoginDock/logout 调用同一套 Host 面。命令输出、RPC 载荷和快照不含 access token、refresh token、JWT 和 account id。access 到期时间可以以时间戳出现。
配置
以下字段属于 codex-login-dock Cordis 行的 config：
| 字段 | 默认值 | 含义 |
|---|---|---|
oauthCredentialRef |
OPENAI_CODEX_OAUTH_CREDENTIAL |
完整 OAuth JSON 凭据 |
accessTokenRef |
OPENAI_CODEX_ACCESS_TOKEN |
当前 access token 凭据 |
displayName: Codex 订阅 和 apiKeyEnv: OPENAI_CODEX_ACCESS_TOKEN 由 OAuth 插件的 patch 提供，避免本包覆盖时丢掉 token env。