# Ccpanes Workspace Migrate

> CC-Panes bundled skill: 工作空间迁移

- Skill: `tangchunwu/ccpanes-workspace-migrate` (Agent Skill)
- Install (CLI): `npx skillmds add tangchunwu/ccpanes-workspace-migrate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tangchunwu/ccpanes-workspace-migrate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tangchunwu (https://skillmd.com/u/tangchunwu)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tangchunwu/ccpanes-workspace-migrate

---


# 工作空间迁移

通过 CC-Panes 内置的“迁移工作空间”能力，把一个工作空间从当前本机目录迁移到新的本机目录，或迁移到 WSL 目录。

参数: $ARGUMENTS

---

## 适用范围

- v1 支持:
  - `local -> local`
  - `local -> wsl`
- v1 不支持:
  - `local -> ssh`
  - 删除原 Windows 副本
  - 自动双向同步

---

## 固定流程

迁移必须走这四步:

1. 预检
2. 复制
3. 校验
4. 切换

校验失败前，不切换工作空间入口。

---

## UI 操作

在 CC-Panes 左侧工作空间树里：

1. 右键目标工作空间
2. 点击 `迁移工作空间...`
3. 选择目标环境和目标根目录
4. 先执行预检
5. 确认预览结果后执行迁移
6. 如需恢复，仅回滚工作空间配置，不删除目标副本

---

## 迁移规则

- 工作空间根目录会整体复制
- `workspace.path` 外的本地项目会被放到 `externals/...`
- 以下目录默认排除:
  - `node_modules`
  - `target`
  - `.venv`
  - `.next`
  - `dist`
  - `build`
  - `.turbo`
  - `.cache`
  - `__pycache__`
- 不删除源目录

---

## 结果说明

- 迁移到 WSL 后:
  - 默认环境切到 `wsl`
  - 工作空间会记录新的 WSL 根目录
  - Windows 本机路径仍保留，用于过渡
- 迁移到本机新目录后:
  - 工作空间本机路径会切到新目录

---

## 建议

- 先迁一个小工作空间验证流程
- 大工作空间迁移前先确认目标目录为空
- 迁移完成后优先从工作空间右键打开 Claude / Codex 验证路径是否正确