# migrate-session

**Repository Path**: tomcat1228/migrate-session

## Basic Information

- **Project Name**: migrate-session
- **Description**: Codex skill: migrate conversations across model providers with full memory
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# migrate-session

[English](README.md) | **简体中文**

一个 [Codex](https://github.com/openai/codex) 技能：把已有对话**跨模型厂商迁移**，历史记忆一条不丢。

## 为什么有这个技能

Codex 的每个会话在本地绑定了唯一的模型厂商。当你在旧线程里只切换模型名、不切换厂商时，请求仍会发往旧厂商的接口，然后报错：

![厂商不匹配报错](assets/provider-error.png)

更麻烦的是，不同厂商下的会话彼此完全无法共享记忆。这个技能同时解决这两个问题：**打通跨厂商的会话迁移**——你可以在任意厂商的新线程里继续聊，并带走完整的对话历史。

## 工作原理

1. **找到**源会话：标题、话题关键词、日期、目录、ID 片段都行（检索本地线程数据库）。
2. **导出**完整对话记录为一份可携带的记忆档案（自动打码明显的 API 密钥）。
3. **重建**：在目标厂商上开一个新线程，开场先读完这份记忆档案，对话无缝续上。

迁移是纯增量操作，源会话不会被修改或删除。

## 安装

把本文件夹复制到 Codex 技能目录：

```powershell
Copy-Item -Recurse migrate-session "$env:USERPROFILE\.codex\skills\"
```

## 使用说明

直接让 Codex 迁移会话，用任何自然的方式描述目标会话即可：

```text
迁移会话，把那个聊共享对话记忆的迁到 ZAI
迁移会话，昨天下午聊 GLM 配置的那个对话
迁移会话，w-s-m 目录里那个报错的线程
```

也可以显式调用：`$migrate-session`

技能会自动搜索匹配的会话——如果命中多个候选，会列出时间、厂商、标题让你挑选，不会瞎猜。导出完成后它会创建新线程、等待新线程完整读入记忆并向你确认迁移成功。

## 注意事项

- 记忆档案是明文 Markdown，默认存放在 `~/Documents/Codex/migrations/`——如果对话里有敏感内容，请注意保管
- 超长会话导出的档案较大（目标模型需要一次性读入），超过约 200 KB 时技能会提醒你
- 适用于 Codex 配置的任意厂商（DeepSeek、ZAI/GLM 等）

## 许可证

[MIT](LICENSE)