wss534857356/dsh-plugin-codex

dsh-llm-codex-app-server

dsh-llm-codex-app-server 注册一个由本地登录的 Codex App Server 驱动的 DeepSeek Harness 主模型提供方。它是独立于 Harness 主仓库的组合包，因此安装时不会修改 deepseek-harness 仓库。

它与 Harness 内置的 @deepseek-ai/dsh-subagent-codex 不同。内置包将 Codex 暴露为接受委派的子 agent；本包注册到 ctx.llm，因此 Harness Agent loop 可以选择 codex-local 作为模型提供方。

截图

会话界面

模型选择器

Codex App Server 设置卡片

CDP 截图日志与验证详情

工作方式

在有界缓存租约有效期间，普通 Harness 会话会复用一个固定版本为 @openai/codex@0.154.0、运行于私有空目录中的 App Server 进程和一个临时线程。该进程使用 CODEX_HOME 下的原生 Codex 账户状态；插件不会读取、复制、记录或保存 OAuth token 与 API key。没有 Session ID 的请求和辅助请求仍使用一次性进程。

适配器将 Harness 系统文本作为 App Server 的基础指令，通过在空 turn 开始前注入全部已记录的 Harness 消息来重建冷启动线程，在 App Server 的 deepseek_harness 命名空间下声明 Harness 工具，并通过原生 turn input 发送后续普通用户消息。当一个 DSH step 追加多条 inbox 消息时，第一条启动 turn，其余消息通过有序的 turn/steer 请求进入同一 turn。外层 Harness 的 skill 工具在该命名空间内映射为 harness_skill；其参数 schema 只接受当前 Harness Session 目录中的名称，而 Codex 原生 skill 仍由 Codex 自己的 loader 管理。只有完整请求是适配器可重现的仅追加续接时才会复用热线程，否则会丢弃并重建线程。App Server 仍会加入 Codex 自有的指令和工具。这是有意设计的分层提供方，不是原始模型传输层，也不声称 Harness 取代了 Codex prompt。

推理、Assistant 文本、用量、Codex 自有上下文、诊断信息和动作生命周期会在到达时转换为 Harness 流事件。Codex 缓存输入通过 Harness 的 cacheReadTokens 上报，因此标准 token 计量器和会话统计无需提供方专用 UI 即可显示缓存命中率。每个 codex-action 块都包含 category（lifecycle、context、action 或 diagnostic）、解析后的 phase、准确的 protocolEvent 以及对应的 JSON 协议快照。即使 App Server 没有发出对应的 ThreadItem，原始 Code Mode 调用及其结果也会保留。Codex 原生动作失败或被拒绝仍属于动作结果；除非 App Server 报告整个 turn 失败，否则不会导致 Harness 模型请求失败。

Harness 用户图片和含图片的工具结果在消息、重放与缓存身份中始终保留为持久 ImageAttachmentRef。只有即将跨越 App Server 边界时，适配器才会验证保留的附件，并临时转换为对应协议形态：冷启动重建使用 Responses input_image，热用户 turn 使用 v2 image，待处理动态工具 callback 使用 inputImage。若预计的 base64 图片负载超过 maxRequestImageBytes，最旧的模型可见图片会被确定性省略文本替代，而且不会读取其字节。Codex 原生图片输出沿反方向处理：先解码并通过 Harness 附件服务持久提交，再发布标准 Harness image 块，同时把轨迹和重放中的字节替换为小型持久标记。任何 data URL 都不会持久化。聊天附件不等于隐式修改工作区：要生成 public/example.png 或其他项目文件，Codex 仍须为明确的目标路径请求已声明的 Harness 修改工具。

本包还包含浏览器插件。它以较低的 slot 优先级覆盖默认 Assistant 单元格，保留标准文本、推理、图片和通用回退展示，并使用 Harness 的紧凑 disclosure row 与状态点渲染 codex-action 块。图片组会委托给当前的 conversation.message.images slot；标准 Web profile 已组合其 ui-attachment owner，自定义 host 则须像默认 Assistant 渲染器一样组合该展示插件。折叠行显示解析后的动作、类别和阶段；展开后显示摘要、准确的协议事件、动作 ID，以及 Harness JSON tree 中的持久 JSON 记录。thread/start 会明确报告分层 prompt 所有权和发现的指令来源数量；它不会被标记为 Harness 工具或请求失败。浏览器插件还通过 DSH 原生 settings.plugin.item 扩展点贡献 Codex App Server 设置卡片，不修改 Models 或 Settings 核心包。

thread/start 块用于披露提供方生命周期，并不表示模型执行了原生动作。由 Codex 添加、且不属于注入的 Harness 历史记录的 developer、system 和 user 消息会显示为 context/injected 报告。它们会被记录以供审计，但不会在下一个无状态请求中作为 Harness 编写的历史内容再次提交。

当 App Server 请求 deepseek_harness 命名空间内的已声明工具时，适配器会发出真正的 Harness tool-call，结束当前模型 step，并保持 App Server callback 待处理。命名空间和映射后的名称必须同时匹配，调用才能进入 Harness；harness_skill 还必须准确匹配当前 Harness 目录中的名称，并且只有验证后才会映射回 skill。即使未带命名空间的 Codex 原生调用名称与 Harness 工具相似，它仍属于提供方轨迹；只有经过验证、带 Harness 命名空间的调用才不会显示为原生动作。Harness 负责这些调用的执行、审批、展示和持久记录。后续仅追加请求会先用已记录的工具结果回复待处理 callback，再把后续 inbox 消息按顺序 steer 进 active turn，并继续同一个 Codex turn；replacement 或其他非前缀历史变化会触发冷启动重建。

辅助工作跟随发起 Agent 的 provider，不会暗中切换账户。compaction-basic 未显式指定摘要路由时，会通过一次性进程使用当前选中的 Codex 模型，并且只有自然完成的文本才会成为持久 Harness checkpoint。Codex Agent 的 web_search 会在配置的 Web provider 之前被条件接管：每个 query 都在独立的一次性 App Server 进程中执行原生实时搜索，URL citation 再经原有 Harness 工具输出约定投影；非 Codex Agent 则原样委托给既有 provider chain。搜索不能复用主进程，因为该线程正在等待 Harness 工具结果。

安装

此版本面向 DSH >=0.1.5-rc.1 .tgz
dsh --profile web --dump-config
dsh --profile web

该组合包注册 codex-local 提供方，以及固定版本 App Server 默认模型选择器中的所有模型：gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5 和 gpt-5.3-codex-spark。请在 Models UI 中选择模型。安装不会自动替换 profile 的默认模型。标记为隐藏的 App Server 路由不会加入选择器。

Harness profile 设置了 autoInstallPeers: false，因此安装时可能报告缺少 peer dependency。启动时，profile 的模块回退机制会从当前 Harness 安装中提供这些 peer，使插件共享相同的 Cordis 和服务实例。

若要从源码安装：
sh
dsh plugin --profile web add github:wss534857356/dsh-plugin-codex

可追加 # 固定版本。通过 Git 安装时，包的 prepare 脚本会构建 TypeScript，因此 pnpm 必须允许该包执行构建。已打包的 tarball 或 npm release 已经完成构建。

从 profile 中移除该组合包：
sh
dsh plugin --profile web remove dsh-llm-codex-app-server

配置

在 Web UI 打开“设置 → 插件 → 插件配置”，展开 Codex App Server 卡片即可修改 image generation、Codex Web Search 接管、搜索默认模型和最大结果数。卡片使用 DSH 的 llm-codex-app-server settings 命名空间，保存后直接写入 DSH 用户设置层；下一次调用即生效，涉及进程能力的变化会通过请求 epoch 自动淘汰旧缓存线程。

后续 profile 补丁层可以替换 llm-codex-app-server 配置项。Harness 补丁配置项不会深度合并，因此替换时必须重新写出完整配置。

| 配置键 | 默认值 | 说明 |
|---|---:|---|
| provider | codex-local | Harness 提供方路由。 |
| displayName | Codex (local login) | 选择器标签。 |
| modelProvider | openai | Codex App Server 的模型提供方 ID。 |
| models | 6 个可见的 App Server 目录项 | 建议模型元数据、输入模态和推理选项。内置快照中的 5 个路由声明图片输入，Spark 仅文本；省略模态的自定义模型默认仅文本。未列出但符合安全格式的模型 ID 仍可按仅文本路由。 |
| timeoutMs | 300000 | 单个 App Server turn 的实际运行时间上限。 |
| disposeGraceMs | 3000 | 终止进程树时的宽限时间。 |
| maxJsonRpcLineBytes | 8388608 | 从 App Server stdout 接受的单条换行分隔 JSON-RPC 消息最大字节数。成功解析的消息不会累计到 stdout 总量限制中。 |
| maxRequestImageBytes | 20971520 | 单次模型请求允许临时恢复的预计 base64 图片负载上限；超限时优先把最旧的模型可见图片替换为确定性省略文本。 |
| maxStderrBytes | 65536 | 保留诊断输出的最大字节数。 |
| maxRetries | 1 | Harness 可见的临时进程或提供方错误重试次数。模型满载时等待 5 分钟，再以原模型重试，不静默切换路由。 |
| maxCachedSessions | 8 | 按最近最少使用策略驱逐前，可保留的最大空闲或等待工具结果的 Session 租约数。活跃请求可能暂时超过该值。 |
| sessionIdleTimeoutMs | 600000 | 已缓存 App Server Session 线程的空闲存活时间。 |
| imageGenerationEnabled | true | 普通模型 turn 是否为固定版本 App Server 开启原生 image generation。压缩 turn 始终关闭。 |
| webSearchEnabled | true | 是否条件接管由本 Codex provider 发起的 web_search；关闭后继续交给原 DSH Web provider chain。 |
| webSearchModel | 跟随主模型 | 插件拥有的搜索专用模型覆盖；留空时使用发起调用的 Codex 主模型。Codex 官方配置没有独立的 Web Search 模型键。 |
| webSearchMaxResults | 8 | 合并条件接管的 Codex 原生搜索后所保留的 source 上限。 |
| env | {} | 叠加到经 Harness 清理的父进程环境之上的显式子进程环境。CODEX_HOME 不在标准位置时，请通过此项传入。 |

覆盖配置示例：
yaml
- id: llm-codex-app-server
name: dsh-llm-codex-app-server
config:
provider: codex-local
displayName: Codex (local login)
modelProvider: openai
models:
- id: gpt-6-astra
name: GPT-6-Astra
contextWindow: 272000
inputModalities: [text, image]
reasoningEfforts: [low, medium, high, xhigh, max, ultra]
defaultReasoningEffort: medium
timeoutMs: 600000
disposeGraceMs: 3000
maxJsonRpcLineBytes: 8388608
maxRequestImageBytes: 20971520
maxStderrBytes: 65536
maxRetries: 1
maxCachedSessions: 8
sessionIdleTimeoutMs: 600000
imageGenerationEnabled: true
webSearchEnabled: true
webSearchModel: gpt-5.6-luna
webSearchMaxResults: 8
env:
CODEX_HOME: !!js process.env.CODEX_HOME

兼容性与限制

- 协议基线为 Codex CLI 0.154.0；由于实验性 App Server 协议对版本敏感，依赖和运行时握手均固定到该版本。
- App Server 默认使用 ~/.codex，也可通过 CODEX_HOME 指定目录。它以 --strict-config 启动，所选目录中须使用 Codex 0.154.0 接受的配置键。启动前移除旧的顶层 network_access = "enabled" 行；danger-full-access 本身允许联网，workspace-write 则支持 [sandbox_workspace_write] 下的布尔值 network_access。
- 静态目录保留本机 Codex 元数据中的上下文窗口：GPT-6 Astra、GPT-5.6 Sol/Terra/Luna 和 GPT-5.5 为 272000，GPT-5.3 Codex Spark 为 128000。Codex 0.154.0 的 model/list 响应不提供 contextWindow 字段，因此这些值仍是可覆盖的显式部署元数据。由提供方确认的上下文溢出仍可触发 Harness 压缩和重试。
- 默认模型目录是 2026-09-12 使用 App Server 0.154.0 观测到的 model/list 快照：GPT-6 Astra、GPT-5.6 Sol/Terra/Luna 和 GPT-5.5 声明文本+图片输入，GPT-5.3 Codex Spark 仅文本。服务端/账户目录可独立变化，因此每次升级 Codex 都必须重新探测。未声明 inputModalities 的自定义条目和未列出的模型 ID 仍按仅文本处理。
- Codex 共同拥有模型可见指令和工具目录。无需密钥的协议测试记录了在应用受支持的线程覆盖配置后仍然存在的额外权限、主 agent、协作、环境、交互和 Code Mode 层。
- Code Mode 保持启用，因为 gpt-5.6-sol 使用它分派 App Server 动态工具。原生图片查看保持启用；普通 turn 的 image generation 默认启用，但可在插件设置卡片关闭，压缩和搜索进程则始终关闭。该 image generation 开关属于固定 App Server 0.154.0 的能力标志，并非 Codex 官方配置中承诺稳定的顶层键。其他无关的可选原生集成保持禁用。
- 图片输入、含图片的工具结果和原生生成图片都需要 profile 提供持久 ctx.attachments 服务。图片字节受该服务的媒体类型、单图字节数、数量、总字节数、像素和单边尺寸限制约束，绝不会以内联形式存入消息、codex-action 块或重放状态。
- Codex 原生动作仍可能发生。它们运行在私有空工作目录中，沙箱模式遵循 Codex 的有效配置，审批策略设为 never；其生命周期快照显示为提供方轨迹。除非协议可以在不使用用户权限的情况下回答，否则审批或交互请求会被安全拒绝。
- thread/start 生命周期报告会显示发现的指令来源。非空报告属于信息披露，并不代表请求失败。不在该列表中的 Codex 生成上下文会单独显示为 context/injected。
- 明确声明 image 的模型接受有序的纯图片或文本/图片混合用户提示，以及含图片的 Harness 工具结果。仅文本、不可用、未声明模态的自定义模型和未列出的路由会在进程启动前拒绝图片历史。
- App Server 0.154.0 没有公开可靠的对应选项，因此会拒绝 temperature 和 stop；普通请求与 Session 标题请求同样拒绝 maxTokens。只有 purpose: compaction 会把它接受为 Harness 的建议预算，移除实时工具声明，并等待 Codex 摘要自然完成；App Server 无法强制执行该数值上限。
- App Server 自动压缩阈值仍设为 Harness 的安全整数上限，使持久 Harness 摘要优先替换已记录历史。任何原生压缩 item 或通知仍会使实时租约不可复用，并且绝不会写入可重建的重放状态。不要设置 compaction-basic.summarizationProvider 与 summarizationModel，即可跟随 Agent 当前选择的 Codex 路由。
- Codex 发起的 web_search 会在隔离的一次性进程中使用 Codex 原生实时搜索，并且只返回可引用的 HTTP(S) source。默认跟随发起 Agent 的模型，也可由卡片设置插件自己的搜索模型覆盖；关闭接管或遇到非 Codex Agent 时，around-dispatch listener 会原样调用 next()，因此安装本组合包既不会移除也不会复制原有 Web provider 实现。
- CODEX_INTERNAL_ORIGINATOR_OVERRIDE=deepseek-harness 用于标识适配器请求；升级 Codex 时会重新验证这一内部兼容点。
- Session 级线程属于内存中的可丢弃缓存。进程重启、插件重载、过期、驱逐、压缩、fork、修复、重试不匹配或请求 epoch 发生任何变化后，Harness 日志与适配器重放状态会重建模型可见历史；不会恢复 Codex rollout 文件。
- Harness rc.8 会把适配器重放放在 ReplayEnvelope.response 中；插件仍兼容 envelope 之前的版本 4 Session。重放状态版本 4 的 items 只包含提供方输出；观测到的 Codex 自有上下文单独保存在 contextItems 中供审计，绝不会重新注入。用户、工具和生成图片负载都使用持久附件标记。冷启动重建会恢复仍保留的模型可见标记；热续接只恢复新增用户消息或工具结果的内容。Harness 调用仍保留 deepseek_harness 命名空间和映射后的 App Server 名称。重建逻辑按稳定的提供方 item 或调用标识合并累积快照，丢弃新进程无法恢复的未配对 Code Mode custom call/output，更旧的重放版本则回退到 Harness 消息重建。
- 身份验证和订阅可用性由原生 Codex 安装负责。登录失败会显示为 Harness AUTH 错误；本插件不提供凭据 UI。

开发

跨平台 CI 矩阵、npm 包内容校验、首次发布引导、trusted publisher 配置及版本 tag 流程见构建与发布。

ADR 0001 根据 提供方调查 捕获的出站请求中 Codex 自有指令与工具，否决了原始传输层方案。ADR 0002 接受当前实现的所有权划分。ADR 0003 记录原始动作、提供方上下文、重放和 Harness 工具调用如何保持相互独立。ADR 0004 记录独立组合包使用的客户端渲染器覆盖层。ADR 0005 按提供方标识约束冷启动重放重建。ADR 0006 定义精确的 Session 续接和可丢弃缓存所有权。ADR 0007 将 App Server 命名空间定义为工具所有权标签。ADR 0008 保留 Codex 图片 skill 所需的原生图片工具。ADR 0009 记录持久生成图片投影。ADR 0010 定义基于标记的图片输入、有界恢复与真实模态声明。ADR 0011 规定 compaction 与 web search 跟随发起 Codex 路由，同时不改变非 Codex 工具执行。
sh
pnpm run typecheck
pnpm run test
pnpm run build
pnpm pack --pack-destination dist

单元测试和协议测试无需账户。完成 codex login 后，可运行真实的本地登录往返测试：
sh
pnpm run test:e2e

真实测试会加载 Harness LLM 和本地 subprocess 提供方，在同一个已缓存 App Server 线程上完成 Harness 工具往返、普通后续请求和持久图片输入 turn；它会记录提供方缓存证据但不依赖非确定性的缓存计量，并验证插件 dispose 后进程树已完全退出。