要在本地无数据库连接时用CodeGeeX生成准确SQL，必须人工提供表结构（注释或JSON Schema）和明确业务需求，模型不自动推断字段、外键或数据库方言，需手动修正语法并确保JSON合法、路径默认。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在没有数据库连接的本地环境里，用 CodeGeeX 准确生成可执行的 SQL 语句，必须人工喂给它表结构和业务目标——模型不会自己猜字段名、不会推断外键关系、更不会知道你上周改过哪个表的主键类型，漏掉关键约束就可能输出 ON 1=1 或 SELECT * FROM user u, dept d 这类无效语句。
安装插件并启用本地模式
打开 VSCode → 扩展商店搜索 “CodeGeeX” → 点击安装 → 重启窗口。首次启动默认走云端，必须手动切换：点击右下角状态栏 “CodeGeeX” 图标 → 选择 “Switch to Local Mode”。【下载路径不可更改，必须保留在默认缓存目录，否则插件无法定位模型】。等待约 4.2GB 模型自动下载并解压，状态栏图标变绿即就绪。
提供表结构上下文
CodeGeeX 本地版不读取数据库元信息，必须人工提供结构描述。两种方式任选其一：
方法一：在 .sql 文件顶部用注释写明，例如：
-- TABLE users (id INT PK, name VARCHAR(50), email VARCHAR(100), dept_id INT FK→departments.id)
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
方法二：在光标上方插入三引号 JSON Schema（推荐复杂关联场景）：
```json
{"tables": [{"name": "users", "columns": [{"name": "id", "type": "INT", "pk": true}, {"name": "dept_id", "type": "INT", "fk": "departments.id"}]}]}
```
【JSON 必须严格合法，字段名不能带空格或特殊符号，否则模型解析失败后将返回空建议】
输入自然语言需求并触发补全
第一步：在已含表结构注释的 .sql 文件中，新起一行输入中文需求，例如：“查上个月注册且邮箱未验证的用户数量”。
第二步：将光标置于该行末尾 → 按 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（Mac）触发补全。
第三步：生成结果默认带 -- generated 注释头，可直接执行；若出现 PostgreSQL 的 LIMIT OFFSET 写法而你用的是 MySQL，需手动改为 LIMIT + OFFSET 子句——【CodeGeeX 本地模型不绑定具体数据库引擎，输出语法需按目标方言手动修正】。
问答模式中精准提问
按下 Ctrl+Shift+I（Windows/Linux）或 Cmd+Shift+I（Mac）唤出侧边栏对话框。
输入自然语言时，必须包含时间范围、聚合条件、排序要求三个要素，例如：“统计 2024 年 Q3 各部门订单总金额，仅显示金额超 50 万的部门，按金额降序排”。
如果字段跨三张以上表，或存在同名列（如多个表都有 status），光靠自然语言无法让模型准确绑定来源，必须提前上传 DDL 或 JSON Schema。
