---
description: "说明 dsh-embedded-codex 支持的 DSH/Codex 版本与失败策略。"
kind: "reference"
---

# 兼容性

## 支持矩阵

| 组件 | 支持值 |
|---|---|
| DeepSeek Harness commit | `a66e4702047846cdaa10c66c9d3df3951f5ea70d` |
| DSH package version | `0.1.2-rc.1` |
| `@openai/codex` | `0.149.1` |
| Node.js | `^22.19.0` 或 `>=24.0.0` |
| DSH Profile | `web` |

本版本是精确兼容，不声明 semver 范围。三个 replacement provider 会在注册前解析 `@deepseek-ai/dsh-agent`、`@deepseek-ai/dsh-agent-presets` 与 `@deepseek-ai/dsh-api-session-controller` 的 package manifest；任一版本不同都会明确失败。

父仓库的 Git submodule gitlink 是开发基线的唯一 commit 来源。构建只确认 checkout 与 gitlink 一致，不再维护第二份 commit、源码摘要或资产摘要。兼容 patch 的单文件约束、文件名编码路径校验、Profile provider 名称 guard、组合测试和运行时 package 版本检查共同负责发现不兼容变化。

## Profile 冲突

Bundle 以原 provider 名称作为 Cordis patch guard。若另一个更早的 Bundle 改写或移除了 `agent`、`agent-presets` 或 `session-controller`，DSH 会输出 patch warning；主 Runtime 的 Loader 检查随后拒绝不完整组合。不要通过改变 Bundle 顺序掩盖冲突，应升级兼容 provider 或移除冲突 Bundle。

## Session 兼容性

标准 DSH Session 保持标准 Runtime 和原有恢复行为。由本插件创建的 Codex Session 使用普通 DSH 事件，但恢复还需要 Assistant source 中的原生 thread binding。

旧实验性实现、其他 Codex adapter 或其他 Agent Runtime 产生的可见 transcript 不会自动转换。若 Session 已有模型 turn，DSH 会锁定 Agent Preset；创建新 Session 才能选择另一个 Runtime。

## 不支持的降级

- Host 版本不同不会尝试 duck typing。
- Codex 未登录不会回退到 DeepSeek。
- API-key Codex 登录在默认配置下不会回退为 ChatGPT 登录。
- `ctx.llm.stream()` 不会接管 Codex 对话。
- 缺少原生 thread binding 不会用可见消息重建隐藏历史。
- 未知 App Server request 不会被忽略。