dsh-codex-auth

当前 npm 版本：v0.3.0

这是一个自包含的 DeepSeek Harness Codex 能力包。它复用官方 Codex CLI 维护的 ChatGPT 登录态（~/.codex/auth.json，或 $CODEX_HOME/auth.json），同时提供：

openai-codex LLM 路由；
接入 DSH 内置 web_search 工具的全局 Codex 搜索提供方；
通过 generate_image 实现持久图片生成与编辑，并提供供模型使用的 list_images 目录；
稳健的 Codex 周用量状态；
一个原生 GPT Auth 设置分区，内含「登录」「LLM 上下文」「网页搜索」「图片创作」四张卡片；搜索与图片的详细设置可收起为紧凑卡片。

⚠️ 非官方通道——仅限个人开发。 私有、受账户权限控制的 chatgpt.com/backend-api 未获官方支持、可随时撤销，也可能在没有通知的情况下被限流或变更。请勿依赖它承载生产任务。

功能

共享 Codex 登录态

LLM、搜索与图片操作共用一个仅运行于 Host 的认证协调器。
通过绑定文件版本的认证快照、短时内存缓存解析凭证，并在到期前主动刷新。
进程内合并并发刷新；OAuth 网络请求前后各使用一段短跨进程锁，且只有账户与 refresh token 谱系仍和决策快照一致时才写入响应。
可启动官方 codex login 浏览器登录或设备码登录流程。
设置页显示连接状态，以及尽力获取的周剩余额度和重置时间。固定的 /backend-api/wham/usage 探测有 10 秒 Host 截止时间，并按窗口时长识别七天窗口。
插件自有、仅允许 loopback 的 /codex-auth Connection RPC 不会向浏览器发送任何 token 值。

GPT-5.6 长上下文

GPT Auth 设置在登录卡片与能力卡片之间提供实时生效、默认关闭的 1M 上下文开关。它会把 gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra 向 DSH 报告的上下文窗口从保守的 272,000 Token 提升到 1,000,000 Token。DSH 会据此计算 Token 压力和压缩时机；插件不会在请求里发送用于和后端协商容量的参数。超过 272K 的请求可能更快消耗账户配额，后端是否支持仍取决于账户，而且启用开关不会展开 DSH 已经压缩的历史。

网页搜索

codex-search Host 行通过 @deepseek-ai/dsh-web 注册 ID 为 codex 的提供方。 bundle patch 会将它选为部署全局搜索提供方；用户后续 profile patch 仍可覆盖该选择。每次搜索向官方独立搜索端点发起请求：

https://chatgpt.com/backend-api/codex/alpha/search

若调用方是 openai-codex Agent，搜索会使用该 Agent 的当前模型；其他 provider 或无法解析调用方时使用设置中的备用模型。结果只包含后端生成的输出，以及从已识别字段中提取、去重并验证过的 HTTP(S) 来源；不会编造标题、日期、摘要，也不会继续抓取网页。

网络错误与 HTTP 5xx 使用可取消的指数退避，最多尝试五次；HTTP 429 立即返回。

可实时生效的搜索设置：

设置	默认值	可选值
启用	`true`	开 / 关
模式	`live`	`live`、`cached`、`indexed`
上下文大小	`medium`	`low`、`medium`、`high`
备用模型	`gpt-5.4`	Codex 模型 ID
最大输出 Token	`2048`	正整数

图片创作

generate_image 对模型呈现为单一操作，并按有无参考图分发到官方 Codex 图片端点：

POST https://chatgpt.com/backend-api/codex/images/generations
POST https://chatgpt.com/backend-api/codex/images/edits

参数包括必填 prompt、最多五个显式参考图、1–10 张输出、受支持的尺寸/质量/背景选项，以及可选模型覆盖。参考图必须明确区分来源：

{ "kind": "session", "handle": "image:<attachmentId>" }
{ "kind": "workspace", "path": "assets/reference.png" }

Session handle 只有在当前会话历史中的持久 ImageBlock 已授权对应附件时才可解析。工作区读取必须留在当前 workspace 内，通过 ctx.fs 执行，并在远程请求前提升到附件存储。不接受 HTTP(S) 参考图 URL。

后端返回的 base64 会经过编码大小限制、解码、文件签名检查、部署媒体策略验证，并通过 ctx.attachments.saveImage(...) 持久保存。多图响应会保留有效图片，并为缺失或无效条目返回结构化 warning；只有一张有效图片都没有或响应 envelope 不可用时，整次调用才失败。图片请求一旦发出便不会自动重试。

list_images 按最新优先分页列出当前会话的持久图片（默认 5 张、最多 10 张），支持不透明 cursor 和来源筛选，同时返回稳定 Image Handle 与真实 ImageBlock，使支持图片的模型在压缩上下文后仍能查看旧图片。

图片工具只注册到使用 openai-codex 且明确声明支持图片输入的 Agent scope；执行时会再次校验相同的路由、模型、登录态和套餐条件。若本地明确识别为 Free 套餐，会标记为不可用；套餐未知时仍允许尝试，以后端结果为准。

可实时生效的图片设置：

设置	默认值	可选值
启用	`true`	开 / 关
图片模型	`gpt-image-2`	图片模型 ID
图片数量	`1`	1–10
尺寸	`auto`	`auto`、`1024x1024`、`1536x1024`、`1024x1536`
质量	`auto`	`auto`、`low`、`medium`、`high`
背景	`auto`	`auto`、`opaque`、`transparent`

成功的 generate_image 结果只展示 DSH 标准图片画廊；list_images 是供模型使用的目录状态，不提供面向用户的结果视图。插件通过公开的会话授权附件 API 读取图片，使用有界 Blob URL 缓存，并在连接重置、淘汰和插件卸载时回收自身 URL。生成图会作为对话附件持久保存。 DeepSeek Harness 0.1.1-rc.1 尚未提供二进制工作区写入 API，因此界面不提供工作区导出操作；插件也不会通过 Node 文件系统绕过 DSH 的文件策略。

ACP 图片互操作

历史背景：DSH rc.7 引入了这里使用的 ACP 图片路径；当时如果当前 openai-codex 模型明确声明支持图片输入，ACP 客户端可以发送 PNG、JPEG、WebP 或 GIF 内联图片。DSH 会在用户消息入队前完成校验和持久化，因此这些图片会作为普通的 user 图片进入本插件的图片目录，之后可通过 Image Handle 选作 generate_image 参考图。

历史背景：rc.7 的 ACP 桥接只发送已经提交到 assistant/message 的文本和图片块。generate_image 生成的图片仍位于 tool/result 内，因此 ACP 客户端不会直接收到这些生成图的二进制内容；除非后续 assistant 消息自身包含 ImageBlock。

环境要求

DeepSeek Harness 0.1.1-rc.1 或兼容的后续 0.1.x 版本。
Node.js ^22.19.0 或 >=24.0.0。
codex CLI 已加入 PATH。
可提前执行 codex login，也可在 GPT Auth 卡片中启动登录。

最低兼容版本为 0.1.1-rc.1（见上方环境要求）。历史背景：rc.7 是第一个完整的 Web 设置功能基线，当时 Host 会把插件注册的 codex-search、codex-image 设置 namespace 暴露给浏览器；原版 rc.6 虽然能够注册 GPT Auth 分区，但这两个实时设置 scope 无法通过远程接口读取或写入。

从 npm 安装（推荐）

npm 包已包含预构建的 Host 与浏览器 bundle，不需要安装期构建权限：

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

重启 dsh web，打开设置并选择 GPT Auth。

安装预构建 Release

dsh plugin --profile web add https://github.com/suntianc/dsh-codex-auth/releases/download/v0.2.2/dsh-codex-auth-0.2.2.tgz

重启 dsh web，打开设置并选择 GPT Auth。

从 GitHub 源码安装

dsh plugin --profile web add github:suntianc/dsh-codex-auth

Git 依赖会通过包内 prepare 脚本从源码构建。pnpm 10+ 默认阻止该脚本，因此第一次安装可能打印 allowBuilds 键并停止。把 dsh 输出的完整键 加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 下，再重新执行安装。只应在审查并信任源码后授权。

需要可复现安装时，固定 release tag 或 commit：

dsh plugin --profile web add github:suntianc/dsh-codex-auth#v0.2.2

从 tarball 安装

git clone https://github.com/suntianc/dsh-codex-auth.git
cd dsh-codex-auth
pnpm install
pnpm pack
dsh plugin --profile web add ./dsh-codex-auth-0.3.0.tgz

升级

先停止正在运行的 dsh web，再将 Web Profile 更新到当前版本：

dsh plugin --profile web add [email protected]
dsh plugin --profile web list

列表显示 [email protected] 后，重新启动 dsh web 并刷新浏览器。

Host 配置

能力包 patch 按依赖顺序启用三条独立 Host 行：

行	Export	作用
`llm-codex-auth`	`dsh-codex-auth`	共享认证协调器与 LLM 路由
`codex-search`	`dsh-codex-auth/search`	全局搜索提供方
`codex-image`	`dsh-codex-auth/image`	Agent scope 图片工具

认证 / LLM 行字段全部可选。设置 llmEnabled: false 后仍保留供搜索/图片能力使用的共享登录状态协调器，但不再注册 LLM 路由：

字段	默认值	含义
`llmEnabled`	`true`	注册 `openai-codex` LLM 路由
`authJsonPath`	`''` → `$CODEX_HOME`/`~/.codex/auth.json`	Codex 登录文件
`credentialRef`	`CODEX_CHATGPT_TOKEN`	状态卡展示的非敏感引用
`refreshLeadMs`	`300000`	token 到期前的刷新提前量（毫秒）
`codexCommand`	`codex`	登录和版本探测使用的 CLI 命令
`displayName`	`OpenAI Codex (chatgpt)`	模型选择器中的 provider 名称
`longContextEnabled`	`false`	GPT-5.6 实时 1M 上下文策略的基础值；GPT Auth 设置可在 `codex-llm` namespace 覆盖它
`transport`	`sse`	流式传输方式：`sse`、`websocket` 或 `auto`（优先 WebSocket、失败回退 SSE）。默认 SSE：WebSocket 升级在常见 HTTP 代理下不稳定，且 `auto` 模式下每个新对话都要先付出连接超时才会回退
`websocketConnectTimeoutMs`	`5000`	WebSocket 连接超时（毫秒，仅当 `transport` 不是 `sse` 时生效；`0` 表示禁用）
`timeoutMs`	`120000`	请求超时（毫秒，SSE 响应头阶段；同时作为 WebSocket 消息空闲间隔；`0` 表示禁用）

不要再在 llm-pi-ai.providers 下添加 openai-codex，也不要同时安装 dsh-codex；重复路由所有权会得到明确诊断并被拒绝。

安全与限制

token 值不会进入浏览器、设置、日志、会话事件、工具 metadata、搜索参数或图片结果；只有 Host 侧请求会收到认证 header。
状态可包含本地解码的账户 ID 和套餐 claim；它们是身份/状态信息，不是凭证。
刷新写回会保留未知字段，并以仅属主可读写（0600）权限原子替换登录文件。
状态/登录 RPC 通道只接受 loopback authority。
图片附件 ID 不是 bearer capability；会话历史中必须存在对应的持久 ImageBlock。
若 Codex 只把凭证放在系统钥匙串，auth.json 可能没有可用 token。可在 ~/.codex/config.toml 设置 cli_auth_credentials_store = "file"，再执行 codex login。
在 DSH 提供受策略约束的二进制写入 API 之前，二进制 Workspace Export 暂不可用；对话附件持久化已经完整支持。

开发

pnpm install
pnpm run check

pnpm run build 生成：

lib/index.js：认证 / LLM Host 插件；
lib/search.js：搜索 Host 插件；
lib/image.js：图片 Host 插件；
lib/invariant.js：invariant companion；
lib/client.js：兼容 Loader、内联 CSS Modules 的浏览器插件；
lib/types/**：类型声明。

另见 docs/design.md、CONTEXT.md 与架构决策记录。

友情链接

L 站

dsh-codex-auth

Cài đặt

Mã nguồn

Thẻ

Readme

dsh-codex-auth

功能

共享 Codex 登录态

GPT-5.6 长上下文

网页搜索

图片创作

ACP 图片互操作

环境要求

从 npm 安装（推荐）

安装预构建 Release

从 GitHub 源码安装

从 tarball 安装

升级

Host 配置

安全与限制

开发

友情链接