Goose 创建的文件
Goose 会在磁盘上创建若干文件和目录。本页列出全局与本地两类文件。
全局文件和目录
Goose 会在用户主目录(以 ~ 表示)中创建以下全局文件和目录:
| 位置 | 说明 | 是否跨版本共享 | 是否跨客户端共享 |
|---|---|---|---|
~/.gooserc | 启动 Goose CLI 客户端时会执行该文件内容。可包含 dot command 与 SQL 语句。命名风格参考 ~/.bashrc、~/.zshrc 这类“启动命令”文件。 | 是 | 仅 CLI 使用 |
~/.goose_history | 历史记录文件,类似 ~/.bash_history 和 ~/.zsh_history。由 Goose CLI 客户端使用。 | 是 | 仅 CLI 使用 |
~/.goose/extensions | 已安装扩展的二进制文件。 | 否 | 是 |
~/.goose/stored_secrets | 由 Secrets manager 创建的持久化密钥。 | 是 | 是 |
本地文件和目录
Goose 会在工作目录(内存连接)或数据库文件所在目录(持久化连接)创建以下文件和目录:
| 名称 | 说明 | 示例 |
|---|---|---|
⟨database_filename⟩ | 数据库文件。仅在磁盘模式创建。文件可使用任意扩展名,常见为 .goose、.db、.ddb。 | weather.goose |
.tmp/ | 临时目录。仅在内存模式创建。 | .tmp/ |
⟨database_filename⟩.tmp/ | 临时目录。仅在磁盘模式创建。 | weather.tmp/ |
⟨database_filename⟩.wal | Write-ahead log 文件。若 Goose 正常退出,WAL 文件会在退出时删除;若 Goose 崩溃,恢复数据需要该 WAL 文件。 | weather.wal |
如果你在 Git 仓库中工作并希望 Git 不跟踪这些文件,
可参考 Goose 的 .gitignore 配置说明。