Qoder需完成项目级上下文初始化才能真正理解项目：先通过Open Folder选择含src或配置文件的根目录完成索引，再手动触发Repo Wiki生成以构建知识图谱，最后通过Ask、Agent等验证跨文件语义关联与全局理解是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Qoder真正理解整个项目，必须完成项目级上下文的初始化构建，而不是依赖它自动扫描打开的单个文件——否则AI只会基于当前编辑器里那几行代码做推测，生成的代码大概率与项目架构脱节、调用不存在的类或违反命名规范。
启动后自动索引项目结构
启动Qoder IDE插件或QoderWork桌面端 → 点击左下角「Open Folder」按钮 → 选择你的项目根目录（必须是含src、pom.xml或package.json等标识文件的完整工程目录）→ 确认后等待右下角状态栏显示「Indexing complete」。这一步耗时取决于项目大小，Java Maven项目通常需30秒至3分钟；若状态栏长期卡在「Scanning…」，【请检查是否选错了子目录，比如只选了src/main/java而漏掉配置和测试目录】。
手动触发Repo Wiki生成（关键动作）
索引完成不等于AI已“理解”项目。必须主动触发知识建模：
方法一：在IDE中右键点击项目根目录 → 选择「Qoder: Generate Repo Wiki」；
方法二：在Qoder聊天面板输入斜杠命令 /repo-wiki 并回车；
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法三：在QoderWork桌面端，点击顶部导航栏「Project」→「Build Knowledge Graph」。
执行后，Qoder会解析AST、提取模块边界、识别Spring Boot Controller/Service层关系、标注Git历史高频修改点，并生成可视化知识图谱。这个过程不可跳过，否则后续所有Ask/Agent/Quest请求都缺乏全局语境支撑。
验证理解是否生效
① 在Qoder聊天面板切换到Ask模式 → 输入：“这个项目用的是哪套权限控制方案？RBAC还是ABAC？” → 若AI能准确指出SecurityConfig.java中hasRole("ADMIN")的配置方式并引用UserAuthorityService类，说明理解已就位；
② 输入：“@UserController.java @UserServiceImpl.java，对比这两个文件里对用户状态的处理逻辑差异” → 如果AI能定位到前者校验status != null、后者调用userStatusValidator.validate()并指出事务边界差异，【证明跨文件语义关联已建立】；
③ 切换到Agent模式 → 输入：“给登录接口加手机号格式校验” → 观察AI是否自动修改LoginRequestDTO的@Pattern注解、同步更新Controller层的BindingResult处理逻辑、并在对应Service测试类中补上新case——全部操作发生在正确文件且符合项目已有风格，即验证通过。
