JetSquirrel/DuckLocal
JetSquirrel/DuckLocal has 35 GitHub stars and 5 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 22:40 UTC. Last push 2026-11-12.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
A local-first workspace for querying and exploring your data, built natively on DuckDB.
数据README.zh-CN.md
原文
DuckLocal
指向你的文件,用 SQL 拿到答案。
快速的原生桌面数据工作台,直接查询 CSV、Parquet、JSON、Excel 和 DuckDB 文件。
不用配置连接,不用建 schema,也不会上传任何数据。
下载 · ducklocal.app · 文档 · English

为什么用 DuckLocal
- 打开就能查:打开一个文件、文件夹或通配符,里面的每张表都能直接查询。
- 数据不出本机:数据只留在你的电脑上,不需要账号,也没有遥测。
- 原生且快:用 Rust 写成,界面基于 GPUI,内置 DuckDB,不是套了壳的浏览器页面。
- 从查询到 Dashboard:查询结果可以直接画图,Dashboard 存成纯文本的
.dash文件,和数据放在一起。 - Agent 也能用:同一个二进制可以无窗口运行并输出 JSON,AI agent 能自己探索数据,再把结果交回你的窗口。
下载
| 平台 | 安装包 |
|---|---|
| macOS 12+(Apple 芯片) | ducklocal-macos-arm64.dmg(已签名并公证) |
| Windows x86_64 | ducklocal-windows-x86_64.zip |
| Linux x86_64 | ducklocal-linux-x86_64.tar.gz |
所有版本见 Releases 页面。
打开数据
ducklocal ./logs/ # 递归打开文件夹下的所有数据文件
ducklocal ./billing.parquet # 单个文件
ducklocal './data/*.csv' # 通配符
ducklocal warehouse.duckdb # 或已有的 DuckDB 数据库
也可以把文件拖进窗口,或者用文件对话框选择。工作区会被记住,下次启动直接恢复。
想看上面截图里的 Dashboard,在仓库目录里运行:
ducklocal examples/orders_dashboard/dashboard.dash
功能
⌨️ SQL 编辑器
|
🔍 数据探索
|
📊 Dashboard
|
🧩 内置 DuckDB
|
🍎 融入 macOS
|
🎨 用着顺手
|
为 AI Agent 而建
同一个二进制可以无窗口运行并输出结构化 JSON。AI agent 不用打开界面就能探索数据,再把结果显示到你的窗口里:
ducklocal schema ./data/ # 列出可查询的内容及列
ducklocal query --sql "SELECT * FROM 'sales.csv'" --limit 20
ducklocal check dashboard.dash # 校验 dashboard 文件
ducklocal propose dashboard.dash --from new.dash # 提出修改,交给人审阅
ducklocal session show # 分析是怎么走到这一步的,哪些结论已经不成立
ducklocal open --run --sql "SELECT ..." # 把结果交给正在运行的窗口
ducklocal open --state # 读取窗口当前显示的内容
ducklocal project check # 这个分析文件夹能不能在这里用,不能的话原因是什么
完整排查示例(英文):从第一条查询到审阅过的 Dashboard,走完一次虚构的 CloudTrail 安全事件。
官方 agent skill:教 AI 先查 schema,再做 SQL 分析和格式转换。复制到你的项目即可:
mkdir -p /path/to/your-project/.claude/skills cp -R skills/ducklocal /path/to/your-project/.claude/skills/默认安全:数据库文件默认只读,写入要加
--read-write。不是你自己写的 SQL,用query --restricted --allow-read PATH运行;不是你自己写的 Dashboard,用check --restricted --allow-read PATH校验。受限模式下,DuckDB 会拒绝访问其他文件、网络、扩展,也不允许写入。它不是操作系统级别的沙箱,具体限制见它管什么、不管什么(英文)。
全部命令和参数见 CLI 指南。agent 怎样和窗口保持同步,见交接约定(英文)。
隐私

数据只留在你的电脑上。DuckLocal 只在用到以下可选功能时才会联网:
- 地图图表的 OpenStreetMap 底图(「视图 → 在线底图」,默认关闭)
- 检查更新:有新版本时从 dl.ducklocal.app 下载,重启后安装(点击状态栏里的版本号,或打开「DuckLocal → 启动时检查更新」,默认关闭)
- 你主动配置的 S3
- 你安装的扩展
- SQL 里写明的远程地址
没有任何遥测。Network and privacy(英文)列出了所有联网途径和验证方法。
文档
使用指南、上手教程和问题排查见 ducklocal.app/docs(源码:JetSquirrel/ducklocal-site)。
开发
cargo run # 启动空工作区
cargo run -- ./data/logs/ # 或直接打开数据
./scripts/bundle.sh # 生成 target/release/DuckLocal.app(未签名)
发布构建支持 macOS 12+(Apple 芯片)、Linux x86_64 和 Windows x86_64;scripts/package-macos.sh 生成签名并公证的 dmg。详见开发文档。
Windows 说明
cargo build --release --locked
python scripts/check-windows.py target/release/ducklocal.exe
生成的 target/release/ducklocal.exe 双击打开 GUI 时不会弹出控制台窗口,资源管理器和任务栏显示内嵌的鸭子图标。CLI 命令会连接调用方的控制台,重定向的 stdin/stdout/stderr 和 LSP 管道照常可用。在 PowerShell 里需要等待命令结束或拿到退出码时,用 Start-Process -Wait -PassThru;要捕获 JSON 就用管道,例如 ./ducklocal.exe query --sql "SELECT 42" | Out-String。
想要更小的可执行文件,可以用 cargo build --profile compact --locked 构建,输出在 target/compact/ducklocal.exe。这个配置让 Rust 代码按体积优化,DuckDB 的 C++ 引擎仍用 opt-level=3;两种配置都保留 LTO 和符号剥离。默认 release 构建仍以速度优先,实际大小和速度请在目标机器上比较。
重新生成仓库里的 Windows 图标:安装 Pillow 后运行 python scripts/make-icons.py --windows。正常构建不需要 Python 或 Pillow;MSVC 构建需要 Visual Studio C++ 工具和 Windows SDK。
性能探针:cargo test --release perf_g_ -- --nocapture --test-threads=1 比较分类图表的内存分配,perf_h_ 比较长文本的列宽自适应;输出包含基线和优化后的耗时、分配次数和字节数。
开源协议
Apache-2.0 · Copyright © 2026 JetSquirrel