Home

Trae2OpenCode Wiki

Trae2OpenCode 用于把本机可恢复的 TRAE 会话迁移到 OpenCode，并在写入后逐项回读核对。 日常使用只需打开来源项目，然后运行：

npm run migrate:local

工具会引导选择 TRAE 窗口和一个或多个会话，自动完成导出、凭据脱敏、兼容性检查、 导入、回读核验和断点续跑。无需手动查找或输入 workbench ID、session ID。

Important

当前来源契约固定为 TRAE CN 3.3.104。OpenCode v2 仅支持 2.0.12、2.0.16； OpenCode v1 仅支持 1.17.9、1.18.32。v1 是两个离散白名单版本，不表示中间版本 均受支持。不同操作系统与协议组合的实机验收状态请先查看兼容性矩阵。

从这里开始

1. 阅读快速开始，准备 Node.js、TRAE 调试端口和受支持的 OpenCode。
2. 迁移前核对兼容性矩阵。
3. 迁移失败时按故障排查中的 T2O_* 错误码处理。
4. 处理私人会话前阅读隐私与安全。

核心能力

• macOS、Windows 本机 TRAE 会话发现与交互式批量选择。
• OpenCode v1 / v2 协议适配，未知版本默认拒绝写入。
• 消息、reasoning、工具记录和时间线顺序映射。
• 写入后回读对账，不以“请求成功”代替迁移成功。
• 基于 manifest 的断点续跑、幂等检查和受保护覆盖。
• 已识别凭据自动脱敏，不可安全改写时停止迁移。
• 单 bundle 上限 1 GiB，单会话 runtime/transfer 上限 384 MiB。

文档导航

页面	内容
快速开始	从安装到完成第一次迁移
兼容性矩阵	系统、TRAE、OpenCode 版本与验收状态
迁移原理	来源读取、IR、目标适配、回读和续跑机制
隐私与安全	本地产物、凭据处理与安全边界
故障排查	常见提示、错误码和恢复步骤

更完整的工程文档位于 仓库 docs/ 目录。

项目链接

• GitHub 仓库
• 项目网站
• 问题反馈
• ISC License