franksong2702/dsh-codex-connect

已发布 Alpha 13： 0.2.0-alpha.13 仅新增精确的 stock DSH 0.2.2-rc.1，保留原十五个 Host 及下述 Task 仅恢复限制。npm 版本／alpha、匹配的 Git tag／prerelease 和归档完整性均已独立核实。latest 保持 Alpha 10。参见发布与验证记录。这不要求升级 DSH；隔离合成检查不代表真实账户／模型、原生 GUI 或 Windows Desktop 验收。

在精确的 DSH 0.2.2-alpha.3 和 0.2.2-rc.1 上，旧 Task 仅保留状态查看、停止和转手动。自动路由、续跑和证据子任务创建均被拒绝，包括内部直接入口。原有停用委派／归档安全退出仍保留 owner、回执和清理校验。原十四个 Host 的行为不变，所有版本的 Task 公共激活入口继续关闭。

当前开发遵循核心维护范围：保留接入、兼容、诊断与恢复，冻结 Task 自动编排及未证明收益的优化。此决定不会删除已发布选项，也不会远程停用已有安装。

English | 中文

通过 OAuth 把你的 ChatGPT 订阅接入 DeepSeek Harness，并提供可选的 GPT Image 图片生成与编辑、由用户控制的默认设置、Harness 原生审批、诊断与可靠的会话恢复。

社区 Alpha 项目——与 OpenAI、ChatGPT、Codex、DeepSeek 或 DeepSeek Harness 不存在隶属关系，也未获得其背书。

Codex Connect 为标准 Harness agent loop 添加 openai-codex 模型提供方。工具、权限、审批、附件、会话持久化、压缩与恢复继续由 Harness 管理。安装插件不会改变默认模型或搜索路由，也不会把 ChatGPT 订阅变成 OpenAI Platform API Key。

快速开始

历史 Alpha 12： 0.2.0-alpha.12 在下述仅恢复限制下适配精确的 stock DSH 0.2.2-alpha.3，退役 Luna Reserve，并修复自带 Auto review preset 的 Codex Responses temperature 参数错误。发布渠道为 alpha，latest 保持 Alpha 10。参见发行与迁移说明。这不要求升级 DSH。

历史 Alpha 11： 0.2.0-alpha.11 交付 GPT-6.1 Terra、统一速度菜单、精确 DSH rc.4／rc.5、seeded fork 原图及 bili 原生压缩预检，并抬高直接 Undici 最低版本。全部 14 个精确宿主使用同一安装包完成验证；npm 版本／alpha、Git tag、prerelease 和包完整性均已独立回读。latest 保持 Alpha 10。参见发布记录；无凭据检查不代表真实账户／模型或 Desktop 验收，Computer Use 不在本版内。

历史 Alpha 10： 0.2.0-alpha.10 仅新增精确 DSH 0.2.1-rc.3，保留原有 11 个宿主，并交付默认关闭的只读额度工具及紧凑速度菜单。npm 版本、alpha 标签、Git tag、prerelease 和包哈希已独立回读；latest 不变。rc.3 的上游 Git 源码映射仍未验证；无凭据合约不代表真实账户／模型或 Desktop 验收。参见发布记录。

本指南推荐 Codex Connect 0.2.0-alpha.13 / DSH 0.2.1-rc.5；其他受支持的精确宿主版本见下表。请先运行 dsh --version，再用 doctor --json 做本地诊断；单凭 CLI 版本无法证明实际安装的模型运行库版本，缺少版本元数据时会报告未知。其他版本请查阅安装与升级。alpha 等会移动的 npm tag 不代表兼容性保证。

要求	已验证组合
Codex Connect	0.2.0-alpha.13
DeepSeek Harness	0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5、0.2.2-alpha.3 或 0.2.2-rc.1（包版本必须一致）
Node.js	^22.19.0 || >=24.0.0
账户	通过 ChatGPT OAuth 使用所请求的 Codex 模型；可用性由 OpenAI 决定

历史维护版本： 0.2.0-alpha.9 增加可选的推理强度回退设置，以及新顶层会话和普通子代理会话各自独立的 Standard / Fast / Ultrafast 默认设置。显式请求中的推理强度和后续手动速度选择优先；省略或重置时保留对应的旧默认行为。已有／恢复会话继续受到尊重。Ultrafast 仍要求登录并匹配可用的模型／账户路由；资格与实际服务档位仍未知。finite SSE 和 Task 暂停状态不变；不声称已测得提速倍数或完成真实账户／Desktop 验收。

历史维护版本： 0.2.0-alpha.8 增加显式会话级 Standard / Fast / Ultrafast 选择，保留宿主重试策略，将 GPT-6.1 Sol 默认上下文设为 500,000 token，并修复恢复／文件身份及 Windows 打包检查。Ultrafast 仅对文档列明的两个 Codex 模型显式启用；不包含新主会话／子代理的默认设置。资格与实际服务档位仍报告未知，保留 finite SSE 及原有可选功能默认行为。不声称已测得提速或完成真实账户／Desktop 验收。

历史图片恢复版本： 0.2.0-alpha.7 在 Harness 预览保存失败时保留已完成、已验证的原图，支持下载原图和明确选择继续编辑。工具说明明确：聊天可继续使用 DeepSeek，图片由 Codex Connect 的独立 ChatGPT OAuth 通道处理。其原有十一个精确宿主组合均保留验证；底层图片接口与凭据行为不变。合成检查不代表真实账户或 Desktop 验收。

0.2.0-alpha.4 将精确宿主支持扩展到 DSH 0.2.1-alpha.2 和 0.2.1-alpha.3，保留原有五个宿主。原有受支持宿主无需升级；Task 仍暂停，默认设置不变。

历史维护版本： 0.2.0-alpha.5 交付精确 DSH 0.2.1-alpha.4、0.2.1-alpha.5 和 0.2.1-rc.1 支持及宿主／浏览器运行版本诊断，保留原有七个已发布宿主。诊断共用一份版本策略；详见兼容性记录及 alpha.4 客户端状态修复。发布及无凭据验证不等于新的真实账户、Desktop 或已登录浏览器验收；#339 继续保持打开，单独跟进验收。

历史发布 0.2.0-alpha.3 增加官方 Desktop 登录适配和桌面版专用账户诊断，保留 Web 登录行为。Desktop 使用独立的 profile 和自带 CLI，请遵循Desktop 安装说明。声明的宿主版本、默认设置和账户存储不变。

历史发布 0.2.0-alpha.2 已发布精确 DSH 0.2.1-alpha.1 的兼容适配，以及跨模型路由的图片选择句柄修复。较早的 0.2.0-alpha.1 安装包保持不变，仍拒绝该宿主。原有受支持宿主无需升级。

截至 2026-11-09，npm alpha 指向 0.2.0-alpha.13，latest 保持 0.2.0-alpha.10。默认安装仍选择 Alpha 10；安装下列宿主组合请使用精确版本命令，会移动的 npm tag 不保证其他宿主版本的兼容性。

历史发布 0.2.0-alpha.1 通过模型目录补充增加 gpt-6.1-sol，并开始较短的独立插件编号。四个受支持的 DSH 版本不变，无需升级宿主。

它保留 Alpha 4.54 的改动，在 DSH 0.2.0-rc.2 调用固定版本的 Codex 提供方时保留初始系统指令和工具定义，修正宿主与插件使用不同提供方库版本时的诊断，并补强 Canary 的普通请求检查。继续保留 Alpha 4.53 的核心维护改动、已有任务恢复与安全检查，以及 4.52 的可选本地请求计量。配置私有目录后才采集；未知用量不当作零。不恢复 Task，也不升级模型库或 OAuth。

该安装包已通过上方十六个精确 DSH 版本的无凭据安装及运行回归验证。Task 控件仍暂停：激活请求会被拒绝，现有宿主的浏览器回归中，新 Session 不显示这些控件。这些检查不代表真实 OAuth、真实账户图片编辑、新宿主的已登录浏览器验收或完整用户验收；跨 Harness 升级迁移旧任务授权尚未验证。较旧组合及其任务行为见安装与升级。

历史记录：2026-10-10，维护者报告已在 Desktop 0.2.0-rc.2 用已记录的本地适配包完成登录并正常使用。仅历史 0.2.0-alpha.3 客户端与该本地适配包进行了比较，确认只差包版本字符串。此比较不代表 0.2.0-alpha.4 的 Desktop 或真实账户验收，也不代表后续 npm 安装包的验收；未进行新的真实 Desktop 验收。参见Desktop 验收记录。

1. 安装

dsh plugin --profile web add dsh-codex-connect@0.2.0-alpha.13
dsh web

将 web 替换为正在使用的 profile 名，启动 Harness 时也使用同一个 profile。从 DSH 源码 checkout 执行时，请在命令前加 pnpm。其他 profile 的用法和安装检查见 INSTALL.md。

2. 授权并选择模型

打开 设置 → 模型 → Openai-Codex → 授权，然后亲自在浏览器中完成批准。如果内嵌窗口被拦截，请用 打开 ChatGPT 登录页面。在 Harness 的常规模型选择器中选择一个 openai-codex 模型。

不要把授权 URL、code、token 或账户标识粘贴到 issue、日志、聊天或配置文件中。在另一台设备上使用浏览器时，可通过默认收起的手动回调表单完成当前登录，无需转发 localhost 回调端口；请遵循远程浏览器授权说明。

3. 检查安装

若要求诊断不经过包管理器，请直接运行已经安装的 bin（替换为已经独立识别的实际路径）：

node /absolute/profile/node_modules/dsh-codex-connect/lib/bin.js doctor --json \
  --install-anchor /absolute/dsh/node_modules/@deepseek-ai/dsh/package.json

doctor --json 只读本地安装元数据，不请求网络或输出原始凭据；指定安装锚点不证明该安装正在运行。dsh plugin exec 等包装命令自身可能核对或安装依赖。详见运行身份与直接诊断，包括 Desktop/ASAR 限制。包含本改动的开发构建还会在设置中区分页面、Host 已加载和磁盘安装版本。诊断通过不代表模型权限，实际请求须另获授权。

核心能力

• **账户：**在 DSH 主机上保存最多 16 个账户，手动选择后续请求使用的活动账户，不按会话绑定。请求保持已固定的账户，插件不会自动轮换或静默故障切换。
• **模型与 Astra 支持：**当前已验证的 DSH 与插件组合已支持 gpt-6-astra。插件补充缺失的模型定义，提供 Low、Medium、High、Xhigh 和 Max 五档推理强度；Default 保持提供方默认值。已保存的 Off/Minimal 选择需要明确更新。安装的依赖目录包含 Astra 时，插件保留其原生元数据，同时维持这五档已校准的推理选择。模型出现在列表中，不代表当前账户具有调用权限；新依赖版本的整体兼容性仍需单独验证。
• **Fast Mode：**为单个对话请求优先服务，默认关闭。可分别为新建主对话和新建子代理对话启用默认值，不改变已有对话。实际速度和额度消耗取决于服务端，不保证固定提速倍数。
• **额度：**显示服务端返回的 5h、7d 窗口及重置时间，已登录且标签页可见时通常每 60 秒刷新一次；失败后延长重试间隔。不虚构缺失窗口；Spark 使用独立额度桶。
• **插件更新：**检查 Codex Connect 新版本，不自动安装，也不建议更改 DSH。宿主兼容性信息通过主动运行的本地诊断查看。

可选能力

**较早的 Alpha 4.40/4.41 组合：**任务级模型安排默认关闭。用户明确授予任务权限后，由 GPT-5.6 Sol／Medium 起步；当前模型可以在授权范围内继续、调档或交接主任务。请求共用同一任务账本与预算；停止、手动接管和重启恢复都保留授权边界。Phase 2 的只读委派需要单独同意，不会给委派工作者写入权限。原版 DSH 0.1.7-rc.1 配合 Alpha 4.43 时，这些 Task 控件仍暂停；不能从旧组合推断它们可用。参见 Phase 1 与 Phase 2 同意边界。

Alpha 4.40 还会在旧提供方目录缺失时补充 gpt-6-sol 和 gpt-6-luna，已有原生定义时保留其元数据。两者提供 Low 到 Max（含 Xhigh），Default 不指定推理档位；尚未实现 Codex Sol 的 Ultra 编排模式。新任务可明确授权使用它们，但已有授权及 GPT-5.6 Sol／Medium 起步不变；Luna Reserve 后续已移除。模型出现在目录中不代表账户具有调用资格。参见兼容范围与验证。

以下选项在新安装时全部关闭。请在 设置 → 插件 → 插件配置 → Codex Connect 或 设置 → 模型 → Openai-Codex → 更多设置 中编辑，再点击 保存更改。发生冲突或保存失败时会保留草稿。

能力	启用字段	重要行为
代理	enableProxy	不带凭据的 HTTP(S)，只作用于本插件流量，包括压缩的 OAuth 和额度响应；无关的 Fetch 请求仍使用宿主原来的传输方式。代理请求失败不会静默改走直连。
Codex 搜索	enableSearch	将整个 profile 的搜索路由切换为 Codex；关闭后恢复之前的路由。
图片查看	enableImageTool	为视觉模型添加 view_image，读取本地文件和经过校验的公网 HTTP(S) 图片。
GPT Image 图片生成与编辑	enableImageGeneration	根据提示词生图，或编辑明确选定的会话图片并使用有顺序的参考图；可用性、尺寸和额度仍由账户及服务端控制。同时作为跨路由图片句柄桥接的开关：在非 Codex 路由上把 Codex Connect 图片选择句柄持久化到图片工具结果中，使图片编辑在这些路由上同样可用；openai-codex 路由会跳过，因为其适配器已在每次请求时注入相同句柄。可选 imageHandleBridgeTools 可将桥接限定到指定工具。
自动审查	enableAutoReview	将有界的审批上下文、工具参数、工作目录和待执行动作发送到 chatgpt.com，首次启用需要确认。失败时交还人工审批。

Luna Reserve 已移除。 旧 enableReserveFallback 开关会被忽略，不再协商或自动切换模型。旧 gpt-reserve 会话须由用户明确选择普通模型；如宿主不支持在原会话切换，请保留原会话并用所选普通模型新建对话。旧 return 文件原样保留，不读取、迁移或删除。账户额度 UI 和只读额度工具仍使用普通 60 秒缓存及失败冷却，不后台轮询。参见迁移说明。

使用你当前 GPT 订阅计划提供的图片生成能力。成功生成的图片会显示在对话回复下方，无需展开处理过程；原工具卡片仍保留在处理过程里。生成原文件与附件预览分开保存；关闭能力或卸载插件不会删除这些文件。存储和访问规则见配置与恢复。

Alpha 4.49 修复了 4.48 中重新上传的副本与历史原图混淆、以及安全失败原因未显示的问题。输入有歧义时要求明确选择，不会静默更换编辑对象。旧安装包保持不变；Alpha 4.50 保留这两项修复，并在继续支持 rc.1 的同时增加精确的 DSH rc.2 兼容。不要混装 rc.1／rc.2 的包，也不要绕过插件管理器的版本检查。

自动审查在 Harness 策略判定需要审批后执行，不会绕过该策略。启用前请阅读自动审查行为。

可选的模型额度查询： 在插件 profile 配置中显式设置 enableQuotaTool: true 并重新加载插件后，会注册只读工具 codex_connect_quota。默认关闭，自定义设置卡没有该开关。它只返回共享 Codex 窗口的剩余比例、重置时间和新鲜度，不返回余额或账户标识。详见额度查询及可选的 skill 示例。百分比不是任务预算；资源限制不能成为降低要求、跳过测试或安全检查的理由。

常见问题与重要限制

凭据保存在哪里？

OAuth 凭据保存在运行 DSH 的主机上，由该主机用于向 OpenAI 认证和发起请求。正常浏览器账户响应只返回账户摘要，不返回原始 token。远程浏览器设备不一定是 DSH 主机。

卸载插件会退出登录吗？

不会。OAuth 状态单独保存在 $DSH_HOME/.openai-codex-auth.json（默认 ~/.dsh），插件不会复制或修改 ~/.codex/auth.json。只有确实要删除凭据时，才使用 退出所有账户，或在卸载前运行 logout。

可以给不同对话分别切换账户吗？

后续 Codex 请求使用所选活动账户，每个对话不会各自绑定账户。Fast Mode 才是会话级设置。取消新的授权会保留已有账户；明确的刷新凭据撤销响应会提示重新授权，临时故障则保留账户供重试。详见账户行为。

为什么列表中的模型调用失败？

模型 HTTP/SSE 请求失败时，会在原错误消息后附加有界、仅属于该请求的诊断信息。单凭 overloaded 消息不能认定账户被封锁。范围与复现方式见持续错误诊断。

账户权限、插件与宿主兼容性、网络条件都会影响可用性。其他客户端可以使用，不代表此集成一定可用。OpenAI 控制模型权限、额度、上下文容量和服务行为；目录条目不是账户权限证明。

修改客户端请求头就能避免持续授权失败吗？

目前没有这样的保证。Codex Connect 是第三方集成，不冒充 Codex Desktop，也不伪造安装标识或 attestation 请求头。pi-ai 模型/OAuth 路由与辅助路由目前采用不同的客户端身份。OpenAI 的 App Server 文档要求集成通过 clientInfo 标识自己的客户端，但这不能证明本插件直接调用后端接口的接受规则。overloaded 本身不是封锁证据。应保留有界诊断信息，对照成功和失败时段后再判断原因；请求 ID 仅私下提供，不公开 token 或完整会话归档。

可以保留原来的 dsh-codex 插件吗？

不能在同一份有效配置中并存：两者都会注册 openai-codex。请遵循 MIGRATION.md，只移除已经确认冲突的条目，不删除凭据或无关提供方。

诊断能证明什么？

doctor 只做本地检查。能力与 reviewer 探针在满足前置条件时可能联网并消耗额度。auto-review-probe 只检查 reviewer 路由和结构化响应，不验证完整 Harness 审批集成，也不执行被审查的动作。命令、限制与退出码见诊断参考。

verified-compatibility.json 缺少某个 DSH/plugin 组合，只表示尚未验证，不表示已知不可运行。不要根据旧组合推断新版宿主支持情况。

文档与开发

• 安装与升级
• 配置、诊断与恢复
• 本地请求计量：启用、报告与停用
• 明确授权、有界的 bili 预处理活动（源码改动；默认关闭）
• 从 dsh-codex 迁移
• 架构与安全细节
• 自动审查行为
• 发布运行手册、贡献指南和安全政策

pnpm install --frozen-lockfile
pnpm run check
pnpm run test:browser
pnpm run check:dsh-install

check 包含静态检查、单元测试、构建、兼容性和打包检查。lint:metadata 检查包元数据与发布规则；lint:source 检查宿主与浏览器 TypeScript 中未处理或误用的 Promise、无效 await、重复 case 和不可达代码。浏览器回归与隔离 DSH 安装是另外两个命令。这些检查不使用真实 OAuth 授权，也不能替代真实账户验收。

许可证与致谢

Codex Connect 的修改与新增工作 Copyright 2026 Frank Song。本项目包含派生自 Yan-Zero/dsh-codex 的软件；上游内容继续保留 Copyright 2026 Yan-Zero。两部分均按 Apache-2.0 发布，详情见 NOTICE。

已发布的 0.2.0-alpha.1 将 gpt-6.1-sol 加入手动模型目录与配置选择器，支持 Low、Medium、High、Xhigh、Max；Default 不显式发送推理强度，不支持 Ultra 编排。该版本当时的 Codex 回退值为 272,000，允许的本地配置上限为 872,000；这不是 API 产品窗口，也不能证明账户访问权限。详见元数据与验证。不会扩大 Adaptive Task 授权。

Alpha 5 能力校准：来源对照 区分锁定目录的 272k 回退值／872k 本地上限、搜索结果收录的官方 Work/Codex 产品文字所宣称的 500k，以及另一 API 产品的限制。该历史变更仅更新 Sol61 的策略来源锁定；当时的默认值、原生提供方元数据优先级和 Fast／effort 行为不变。没有验证账户或端点的实际容量。

已发布的 #338 基础默认值后续修复：按官方 Work/Codex 产品默认策略，将 Sol61 缺失条目和已知旧内置静态元数据的基础默认值校准为 500,000 token。显式提供方元数据与用户覆盖值仍优先；其他模型、输出上限和 872,000 本地配置上限不变。范围与证据 区分校准默认值与真实路由容量。

Alpha 11 已发布：手动模型目录与配置选择器新增 gpt-6.1-terra，保留文字/图片输入和既有 Responses 工具。官方 Codex 回退默认 500,000 tokens，本地可选上限 872,000、输出上限 128,000；上游原生元数据优先，但与 Sol61 一样仍套用 effort 遮罩。提供 Low、Medium、High、Xhigh、Max；Default 不发送 effort。锁定的 OAuth 目录未列出 API 的 none，Ultra 客户端编排不受支持。本轮不新增桌面 Computer Use 执行器、不扩大 Ultrafast 范围。来源、范围及合成验证；真实账户可用性尚未验证。