Codex Connect for dsh

English | 中文

通过 OAuth 将你的 ChatGPT 订阅连接到 DeepSeek Harness，同时保留用户自主默认项、Harness 原生审批、非敏感诊断和可靠的会话恢复。

dsh-codex-connect 提供 openai-codex 模型目录和独立的 ChatGPT OAuth 登录。模型仍走 Harness 标准 LLM 服务，因此流式输出、工具调用、reasoning replay、压缩、文件系统控制、权限门禁和审批提示仍由 Harness 负责。ChatGPT 订阅不会因此变成 OpenAI Platform API 凭据。

安装是增量的：bundle 不会替换当前主模型或搜索路由；独立搜索提供方和 view_image 工具也默认关闭，必须显式开启。

安装

dsh plugin --profile web add dsh-codex-connect
dsh web

在 DeepSeek Harness 源码 checkout 中运行时，在命令前加 pnpm。本地开发可安装 link:/absolute/path/to/dsh-codex-connect。

可在 设置 → 插件 → 插件配置 → OpenAI Codex → 使用 ChatGPT 登录，也可使用 CLI：

dsh plugin --profile web exec dsh-codex-connect login
dsh plugin --profile web exec dsh-codex-connect status
dsh plugin --profile web exec dsh-codex-connect doctor

doctor 只读取进程与文件系统元数据，不打开 OAuth 文件，也不会输出 token、授权 URL、授权码、账户 ID 或认证文件内容。

显式配置

安装后的 bundle 只注册模型提供方，不改变路由：

- id: llm-openai-codex
  config:
    enableSearch: false
    enableImageTool: false

如需把 Codex 模型设为新 agent 的默认模型，需要自行添加或修改 Harness 的独立配置项：

- id: agent-default-model
  config:
    provider: openai-codex
    model: gpt-5.6-sol

如需启用并选中 Codex 独立搜索，两项都必须显式配置：

- id: llm-openai-codex
  config:
    enableSearch: true
    searchMode: live
    searchContextSize: medium

- id: web
  config:
    searchProvider: openai-codex

如需图片加载工具，在 llm-openai-codex 上设置 enableImageTool: true。浏览器粘贴/拖放属于 Harness 附件能力，不依赖该工具。

凭据、诊断与冲突

• OAuth 单独存储于 $DSH_HOME/.openai-codex-auth.json（默认 ~/.dsh），不会复制或修改 ~/.codex/auth.json。
• 支持的平台上，父目录与文件使用仅所有者可访问权限；写入采用原子替换，刷新写入使用跨进程文件锁。
• 状态和诊断只返回非敏感信息；OAuth 交互只会由显式 login 操作触发。
• 浏览器 OAuth 路由只接受 loopback 客户端和 loopback Host/Origin；30 秒内没有得到有效的 HTTPS 授权地址时会安全失败，不会一直挂起。
• 两个 adapter 不能同时占用 openai-codex。旧 dsh-codex bundle 或手动 provider 配置冲突时，启动会给出明确迁移提示。
• 移除包不会删除 OAuth 状态；只有确实需要删除凭据时才运行 logout。

兼容性与安全边界

• Alpha 面向当前 Harness 主线组合与兼容的 插件 API、Node.js 和固定版本的 Codex provider。