工作空间迁移
通过 CC-Panes 内置的“迁移工作空间”能力,把一个工作空间从当前本机目录迁移到新的本机目录,或迁移到 WSL 目录。
参数: $ARGUMENTS
适用范围
- v1 支持:
local -> locallocal -> wsl
- v1 不支持:
local -> ssh- 删除原 Windows 副本
- 自动双向同步
固定流程
迁移必须走这四步:
- 预检
- 复制
- 校验
- 切换
校验失败前,不切换工作空间入口。
UI 操作
在 CC-Panes 左侧工作空间树里:
- 右键目标工作空间
- 点击
迁移工作空间... - 选择目标环境和目标根目录
- 先执行预检
- 确认预览结果后执行迁移
- 如需恢复,仅回滚工作空间配置,不删除目标副本
迁移规则
- 工作空间根目录会整体复制
workspace.path外的本地项目会被放到externals/...- 以下目录默认排除:
node_modulestarget.venv.nextdistbuild.turbo.cache__pycache__
- 不删除源目录
结果说明
- 迁移到 WSL 后:
- 默认环境切到
wsl - 工作空间会记录新的 WSL 根目录
- Windows 本机路径仍保留,用于过渡
- 默认环境切到
- 迁移到本机新目录后:
- 工作空间本机路径会切到新目录
建议
- 先迁一个小工作空间验证流程
- 大工作空间迁移前先确认目标目录为空
- 迁移完成后优先从工作空间右键打开 Claude / Codex 验证路径是否正确