Qoder需通过扫描标准构建文件（如pom.xml、build.gradle等）自动识别项目结构，否则无法判定技术栈导致接口生成失败；正确打开含构建文件的根目录后索引成功，方可支持Quest模式、现有控制器扩展及CLI命令三种接口生成方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder需要准确识别项目结构才能生成符合工程规范的接口代码，它不靠手动指定路径，而是通过扫描标准构建文件自动建立上下文。
确认项目根目录是否含标准构建文件
打开你的项目文件夹，检查最外层目录下是否存在以下任一文件：【pom.xml、build.gradle、package.json、pyproject.toml 或 requirements.txt】。没有这些文件，Qoder无法判定技术栈，后续所有接口生成都会失败。
若项目是纯Java但用Eclipse管理，必须先将其转为Maven结构——直接复制pom.xml到根目录比尝试“转换项目”更可靠。
在Qoder中正确打开项目
启动Qoder IDE → 点击左上角【文件】→【打开文件夹】→ 【精准选择含构建文件的那层目录】（不是src子目录，也不是modules下的某个模块）。选错会导致索引为空、Controller类无法被识别、@RequestBody参数解析失败。
等待右下角索引进度条走完。成功后，左侧资源管理器应能展开Java类、TSX组件、SQL文件等，并支持跳转。
触发接口生成的三种方式
方法一：Quest模式一键生成
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
点击左侧边栏顶部“创建Quest”输入框 → 输入明确需求，例如：“生成用户登录接口，接收邮箱和密码，校验后返回JWT令牌，使用BCrypt加密” → 按Ctrl+Enter执行。
Qoder会自动读取已索引的User实体类、Spring Security配置、application.yml中的jwt密钥项，生成带@Controller、@Service、@Mapper的完整代码链，并插入对应包路径下。
方法二：基于现有控制器文件生成
在编辑器中打开UserController.java → 在侧边聊天面板输入：“为这个控制器的所有@PostMapping方法生成Swagger文档” → Qoder立即解析@RequestMapping路径、@Parameter注解、@Schema响应模型，输出openapi.json与Markdown文档至./docs/api/。
方法三：CLI命令行驱动
终端进入项目根目录 → 执行qoder cli → 输入/quest → 描述：“根据当前数据库schema，为orders表生成CRUD接口，包含分页查询和状态筛选” → Agent将调用@database上下文，生成带MyBatis动态SQL的Mapper XML与对应Service逻辑。
