个性化与参考
个性化:深色模式与中英文切换
深色模式
功能栏 🌙/☀ 一键切换(位置见截图中红色箭头标注),全局生效(编辑器、网格、弹窗、闪屏全套深色适配),选择持久记忆,下次启动自动恢复。

中英文切换
功能栏 EN/中 开关,全界面文案实时切换(含错误提示、状态栏、闪屏):

注意: 编辑器中的 SQL、数据内容、对象名永不翻译——翻译层只作用于界面文案。
快捷键速查
| 快捷键 | 功能 |
|---|---|
| F5 | 执行(选中片段或首条) |
| F9 | 执行脚本(逐条) |
| F4 | 转到定义(光标处表/视图 → 结构) |
| Ctrl+Space / Alt+/ | 手动触发补全 |
| Ctrl+/ | 注释/取消注释 |
| Ctrl+F | 查找替换 |
| Ctrl+O / Ctrl+S | 打开 / 保存 SQL 文件 |
| Ctrl+C(有选区时) | 复制选中矩形(TSV) |
| Esc | 关闭弹窗/菜单/查找条 |
常见问题(FAQ)
1. 连接测试失败「Connection refused」?
检查目标库端口是否开放、防火墙;Halo 默认端口是 1921 不是 1521;云数据库需在白名单中加入本机出口 IP。
2. 连上了但对象树是空的?
确认账号对该模式有权限;PostgreSQL/Halo 点击连接名后会列出全部可见模式,系统模式(pg_*、information_schema)默认隐藏,可用模式搜索找到。
3. SQL 报错看不懂位置?
看详情页错误卡片——「第 X 行 · 第 Y 列」chip 与红色标出的出错 token,点「定位到编辑器」一键跳转。
4. 编辑数据保存时提示需要主键?
就地编辑依赖主键定位行。给表加主键,或改用 SQL 语句更新。
5. int(10) 建表报错?
PostgreSQL/Halo 的整数类型不接受长度参数(这是 MySQL 习惯)。向导会自动忽略整数类型的长度;手写 DDL 请去掉 (10)。
6. 导入 CSV 空值变成了空字符串?
空单元格按 NULL 处理;若目标列 NOT NULL 会出现在失败日志中,可下载日志逐行排查。
7. 大结果集卡顿?
结果集采用流式加载(首批 1000 行,滚到底续传)。需要全量导出时用工具条「导出」,导出走全量流式管道不依赖界面加载。
8. 忘记主口令?
主口令无法找回(这是安全设计)。功能栏「主口令」→「忘记口令」→ 红色确认区清除,之后需重新录入各连接密码。
9. 如何完全离线使用?
除 AI 副驾驶与数据库连接外,所有功能本地运行。AI 需配置可达的模型服务端(支持内网部署的 OpenAI 兼容服务)。
10. 多开会不会互相干扰?
连接配置、历史、标签按用户目录隔离;同一 Windows 账户的多个远程会话(RDP)会自动派生不同后端端口,互不冲突。