DSH 会话桥接（dsh-codex-bridge）

把 Codex、DeepSeek Harness（DSH）、Zcode、Claude Code、WorkBuddy AI 五端的会话历史互相打通，并提供 MCP Server 让任意支持 MCP 的客户端接入。

> 一个 DSH 插件 + 一个独立 MCP 服务：
> 在任意客户端里干活，历史随时搬到另一端继续。

功能总览

架构：N×N 靠 UIR 枢纽

Codex ──┐                    ┌── Codex
DSH ──┤                    ├── DSH
Zcode ──┼──▶  UIR  ◀─────────┼── Zcode
Claude CC ─┤  统一中间表示       ├── Claude CC
WorkBuddy ─┘                    └── WorkBuddy
▲
│
MCP Server（通用接入）

不需要 N² 个转换器，只需 2N 个适配器（每端一读一写）。

安装

前置条件

方式一：一键安装（推荐）

git clone https://github.com/ztg-pty/dsh-codex-bridge.git
cd dsh-codex-bridge
powershell -ExecutionPolicy Bypass -File scripts/install.ps1

无需构建：plugin/lib/ 已包含编译好的产物（index.js / client.js / mcp-stdio.js），
clone 下来直接就能装。

脚本会自动：
1. 备份 profile 原有配置（可用 scripts/rollback.ps1 回滚）
2. 复制插件到 /node_modules/dsh-codex-bridge
3. 登记到 profile 的 dependencies 与 dsh.bundles
4. 提示重启 DSH

> 如果 DSH profile 不在默认位置，可用环境变量指定：
> powershell > $env:DSH_PROFILE_DIR = "D:\path\to\profile" > powershell -ExecutionPolicy Bypass -File scripts/install.ps1 >

方式二：手动安装

1. 把 plugin/ 复制到 /node_modules/dsh-codex-bridge
2. 在 profile 的 package.json 里：
   - dependencies 加 "dsh-codex-bridge": "file:<路径>/plugin"
   - dsh.bundles 加 "dsh-codex-bridge"
3. 重启 DSH

验证安装

node --experimental-strip-types --import ./scripts/ts-register.mjs scripts/acceptance.mjs

会自检 29 项（UI / 五端适配器 / MCP / 可移植性 / 构建部署 / 中文错误），全部通过即安装成功。

卸载 / 回滚

powershell -ExecutionPolicy Bypass -File scripts/rollback.ps1

使用

一、UI 操作（DSH 插件内）

打开 插件 → 会话桥接，三个入口：

1. 跨端转换 / 上下文预览
   - 选源客户端 → 选会话 → 选目标客户端
   - 自动显示「转换会丢失什么」
   - 可先「预览压缩上下文」并下载 Markdown
   - 点「开始转换」

2. 导入 Codex 会话 —— Codex → DSH（选目标工作区）

3. 导出至 Codex / WorkBuddy —— DSH → 目标端

二、MCP 接入（任意客户端）

MCP Server 有两种运行方式：

方式 A：stdio（推荐，最通用）

node <插件目录>/bin/mcp-stdio.js

在各客户端配置：

Claude Code

claude mcp add dsh-bridge -- node "C:/path/to/plugin/bin/mcp-stdio.js"

Cursor

在 .cursor/mcp.json：

{
"mcpServers": {
"dsh-bridge": {
"command": "node",
"args": ["C:/path/to/plugin/bin/mcp-stdio.js"]
}
}
}

Cline / Continue / 其他

同上格式：command + args 指向 bin/mcp-stdio.js。

方式 B：HTTP（复用 DSH 插件服务）

DSH 运行时，MCP 端点：

POST http://127.0.0.1:/plugins/dsh-codex-bridge/mcp
GET  http://127.0.0.1:/plugins/dsh-codex-bridge/mcp/tools   （调试用）

三、MCP 工具清单

典型用法（在 Claude Code / Cursor 里说）：

> 「把 DSH 里『城市地图系统』那个会话的上下文拉进来」
> → 客户端调 list_sessions → get_context

> 「用 Gemini 的窗口拉，能装多少装多少」
> → get_context({ client: 'dsh', sessionId: 'xxx', model: 'gemini-1.5-pro' }) → 1.84M 预算

> 「只给我 32k 的摘要版」
> → get_context({ ..., budget: 32000 })

> 「把这段对话存到 Zcode」
> → 客户端调 push_context({ target: 'zcode', messages: [...] })

四、上下文长度如何指定

预算解析优先级：显式 budget > model 预设 > 默认 200k，硬上限 2M。

完整列表（31 个）用 list_models 查，或直接读 plugin/src/budget/tokens.ts 的 MODEL_CONTEXT_PRESETS。

DSH 插件 UI 里：导出对话框有「上下文长度」卡片（默认不裁剪，勾选后可选模型或自定义 token），跨端转换对话框同样支持。

上下文压缩（核心能力）

目标：在模型上下文窗口内返还近乎完整的信息；技术细节不丢失。

四级流水线

L0 原始   → 未超预算直接返回
L1 去冗余 → 剥离环境注入模板、去重（无损）
L2 结构化 → 每条消息压成 {意图, 关键操作, 结果}，P0 片段逐字保留
L3 骨架   → 早期轮次折叠成摘要句

保留优先级

技术索引

即使早期轮次被折叠，其中的文件、目录、命令、报错、版本号会被去重后集中列在末尾的「技术索引」里。

实测数据（真实会话）

会话「Blender 写实城市建模」（133 万 tokens，44 轮）压缩到 200k 预算（模型未指定时的默认值）：

预算利用率    99.9%（182,712 / 184,000）
报错保留      50%
命令保留      45%
技术索引      814 条（含全部 761 个可识别文件名）

五端存储格式（实测）

所有路径从 os.homedir() + 环境变量推导，支持覆盖：
DSH_HOME / CODEX_HOME / ZCODE_HOME / CLAUDE_HOME / WORKBUDDY_HOME

项目结构

dsh-codex-bridge/
├── plugin/
│   ├── src/
│   │   ├── uir/                 # 统一中间表示
│   │   │   ├── types.ts         # UIR 类型 + 适配器接口
│   │   │   └── helpers.ts       # 价值分级、特征检测、校验
│   │   ├── adapters/            # 五端适配器
│   │   │   ├── registry.ts      # 注册表 + 跨端转换
│   │   │   ├── dsh/adapter.ts
│   │   │   ├── codex/adapter.ts
│   │   │   ├── zcode/adapter.ts
│   │   │   ├── claude-code/adapter.ts
│   │   │   └── workbuddy/adapter.ts
│   │   ├── budget/              # Token 预算与压缩
│   │   │   ├── tokens.ts
│   │   │   └── summarize.ts
│   │   ├── mcp/                 # MCP Server
│   │   │   ├── protocol.ts      # JSON-RPC 2.0 + MCP 方法
│   │   │   ├── tools.ts         # 7 个工具
│   │   │   └── stdio-entry.ts   # stdio 入口
│   │   ├── client/              # React UI
│   │   ├── host/                # 路由、日志、客户端探测
│   │   └── convert/             # 底层格式读写
│   ├── bin/mcp-stdio.js         # MCP CLI 入口
│   ├── lib/                     # 构建产物（已提交，可直接安装）
│   └── test/                    # 35 个单元测试
├── docs/                        # 架构与验证文档
└── scripts/                     # 安装 / 回滚 / 推送

技术要点（踩过的坑）

DSH 侧

Codex 侧

Zcode 侧

Claude Code 侧

WorkBuddy 侧

开发

cd plugin
npm install
npm run typecheck   # 类型检查
npm test            # 35 个单元测试
npm run build       # 构建 index.js + client.js + mcp-stdio.js

已知限制

• 各客户端需重启才能看到写入的会话（都只在启动时读索引）
• 工具名映射有损：exec_command → pwsh、apply_patch → edit
• 子代理会话合并进父会话，不单独导入
• 加密内容（Codex encrypted_content、DSH 加密思考）只能占位
• Claude Code 的消息分支（parentUuid 树）跨端时线性化
• 仅 Windows 完整实测

免责声明

本项目通过逆向分析各客户端本地存储格式实现互通，会写入这些应用的本地数据。
虽然实现了自动备份，但仍建议：

• 操作前自行备份 ~/.dsh、~/.codex、~/.zcode、~/.claude、~/.workbuddy-ai
• 不要在应用正在写入会话时批量操作
• 客户端版本升级可能改变存储格式，升级后请先小样本验证

使用本工具造成的任何数据问题，作者不承担责任。

License

MIT