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

# 开发

> 使用 Go 开发并验证 hyperlocalise CLI。

## 先决条件

* Go 1.26+
* `git`
* `make` 可在你的 shell 中使用

## 克隆仓库

```bash theme={null}
git clone https://github.com/hyperlocalise/hyperlocalise.git
cd hyperlocalise
```

## 引导工具和模块

```bash theme={null}
make bootstrap
```

这将下载 Go 模块并安装固定的 lint 工具链。

## 每日开发循环

```bash theme={null}
make fmt
make lint
make test
make check-build
```

## 在本地运行 CLI

```bash theme={null}
make run
# or
go run -ldflags "-X main.version=dev" ./apps/cli
```

## 安装本地二进制文件

```bash theme={null}
make install
hyperlocalise version
```

## 键代码位置

* `apps/cli/cmd/`：Cobra 命令、标志和 CLI 输出行为
* `pkg/i18nconfig/`：`i18n.yml` 和 `i18n.jsonc` 解析和验证
* `apps/cli/internal/i18n/runsvc/`：`run` 规划与执行流程
* `apps/cli/internal/i18n/syncsvc/`：同步编排和冲突逻辑
* `internal/i18n/storage/`：适配器契约和提供方集成

## 在打开 PR 之前

```bash theme={null}
make precommit
```

这会在与贡献者相同的流程中运行格式化、lint、测试和构建检查。