TableLite 使用说明书整体界面一览
这份说明书按「你会在界面上看到什么、每个控件做什么」来组织。 每一章都用线框图画出界面，图上标着数字编号，下面的表格逐个解释这些控件的作用与快捷键。
这个工具是做什么的
TableLite 是一个在 macOS 上运行的 MySQL / MariaDB 客户端，用来日常查看数据、改数据、跑 SQL。 它是自用工具，不是通用产品，因此界面上没有多余的东西。
它擅长的事
- 打开一张表，分页翻、排序、筛选着看
- 选中一行后在右侧字段栏里改字段、增删行，改完先预览再一次性提交
- 写 SQL 跑脚本，多个语句的结果分开看
- 通过 SSH 跳板机连内网数据库
- 导出 CSV / JSON / SQL，从 CSV 导入数据
它不做的事
- 不改表结构（建表、加列、加索引请手写 DDL）
- SQL 编辑器没有自动补全、没有格式化
- 查询结果只读，只有表数据视图能改
- 不支持 MySQL / MariaDB 之外的数据库
- 数据网格没有撤销重做，回退靠「放弃全部改动」（SQL 编辑器里有撤销 / 重做）
先记住这一条
在界面上做的任何修改都不会立刻写进数据库。改动会先进入「变更暂存区」， 你确认无误后再点提交，所有改动打包在一个事务里执行——要么全部成功，要么全部回滚。 所以看到一个橙色的格子，说明这个改动还没生效，随时可以放弃。
主窗口长什么样
整个程序只有一个窗口，从上到下是工具栏（下沿有一条连接颜色带）、主体区、状态栏。 主体区横向分三块：左侧栏（库、对象树）、标签内容区、右侧字段栏（表数据标签专有）。 下图的数字对应后面表格里的说明。
| # | 控件 | 作用 | 快捷键 |
|---|---|---|---|
| 1 | 连接切换器 | 显示当前连接与所在库。点开可以切换到别的连接、编辑连接、重新连接或断开。切换连接不会断开之前那个连接，只是换一组标签来看。 | ⌘K 切换库 |
| 2 | 新建查询 / 打开表 | 左边的 ‹ › 是标签的历史前进后退。+ 新建查询 开一个空的 SQL 标签；+ 打开表… 弹出表名搜索框，不用去左侧栏翻。 | ⌘T |
| 3 | 变更操作组 | 放弃丢掉全部未提交修改；预览列出将要执行的 SQL；提交真的写库。按钮上的数字是待提交条数，为 0 时整组变灰。 | ⇧⌘⌫ ⇧⌘P ⌘S |
| 4 | 连接颜色带 | 一条 2pt 的细带，用连接配置里的颜色着色。给生产库配红色，一眼就能看出当前在哪个环境。 | — |
| 5 | 库切换器与搜索框 | 上面是当前连接的库下拉，点开可以换库。下面是对象树搜索框，输入即过滤，会自动展开所有分组。 | ⌘F 聚焦搜索 |
| 6 | 对象树 | 当前库里的表、视图，分组标题上带数量。单击表打开数据视图，右键有更多操作。 | ⌘R 刷新 |
| 7 | 查询历史 / Console Log | 左侧栏底部两个入口。查询历史记录你在编辑器里跑过的语句；Console Log 记录所有发给服务器的语句，包括客户端自动发的元数据查询。 | ⇧⌘C |
| 8 | 标签栏 | 当前连接打开的所有东西：表数据、表结构、查询、历史、日志。标题右边的橙点表示这个标签有未提交的改动。中键点击关闭标签。 | ⌘W ⌘[ ⌘] ⌘1…⌘9 |
| 9 | 标签内容区（数据网格） | 占窗口最大的部分。表数据标签里是只读的数据网格：能选、能排序、能复制，但不能在格子里改值。查询标签里是编辑器加只读结果区，结构标签里是只读的列表。 | — |
| 10 | 状态栏 | 左半是连接状态和当前标签的关键信息（行数、页数、耗时）；右半是随标签变化的操作按钮，比如 筛选、列、导出…。 | — |
| 11 | 右侧字段栏 | 表数据标签专有：选中一行后，这里列出它的全部字段（列名、类型、值），也是唯一能改数据的地方。顶部有「搜索字段」框。默认显示，用工具栏最右的 ▤ 或「视图 → 显示/隐藏右侧字段栏」开关，没有快捷键。 | — |
怎么读这份说明书
- 先看第 2 章「界面结构」，把窗口各分区的职责弄清楚，后面所有章节都在这套框架里。
- 图上带数字的圆点和下面的表格一一对应。鼠标移到表格某一行，图上的圆点会变成橙色，方便定位。
- 橙色的提示框是需要特别注意的行为，红色的提示框是不可撤销的操作。
- 末尾的第 12、13 章是速查表：快捷键总表和提示文案规范，可以当参考手册随时翻。
功能与章节对照
| 我想…… | 去哪一章 |
|---|---|
| 新建一个连接，或者配 SSH 跳板机 | 01 · 连接、10 · SSH 隧道 |
| 搞清楚窗口里每块区域是干什么的 | 02 · 界面结构 |
| 打开一张表翻数据、排序、看大字段 | 03 · 浏览表数据 |
| 改数据、加行、删行，然后提交（编辑在右侧字段栏里做） | 04 · 编辑数据 |
| 只看符合条件的行，或者隐藏某些列 | 05 · 过滤器 |
| 写 SQL、跑多条语句、查历史记录 | 06 · 查询编辑器 |
| 看一张表的列、索引、外键、建表语句 | 07 · 表结构视图 |
| 导出数据给别人，或者从 CSV 导一批数据进来 | 08 · 导入与导出 |
| 防止误改生产库 | 09 · 只读模式 |
| 调整默认每页多少行、编辑器字体之类 | 11 · 偏好设置 |
| 查某个操作的快捷键 | 12 · 快捷键总表 |
| 弄明白某个弹窗或报错是什么意思 | 13 · 提示与错误 |
完全离线
这份说明书就是一组静态 HTML 文件，放在项目的 manual/ 目录里。
直接双击 index.html 用浏览器打开即可，不需要起服务器，也没有任何外部依赖。
需要纸面版时用浏览器的「打印 → 存储为 PDF」。