前言¶
DeepSeek Harness (DSH) 采用模块化插件架构，允许开发者扩展其功能。对于从 Codex 平台迁移的开发者而言，如何延续对话历史是一个具体需求。session-import-codex 旨在解决将 Codex App Server 对话记录导入 DSH 的问题，确保历史对话在新的环境中得以无缝衔接。
插件定位¶
这是一个 DeepSeek Harness 插件，由 xing01l 维护。它通过读取 Codex App Server 的稳定历史方法，将已完成的对话轮次转换为经过验证的 DSH 会话事件。插件提供了 CLI 工具和 Harness 聊天命令两种操作方式，支持一次性迁移和确定性 ID 生成。
核心功能¶
- 对话历史导入：将 Codex 非归档交互会话导入 DeepSeek Harness。
- CLI 工具：提供命令行工具进行一次性迁移。
- 聊天命令回退：提供
/import-codex聊天命令作为开发或针对性回退手段。 - 推理摘要处理：默认仅导入推理摘要，不导入原始推理内容。
- 确定性 ID：生成如
codex-<thread-id>的确定性目标 ID。 - 幂等性：支持幂等的 workspace 附加，重复运行不会重复创建会话。
- 环境要求：需要 Node.js
^22.19或>=24，pnpm 10，以及路径中的codex命令。
安装与启用¶
通过 Harness 安装插件，以更新目标 profile 的依赖和打包层：
dsh plugin --profile web add dsh-session-import-codex
典型用法¶
命令行迁移¶
插件提供了 CLI 工具进行迁移。支持 Dry Run 模式先验证源历史和目标冲突：
pnpm --dir "$env:USERPROFILE\.dsh\profiles\web" exec dsh-import-codex --profile web --dry-run
执行实际迁移：
pnpm --dir "$env:USERPROFILE\.dsh\profiles\web" exec dsh-import-codex --profile web
聊天命令¶
在 DSH 聊天界面中，可以使用 /import-codex 命令：
- /import-codex <thread-id>：导入指定会话 ID。
- /import-codex --all：导入所有符合条件的会话。
注意事项¶
- 离线写入工作流：插件不支持直接写入 Harness 持久化文件。支持的写入工作流是离线的，需要先停止
dsh --profile web进程，执行迁移后，再重启 Web profile。 - 隐私安全：插件不会读取 Codex 滚动文件、桌面状态、SQLite 数据库或私有 JSONL 文件。它也从不直接写入 Harness 持久化文件。
- 许可证：插件遵循 MIT 许可证。
总结¶
该插件为开发者提供了从 Codex 迁移对话历史到 DeepSeek Harness 的能力。通过 CLI 工具和聊天命令，开发者可以方便地将历史会话导入 DSH，并利用确定性 ID 和幂等性设计确保迁移过程的安全与可重复。
