项目迁移至qoderwake有四种路径：一、cli结构化导入；二、connector sdk对接ci/cd；三、手动注入上下文至记忆中心；四、yaml模板批量迁移多模块项目。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将已有项目无缝导入QoderWake环境并启用数字员工协同开发，但遭遇结构识别失败、上下文断连或技能调用不匹配等问题，则可能是由于项目元信息缺失、目录规范不兼容或权限沙盒未初始化。以下是完成项目迁移的多种可行路径：
一、通过CLI执行结构化项目导入
该方式适用于已部署Qoder CLI且项目具备标准Git仓库结构的场景，利用qoderwake import命令自动解析技术栈、提取依赖图谱并绑定对应数字员工角色。
1、在项目根目录下打开终端，确保当前分支为待迁移主干（如main或develop）。
2、执行导入命令：qoderwake import --auto-detect --role=digital-programmer。
3、系统自动扫描package.json、pyproject.toml或pom.xml等配置文件，识别框架类型与版本。
4、确认输出的检测摘要，包括识别出的技能需求（如Git分析、日志解析）、记忆锚点（如历史PR模式）及权限红线（如是否允许直接推送至main）。
5、输入yes确认导入，CLI将生成.qoder/project.yaml并触发首次记忆快照归档。
二、使用Connector SDK对接现有CI/CD流水线
该方式适用于已接入GitHub Actions、Jenkins或GitLab CI的企业级项目，通过事件驱动机制实现零侵入式迁移，所有任务由平台Webhook触发并经QoderWake沙盒代理执行。
1、在QoderWake控制台「Connector管理」中创建新实例，选择目标平台（如GitHub），获取connector_id与webhook_secret。
2、将webhook_secret填入GitHub仓库Settings → Webhooks页面，Payload URL设为https://api.qoder.com/v1/connector/github/inbound，勾选pull_request.opened、push、issue.created事件。
3、在本地CI脚本末尾添加curl调用：curl -X POST https://api.qoder.com/v1/connector/github/trigger -H "Content-Type: application/json" -d '{"connector_id":"c-7a8b9c","event":"repo-import-init"}'。
4、QoderWake接收到事件后，自动拉取最新commit tree，构建初始知识图谱，并向指定IM群组发送导入完成通知。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、手动注入项目上下文至记忆中心
该方式适用于无版本控制或离线部署的遗留项目，通过结构化文本描述人工注入关键元数据，使数字员工快速理解项目语义边界与协作惯例。
1、在Qoder IDE中打开「记忆中心」，点击右上角「+ 新建记忆条目」。
2、选择类型为Project Context Schema，填写项目唯一标识（如proj-legacy-invoice-v2）。
3、在Description字段粘贴JSON格式上下文描述，必须包含：codebase_root、primary_language、critical_dependencies、owner_team、approval_workflow节点。
4、上传一份sample.log与error_pattern_examples.txt作为辅助训练样本，用于增强后续日志分析技能的准确率。
5、保存后，系统立即对该记忆条目执行语义校验，若通过则标记为Active，可供任意数字员工在任务中调用。
四、基于YAML工作流模板批量迁移多模块项目
该方式适用于微服务架构或单体拆分项目，通过预定义的迁移模板统一规范各子模块的导入参数、技能绑定与审计策略，避免逐个配置偏差。
1、从Qoder官方模板库下载multi-module-migration.yaml，保存至项目根目录下的.qoder/templates/子目录。
2、编辑该文件，在modules列表中为每个子服务声明name、path、tech_stack、required_skills及sandbox_policy字段。
3、执行命令：qoderwake workflow run --template=.qoder/templates/multi-module-migration.yaml --env=prod。
4、CLI按拓扑顺序依次初始化各模块沙盒，自动创建对应Connector实例并同步权限策略至服务端。
5、全部模块状态变为Ready后，控制台「项目总览」页将显示完整服务依赖拓扑图与数字员工分配映射表。
