[Plugin / 插件] dsh-codex — ChatGPT OAuth, Codex search, and image input / ChatGPT 登录、搜索与图片输入

[Yan-Zero]

中文

大家好，我做了一个独立的 dsh 插件 dsh-codex，可以通过 ChatGPT OAuth 登录，在 DeepSeek Harness 里使用账号可用的 Codex 模型。

我平时主要在 Web profile 里用 dsh，所以把登录、额度和图片都接进了现有界面。目前包里有这些功能：

• 在 设置 → OpenAI Codex 里完成浏览器登录，也支持 CLI 和 device code；
• 自动刷新 token，凭据单独保存在 $DSH_HOME/.openai-codex-auth.json；
• Codex 模型目录、流式输出、工具调用、推理回放、prompt caching 和 dsh compaction；
• 复用 dsh 的 web_search 工具访问 Codex 独立搜索，并保留普通文本与引用历史；
• 在 Web 输入框粘贴或拖放图片；view_image 也能读取本地路径和 HTTP(S) 图片；
• 设置页显示 Codex 额度进度条和剩余百分比。

安装：

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

启动后打开 设置 → OpenAI Codex → 使用 ChatGPT 登录。无界面环境可以运行：

dsh plugin --profile web exec dsh-openai-codex login --device-code

插件使用 ChatGPT Codex 后端。模型权限、额度和可用性由 OpenAI 账号与套餐决定；它不会生成通用 OpenAI API Key。dsh 的 shell、文件系统、skills、MCP、subagents 和权限系统仍由当前 profile 提供。

• 源码与文档：https://github.com/Yan-Zero/dsh-codex
• npm：https://www.npmjs.com/package/dsh-codex
• 当前版本：0.2.1，依赖与测试环境对齐 dsh 0.1.0-rc.6
• License：Apache-2.0

如果你愿意试一下，我很想了解浏览器回调、headless 登录、图片附件和搜索记录在不同环境里的表现。协议和凭据生命周期也写在仓库的 design 文档里，欢迎直接提 issue。

---

English

Hi! I’ve been working on an independent dsh plugin called dsh-codex. It signs in through ChatGPT OAuth and makes the Codex models available to a DeepSeek Harness profile.

I use dsh mostly through the Web profile, so the package covers the account flow and a few everyday Codex features in the existing UI:

• browser sign-in from Settings → OpenAI Codex, plus CLI and device-code flows;
• automatic token refresh, with a separate credential store at $DSH_HOME/.openai-codex-auth.json;
• the Codex model catalog, streaming, tool calls, reasoning replay, prompt caching, and dsh compaction;
• Codex standalone search through dsh’s existing web_search tool, with regular text and citation history;
• image paste/drop in the Web composer, plus a view_image tool for local paths and HTTP(S) URLs;
• live Codex quota bars and exact remaining percentages in Settings.

Install it into a Web profile:

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

Then open Settings → OpenAI Codex → Sign in with ChatGPT. For a headless machine:

dsh plugin --profile web exec dsh-openai-codex login --device-code

The plugin talks to the ChatGPT Codex backend. Model access, quotas, and eligibility follow the OpenAI account and plan; this does not create a general OpenAI API key. Shell, filesystem, skills, MCP, subagents, and permissions continue to come from the active dsh profile.

• Source and docs: https://github.com/Yan-Zero/dsh-codex
• npm: https://www.npmjs.com/package/dsh-codex
• Current release: 0.2.1, aligned and tested with dsh 0.1.0-rc.6
• License: Apache-2.0

I’d especially appreciate field reports on the browser callback, headless login, image attachments, and search history across compaction. Protocol and credential-lifecycle notes are in the repository’s design document; issues are welcome.