Rohithgilla12/data-peek · 上手攻略
- 仓库：Rohithgilla12/data-peek
- 链接：https://github.com/Rohithgilla12/data-peek
- 分类：开发者工具 · 数据库客户端
- 作者：Jay
- 更新：2026-10-05
这是什么
Data Peek 是一款轻量、键盘优先的 SQL 客户端桌面应用，支持 PostgreSQL、MySQL、Microsoft SQL Server，正在开发 SQLite 支持（约 1,677 Stars，单人维护）。核心理念：打开就用，用完就走，不拖泥带水。两秒启动、不跑 splash、不装插件、内存占用低——面向需要随时瞄一眼数据但不打算对付复杂 DBA 工具的开发者。
解决什么问题
DBeaver 太大、Navicat 太贵、pgAdmin 太慢、TablePlus 闭源且跨平台功能不一致。Data Peek 用 Electron 构建，主打"最小化干扰"：没有项目概念、没有服务器配置、没有账户注册，直接连数据库跑查询。
快速安装
# macOS / Linux 快速安装（推荐）
curl -fsSL https://install.cat/Rohithgilla12/data-peek | sh
# Windows PowerShell
irm https://install.cat/Rohithgilla12/data-peek | iex
# macOS Homebrew
brew install --cask Rohithgilla12/tap/data-peek
# 或直接下载 Release
# https://github.com/Rohithgilla12/data-peek/releases/latest
# .dmg（macOS 已签名公证）/ .exe（Windows）/ .AppImage / .deb / .tar.gz（Linux）
⚠️ macOS 若提示"App 已损坏"，运行：
xattr -cr "/Applications/Data Peek.app"⚠️ Linux AppImage / .deb 会自动更新，.tar.gz 需手动下载。
核心用法
连接数据库
支持直接输入连接字符串或图形化配置：
postgres://user:password@host:5432/database
mysql://user:password@host:3306/database
mssql://user:password@host:1433/database
也支持 SSH 隧道跳板机（密码或密钥认证）。
键盘快捷键
| 操作 | 快捷键 |
|---|---|
| 命令面板（搜索所有操作） | Cmd/Ctrl + K |
| 执行查询 | Cmd/Ctrl + Enter |
| 格式化 SQL | Cmd/Ctrl + Shift + F |
| 切换 Tab | Cmd/Ctrl + Tab |
| 跨 Tab 引用结果 | @tab-name（命名 Tab 后） |
| 历史查询 | / 打开 OmniBar 搜索 |
CLI 诊断命令
# 安装 CLI（Node.js 环境）
npm install -g @data-peek/cli
# 或直接
npx @data-peek/cli doctor postgres://user:pass@localhost:5432/app
# 检查 8 项 PostgreSQL Schema 问题（无主键/无索引 FK/重复索引/无效索引/膨胀/未 vacuum/可空外键）
npx @data-peek/cli doctor "postgres://user:pass@localhost:5432/app"
# CI 模式：发现 Warning 即失败
npx @data-peek/cli doctor "$DATABASE_URL" --fail-on warning
CLI doctor 输出示例包含发现的问题及对应修复 SQL，可直接复制执行。
特色功能一览
| 功能 | 说明 |
|---|---|
| Monaco 编辑器 | Schema 感知的自动补全，理解表别名 |
| Saved Queries | 文件夹 + 标签管理查询片段，支持 SQL Notebooks（Markdown + SQL 混排） |
| Inline Editing | 直接修改单元格，提交前预览生成的 INSERT/UPDATE/DELETE |
| Watch Mode | 每 500ms ~ 5min 自动重跑只读查询，高亮变更单元格 |
| Time Machine | 本地快照历史结果，Cmd/Ctrl + Shift + H 对比任意两次运行差异 |
| AI 助手 | 自然语言转 SQL，可接 OpenAI / Anthropic / Google / Groq / 本地 Ollama |
| MCP Server | 可选内置 MCP Server（默认关闭），暴露数据库连接给 AI 智能体；写入需 App 内审批 |
| ER 图 | 交互式实体关系图 |
| Explain Viewer | EXPLAIN 结果的交互式计划树 |
| Performance Hints | 缺失索引、N+1 模式、慢查询建议修复 |
| 数据脱敏 | Demo/截图时模糊敏感列 |
MCP Server（AI 智能体集成）
# 在 App 设置中开启 MCP Server 后，可被 Claude Code / Codex 等调用
# 只读操作自动回滚，写操作需 App 内审批
典型适用场景
- 临时数据检查：不需要建项目、不需要配置服务器，几秒钟看数据
- Schema 审查：CLI doctor 做数据库体检，CI/CD 流水线集成
- 数据对比：Time Machine 对比两次查询结果差异
- AI 辅助开发：让 Claude Code 直接查数据库跑 SQL
坑与注意
- 不是 DBA 工具：官方明确说明不擅长服务器管理、数据库迁移、大规模导入导出。
- SQLite 仍在开发：README 写明"Coming soon"，生产环境不要依赖。
- 单人维护：Stars 1,677 但只有一位维护者，有 dormancy pledge（维护者 12 个月不活跃则豁免商业许可），但功能更新可能较慢。
- 商业使用需付费：MIT 源码免费，但公司内 ≥2 人使用或代理/咨询机构使用需要 Pro 许可证。
- AI 助手需自备 Key：内置 AI 助手不包含 API Key，需自购 OpenAI / Anthropic / Ollama 等。
- Linux AppArmor：Ubuntu 24.04+ 需要 AppArmor profile（.deb 安装包自带），AppImage 需手动配置。
与同类对比
| Data Peek | DBeaver | TablePlus | Navicat | |
|---|---|---|---|---|
| 体积 | ~50MB | ~300MB+ | ~30MB | ~200MB |
| 启动速度 | ~2s | 慢 | 快 | 快 |
| License | MIT（源码）/ 付费 Pro | 免费（社区）/ 付费 | 闭源付费 | 闭源付费 |
| AI 集成 | ✅ 内置 | ❌ | ❌ | ❌ |
| MCP Server | ✅ | ❌ | ❌ | ❌ |
| CLI | ✅（doctor 等） | 有限 | ❌ | ❌ |
| PostgreSQL | ✅ | ✅ | ✅ | ✅ |
| MySQL | ✅ | ✅ | ✅ | ✅ |
| SQL Server | ✅ | ✅ | ✅ | ✅ |
| SQLite | 开发中 | ✅ | ✅ | ✅ |
Data Peek 在轻量 + 键盘优先 + AI 集成 + MCP 四维上是当前开源首选。如果你需要的是随时瞟一眼数据的工具，它比 DBeaver 舒服太多；如果需要企业级 DBA 功能，换 Navicat 或 DBeaver。
一句话结论
Data Peek 是追求"秒开、查数、闪人"的独立开发者首选 SQL 客户端，内置 AI 助手和 MCP Server 让它天然适合 AI 辅助编程流；注意 SQLite 未完成、商业使用需付费。