前言¶
DSH 的理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。对同时使用 OpenAI Codex CLI 和 DSH 的开发者，常见需求是把 Codex CLI 的历史对话导入 DSH，使其可浏览、可搜索、可继续。dsh-codex-import 提供这一导入路径。
这是什么¶
dsh-codex-import 是一个 DSH 插件，仓库为 G1en-114/dsh-codex-import，许可证为 MIT。
它把 OpenAI Codex CLI 的历史对话导入 DeepSeek Harness (DSH)，成为可浏览、可搜索、可继续的 DSH 会话，并出现在对应 workspace 侧边栏。
它提供两种形态：
- 宿主插件命令
- 独立 CLI
核心能力¶
下面介绍已核实的能力。
- 支持在 DSH 中执行
/codex-import <session-id>，把 Codex CLI 历史会话导入为 DSH 会话。 - 导入时保留用户消息、助手回复（
commentary+final_answer）、工具调用与输出、turn/step结构和会话标题。 - 零运行时依赖，使用 Node >=22.20 内置
node:zlib的 zstd 支持写入 DSH 标准会话文件。 - 写入后进行自校验：双帧 zstd、header 单独一帧、
seq连续、带 checksum。 - 超大会话可自动压缩最老 turn 为摘要检查点，也支持
--max-turns纯截断。 - Codex rollout 不保存
web_search_call输出，导入时省略。
安装与启用¶
作为 DSH 插件安装时，使用下面命令：
dsh plugin --profile web add git+https://github.com/G1en-114/dsh-codex-import.git
这条命令会把插件加入 web profile。
git 安装时，pnpm 会拦截 prepare 脚本；需要按报错提示把包名加入下面配置文件的 allowBuilds，然后重跑安装命令：
~/.dsh/profiles/web/pnpm-workspace.yaml
安装完成后，重启 dsh web 或刷新页面。
作为独立 CLI 运行时，Node 版本要求如下：
Node >=22.20
插件命令形态运行在 DSH 进程内，README 称无此限制。
典型用法¶
在 DSH 会话中，可用 session-id 导入：
/codex-import 019feec0-f565-7900-b985-1d6ba3b63a56
如果已有 rollout 文件，也可导入并指定会话 id 与 workspace 上下文：
/codex-import ~/rollout.jsonl --session-id session-my-import --cwd /mnt/e/cell
如果只想保留最近的 turn，可使用：
/codex-import 019feec0-... --max-turns 80
独立 CLI 示例如下。--dry-run 用于试跑，--compact 用于在超预算时压缩最老 turn：
dsh-codex-import --dry-run 019feec0-...
dsh-codex-import --compact 019feec0-...
dsh-codex-import ~/backup/rollout-2026-08-11.jsonl --cwd /mnt/e/cell
--compact 需要 DEEPSEEK_API_KEY 环境变量或下面凭据文件：
~/.dsh/.credentials.yaml
超大会话处理¶
导入完成后，之后每次对话会按完整历史计费输入 token；自动压缩会把最老 turn 压缩成摘要检查点，这会消耗一次性 token。
如果只需要保留最近可继续的部分，可优先使用 --max-turns 做纯截断；确实需要早期上下文时，再考虑自动压缩。
适用场景与注意¶
- 适合有 Codex CLI 历史会话，并希望继续在 DSH 中浏览、搜索、继续对话的开发者。
- 插件以当前 dsh 进程权限运行；安装前应检查源码与许可证。当前许可证为 MIT。
- 重复导入同一个 Codex 会话会生成新的 session id；指定相同
--session-id会报错。 package.json声明 peerDependencies：
@deepseek-ai/cordis
@deepseek-ai/dsh-commands
@deepseek-ai/dsh-session-persistence
- 安装后需重启
dsh web或刷新页面。
结尾¶
经过上面的步骤，dsh-codex-import 可以把 Codex CLI 历史会话转成 DSH 可继续使用的会话，并保留消息、工具调用、turn/step 等结构。
GitHub 仓库：
https://github.com/G1en-114/dsh-codex-import
目录页链接未在所提供资料中确认；可在 DSH 社区目录中按名称 dsh-codex-import 查找。
