一切皆文件
功能的连接、历史记录、代码片段、卡片和规则都以普通文件的形式存在,你可以随意备份、查看和留存。
连接、查询历史、代码片段、实体卡片、快捷键和规则都以 普通文件的形式存在于磁盘上。这里没有日后要费劲挣脱的不透明应用数据库:你可以备份它们、对比差异,或者在适合你的工作流时把它们放进 Git。
它们的位置
所有内容都位于一个 SQLLY 文件夹中,该文件夹位于你所用平台的常规配置和数据位置之下:
| 平台 | 文件夹 |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/ |
| Windows | %APPDATA%\SQLLY\ 和 %LOCALAPPDATA%\SQLLY\ |
| Linux | ~/.config/SQLLY/ 和 ~/.local/share/SQLLY/ |
你会在那里找到这样几个文件:
connections.json- 你的连接以及它们所属的客户、项目和环境,包括它们的颜色和安全策略。 绝不包含任何密码 (见下文)。keybindings.json- 你的 键盘映射,可手动编辑。intellisense-rules.jsonc- 补全规则,允许写注释——一份没法加注释的规则文件,你是不会去维护的。entra-accounts.json,query-ai-summary.json,cli-agent.json- 每个功能单独设置一个文件,所以重置就是删除而不是手术。- 用于查询历史、AI 对话、MCP 提案与审计以及临时结果溢出文件的文件夹。
机密是刻意设计的例外。 密码和令牌存储在操作系统的钥匙串中(macOS 钥匙串、Windows 凭据管理器、Linux Secret Service),而 JSON 仅存储一个 引用 到它们。这正是可以放心复制、diff 或提交你的连接文件的原因:凭据并不在文件里。
版本化设置文件
connections.json, tenant-scoping.json,以及其他所有设置文件都记录了它们保存时的配置版本。当 SQLly 启动并发现一个由旧版本保存的文件时,它会对该文件进行一次升级,并以当前版本保存。在此版本中,升级会清除早期版本保存的租户范围设置(参见 租户范围)。你无需执行任何操作。
为什么采用这种结构
- 你随时可以离开。 你的设置不用 SQLly 也清晰可读,迁移时只需要一条
cp. - 你可以先审阅。 对连接或键映射的更改会以你能读懂的 diff 呈现——这是唯一能在团队里长期留存下去的配置变更方式。
- 你可以修复它。 出了问题时,你面对的是一个自己就能打开的文件,而不是一个得提交支持工单才能查看的数据库。
- 同步不归我们管。 因为它只是文件,任何能同步文件的工具都可以用,我们不必插在中间。