会话同步 NB4747/dsh-session-sync

dsh-session-sync

把 Codex / Claude Code 的会话同步进 DeepSeek Harness，导入后可以继续聊。
把 Codex / Claude Code 的历史会话同步到 DeepSeek Harness（DSH），导入后可直接续聊。

Features / 功能

- 一条命令导入：/sync codex 自动扫描 ~/.codex/sessions，导入最新会话
- 自动监听（实时）：启动时自动监听 ~/.codex/sessions，Codex 会话一有变化就增量导入，不用手动操作
- 增量：manifest 按 mtime 去重，只导入新增或更新的 rollout，不重复创建
- 完整保真：用户消息、助手回复（含工具调用文本）完整保留，导入后可续聊
- 自动归组工作区：按源项目目录（cwd）自动归入 DSH 工作区，与 Codex 项目视图一致
- 已校验：写入走 DSH 官方 SessionPersistence 接口，通过全部 load 校验

Install / 安装

install the plugin into your DSH web profile
cd ~/.dsh/profiles/web
pnpm add @z47_rose_1/dsh-session-sync

或者直接从 GitHub 安装：

pnpm add github:NB4747/dsh-session-sync

然后加到 cordis.patch.yml：

- insert:
- id: session-sync
name: 'dsh-session-sync'

重启 DSH（dsh web）。

Usage / 使用

在 DSH Web UI 里运行：

/sync codex # manual incremental import
/sync claude # import Claude Code sessions (~/.claude/projects)
/sync watch # start realtime watcher (enabled automatically on boot)
/sync unwatch # stop the watcher
/sync push <sessionId> # export new DSH turns back to the source Codex rollout (bidirectional)

也可以指定路径（文件或目录）：

/sync codex C:\Users\you\.codex\sessions

导入的会话会出现在对应源项目的工作区下。刷新会话列表就能看到。

插件加载时默认开启实时同步——Codex rollout / Claude Code 会话只要有新增或改动，3 秒防抖后自动导入。想关掉，在插件配置里设 autoWatch: false。

Development / 开发

pnpm install
pnpm run build

How it works / 原理

1. 解析 Codex rollout JSONL（~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl）——只读
2. 把用户轮次和助手回复映射成 DSH SessionEvent
3. 通过 DSH 的 sessionPersistence.create / append 写入（zstd 帧、seq 连续、轮次平衡）
4. DSH 工作区 bootstrap 按源 cwd 给会话归组

Roadmap / 路线图

- [x] MVP：/sync codex 增量导入
- [x] V2 第一步：实时自动监听（启动时开启，带防抖）
- [x] V2 第二步：支持 Claude Code 源（/sync claude，双目录监听）
- [x] V2 第三步：双向同步（/sync push——DSH → Codex 导出）
- [x] V2 第四步：冲突处理（外部改动检测、push→watch 循环防护）
- [ ] GUI 桌面应用

Conflict handling / 冲突处理

- push → watch 循环防护：/sync push 之后，manifest 记录 push 后的 mtime，监听器就跳过刚写入的那些行——不会重复建会话。
- 外部改动检测：如果导入之后 Codex 那边的源 rollout 又多了新轮次，/sync push 会提醒你，并把你的 DSH 轮次追加在它们后面（保持时间顺序）。

License

MIT