dsh-codex-connect 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-codex-connect 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-codex-connect 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-codex-connect 还在维护吗？

GitHub 176 星。最近一次上游提交在 2026/10/31。

Codex 接入插件 franksong2702/dsh-codex-connect

DeepSeek Harnessv0.2.0-alpha.10

franksong27022 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

当前开发遵循核心维护范围：保留接入、兼容、诊断与恢复，冻结 Task…

64.5/100

综合分

176

GitHub 星标

2,642

npm 周下载

—/5

用户评分

数据截至 2026/11/1 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

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

npm 源 · dsh-codex-connect 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · market

装得上吗

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 2 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-codex-connect @ 0.2.0-alpha.10

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/2 11:38:33

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 119 处，展示前 56 条）

发起网络请求
lib/index.js:341
return await fetch(input, init);
发起网络请求
lib/index.js:391
response = await fetch(TOKEN_URL, {
写入本地文件
lib/index.js:940
await mkdir(dirname(this.filename), {
写入本地文件
lib/index.js:984
await mkdir(dirname(this.filename), {
写入本地文件
lib/index.js:1004
await mkdir(dirname(this.filename), {
删除本地文件
lib/index.js:1024
await rm(this.version1BackupFilename, { force: true });
删除本地文件
lib/index.js:1026
await rm(this.filename, { force: true });
写入本地文件
lib/index.js:1040
await mkdir(dirname(this.filename), {
写入本地文件
lib/index.js:1067
await mkdir(dirname(this.filename), {
删除本地文件
lib/index.js:1072
await rm(this.filename, { force: true });
删除本地文件
lib/index.js:1073
await rm(this.version1BackupFilename, { force: true });
发起网络请求
lib/index.js:2613
async fetch(input, init) {
发起网络请求
lib/index.js:2621
async fetch(input, init) {
发起网络请求
lib/index.js:2626
const response = await fetch(prepared.input, {
发起网络请求
lib/index.js:3399
const response = await fetch(input, init);
读取本地文件
lib/index.js:4272
metadata = await lstat(filename);
读取本地文件
lib/index.js:4356
text = await readFile(this.filename, "utf8");
写入本地文件
lib/index.js:4379
await mkdir(dirname(this.filename), {
读取本地文件
lib/index.js:5803
const metadata = await lstat(filename, { bigint: true });
读取本地文件
lib/index.js:5806
const directory = await realpath(dirname(filename));
读取本地文件
lib/index.js:5815
if (!sameManifestFile(opened, await lstat(filename, { bigint: true }))) return null;
读取本地文件
lib/index.js:5816
if (manifestPath !== filename && !sameManifestFile(opened, await lstat(manifestPath, { bigint: true }))) return null;
删除本地文件
lib/index.js:11486
await rm(directory, {
删除本地文件
lib/index.js:11509
await rm(this.directory(ref.assetId), {
发起网络请求
lib/index.d.ts:247
fetch(input: string | URL | Request, init?: RequestInit, options?: Omit<OpenAICodexBackendFetchOptions, 'lane'>): Promise<Response>;
发起网络请求
lib/client.js:239
const response = await fetch(path, {
发起网络请求
lib/client.js:440
const response = await this.request(OPENAI_CODEX_AUTH_STATUS_PATH, "GET", signal);
发起网络请求
lib/client.js:500
const challenge = parseChallenge(await this.request(OPENAI_CODEX_AUTH_LOGIN_PATH, "POST"));
发起网络请求
lib/client.js:584
await this.request(OPENAI_CODEX_AUTH_CANCEL_PATH, "POST");
发起网络请求
lib/client.js:620
await this.request(OPENAI_CODEX_AUTH_LOGOUT_PATH, "POST");
发起网络请求
lib/client.js:664
await this.request(OPENAI_CODEX_AUTH_ACCOUNTS_PATH, method, void 0, body);
写入剪贴板
lib/client.js:3199
await navigator.clipboard.writeText(prompt);
写入剪贴板
lib/client.js:4607
await navigator.clipboard.writeText(trustedOriginCommand);
写入本地文件
lib/bin.js:44
await rename(temp, filename);
写入本地文件
lib/bin.js:71
await mkdir(dirname(filename), {
写入本地文件
lib/bin.js:77
await writeFile(temp, content, {
删除本地文件
lib/bin.js:83
await rm(temp, { force: true });
读取本地文件
lib/bin.js:93
await lstat(lockPath);
写入本地文件
lib/bin.js:140
await writeFile(lockPath, `${process.pid}\n`, {
删除本地文件
lib/bin.js:158
await rm(lockPath, { force: true });
写入本地文件
lib/bin.js:468
await mkdir(dirname(this.filename), {
写入本地文件
lib/bin.js:512
await mkdir(dirname(this.filename), {
删除本地文件
lib/bin.js:552
await rm(this.version1BackupFilename, { force: true });
删除本地文件
lib/bin.js:554
await rm(this.filename, { force: true });
删除本地文件
lib/bin.js:600
await rm(this.filename, { force: true });
删除本地文件
lib/bin.js:601
await rm(this.version1BackupFilename, { force: true });
读取本地文件
lib/bin.js:775
const metadata = await lstat(filename, { bigint: true });
读取本地文件
lib/bin.js:778
const directory = await realpath(dirname(filename));
读取本地文件
lib/bin.js:787
if (!sameManifestFile(opened, await lstat(filename, { bigint: true }))) return null;
读取本地文件
lib/bin.js:788
if (manifestPath !== filename && !sameManifestFile(opened, await lstat(manifestPath, { bigint: true }))) return null;
读取本地文件
lib/bin.js:899
const info = await lstat(path);
发起网络请求
lib/bin.js:1574
return await fetch(input, init);
发起网络请求
lib/bin.js:1624
response = await fetch(TOKEN_URL, {
发起网络请求
lib/bin.js:6646
async fetch(request, signal) {
发起网络请求
lib/bin.js:6650
}).fetch(request, signal);
执行外部命令来自配置/变量
lib/bin.js:7761
const child = spawn(command.file, command.args, {

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/cordis-plugin-include@deepseek-ai/cordis-plugin-loader@deepseek-ai/dsh-agent@deepseek-ai/dsh-agent-default-model@deepseek-ai/dsh-agent-loop@deepseek-ai/dsh-api-gateway@deepseek-ai/dsh-api-remotes@deepseek-ai/dsh-api-session-controller@deepseek-ai/dsh-atomic-write@deepseek-ai/dsh-attachment

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

2 张 · 点击查看大图

功能亮点

图像生成
接入与兼容维护

用 ChatGPT OAuth 在 DeepSeek Harness 里调用 openai-codex 模型和图像生成。

README

由 DeepSeek 最新模型翻译生成

Codex Connect 当前开发遵循核心维护范围：保留接入、兼容、诊断与恢复，冻结 Task 自动编排及未证明收益的优化。此决定不会删除已发布选项，也不会远程停用已有安装。通过 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 11： 0.2.0-alpha.11 交付 GPT-6.1 Terra、统一速度菜单、精确 DSH rc.4／rc.5、seeded fork 原图及 bili 原生压缩预检，并抬高直接 Undici 最低版本。

展开完整文档（README 剩余 1 节）

Codex Connect

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

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

| 要求 | 已验证组合 |
| Codex Connect | 0.2.0-alpha.11 |
| 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（包版本必须一致） |
| 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-10-31，npm alpha 指向 0.2.0-alpha.11，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.11
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；关闭后恢复之前的路由。 |
| Luna Reserve | enableReserveFallback | 只在服务端为当前已固定账户明确授权时使用隐藏的 Reserve 路由；不修改全局默认模型，也不因普通 429 重试。 |
| 图片查看 | enableImageTool | 为视觉模型添加 view_image，读取本地文件和经过校验的公网 HTTP(S) 图片。 |
| GPT Image 图片生成与编辑 | enableImageGeneration | 根据提示词生图，或编辑明确选定的会话图片并使用有顺序的参考图；可用性、尺寸和额度仍由账户及服务端控制。同时作为跨路由图片句柄桥接的开关：在非 Codex 路由上把 Codex Connect 图片选择句柄持久化到图片工具结果中，使图片编辑在这些路由上同样可用；openai-codex 路由会跳过，因为其适配器已在每次请求时注入相同句柄。可选 imageHandleBridgeTools 可将桥接限定到指定工具。 |
| 自动审查 | enableAutoReview | 将有界的审批上下文、工具参数、工作目录和待执行动作发送到 chatgpt.com，首次启用需要确认。失败时交还人工审批。 |

已发布的实验功能： Alpha 4.35 包含 Luna Reserve 回退，仍默认关闭。真实账户进入 Reserve 及恢复普通模型的过程仍未验证；Alpha 4.34 不包含该功能。

启用 enableReserveFallback: true 后，账户 UI 和 agent 路由共用一份绑定身份的额度状态，最近有使用需求时按服务端返回的额度窗口后台刷新；有效状态可跨 agent step 复用。普通额度读取也共用缓存，即使 Reserve 已关闭。只有身份完整、非 FedRAMP 且服务端授权时，插件才进入 gpt-reserve；普通额度确认恢复后，切回该会话先前的模型和推理强度。Reserve 有自己的额度，不出现在模型选择器中，也不是无限额度。资格由服务端决定，重置时间本身不授权切换。当前版本只支持已知的 gpt-5.6-luna 元数据。刷新、身份和验证限制见 Luna Reserve 回退。

使用你当前 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 范围。来源、范围及合成验证；真实账户可用性尚未验证。