前言¶

在 DeepSeek Harness（DSH）里跑智能体，模型、工具和网络能力通常靠各自插件拼装。若你已有 OpenAI 的 ChatGPT 或 Codex 订阅，却还要单独配置 API Key、再为 GPT 对话、图片生成和联网搜索分别找方案，集成成本会偏高。

下面介绍的 @wnjxyk/dsh-codex-oauth 走 OAuth 登录订阅账号，把 GPT 模型、生图、web_search 和配额查询接到 DSH 原生界面里。维护者为 WNJXYK，在 SkillHub 社区目录归类为「模型推理」；GitHub 仓库 WNJXYK/dsh-codex-oauth 当前约 14 stars、4 forks，许可证为 MIT。插件在 DSH 0.1.0-rc.6 上做过验证，npm 包版本为 0.4.2，运行环境要求 Node.js >= 20。

这是什么¶

dsh-codex-oauth 是面向 DSH Web 侧的统一 OpenAI Codex 订阅插件。它通过 OAuth 绑定 ChatGPT / Codex 账号，激活 DSH 内置的 openai-codex 模型提供方，并按账号权限动态加载可用 GPT 模型；同时注册生图工具与联网搜索能力，并在界面中展示订阅计划、剩余配额与重置时间。

SkillHub 目录页：https://www.skillhub.cn/plugins/WNJXYK/dsh-codex-oauth。SkillHub 是面向 Skills / 插件的社区目录，与 DeepSeek 或幻方无官方从属关系；安装与文档以 GitHub README 为准。

核心功能¶

GPT 模型¶

插件激活 DSH 内置 openai-codex provider，从订阅账号侧发现可用 GPT 模型，并在 DSH 模型选择器里提供专用控件。聊天模型由 DSH 内置 llm-pi-ai 插件提供的 openai-codex 模型源动态加载，无需手工维护模型列表。

图片生成¶

注册 generate_image 工具，支持多种尺寸与质量档位，生成结果在对话界面中预览展示。生图编排默认使用 Codex Power 模型 gpt-5.6-sol，实际渲染走托管 GPT Image（image_generation）工具。

联网搜索¶

将 DSH 原生 web_search 路由到托管 GPT 搜索，返回答案文本及带来源 URL 的结构化引用。默认搜索模型同为 gpt-5.6-sol，与 README 中 Codex Power 配置对齐。

订阅配额与 OAuth¶

界面可查看计划类型、剩余配额、重置时间，以及 5 小时、每周等窗口限制（数据来自 https://chatgpt.com/backend-api/wham/usage）。OAuth 支持浏览器登录与无头设备码授权，含自动续期、状态刷新与登出；凭证默认写入 $DSH_HOME/codex-oauth.json。

界面集成¶

插件注入 DSH 客户端运行时与设置、对话、工具等 UI 模块，跟随 DSH 中英文与 Light / Dark / System 主题，符合 DSH 热插拔插件设计。

安装与启用¶

DSH 生态遵循「一切皆插件」；Web 侧安装需带 --profile web 与 -w 参数。任选 npm 或 GitHub 源之一即可。

从 npm 安装最新版：

dsh plugin --profile web add -w @wnjxyk/dsh-codex-oauth@latest

从 GitHub 安装：

dsh plugin --profile web add -w github:WNJXYK/dsh-codex-oauth

卸载（npm 与 GitHub 安装方式相同）：

dsh plugin --profile web remove -w @wnjxyk/dsh-codex-oauth

安装完成后，在 DSH 设置或插件提供的控制入口完成 OAuth 登录；无图形环境时可使用设备码流程（README 中有 headless 登录示意）。

典型用法与配置¶

默认使用¶

多数场景无需额外配置。登录成功后，在模型选择器里挑选账号可用的 GPT 模型即可对话；需要生图或联网时，通过 DSH 对话中的工具调用触发 generate_image 与 web_search。

模型可见性与功能开关保存在 $DSH_HOME/codex-oauth-preferences.json，可在插件界面调整。

高级 Cordis 配置¶

若需自定义凭证路径、OAuth issuer 或本地回调端口，可在 Cordis 中插入插件并传入 config。下列示例来自 README，展示自定义 DSH 主目录、凭证文件路径及 Web 搜索模型：

- insert:
    - id: dsh-codex-oauth
      name: "@wnjxyk/dsh-codex-oauth"
      config:
        dshHome: /data/dsh
        path: /secure/codex-oauth.json
        preferencesPath: /secure/codex-oauth-preferences.json
        issuer: https://auth.openai.com
        usageUrl: https://chatgpt.com/backend-api/wham/usage
        controlPort: 1456
        redirectPort: 1455

    - id: codex-web-search
      name: "@wnjxyk/dsh-codex-oauth/web-search"
      config:
        model: gpt-5.6-sol

常用配置项说明：

适用场景与注意事项¶

适合谁¶

• 已有 ChatGPT / Codex 订阅，希望在 DSH Web 界面内统一使用 GPT 对话、生图与联网搜索；
• 需要在 DSH 里查看订阅配额与重置窗口，避免超额使用；
• 希望在无浏览器的服务器侧通过设备码完成 OAuth，再在 DSH 中调用同一套能力。

风险与权限¶

README 明确说明：项目基于开源软件构建，并依赖非公开的 ChatGPT Codex 后端接口。OpenAI 协议变更可能导致功能暂时不可用，需等待插件更新；另存在较低的账号受限风险，使用前请自行评估。

插件以当前 DSH 进程权限运行，OAuth 凭证写入宿主机文件。安装前应阅读 GitHub 源码 与 MIT 许可证，确认凭证路径、回环端口（默认 1455 / 1456）与部署环境相符。

结尾¶

@wnjxyk/dsh-codex-oauth 把 OpenAI 订阅侧的 GPT 模型、生图、联网搜索和配额查询收拢到 DSH 一条 OAuth 链路里，适合已订阅且希望在 Harness 内原生使用 Codex 能力的开发者。目录与源码：

• SkillHub：https://www.skillhub.cn/plugins/WNJXYK/dsh-codex-oauth
• GitHub：https://github.com/WNJXYK/dsh-codex-oauth