> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 初始化

> 在你的项目中创建或覆盖 i18n.yml 模板。

## 用法

```bash theme={null}
hyperlocalise init [--force]
```

## 它的作用

* 从内置模板编写一个最小可运行的`i18n.yml`
* 以 `locales`、`buckets` 和 `llm.profiles.default` 开头 בלבד
* 将高级配置如 `groups`、`llm.rules`、`context_memory` 和 `cache` 留在入门文件之外
* 如果文件已存在则失败（除非`--force`）

## 标志

* `--force`：覆盖现有的`i18n.yml`

## 起始形状

生成的入门模板保持初学者路径简洁：

* `locales`：源语言区域设置和目标语言区域设置
* `buckets`：源到目标文件映射
* `llm.profiles.default`：提供商和模型

当省略`groups`时，Hyperlocalise 会自动将该配置视为一个隐式的`default`组，其中包含所有目标区域设置和所有 bucket。

有关 `groups`、`llm.rules`、`context_memory`、回退和缓存的完整示例，请参见 [i18n config](/configuration/i18n-config)。

## 典型流程

```bash theme={null}
hyperlocalise init
hyperlocalise run --dry-run
```