HASH
设置 HASH 后台自动保存
为指定 HASH 容器设置后台自动保存文件，常见于全局 HASH 的持久化。
命令用途
Hash-BGSave 对应的实际命令写法是 HASH <标识> BGSave，用于为指定 HASH 容器设置后台自动保存文件。
它更常见于需要长期保留的全局 HASH 数据，例如物品描述缓存、公共配置缓存和跨次启动仍要复用的运行时数据。
命令名
Hash-BGSave
调用格式
HASH <标识> BGSave <文件名>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要设置后台自动保存的 HASH 容器标识。 |
BGSave | 是 | 固定子命令，表示设置后台自动保存。 |
文件名 | 是 | 后台保存使用的目标文件路径。 |
返回或影响
- 该命令会为指定 HASH 配置后台自动保存目标。
- 配置完成后，该 HASH 的数据可以按引擎规则持续落盘到指定文件。
示例
基础用法
#ACT
HASH H_ItemDesc BGSave ..\ItemData\ItemDesc.csv
这段写法适合给全局物品描述 HASH 配置后台自动保存文件。
注意事项
- 这类写法更常见于全局 HASH；如果只是短期临时数据，通常不需要专门配置后台保存。
- 如果文件路径不可写或目录不存在，后台保存效果通常不会符合预期。
Hash-BGSave是速查名，实际执行时写法是HASH <标识> BGSave ...。