新版Kimi Code CLI已从Python与uv基础迁移到TypeScript和Node.js，安装方式、配置目录、终端界面和Agent架构均有变化。它不是简单的小版本覆盖，旧配置并不天然兼容。直接删除旧环境再安装，可能丢失会话、MCP连接和自定义规则。可靠迁移需要先盘点、备份，再在独立终端验证。
迁移前做完整盘点
记录旧版版本、安装方式、配置文件、环境变量、会话目录、MCP服务、代理和自定义指令。导出重要会话与任务结果，密钥只记录存放位置，不复制到普通文档。
检查CI、Shell脚本和编辑器是否调用旧命令路径。多人团队统一迁移窗口，避免文档和脚本同时支持两套不一致行为。
并行安装与配置转换
在测试账号或隔离环境安装新版，使用官方迁移能力转换数据，不直接覆盖旧目录。逐项检查模型、Base URL、权限模式、代理和工作区规则。
插件视为可执行依赖，重新确认来源和版本。不要把旧版未知字段盲目复制，新架构中不存在的配置应删除或按文档改写。
验证核心工作流
测试登录、读取、编辑、命令执行、Git、MCP、代理、长会话恢复和权限确认。用测试仓库运行固定任务，比较改动、启动时间和错误处理。
特别检查文件系统边界、令牌和网络访问。新版默认行为更方便不代表适合生产，危险操作仍需人工批准。
切换与回滚
验证通过后更新团队安装文档和脚本，再逐步切换用户。保留旧环境只读备份一段时间，但不要让两版同时写同一会话目录。
出现问题时恢复旧命令与配置，不在生产会话中反复试错。迁移完成后撤销不用的密钥、删除废弃依赖并记录新版本基线。
进一步实施要点
如果旧版通过Python虚拟环境启动MCP服务，新版CLI迁移后仍需分别确认这些服务的运行时，不能因为主程序改成Node.js就删除其Python依赖。代理环境中的HTTP_PROXY、NO_PROXY也要重新测试，确保本地MCP走直连、外部模型走受控出口。迁移完成后用最小权限账号运行一周，观察启动失败、会话恢复和插件兼容，再移除旧环境。
落地检查清单
- 备份会话、配置和MCP清单。
- 在隔离环境转换而非原地覆盖。
- 用固定仓库验证全部核心操作。
- 保留可执行回滚并更新团队文档。
