设置与应用数据
DuckLocal 在磁盘上只保留一个文件。其余一切都在会话期间存在于内存中。
存储位置
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/DuckLocal/history.duckdb |
| Linux（如果在该平台构建） | ~/.local/share/ducklocal/history.duckdb |
这单个 DuckDB 文件包含三张表：查询历史、已注册的数据文件，以及一张小型的键值设置表——界面语言、打开的应用与 dashboard 标签页、最近文档列表，以及你信任过的应用文件夹。应用运行期间，它旁边会有一个 .wal 文件。
你的数据永远不会被复制进去。已注册的文件只按路径引用，并在启动时重新挂载。
重启后保留的内容
| 会记住 | 位置 |
|---|---|
| 已注册的数据文件 —— 路径、视图名、类型 | 应用数据文件 |
| 查询历史，包括失败记录 | 应用数据文件 |
| 界面语言 | 应用数据文件 |
| 界面大小 | 应用数据文件 |
| 侧栏是否收起 | 应用数据文件 |
| 打开的应用与 dashboard 标签页及其标题 | 应用数据文件 |
| 最近打开的应用与 dashboard（侧栏的 应用 / 仪表盘） | 应用数据文件 |
| 你选择信任的应用文件夹 | 应用数据文件 |
| 不会记住 | 说明 |
|---|---|
| 打开的查询 Tab 及其 SQL | 仅在内存中——运行过的查询在 查询历史 里 |
| 结果面板的内容 | 仅在内存中 |
| 打开的是哪个数据库文件 | 每次启动都从内存模式开始，除非你指定一个文件 |
| 窗口大小与位置 | 固定为 1440×900，最小 960×600 |
| 侧栏与结果面板的尺寸 | 每次启动固定 |
| 结果过滤器 | 仅在内存中 |
| 主题 | 总是以浅色启动 —— 见下文 |
| S3 凭据 | 按设计仅限当前会话 |
主题是唯一的例外：语言切换会被保存，主题切换不会，每次启动都进入浅色模式。
语言
标题栏中的 EN / 中 按钮会立即切换界面语言，并记录这一选择。
首次运行时 —— 在存储任何设置之前 —— 语言取自系统区域设置：LC_ALL 或 LANG 中包含 zh 则选择中文，其他情况选择英文。无法识别的已存值会回退到中文。
有少量字符串刻意不翻译：DuckLocal、S3 和 EXPLAIN 按钮标签、EN / 中 切换，以及凭据占位符。引擎和网络的错误消息会原样呈现，并且无论界面语言是什么，始终为英文。
主题
太阳/月亮按钮在浅色与深色主题之间切换。没有主题选择器，也没有可编辑的主题文件 —— 你得到的就是这两种模式。
界面大小
文字、图标和控件一起缩放，共四档：
| 大小 | 界面文字 | 编辑器文字 |
|---|---|---|
| 小 | 13px | 12px |
| 默认 | 14px | 13px |
| 大 | 16px | 15px |
| 特大 | 18px | 17px |
在标题栏的 Aa 按钮里选择，或用 ⌘+（放大）、⌘−（缩小）、⌘0（复原）逐档切换——无论焦点在哪里都有效，包括 SQL 编辑器。选择会被记住，切换明暗主题后也保持不变。
你拖动过的面板尺寸，以及 dashboard 图表的高度，仍以像素计：它们由你调整，不随界面缩放。
重置
要重新开始 —— 清空查询历史、已注册的文件、记住的标签页、信任过的应用文件夹和语言设置 —— 请退出 DuckLocal 并删除它的应用数据目录：
rm -rf ~/Library/Application\ Support/DuckLocal下次启动会重新创建它。你的数据文件绝不会受此影响，受影响的只有 DuckLocal 自己的记录。
疑难排查
症状、原因与解决办法都整理在常见问题排查页面。