dsh-codex-auth

这是 DeepSeek Harness 的独立 Codex Auth 工作区。可发布包位于 packages/plugin，它在 Web 设置中增加 Codex 栏目，调用 Harness 官方授权服务完成 ChatGPT 登录，并启用 llm-pi-ai/openai-codex 模型路线。

根目录的 dsh-codex-auth-cli-proof 是私有的阶段一 CLI 验证程序，不是交付包。安装、升级和卸载时应使用 packages/plugin 构建出的 dsh-codex-auth-*.tgz。Cordis 插件 ID 继续使用 codex-auth。

能力边界

• Harness 继续拥有智能体主循环、工具、会话和模型请求。
• @deepseek-ai/dsh-authorization 拥有授权生命周期；llm-pi-ai 拥有 OpenAI 登录适配和刷新逻辑；凭据服务拥有持久化与跨进程写锁。
• 本包只提供授权编排、浏览器安全远程接口、Web 设置栏目和模型路线开关。
• 浏览器只能读取“是否已登录、凭据种类、是否可写”等元数据，不能读取 access token 或 refresh token。
• OAuth 地址和设备码只在授权运行中返回，成功、取消或失败后由宿主清除。
• 本包不修改 agent-loop，不实现第二套 OAuth，不另建 Token 文件，也不静默回退到旧链路。

工作区结构

路径	职责
packages/plugin	可发布的 Host + Web Client 组合包
packages/typert-meta	独立构建时使用的 Typert 元数据桥接包
src	私有阶段一 CLI 验证程序
artifacts	本地打出的版本化 .tgz
.dist-home	stable/next/卸载验证使用的隔离 DSH_HOME

构建与测试

pnpm.cmd install
pnpm.cmd --filter dsh-codex-auth test
pnpm.cmd --filter dsh-codex-auth build

生成安装包：

Push-Location packages/plugin
npm.cmd pack --pack-destination '..\..\artifacts'
Pop-Location

安装与版本管理见 可发布包 README，版本变化见 可发布包 CHANGELOG。

从早期 link: 开发安装迁移到 .tgz 时，应先通过 Harness 插件命令卸载旧包，并确认 Profile 的 node_modules/dsh-codex-auth 不再是指向源码工作区的 junction。Windows 上残留的 junction 会让 pnpm 沿旧链接读取开发依赖，并在导入正式包时触发 EPERM；清除该残留链接后再安装版本化 .tgz，不要回退到 link: 掩盖问题。

当前验证状态

0.2.0 是首个正式版本，在 Harness 官方授权与凭据能力之上提供 ChatGPT 登录、Codex 模型路线管理和带独立钥匙图标的 Web 设置入口。功能链路已完成真实 ChatGPT 登录、GPT-5.6 Sol Web 请求、宿主重启后复用、终态脱敏、取消/失败/并发自动化、tgz Web 加载、stable/next 共存、升级、回滚和卸载验证。

真实 OAuth grant 的到期刷新没有通过等待生产令牌过期来触发；刷新读改写和跨进程锁由 Harness 官方 llm-pi-ai 与 credentials-local 测试覆盖。正式凭据的“退出登录”按钮未点击，以免删除用户当前登录；本包的删除范围由自动化测试覆盖。