dsh-codex-connect 使用指南

通过 ChatGPT OAuth 在 DSH 中使用 OpenAI Codex 模型，可选启用独立搜索、读图、生图能力。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

For the exact gpt-5.3-codex-spark model, the Composer reads the Spark weekly bucket. Other GPT Codex models read the standard Codex weekly bucket; these are separate limits.
id: llm-openai-codex
enableSearch: true registers Codex as an available search provider. It does not select the profile's global search route.
enableImageTool: true enables view_image for approved local reads and public-network image fetches on vision-capable models.
Codex · Weekly is the standard Codex weekly bucket used by ordinary GPT Codex models.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后会替换默认模型或全局搜索吗？

不会。cordis.patch.yml 只新增一行 llm-openai-codex 且全部 capability 默认为 false，profile 默认模型与 web.searchProvider 需用户手动编写。

OAuth 凭据存在哪里？和 ~/.codex/auth.json 是什么关系？

凭据存储于 $DSH_HOME/.openai-codex-auth.json（默认 ~/.dsh），与 Codex CLI/Desktop 独立，卸载包不会删除。需要复制凭据时直接在目标机器重新 Sign in 即可。

需要 OpenAI Platform API Key 吗？

不需要。Codex Connect 用 ChatGPT OAuth bearer token；私有 OpenAI Platform 凭据不被读取或代用。

重装或换机器后怎么恢复登录？

重新进入 Settings → Plugins → Plugin configuration → Codex Connect，点击 Sign in with ChatGPT 完成浏览器授权即可，不要在 issue/日志/配置中粘贴授权码。

在 Windows 上能用吗？有什么限制？

可以使用全部能力，但 OAuth 文件跳过 POSIX owner-only 检查；历史修复命令在 Windows 上只能 dry-run，应用模式会被拒绝。

doctor / status / migrate-history 会泄露凭据吗？

不会。doctor 只读 lstat 元数据并输出不包含密钥的 JSON；status 仅区分 signed-in / signed-out；migrate-history 修改前会创建同目录备份，fail-closed 默认拒绝改写。

升级到 DSH 0.1.0-rc.7 后 Alpha 4.10 的搜索历史读不出来了怎么办？

先运行 dsh plugin --profile web exec dsh-codex-connect migrate-history --json 查看，确认后停掉所有 DSH，再运行带 --apply --confirm-stopped --json 才会真正改写历史文件。

同时装旧的 dsh-codex 怎么办？

Harness 禁止重复 provider，启动时会直接拒绝并提示只保留其中一个。先卸载旧包并移除 profile 中多余的 llm-openai-codex 行，再添加 Codex Connect。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则