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

快速上手

dsh-codex

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-codex

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

— 源: plugins.install

关键要点

• 在 dsh 设置面板或独立 CLI 中完成 ChatGPT OAuth 登录，并自动刷新 token
• Codex GPT 模型目录；账号提供视觉模型时自动声明其图片输入能力
• 经标准 LLM 服务运行的流式响应、工具调用、推理回放、提示词缓存与 dsh 压缩
• 通过 dsh 现有 web_search 工具使用 Codex 独立联网搜索
• 为 Harness 现有 read_image 工具增加可选的 HTTP(S) URL 输入

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

需要 OpenAI API Key 吗？

不需要。本插件消费 ChatGPT Plus/Pro 订阅（与官方 Codex CLI 同一通道），登录走 OAuth，不会把订阅变成通用 OpenAI Platform 凭据。

和官方 Codex CLI 能共享登录态吗？

不能互相复用。本插件把凭证独立写入 $DSH_HOME/.openai-codex-auth.json，绝不读取或修改 ~/.codex/auth.json，两套存储互不干扰。

怎样在 Web 之外登录？

用插件自带的 CLI：dsh plugin --profile web exec dsh-openai-codex login，加 --device-code 走设备码授权；status/logout/doctor --json 可查看状态和诊断。

模型选择器能精简 Codex 模型吗？

可以。在「设置 → OpenAI Codex」通过复选框勾选需要展示的模型，改动会持久化并即时刷新 Web/TUI 的模型列表；或在 profile patch 中给 llm-openai-codex 传 models 列表做初始子集。

图片输入支持哪些来源？

本地路径走 Harness 现有文件系统；HTTP(S) URL 由本插件扩展 read_image 后支持，会拒绝内嵌凭据、本地/私网/特殊网络目标并绑定已验证公网地址。Web 输入框可粘贴或拖拽，PNG/JPEG/WebP/GIF 均在附件限制内可用。

imagegen 工具能在非 Codex 模型上调用吗？

默认可以，受「设置 → OpenAI Codex → 允许其他模型使用生图」开关控制。关闭后只有 Codex 视觉模型能调用 imagegen，其他提供方的调用会在执行入口被拒绝。

登录凭证放在哪里？安全吗？

写入 $DSH_HOME/.openai-codex-auth.json（默认 ~/.dsh），文件 0o600 权限、原子写入、跨 dsh 进程加锁刷新；状态接口与诊断只返回非敏感字段，原始 token 不会下发到浏览器。

卸载会删掉登录凭证吗？

不会。卸载 bundle 仅移除 DSH 端集成，需在账号页面或 dsh-openai-codex logout 才会删除本地凭据文件。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.7+
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则