第57章 TablePlus 第57章:LLM 插件,内置 AI 助手帮你编写和解释 SQL
实用功能
LLM 插件
TablePlus 内置了 AI 助手,可以帮你编写和解释查询语句。它位于右侧边栏的 Assistant 标签页,支持你选择的 LLM 服务商或编码代理:OpenAI、Anthropic、Google AI、OpenRouter、DeepSeek、GitHub Copilot、Codex CLI、Ollama、任何 OpenAI 兼容服务器,以及任何支持 Agent Client Protocol (ACP) 的代理。
右侧边栏中的 Assistant 标签页
启用助手
助手默认是启用的。要开启或关闭它,可以通过以下任一方式:
打开设置(⌘ + ,)> AI Agent,开启或关闭 Enable Assistant Tab on the Right Sidebar。 在右侧边栏点击设置按钮,选择 Enable LLM Chat。
助手启用后,右侧边栏会显示两个标签页:Details 和 Assistant。
配置服务商
打开设置 > AI Agent。列表中会显示内置服务商以及你添加的自定义服务商。选中一个服务商即可在列表下方进行配置。
偏好设置 > LLM Agent
为你希望新会话默认使用的服务商打开 Default Vendor。你仍然可以在每个会话中切换服务商。
API key 服务商
OpenAI、Anthropic、Google AI、OpenRouter 和 DeepSeek 需要使用服务商提供的 API key:
选择该服务商。 将你的 key 粘贴到 API Key 中。 选择一个 Default Model。TablePlus 会从服务商加载模型列表。
你的 API key 保存在 macOS 钥匙串中。
Ollama
Ollama 在本地运行模型。TablePlus 默认连接 http://localhost:11434。
启动 Ollama 并拉取一个模型,例如 ollama pull llama3.2。 选择 Ollama 并选择一个 Default Model。
Ollama 不需要 API key,但 TablePlus 在发送请求前会要求填写。在 API Key 中输入任意文本即可。
GitHub Copilot
需要一个已订阅 Copilot 的 GitHub 账号。
选择 GitHub Copilot 并点击 Connect to GitHub。 复制 TablePlus 显示的代码,然后点击 Open GitHub Login Page,粘贴代码以授权 TablePlus。 登录后,选择一个 Default Model。
点击 Logout 可断开 GitHub 账号。
Codex CLI
TablePlus 可以使用你 Mac 上已安装、并用 ChatGPT 账号登录的 Codex CLI。
安装 Codex CLI。 选择 Codex CLI。TablePlus 会自动找到 codex 可执行文件,并显示其 Status、Version 和 Path。如果找不到 Codex,请在 Path 中输入完整路径。 点击 Sign in with ChatGPT 并完成 Codex 登录。点击 Refresh 更新状态。 选择一个 Default Model。
Codex CLI 设置
与 Codex 对话时,聊天框还会显示 Reasoning 和 Speed 按钮,方便你为所选模型选择推理强度和服务级别。
自定义 LLM(OpenAI 兼容)
用于自托管模型或任何提供 OpenAI 兼容 API 的服务。
点击服务商列表下方的 Add,选择 Custom LLM (OpenAI-compatible).... 填写 Name、Host(例如 localhost:3006)、Sub Path(例如 /v1),如果服务器需要的话再填写 API Key。 选择一个 Default Model。
自定义代理(ACP)
你可以接入任何支持 Agent Client Protocol 的编码代理,例如 Claude Code(通过 ACP 适配器)或 Gemini CLI。TablePlus 会在你的 Mac 上启动该代理并与之对话。代理无法从 TablePlus 读取你的文件或执行终端命令。
点击服务商列表下方的 Add,选择 Custom Agent (ACP).... 填写:
Name:代理在聊天中显示的名称。 Command:代理的可执行文件,可以是 shell PATH 中的命令,也可以是绝对路径,例如 claude-agent-acp。 Arguments:命令的额外参数,例如 --acp。 Environment:额外的环境变量,每行一个 KEY=VALUE,例如 ANTHROPIC_API_KEY=...。这些内容保存在 macOS 钥匙串中。
点击 Test Agent 检查 TablePlus 能否启动该代理。
自定义代理(ACP)设置
只有开启 TablePlus MCP Server 后,自定义代理才能查询你的数据库。参见“代理的数据库访问”。
要删除自定义服务商,在列表中右键点击并选择 Delete。内置服务商无法删除。
与助手对话
打开一个连接,点击右侧边栏顶部的 Assistant。 通过聊天框中的按钮选择服务商和模型。 在 Ask anything... 中输入问题,按 Return 发送。按 Shift + Return 可以换行。
点击停止按钮可以取消还在生成的回复。
添加表作为上下文
为了让助手写出更准确的查询,点击 @ Add context 并勾选它需要了解的表和视图。TablePlus 会把它们的结构(CREATE 语句)加入对话。
添加表作为上下文
运行生成的 SQL
回复中的每个 SQL 代码块都有两个按钮:
Copy:将代码复制到剪贴板。 Run:将代码添加到 SQL 编辑器并运行。
将鼠标悬停在消息上,可以复制、重发或删除它。
让助手自主执行查询
助手也可以自行查询当前数据库,例如在回答前先查看数据:
只读查询(如 SELECT)会直接执行。如果连接启用了安全模式,TablePlus 会照常要求确认。 其他查询需要你先批准。聊天框中会出现 Approve SQL 按钮,点击后可以查看 SQL 及其目标数据库,然后点击 Approve 执行或 Cancel 拒绝。即使批准后,安全模式仍然生效。
执行前审查 SQL
管理会话
点击聊天框中的菜单按钮可以:
New Chat:开始新对话。 Clear Chat:清除当前对话的所有消息。 History:打开最近的对话,或搜索历史对话。 Settings..:打开设置 > AI Agent。
代理的数据库访问
所有内置服务商和自定义 OpenAI 兼容服务商都会自动获得当前数据库的访问权限。自定义 ACP 代理则使用 TablePlus MCP Server:
打开设置 > MCP。 开启 Enable MCP Server。
自定义代理设置中会显示代理是否拥有数据库访问权限。代理执行的查询会按“查询批准”所述进行确认。
在其他 AI 工具中使用 TablePlus
MCP Server 还能让其他 AI 工具(如 Codex 或 Claude Code)操作你的 TablePlus 连接。所有选项参见 MCP Server。在设置 > MCP 中:
Client Setup 可一键将 TablePlus 添加到 Claude Code、Codex、Grok Build 或 Antigravity,例如 Add to Claude Code。Others… 列出更多代理,如 Cursor 和 VS Code。Manual Setup… 显示可复制到任何其他客户端(Manual)的配置,或 HTTP Server 的地址。 Access Token 可创建具有 Read Only、Read & Write 或 Full Access 权限的令牌,限定其可访问的连接,并可随时撤销。默认情况下,TablePlus 会为 tableplus-mcp 命令自动生成一个令牌。 Approval needed for unsafe query 要求你批准在 Silent Mode 连接上修改数据的查询(默认开启)。 Allow remote access (TLS) 允许其他机器连接。使用 Export Certificate… 在远程机器上安装服务器证书。 Activity 显示 MCP 客户端发出的请求。
偏好设置 > MCP
隐私
助手只是一个聊天客户端。它直接从你的 Mac 向你配置的服务商或代理发送请求,不经过 TablePlus 的服务器。因此如果你屏蔽了某个服务商的访问,助手就无法使用它。
服务商会收到:
你的消息以及此前的对话内容。 你添加为上下文的表的结构(CREATE 语句)。 助手请求时的当前连接信息,例如数据库名、驱动和服务器版本。 助手执行的查询的结果。只有你批准的查询或只读查询才会执行,但其结果(包括数据行)会发送给服务商。
你的服务商可能按照其自身条款存储和处理这些数据。如果数据必须保留在本机,请使用本地模型,例如 Ollama。