Qoder需在项目完成仓库级索引且状态为【Online + Indexed】后，于正确上下文位置（如Controller类声明下方）输入自然语言需求，才能生成符合Spring Boot/FastAPI风格、包结构、DTO路径及统一响应规范的代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Qoder根据当前项目的实际目录结构、已有接口定义和依赖关系，自动生成符合项目风格的控制器、服务层与DTO代码，而不是套用通用模板——这意味着补全必须识别你用的是Spring Boot还是FastAPI，是否启用了Swagger注解，DTO是否放在dto子包下，以及Controller是否继承了统一基类。
确认项目已完成仓库级索引
Qoder的接口补全能力完全依赖对整个项目结构的理解。如果只打开单个文件或未等待索引完成，补全将退化为语法猜测，无法识别@RestController命名规范或ResponseEntity<page>></page>这类项目特有返回类型。
在IDE右下角状态栏查看Qoder图标旁是否显示【Online + Indexed】；若仅显示Online，说明索引尚未完成，此时触发补全大概率失败。
首次打开大型项目时，索引可能需1–3分钟，期间可继续编码，但不要急于触发AI补全。
在正确位置输入自然语言需求
光标必须位于可推断上下文的位置：比如在controller包内新建的UserAdminController.java文件顶部空白处，或已有类的public class UserAdminController extends BaseController {下方空行。
直接键入需求描述，例如：
“实现用户列表分页查询，支持按用户名模糊搜索，返回UserVO列表，需校验登录态”
注意：不能写在方法体内部、注释块中或import语句之后——否则Qoder无法关联到当前模块的包路径与父类定义。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
触发并筛选补全建议
按下快捷键触发补全：
macOS：⌥+P｜Windows：Alt+P
Qoder会基于以下信息生成建议：
• 当前文件所在包路径（如com.example.admin.controller）
• 项目中已存在的VO类（扫描vo或dto目录）
• 统一响应包装类（如Result<t></t>）
• 权限校验注解（如@RequiresPermissions("user:list")）
• 分页工具类（如PageUtil.of()）
若出现多条建议，用⌥+[ / Alt+[向上切换，⌥+] / Alt+]向下切换，选中语义最贴合的一条。
接受补全并验证上下文一致性
第一步：按Tab插入整段代码，Qoder会自动补全完整方法体，包括参数绑定、服务调用、分页封装、异常处理分支。
第二步：检查生成代码是否复用项目已有组件——比如调用的是userService.listByPage()而非userMapper.selectList()，返回类型是否匹配Result<page>></page>而非ResponseEntity。
第三步：若发现DTO名称错误（如生成UserDto但项目实际用UserQueryReq），立即撤销（Ctrl+Z），回到需求描述行，追加限定：“DTO类名为UserQueryReq，位于com.example.admin.dto包下”再重新触发。
