必须进入Agent模式才能让Qoder自动完成完整功能开发，包括新增接口、生成前端组件和单元测试；需先完成云端登录并切换至Quest视图，再输入含目标动词、作用对象和技术约束的精准指令，并在各检查点人工确认产物。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让 Qoder 自动完成一段完整功能开发，比如新增用户登录接口、生成配套前端组件、补全单元测试，而不是只帮你补几行代码或解释某个报错——这就必须进入 Agent 模式，否则 Qoder 会默认走 Ask 模式，只回答不执行。
确认 Agent 模式已就绪
Agent 模式不是插件装完就自动启用的，它依赖云端身份认证和界面模式切换，缺一不可。未完成这步，后续所有指令都会被当作普通问答处理，不会生成文件、不会修改代码、更不会调用工具。
1、打开 JetBrains IDE（如 IDEA），确保已安装 Qoder 插件 v3.2.0 或更高版本 → 进入 File → Settings → Plugins 检查版本号。
2、重启 IDE 后，按 Ctrl+Shift+L（Windows）或 ⌘⇧L（macOS）唤出 Qoder 面板 → 点击右上角 Sign In，跳转浏览器完成 qoder.com 账号登录；【必须用官网注册过的邮箱，不能直接输公司邮箱密码】
3、登录成功后，面板右上角显示绿色在线状态和用户名 → 此时基础连接已建立，但仍未进入 Agent 模式。
切换到 Quest 视图启动 Agent 工作流
Quest 是 Agent 模式的唯一入口，它提供三栏布局（任务导航区 + 会话流 + 产物区），所有自主决策、文件写入、多步验证都发生在这里。Ask 模式下的聊天窗口无论怎么输入“请写代码”，都不会触发执行链。
1、在 Qoder 面板顶部导航栏，点击 Quest 标签（不是 Ask 或 Chat）；若该标签不可见，检查 IDE 右下角状态栏是否提示「Switch to Quest Mode」，点击即可强制激活。
2、首次进入会引导你选择 Workspace —— 【务必新建一个专属 Workspace，命名如 “user-auth-task”，避免与日常问答混淆】。
3、进入三栏界面后，左栏出现任务卡片、中栏为输入框、右栏为空白产物区 → 此刻你已处于 Agent 模式运行环境，可以开始提交真实开发任务。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
输入带约束的自然语言指令
Agent 不理解模糊需求。“写个登录功能”会失败，“加个接口”会乱生成。它需要目标动词 + 作用对象 + 技术约束三要素齐全，才能规划出可验证的执行路径。
方法一：单步精准指令
在中栏输入框直接写：“为 user-service 模块新增 JWT 鉴权拦截器，兼容 Spring Security 6.3，不修改现有 FilterChain，拦截路径为 /api/**。”
方法二：分阶段带检查点
追加关键词控制节奏：“请先生成 OpenAPI v3 接口定义草案，输出到 Spec Tab 后暂停，等待我确认再继续生成 Controller 和 Service 代码。”
方法三：启用 Experts Mode 协同
开头加入角色声明：“启用 Experts Mode：后端工程师、前端工程师、测试工程师。任务：基于当前项目结构，为上述 JWT 拦截器配套生成 React 登录表单组件 + Jest 测试用例骨架。”
人工介入关键检查点
Agent 会在每个 Checkpoint 停下，把中间产物（如 API 草案、测试骨架、UI 组件结构）放在右栏产物区供你审核。这一步不能跳过，否则后续代码可能偏离契约。
第一步：查看右栏 Spec Tab 中的 OpenAPI v3 文档 → 确认 paths 下的 /login POST 定义是否含 email/password 请求体、是否返回 200 + token 字段。
第二步：点击右栏“Accept & Continue” → Agent 才会基于已确认的契约生成 Controller 类，自动注入 @PreAuthorize 注解并引用 UserDetailsService。
第三步：等右栏出现 Changed Files Tab → 展开查看新增的 LoginController.java、LoginRequest.java 是否落在 src/main/java/com/example/user/controller/ 目录下，包名是否与项目一致。
