NOirBRight/dsh-llm-codex

dsh-llm-codex

DeepSeek Harness 的 ChatGPT Codex 集成。独立提供方路由是 codex，设置命名空间是 llm-codex。不声明 apiKeyEnv，不读写 ~/.codex/auth.json，也不和 dsh-codex-connect 共用凭据文件。

包根导出 Cordis 插件契约。同一产物还导出 ./client，在「设置 → LLM 供应商」里贡献 Codex 卡片。

兼容性

宿主 @deepseek-ai/dsh- 不锁定发行号：peer 为  且 optional。devDependencies 钉编译目标（0.1.5-rc.1）。Cordis 保持 >=4.0.2 k 或 -m（例如 gpt-5.6-sol-272k 或 gpt-5.6-sol-272k-fast）。插件在发给 ChatGPT 前剥掉该后缀，并用 n×1000 / n×1,000,000 作为 DSH 压缩预算，所以 272K 行会比 1M 行更早开始压缩。kimi-k3-max 这类产品名不算档位。Composer picker 按剥后缀后的 base 把兄弟行收成一个家族。

思考等级默认按模型设置，并可在行上改：Luna 用 max，Terra 用 xhigh，Sol 用 high，其他官方 Codex 模型用 xhigh。Fast / 1M 行沿用基础型号；会话中用户手动选择的等级优先。

聊天走 pi-ai openai-codex-responses，目标是 https://chatgpt.com/backend-api。未登录聊天会失败为 MISSING_CREDENTIAL。已存会话刷新失败则报 AUTH。之后若在没有任何模型内容前收到 AUTH（HTTP 401），会强制 refresh 再打一次请求；仍失败的 AUTH 进入 bundle 默认的八次 normal 重试。

Model Switch 集成

安装 dsh-model-switch v0.2+ 后，Codex 会注册复用本插件认证客户端的 Search 与 Image Adapter。Model Switch 保留官方 web_search 所有权，也不改变 view_image / codex_generate_image；不会注册 Vision Adapter。

可选能力

搜索、view_image 和 codex_generate_image 都实现了，但默认关闭。勾选后点保存会立刻注册或卸载，无需重启。打开搜索会注册独立的 Codex WebSearchProvider（POST /codex/alpha/search）。不会写入 web.searchProvider 或 agent-default-model。搜索模型是官方非 Fast 模型的下拉框，默认 gpt-5.6-luna。本插件还会注册 web/openai-codex-search-llm-request，以便卸载 dsh-codex-connect 后仍能打开它写下的会话日志。搜索模式与官方 Codex 一致：

- cached（默认）：只用 OpenAI 维护的索引，不抓当前页面
- indexed：仅当搜索索引放行时才 live fetch
- live：无限制实时抓取

view_image 是模型调用的工具，可读本地文件和公网 HTTP(S) 图片。Spark 只有文本。

codex_generate_image 是另一个模型调用工具。任意会话模型都能调用；它使用本插件的 ChatGPT 登录和 Codex 额度（大约是普通一轮的 3–5 倍），后端用 gpt-image-2 画画。路由模型下拉列出官方视觉模型，默认 gpt-5.6-luna。工具名故意不是 generate_image，以免和其它供应商插件撞名。生成文件默认写到 generated-images/，也可用 path 指定。

可选的 Codex 搜索与 view_image 能力

可选的 Codex 搜索与 view_image 能力

配置

~~~yaml
- id: llm-codex
name: 'dsh-llm-codex'
config:
enableSearch: false
enableImageTool: false
enableImageGeneration: false
streamIdleTimeoutMs: 300000
retryPolicy:
mode: normal
maxRetries: 8
backoff:
initialDelayMs: 500
maxDelayMs: 10000
jitterRatio: 0.1
~~~

bundle 默认对符合条件的模型请求失败最多重试八次，包括 AUTH。除消息过大 1009 外，带 code/reason 的 ChatGPT WebSocket 关闭、连接上限和过载响应使用可重试的 DSH failure code。含义不明确的 usage limit 仍不可重试。

没有 apiKeyEnv，也没有用户可改的 base URL。models 是显示在对话选择器里的目录。

许可证

MIT

LLM Providers UI ownership

LLM 供应商设置页（settings.section id: providers 及子槽 settings.provider.item）与共享的 llm-providers 排序存储完全由 dsh-llm-providers-ui 拥有。

- 本插件仅贡献自己的卡片（key: llm-codex）和 Host 上的 llm 路由；不安装页面或共享命名空间。加载顺序不影响归属。
- 未安装 owner 时（Headless 或 Web 未装 dsh-llm-providers-ui）：Host 侧模型路由 codex 仍可工作；Web 侧由 owner 决定 Providers 页面与本卡片是否挂载。正式 Web 发版的组合测试会拒绝缺少 owner 的图。
- 导航地球图标为 Alpha.4 临时 DOM 适配器，仅由 dsh-llm-providers-ui 持有；本插件不含该适配。

请在 profile 中与 provider 插件一起显式安装 dsh-llm-providers-ui（见其 cordis.patch.yml）。

正式版安装（Latest）

ChatGPT Codex login, model catalog, usage, and optional search/image capabilities. 正式成品按上方兼容性记录运行；发布包只包含构建后的 Host/Client 产物，不包含兄弟仓库源码、本机路径或 link:/workspace: 依赖。

LLM Providers 页面、导航和共享排序由 dsh-llm-providers-ui 独占；本插件只提供卡片、模型和 Host 路由。Web 必须先装 Owner，headless 只使用 Host 路由时可以不装 Owner。

Latest（Owner + 本插件；Web 必须一起装）：

~~~sh
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-llm-providers-ui/releases/latest/download/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-llm-codex/releases/latest/download/dsh-llm-codex-0.3.20.tgz
~~~

固定版本（可复现）：

~~~sh
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.9/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-llm-codex/releases/download/v0.3.20/dsh-llm-codex-0.3.20.tgz
~~~

更新、卸载与验证：

~~~sh
更新 Owner + 本插件到 Latest
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-llm-providers-ui/releases/latest/download/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-llm-codex/releases/latest/download/dsh-llm-codex-0.3.20.tgz
验证加载与版本
dsh plugin --profile web list
dsh plugin --profile web doctor
只卸载本插件
dsh plugin --profile web remove dsh-llm-codex
~~~

配置入口：Web 使用「设置」中的本插件页面；Host-only 插件使用 profile 的 dsh.profile.bundles 配置。先复制本 README 的最小 YAML/JSON 示例，再填写凭据或后端地址。

回滚：重新执行固定版本 v0.3.20 命令，确认插件列表后只重启一次 Web 服务。失败时查看 journalctl --user -u dsh-web.service 与 dsh plugin --profile web doctor，不要把源码 checkout 写入 production profile。

Release 与完整性：v0.3.20 · SHA256SUMS。

独立 Model Switch 搜索

0.3.14 起，Host adapter 通过既有 Model Switch adapter registry 自声明当前搜索模型目录（tools !== false）：展示名 Codex 加实时可序列化 models 列表（{id, name}），跟随当前 provider 设置。搜索沿用既有 ChatGPT 凭据存储与 Codex 搜索实现；凭据与可执行函数不发送到浏览器。不支持的模型与缺失的凭据会显式失败。

读取该元数据的协同搜索 UI 需要 Model Switch 0.4.7（协同发布，尚未发布）；dsh-model-switch peer 范围（^0.4.5）不变，旧版本会忽略新增字段。注册不改变全局 Web 路由：保留完整既有 Web 配置并显式设置 web.searchProvider: model-switch，再在 Model Switch 设置中选择 adapter/模型。web_fetch 不变。ProviderDirectory 角色/用量注册仍通过 ctx.inject 延迟注册。

验证：pnpm run check、pnpm run build；3082 官方 Web 选择 gpt-5.6-luna 的 live 验收通过。lab 组成与证据见 Model Switch 集成审计。