codebuddy项目迁移是分层适配过程：结构自动对齐、语法人工校准、依赖声明重构、配置安全注入、行为隔离验证；每步须确认平台约束，禁用本地开发习惯，通过向导、清单声明、配置服务和沙箱比对确保兼容性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy项目迁移不是一次性复制粘贴，而是分层适配的过程：结构自动对齐、语法人工校准、依赖声明重构、配置安全注入、行为隔离验证。关键在于每一步都需确认平台约束，避免直接沿用本地开发习惯。
用内置向导自动适配项目结构
迁移第一步是让CodeBuddy理解你的项目骨架。系统会识别语言类型、框架版本和目录约定，生成兼容的运行时基础。
- 登录CodeBuddy控制台，进入“项目管理”，点击“+新建项目” → 选择“从本地导入”
- 上传.zip或.tar.gz压缩包（不支持文件夹拖拽）；上传后系统自动扫描语言与框架
- 在向导中明确选择目标运行时（如Python 3.11、Java 17、Node.js 20），点击“启动智能适配”
- 等待分析完成，查看差异报告——重点关注被标记为“需重写”的源文件，勾选后点击“应用迁移规则”
手动校准语法与API调用
向导无法覆盖所有逻辑，尤其涉及系统调用、日志、路径或异步行为时，必须按平台规范调整。
- 替换print()为logger.info()，确保日志可被统一采集
- 将硬编码路径（如"./config.yaml"）改为调用get_config_path("config")
- 禁用os.system()和subprocess.Popen()，改用平台提供的exec_command()
- 检查asyncio.run()等受限API，在沙箱环境中改用asyncio.create_task() + await组合
改用声明式依赖清单
CodeBuddy不执行pip install或npm install，所有依赖必须通过静态清单文件声明，由平台统一注入。
- Python项目：创建requirements.codebuddy.txt，仅保留包名与精确版本（如requests==2.31.0），移除注释与-e安装项
- Node.js项目：创建dependencies.codebuddy.json，格式为{"express": "4.18.2"}
- 私有PyPI包需替换索引URL为CodeBuddy认证代理地址：https://proxy.codebuddy.dev/pypi/private/{org_id}/simple/
- 保存后，在项目设置中启用“依赖自动注入”，并触发环境重建
通过配置服务加载配置
平台禁止任意文件读取，所有配置必须经环境变量或配置中心注入，不可open()本地文件。
- 删除原代码中类似open("secrets.json")的调用
- 改用get_config_value("DB_HOST")或os.getenv("DB_PORT")获取值
- 敏感配置（如密钥）须在CodeBuddy控制台的“项目配置 → 环境变量”中手动添加，标为“加密项”
- 非敏感配置（如feature flags）可通过配置服务API动态拉取：fetch_config("app-settings")
隔离验证行为一致性
迁移完成后，不能只测功能通不通，要验证行为是否与原环境一致，特别是并发、超时、错误码等边界场景。
- 启用CodeBuddy的“沙箱快照比对”功能，对同一输入分别运行旧版与迁移后版本，输出响应差异报告
- 重点验证：HTTP状态码是否一致、JSON字段顺序是否保留、空值处理逻辑是否相同、异常堆栈是否可读
- 使用平台内置的stress-test命令模拟高并发请求，观察资源占用与失败率变化
- 若发现差异，回溯到对应模块的API调用或配置注入环节，而非直接修改业务逻辑
