代码迁移需经五步：一、用内置向导自动适配项目结构；二、手动校准语法与api；三、改用声明式依赖清单；四、通过环境变量或配置服务加载配置；五、隔离验证行为一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要将现有代码库迁移到CodeBuddy平台，可能面临语法适配、依赖映射、配置转换等问题。以下是完成代码迁移的具体操作路径：
一、使用CodeBuddy内置迁移向导
CodeBuddy提供图形化迁移向导，可自动识别主流语言项目结构并生成兼容代码骨架，适用于标准项目模板迁移。
1、登录CodeBuddy控制台，进入“项目管理”页面。
2、点击右上角“+新建项目”，选择“从本地导入”选项。
3、上传源代码压缩包（支持.zip、.tar.gz格式），系统自动扫描语言类型与框架版本。
4、在向导界面确认目标运行时环境（如Python 3.9、Node.js 18等），点击“启动智能适配”。
5、等待分析完成后，查看差异报告，勾选需自动重写的文件，点击“应用迁移规则”。
二、手动执行语法与API对齐
当项目含自定义构建逻辑或非标依赖时，需人工校准CodeBuddy的语法约束和运行时API边界。
1、查阅CodeBuddy官方《语言兼容性矩阵》，定位源代码中被标记为“不支持”的语法特性（如Python的asyncio.run()在沙箱环境中受限）。
2、将原代码中print()调用替换为logger.info()，以适配平台统一日志采集机制。
3、将硬编码的路径字符串（如"./config.yaml"）改为调用get_config_path("config")接口获取安全路径。
4、检查所有os.system()或subprocess.Popen()调用，替换为CodeBuddy提供的exec_command()安全执行函数。
三、重构依赖管理方式
CodeBuddy不支持直接执行pip install或npm install命令，所有依赖必须通过声明式清单文件注入运行时环境。
1、在项目根目录创建requirements.codebuddy.txt（Python）或dependencies.codebuddy.json（Node.js）。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、将原requirements.txt中每行依赖按格式转换：保留包名与精确版本号，移除注释及-e可编辑安装条目。
3、对于私有PyPI包，将索引URL替换为CodeBuddy认证后的代理地址：https://proxy.codebuddy.dev/pypi/private/{org_id}/simple/。
4、保存清单文件后，在项目设置中启用“依赖自动注入”开关，并触发一次环境重建。
四、调整配置加载逻辑
CodeBuddy禁止读取任意本地文件，所有配置必须通过平台注入的环境变量或专用配置服务访问。
1、将原代码中open("secrets.json", "r")调用替换为load_secrets_from_env()辅助函数（SDK已预置）。
2、进入CodeBuddy项目“配置管理”页，点击“新增密钥”，逐项录入敏感字段（如DB_PASSWORD、AWS_ACCESS_KEY）。
3、在代码中改用os.getenv("DB_PASSWORD")获取值，确保所有环境变量名与配置管理页中定义完全一致（区分大小写）。
4、删除原项目中的.env文件及任何尝试加载该文件的初始化代码段。
五、验证迁移后行为一致性
迁移完成后需在隔离环境中执行端到端功能比对，避免因运行时差异导致逻辑偏移。
1、在CodeBuddy中创建“验证测试”任务，上传原始输入样本（如JSON请求体、CSV测试数据集）。
2、运行迁移后代码，捕获标准输出、返回状态码及响应头信息。
3、将结果与本地运行相同输入所得基准输出进行逐字段比对，重点关注时间戳、随机ID、浮点精度等易变字段。
4、对不一致项定位至具体函数调用栈，检查是否调用了平台未实现的底层系统调用或未声明的隐式依赖。
