dsh-plugin-codex-import

English | 中文

一个 DeepSeek Harness 插件， 用一条斜杠命令把 OpenAI Codex 的历史对话导入 DSH 会话——按项目工作区分组， 可继续对话、可搜索、可分叉。

/codex-import

Imported 679 session(s) from /Users/you/.codex.
Scanned 681, already present 0, failed 0.
Content: 10694 turns, 81513 steps, 13580 user messages, 81513 assistant messages, 101215 tool calls.
Grouped 529 session(s) into 116 workspace(s).
Reload the interface to see the imported sessions.

安装

dsh plugin --profile web add github:Gordonynh/dsh-plugin-codex-import

然后在 ~/.dsh/profiles/web/cordis.patch.yml 中启用：

- insert:
    - id: codex-import
      name: 'dsh-plugin-codex-import'

重启 harness。可用 dsh --profile web --dump-config | grep codex-import 确认插件已进入插件树。

用法

命令	效果
/codex-import	导入所有尚未导入的 Codex 会话
/codex-import --dry-run	只报告将导入什么，不写入
/codex-import --limit 20	导入 20 个后停止
/codex-import --since 30	只导入最近 30 天的会话
/codex-import --project ~/work	只导入 cwd 在该路径下的会话
/codex-import --archived	同时扫描 ~/.codex/archived_sessions

重复运行是安全的：已导入的会话 id 会被跳过，Codex 原始文件永不改动。

配置

- insert:
    - id: codex-import
      name: 'dsh-plugin-codex-import'
      config:
        codexHome: '~/.codex'        # 默认：$CODEX_HOME，否则 ~/.codex
        provider: 'codex'            # 记录在导入的助手消息上
        groupIntoWorkspaces: true    # 把导入的会话挂到工作区

映射方式

Codex（rollout-*.jsonl）	DeepSeek Harness 会话事件
session_meta	会话头（id、createdAt、cwd）
用户 message（真人输入）	user/message，source:{kind:"user"}
注入上下文 / developer 角色	user/message，source:{kind:"plugin",plugin:"codex-import"}
reasoning	assistant/message 的 reasoning 块
助手 message / agent_message	assistant/message 的 text 块
function_call / custom_tool_call	tool-call 块 + tool/call 事件
各类 *_output	tool/result（在步内按 call id 配对）
web_search_call / tool_search_call / image_generation_call	成对的 tool/call + tool/result
turn_context.model	AssistantMessage.source.model
首条真人提问	session/title 事件（无须额外调用模型起标题）
event_msg 遥测、ghost_snapshot、token 计数	丢弃（UI 重复信息）

Codex 记录的是扁平事件流，Harness 需要的是 turn/start → (user/message | step/start … step/end)* → turn/end 的括号结构。 插件优先按 Codex 的 turn_id 重建该结构，缺失时以真人消息为轮次边界。

存储完全交给 Harness 自己。 会话通过 ctx.sessionPersistence.create() / .append() 写入，工作区通过 ctx.workspaceRegistry.create() / workspace.attachSession() 分配。插件不碰 会话目录、不碰 zstd 容器、不碰工作区注册表文件——物理编码、路径布局、持久化 与工作区记账都留在它们该在的地方，因此 Harness 的格式变更不会让插件悄悄失配。

转换途中的自动修复：悬空的工具调用补上合成错误结果（TOOL_NOT_STARTED）， 确保没有助手消息带着无人应答的调用；无主的工具输出被丢弃；非 JSON 的自定义 工具输入包装为 {"input": …}，使 tool/call.arguments 始终可解析；图片以 文字占位符代替（Harness 的图片块需要附件服务引用，插件无法伪造）；被 Codex 压缩过的会话导入压缩前的完整历史。

项目目录已不存在的会话仍会被导入，但保持未分组——工作区必须指向真实存在的 目录，这是 Harness 自身的规则。

验证

node test/verify.mjs        # 语法、参数解析、映射边界，
                            # 并把本机全部真实 rollout 过一遍 harness 的重建路径
node test/integration.mjs   # 在临时目录里启动真实的 dsh-session、持久化与
                            # 工作区插件，通过它们完成一次真实导入

verify.mjs 调用 Harness 自己的 foldSurface / deriveEventMessage——即恢复 会话时实际走的重建路径。integration.mjs 证明 Harness 真实的持久化服务接受 本插件产出的会话头与事件批次，且工作区注册表接受由此产生的会话。

作者机器实测：679 个真实会话、19.6 万+ 条重建消息，零失败。

注意事项

• DSH 处于 developer preview，会话格式钉在版本 0 且无兼容性承诺。若将来 Harness 拒读 v0 日志，重新导入即可——Codex 原件不受影响。
• 继续一个导入的会话时，历史会发给 DSH 当前配置的模型；原提供商专有的重放 状态不会带过去。
• 需要 Node ≥ 22（与 Harness 自身要求一致）。

许可协议

以自定义协议开放源代码（source-available）——不是 OSI 认证的开源协议。 摘要如下（以协议文本为准）：

对象	权利
所有人	自由的非商业使用、修改、再分发（沿用本协议、保留声明）
个人（全球）	额外允许：商业使用
DeepSeek 及其合作企业	额外允许：商业使用、闭源专有衍生、再许可——见补充协议
其他企业/组织	仅限非商业；商业使用需另行获得作者书面许可

LICENSE.md · LICENSE-SUPPLEMENT-DEEPSEEK.md · NOTICE.md