DuckLocal — 在电脑上直接用 SQL 查你的文件

#	date	revenue
1	2026-09-01	62,598.48
2	2026-09-02	57,985.04
3	2026-09-03	63,822.32
4	2026-09-04	66,597.12
5	2026-09-05	70,272.00
6	2026-09-06	69,695.60
7	2026-09-07	64,956.32
8	2026-09-08	69,076.72
9	2026-09-09	68,762.00
10	2026-09-10	57,039.12
11	2026-09-11	65,157.92
12	2026-09-12	63,551.60
13	2026-09-13	55,106.72
14	2026-09-14	68,052.40

智能体在终端里，
数据在 DuckLocal 里。

智能体写 .dash 文件，你在 DuckLocal 里看图、直接在图上留评论。

ducklocal schema
先看结构，再查询
列出所有文件、表和列。加 --stats 得到逐列统计。
ducklocal query
结果是 JSON，不靠猜
一次一条 SQL，输出有边界的 JSON。结果被截断时会明确说明。
ducklocal open
把结果摆到你面前
把查询或仪表盘送进打开的窗口。--state 读回你正在看的内容。
ducklocal check
仪表盘是一个文本文件
.dash 文件能像代码一样比对和提交，交给你之前先校验。
ducklocal comments
在图表上审阅
你在图上留言，智能体修改、回复并标记解决。
ducklocal presence
看见智能体在做什么
窗口里显示智能体正在读或改哪张图。

三步接入你的智能体

在 DuckLocal 里打开 命令行与 AI…，点 安装命令。
点 添加到 Claude Code 安装官方技能。用 Codex 或 Cursor 时，点 复制说明 再粘贴给它。
在终端里把任务交给智能体，回到 DuckLocal 看结果、留评论。

# 命令行与 AI… → 安装命令 → 添加到 Claude Code
$ claude
❯ 用 sales.csv 做一个销售仪表盘，在 DuckLocal 里打开。
❯ 处理 sales.dash 上的评论。

# 命令行与 AI… → 安装命令 → 复制说明
# 把说明粘贴给智能体，然后：
❯ 用 sales.csv 做一个销售仪表盘，在 DuckLocal 里打开。
❯ 处理 sales.dash 上的评论。

# 先确认命令可用
$ ducklocal --help
# 在 DuckLocal 源码仓库里，把技能复制到你的项目
$ mkdir -p /path/to/your-project/.claude/skills
$ cp -R skills/ducklocal /path/to/your-project/.claude/skills/

从文件到答案

拖入文件

把 CSV、表格或整个文件夹拖进来，没有导入步骤。
- 本地文件1
- sales224
- dateDATE
- channelVARCHAR
- revenueDOUBLE
它已经是一张表

sales.csv 变成表 sales，列显示在侧栏里。原文件不会被复制或改动。
用 SQL 提问

按 ⌘↵ 得到答案，再把它画成图，或保存为 CSV、Parquet。

打开你手头已有的文件

文件都在原处打开。

.csv逗号分隔
.tsv制表符分隔
.parquet列式存储，读得快
.json .ndjsonJSON 文档，或每行一条
.xlsx .xls .ods每个工作表一张表
.duckdb直接作为数据库打开，或附加在旁边
s3://S3 与兼容存储
folder/里面的所有数据文件，或 *.csv 这样的通配符

了解 DuckLocal 如何做本地数据分析 →

拿到第一个答案之后

查询为什么慢、一列里装了什么、表在哪个库里，都能在窗口里找到答案。

SQL 编辑器、结果与图表、数据源

用性能分析看清时间花在了哪一步。
查看结果里每一列的空值、不同值和取值范围。
附加更多 DuckDB 或 SQLite 数据库，在侧栏管理扩展。
在 Mac 上从访达直接打开 Parquet 和 DuckDB 文件，或用快速查看预览。

你的数据只属于你

文件在原地读取，从不复制，也不上传。
没有账号，没有遥测，没有云服务。
你不打开，它就不联网。
以 Apache-2.0 开源，每一行代码都能查看。

常见问题

DuckLocal 是什么？

一款免费开源的桌面应用，用 SQL 查询你电脑上的数据文件。DuckDB 内置在应用里，拖进来的每个文件都是一张可以查询的表。

DuckLocal 会上传我的数据吗？

不会。文件在原地读取，从不复制、上传或修改。没有账号，也没有遥测。

能打开哪些文件格式？

CSV、TSV、Parquet、JSON、Excel 与 OpenDocument 表格、DuckDB 数据库、整个文件夹，以及亚马逊云 S3 或兼容存储里的文件。

支持哪些系统？

Apple 芯片的 macOS 12 及以上、64 位 Windows 10 及以上，以及 glibc 2.35 及以上的 x86_64 Linux。

数据量可以有多大？

DuckDB 直接在文件上查询，不会先把数据载入应用。结果表格最多显示 100,000 行，导出时写出完整结果。

Claude Code、Codex 这类智能体能用它吗？

能。ducklocal 命令在终端里执行 SQL 并输出 JSON。官方技能会教智能体先看表结构，再查询。

用你自己的文件试试

下载 DuckLocal，拖入一个文件，运行一条查询。

下载 Mac 版 10 分钟上手教程

智能体在终端里，数据在 DuckLocal 里。

先看结构，再查询

结果是 JSON，不靠猜

把结果摆到你面前

仪表盘是一个文本文件

在图表上审阅

看见智能体在做什么