Codex 订阅接入 softspark/dsh-codex

dsh-codex

License: Apache-2.0
DSH community plugin

@softspark/dsh-codex 将 DeepSeek Harness 连接到本地已认证的 Codex 应用服务器，提供程序 ID 为 codex。

版本 1.0.0 是首个公开发布版本。该插件不实现 OAuth、不读取 Codex 认证文件、不复制令牌、不直接调用 OpenAI Responses API，也不发送遥测数据。

这是一个由 SoftSpark 独立维护的社区集成。它是非官方的，与 OpenAI 或 DeepSeek 无关联，也未获得其认可。

新特性

候选版本 1.5.0 增加了对 DSH 0.1.2-rc.1 的兼容性，并防止较旧的会话权限覆盖较新的交互式或无效策略。DSH 0.1.1-rc.2 仍受支持。已发布的 1.4.0 需要较旧的 DSH 宿主；在 1.5.0 发布之前，请对新宿主使用本地候选 tarball。

当前的产物校验和运行时限制记录在 2026-09-06 验证 中。

历史验证

2026-08-26 的验证运行产生了以下证据：

- 131 项单元、协议、桥接和组合测试中 131 项通过。
- 覆盖率达到了 88.98% 的语句覆盖率、82% 的分支覆盖率和 91.32% 的行覆盖率。
- 一个实时应用服务器报告了认证类型 chatgpt 和七个模型。
- 一次直接的适配器回合返回了精确标记、结束原因 stop 以及令牌用量。
- 一个隔离的 DSH Web 配置文件以 HTTP 200 启动。
- DSH 加载了提供程序 codex，包含七个模型。
- 一个 DSH 会话在宿主重启后以相同的 Codex 线程 ID 存活，并且一次实时取消以 aborted 结束。
- 用户截图显示了 GPT-5.6-Sol 与 xhigh 推理。

这些结果仅描述最初的 1.0.0 验证。后续版本需要各自的源代码和已发布产物检查。

要求

- Node.js 22.19.0 或更高版本。
- 本仓库使用 npm。
- DSH 配置文件插件管理器可用的 pnpm。
- 一个能够启动 codex app-server 的本地 Codex CLI。
- 由 Codex CLI 管理的现有 Codex 登录。
- DeepSeek Harness 0.1.1-rc.2 或 0.1.2-rc.1，具有匹配的附件、LLM 和会话接缝以及 @deepseek-ai/cordis@4.0.2。

对于基于订阅的使用，codex login status 必须报告 ChatGPT。

构建并安装本地 tarball

git clone https://github.com/softspark/dsh-codex.git
cd dsh-codex

npm ci --ignore-scripts
npm run verify
npm run typecheck
npm run lint
npm run test:coverage
npm run build
npm run audit
npm run package:check

command -v pnpm
pnpm --version

PLUGIN_TGZ="$(npm pack --ignore-scripts --silent)"
dsh plugin --profile web add "file:$(pwd)/$PLUGIN_TGZ"

在修改常规配置文件之前，请使用隔离的 DSH_HOME 进行评估。
在 DSH 配置文件配置为 autoInstallPeers=false 的情况下，pnpm 对等依赖检查可能会报告缺少 @deepseek-ai/cordis 和 @deepseek-ai/dsh-llm。经验证的 DSH 宿主加载器会提供这些扩展接缝。除非未来的 DSH 版本在运行时失败且其兼容性说明要求安装，否则不要安装重复的对等依赖副本。

安装已发布的版本

将经过审查的确切版本安装到 DSH 配置文件中：

dsh plugin --profile web add @softspark/dsh-codex@1.4.0 --save-exact

此命令会为 DSH 0.1.1-rc.2 安装当前已发布的构件。1.5.0 候选版本必须在发布前从其本地 tarball 进行测试。安装后重启 DSH。

架构

DeepSeek Harness

| provider: codex
v
@softspark/dsh-codex

| validated JSON-RPC over JSONL stdio
v
local codex app-server

| Codex-owned auth, agent loop, built-in tools, thread state
v
ChatGPT subscription

该插件将 DSH 文本消息、模型选择、推理强度、流式传输、用量、取消和完成状态映射到稳定的 app-server 协议。Codex 负责身份验证和凭据存储。

配置

| 字段 | 默认值 | 说明 |
| provider | codex | 唯一接受的提供方路由。 |
| command | codex | 直接可执行文件名或路径。空值会失败。 |
| cwd | process.cwd() | Codex 线程的工作目录。 |
| sandbox | workspace-write | 也接受 read-only 和 danger-full-access。 |
| approvalPolicy | untrusted | 也接受 never 和 on-request。 |
| inheritSessionPermissions | false | 启用后，会应用显式的每会话 DSH 沙箱覆盖，并将 DSH 的 never 映射为 Codex 的 never，用于新启动或恢复的线程。缺失或交互式会话状态会保留静态回退值。 |
| allowApiKeyAuth | false | 为 true 时，允许使用已由 Codex 拥有的 API 密钥登录。插件永远不会收到该密钥。 |
| experimentalDynamicTools | false | 选择启用实验性 DSH 工具桥接和 app-server 实验性 API。 |
| dynamicToolTimeoutMs | 600000 | 将延迟的 DSH 工具调用限制在 1,000 到 3,600,000 毫秒之间。 |
| requestTimeoutMs | 30000 | 范围为 1,000 到 300,000 毫秒。 |
| turnTimeoutMs | 600000 | 范围为 1,000 到 3,600,000 毫秒。 |

参见配置参考。

工具边界

Codex app-server 内置工具在 Codex 内部运行，受所选 Codex 沙箱和审批策略约束。当 inheritSessionPermissions: true 时，新启动或恢复的线程仅读取匹配的 DSH Session 日志：显式的 Full 组合（danger-full-access 加 never）会变为相同的 Codex 组合，而缺失、格式错误或交互式审批状态则保留配置的回退值。
默认情况下，DSH 工具保持不可用，工具结果续接会以失败关闭方式处理。启用 experimentalDynamicTools: true 后，适配器会将当前 DSH 工具目录注册到 Codex，发出规范的 DSH 工具调用分块，让常规 DSH 代理循环执行该工具，然后将关联的文本结果返回到同一个 Codex 回合。桥接层从不直接执行 DSH 工具。

该可选启用的桥接层可承载文本和图像，有大小限制，不适用于临时会话，且不支持进程重启后的线程重放。无法承载的块会在文本中描述，而不是使该回合失败——当结果被校验时，它已经在转录记录中，因此拒绝一个结果会终止会话而非仅终止该调用。使用配套的 @softspark/dsh-orchestrator 包来注册由订阅支持的 Claude Code 和 Gemini ACP 委托工具。

安全边界

- App-server 作为直接子进程启动，使用 shell: false。
- JSON-RPC 输入不可信，并经过运行时校验。
- 类似凭据的值会从错误和诊断信息中脱敏。
- 该插件不添加遥测、远程日志或直接网络客户端。
- DSH 和 Cordis 仍是由宿主提供的对等依赖。
- 禁止 npm 生命周期脚本。

请通过 SECURITY.md 私下报告漏洞。

开发

npm ci --ignore-scripts
npm run verify
npm run typecheck
npm run lint
npm run test:coverage
npm run build
npm run audit
npm run audit:permissions
npm run audit:dependencies
npm run audit:signatures
npm run package:check

文档

| 文档 | 用途 |
| 架构 | 运行时层与信任边界 |
| 配置 | 提供方 schema 与默认值 |
| 安装设置 | 源码构建与本地 tarball 安装 |
| 实现计划 | 已验证阶段与剩余发布工作 |
| CHANGELOG.md | 未发布变更 |
| SECURITY.md | 报告与安全范围 |

许可证

Apache-2.0。参见 LICENSE 和 NOTICE。