需先配置数据库连接并测试成功，再通过add context注入schema，启用query console快捷生成sql，开启轻量模式避免资源占用，最后端到端验证功能闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Qoder中直接使用内建数据库能力，但发现@database功能未生效、Schema无法识别或SQL生成失败，则可能是由于数据库连接未建立、Query Console未激活或上下文未正确注入。以下是启用Qoder内建数据库功能并完成本地轻量配置的步骤：
一、确认数据库连接已配置并测试通过
Qoder不会自动创建数据库连接，必须先在JetBrains系IDE（如IntelliJ IDEA、DataGrip或Qoder原生IDE）中手动配置连接，否则@database指令将无目标可选。该步骤是所有数据库操作的前提。
1、在Qoder IDE中按快捷键 Ctrl+Shift+Alt+Insert（Windows/Linux）或 Cmd+Shift+Alt+Insert（macOS）打开Database工具窗口。
2、点击左上角“+”号 → 选择“Data Source” → 从列表中选取对应数据库类型（如MySQL、PostgreSQL、SQLite等）。
3、填写连接参数：Host、Port、Database、Username、Password；对SQLite则指定.db文件绝对路径。
4、点击“Test Connection”，确保显示Connection successful；若失败，请检查服务是否运行、防火墙是否放行或SQLite路径是否存在。
二、在Ask/Agent模式中注入数据库上下文
Qoder需显式获知开发者意图访问哪个数据库Schema，才能生成语义准确的SQL。仅靠连接存在并不自动触发上下文绑定，必须通过Add Context流程主动声明。
1、在Qoder主界面右侧聊天窗口（Ask或Agent模式），点击输入框下方的“Add Context”按钮。
2、在弹出菜单中选择@database选项。
3、从下拉列表中勾选已成功测试的数据库连接名称（如“myapp_production”或“local_sqlite”）。
4、确认后，Qoder将在本次对话上下文中加载该Schema的完整表结构、字段类型与外键关系。
三、通过Query Console快捷生成SQL
此方式绕过自然语言理解链路，直接在数据库执行环境中触发Qoder推理，响应更快、上下文更聚焦，适合日常高频小查询场景。
1、在Database工具窗口中，双击已配置的数据库连接，展开其Schema节点。
2、右键任意表或Schema → 选择“Open Console”以启动专属Query Console。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
3、确保该Query Console处于焦点状态（标题栏高亮）。
4、按下快捷键：Ctrl + Shift + I（Windows/Linux）或 Cmd + Shift + I（macOS）。
5、在弹出的Qoder输入框中输入自然语言描述，例如：“统计每个用户最近一次登录时间”。
6、按Enter，Qoder立即返回带“Execute”按钮的SQL代码块；点击即可在当前Console中执行。
四、启用轻量模式规避资源占用
默认情况下，Qoder会扫描整个项目目录以构建全局上下文索引，该过程在低配设备上易引发内存溢出或卡顿。启用轻量模式可跳过项目扫描，仅依赖显式注入的数据库Schema进行推理，显著降低CPU与内存压力。
1、在Qoder IDE右上角点击用户头像 → 进入Settings → Agent Settings。
2、找到“Context Scanning Policy”选项，将开关设为Off。
3、在同页面向下滚动，勾选Don't scan project files!提示项。
4、关闭设置页，重启Qoder IDE使配置生效。
五、验证@database功能闭环
完成上述配置后，需执行端到端验证，确保数据库上下文能被正确解析、SQL能被生成并执行，且结果符合预期。此步骤不依赖外部服务或网络，纯本地完成。
1、在已激活的Query Console中，输入任意合法SQL（如SELECT 1;）并执行，确认基础连接正常。
2、切换至Ask模式聊天窗口，输入：“用@database生成一个查询，列出users表中email以‘gmail.com’结尾的用户ID和注册时间。”
3、确认Qoder返回的SQL包含FROM users WHERE email LIKE '%gmail.com' AND ...等关键子句。
4、点击返回SQL块中的“Execute”按钮，观察Query Console是否输出对应数据行。
