atuin/docs/zh-CN/config.md

138 lines
3.5 KiB
Markdown
Raw Normal View History

# 配置
Atuin 维护两个配置文件,存储在 `~/.config/atuin/` 中。 我们将数据存储在 `~/.local/share/atuin` 中(除非被 XDG\_\* 覆盖)。
您可以通过设置更改配置目录的路径 `ATUIN_CONFIG_DIR`。 例如
```
export ATUIN_CONFIG_DIR = /home/ellie/.atuin
```
## 客户端配置
```
~/.config/atuin/config.toml
```
客户端运行在用户的机器上,除非你运行的是服务器,否则这就是你所关心的。
见 [config.toml](../../atuin-client/config.toml) 中的例子
### `dialect`
这配置了 [stats](stats.md) 命令解析日期的方式。 它有两个可能的值
```
dialect = "uk"
```
或者
```
dialect = "us"
```
默认为 "us".
### `auto_sync`
配置登录时是否自动同步。默认为 true
```
auto_sync = true/false
```
### `sync_address`
同步的服务器地址! 默认为 `https://api.atuin.sh`
```
sync_address = "https://api.atuin.sh"
```
### `sync_frequency`
多长时间与服务器自动同步一次。这可以用一种"人类可读"的格式给出。例如,`10s``20m``1h`,等等。默认为 `1h`
如果设置为 `0`Atuin将在每个命令之后进行同步。一些服务器可能有潜在的速率限制这不会造成任何问题。
```
sync_frequency = "1h"
```
### `db_path`
Atuin SQlite数据库的路径。默认为
`~/.local/share/atuin/history.db`
```
db_path = "~/.history.db"
```
### `key_path`
Atuin加密密钥的路径。默认为
`~/.local/share/atuin/key`
```
key = "~/.atuin-key"
```
### `session_path`
Atuin服务器会话文件的路径。默认为
`~/.local/share/atuin/session` 。 这本质上只是一个API令牌
```
key = "~/.atuin-session"
```
### `search_mode`
使用哪种搜索模式。Atuin 支持 "prefix"(前缀)、"fulltext"(全文) 和 "fuzzy"(模糊)搜索模式。前缀(prefix)搜索语法为 "query\*",全文(fulltext)搜索语法为 "\*query\*",而模糊搜索适用的搜索语法 [如下所述](#fuzzy-search-syntax) 。
默认配置为 "prefix"
### `filter_mode`
搜索时要使用的默认过滤器
| 模式 | 描述 |
|--------------- | --------------- |
| global (default) | 从所有主机、所有会话、所有目录中搜索历史记录 |
| host | 仅从该主机搜索历史记录 |
| session | 仅从当前会话中搜索历史记录 |
| directory | 仅从当前目录搜索历史记录|
过滤模式仍然可以通过 ctrl-r 来切换
```
search_mode = "fulltext"
```
#### `fuzzy` 的搜索语法
`fuzzy` 搜索语法的基础是 [fzf 搜索语法](https://github.com/junegunn/fzf#search-syntax) 。
| 内容 | 匹配类型 | 描述 |
| --------- | -------------------------- | ------------------------------------ |
| `sbtrkt` | fuzzy-match | 匹配 `sbtrkt` 的项目 |
| `'wild` | exact-match (quoted) | 包含 `wild` 的项目 |
| `^music` | prefix-exact-match | 以 `music` 开头的项目 |
| `.mp3$` | suffix-exact-match | 以 `.mp3` 结尾的项目 |
| `!fire` | inverse-exact-match | 不包括 `fire` 的项目 |
| `!^music` | inverse-prefix-exact-match | 不以 `music` 开头的项目 |
| `!.mp3$` | inverse-suffix-exact-match | 不以 `.mp3` 结尾的项目 |
单个条形字符术语充当 OR 运算符。 例如,以下查询匹配以 `core` 开头并以 `go`、`rb` 或 `py` 结尾的条目。
```
^core go$ | rb$ | py$
```
## 服务端配置
`// TODO`