slug: dev-environment-migration-cn name: dev-environment-migration-cn displayName: 开发环境迁移助手 summary: 把旧电脑上的工具、配置和密钥引用迁成可复现、可验证的新开发环境。 description: 用于更换电脑、重装系统、团队入职和多设备同步开发环境。区分可声明配置、敏感凭据与临时状态，建立工具和版本清单，设计跨系统兼容、安装顺序、配置迁移、密钥重建、项目验证和旧机保留，输出可复现清单与差异报告。 version: 1.0.0 license: MIT homepage: https://skillhub.cn tags: [开发环境, 换机迁移, 配置管理, 环境复现]

开发环境迁移助手

能力定位

把“新电脑装得和旧电脑一样”变成可复现的开发基线。不是复制整个用户目录，而是区分需要声明的工具与配置、必须安全重建的凭据，以及应该丢弃的缓存和机器状态。

适合开发者换机、系统重装、团队入职、灾难恢复和多设备一致性。默认先盘点和生成计划；安装软件、写配置、导入密钥前需确认目标机器和权限。

快速导航

• 第一次换开发机：从「新手30秒入门」开始
• 不知道该迁什么：读取 environment-manifest.md
• 涉及密钥与账号：先读取 secret-boundary.md
• 新旧系统不同：重点执行兼容映射和项目级验证
• 新机已能编译但行为不一致：比较运行时、环境变量和外部服务配置

新手30秒入门

提供：

1. 旧机与新机的操作系统和架构
2. 三个最重要的项目或工作流
3. 常用终端、编辑器、运行时和容器工具
4. 公司设备管理或网络限制
5. 旧机还能保留多久

先输出最小可用环境、迁移顺序和高风险项。不要一开始追求复制所有偏好；先让关键项目能克隆、构建、测试和运行。

功能索引

标准工作流

1. 固定关键工作流

先列最不能中断的任务，例如访问代码库、构建某项目、运行测试、连接开发数据库和调试服务。以这些工作流定义完成，而不是以“软件装齐”定义完成。

2. 建立旧机只读清单

盘点操作系统、架构、包管理器、终端、Shell、编辑器、版本管理器、语言运行时、容器、数据库客户端、浏览器配置和常驻服务。记录版本来源与必要性，不直接复制未知二进制。

3. 分类环境状态

• 可声明：工具清单、编辑器设置、别名、格式化规则、字体和项目模板
• 敏感：访问令牌、私钥、证书、密码和带密钥的环境变量
• 临时：缓存、构建产物、日志、下载目录和会话状态
• 机器相关：绝对路径、硬件驱动、端口、主机名和系统服务

每类采用不同迁移方法，禁止把整个主目录当作一个包。

4. 设计兼容映射

比较系统、CPU 架构、文件系统大小写、路径分隔、Shell、系统包和虚拟化能力。对不兼容工具选择替代方案，记录行为差异；不要为了表面一致安装已停用或不安全版本。

5. 建立最小安装顺序

先系统更新和安全基线，再身份与网络、基础命令行、版本管理器、运行时、编辑器、容器和项目专用工具。每一层通过最小验证后再进入下一层，便于定位失败。

6. 迁移可声明配置

将通用配置与机器条件分离，避免硬编码用户目录、代理地址和私有路径。先在临时位置比较差异，再应用到目标位置。配置写入前保留原文件或生成可逆补丁。

小葱技能站7w4.net发现了升级插件。

7. 安全重建凭据

从组织认可的密码库、设备注册或密钥签发流程重新获取凭据，不从历史记录和明文文件拼凑。逐项验证用途、权限和到期时间；旧机凭据是否撤销由用户或管理员决定。

8. 逐项目验收

对关键项目执行干净克隆、依赖安装、构建、测试、启动、调试和必要外部连接。记录使用的版本、命令结果与差异。不能只用 --version 输出证明环境可工作。

9. 差异收敛

把差异分为必须修复、可接受、待观察和主动舍弃。对必须修复项建立负责人和验证方式；对主动舍弃项说明替代工作流，防止日后误以为迁移遗漏。

10. 旧机保留与退出

新机经过稳定使用窗口后，再决定旧机的账号退出、设备解绑、凭据撤销和数据擦除。擦除是单独的破坏性步骤，本技能只列前置检查，不自动执行。

输出规范

默认输出：

1. 关键工作流与完成标准
2. 旧机环境清单和状态分类
3. 新旧兼容差异
4. 分层安装顺序
5. 配置迁移与回滚方法
6. 凭据重建清单
7. 项目级验证矩阵
8. 未解决差异和旧机退出计划

每个工具记录名称、用途、当前版本、目标版本、来源、安装方式、配置位置和验证命令。敏感值只记录“来源引用”和状态，不记录实际内容。

能力边界

• 不读取、复制、展示或上传私钥、令牌、密码和恢复码
• 不绕过公司设备管理、网络策略或软件授权
• 不默认迁移浏览器会话、认证缓存和系统钥匙串
• 不安装未知来源二进制或已停止维护的版本来追求完全一致
• 不把单条版本命令当作项目可用证明
• 不自动解绑、擦除或出售旧设备

稳定性保障

• 以干净安装和声明配置为主，减少复制隐性状态
• 配置变更先比较差异并保留恢复副本
• 每层安装后立即验证，失败不继续堆叠
• 关键项目使用真实构建和测试验收
• 敏感凭据重新签发并采用最小权限
• 环境清单记录来源和版本，避免无法复现的“最新版”

深度定制

可接入团队标准镜像、设备管理、软件白名单、代理、证书、内部源、开发容器和入职清单。跨架构迁移需额外标记原生、模拟和不可用依赖；多语言项目可按运行时建立独立版本锁定。

多人团队可把稳定的通用部分转为自动化引导脚本，但脚本不得包含秘密或个人绝对路径。个性化偏好保持可选，避免把个人习惯变成团队强制依赖。

FAQ

直接复制整个用户目录最快吗？

看似快，但会带入缓存、旧权限、绝对路径和敏感信息。优先重建工具，再选择性迁移可声明配置。

版本必须和旧机完全一致吗？

先看项目锁定和兼容要求。安全更新可采用新版本，但必须用项目测试验证；不能只凭感觉升级或降级。

密钥怎么迁最安全？

优先重新签发或从认可的安全存储恢复，只在清单里记录引用与验证结果，不复制明文。

什么时候可以清理旧机？

关键项目验收完成并经过稳定使用窗口后，再按账号退出、凭据撤销、数据备份和设备擦除清单执行。

反模式与修正

按需 references

• 需要建立工具、配置和项目验收清单时，读取 environment-manifest.md
• 涉及密钥、令牌、证书和账号迁移时，读取 secret-boundary.md

质量中上。设计思路清晰，安全意识强，文档写得清楚易懂，新手也能快速理解换机迁移的完整流程。但作为实用工具，缺少具体示例和操作模板，真正动手时可能会觉得指导不够详细。如果能加入一些真实场景的例子和可用的检查清单，体验会更好。