#环境准备
克隆仓库，装 Rust 工具链，再装本地开发需要的工具和 git hook。
git clone https://github.com/tw93/Kaku.git
cd Kaku
# Homebrew 把 rustup 装在 keg-only，需要手动 export PATH
brew install rustup
echo "export PATH=\"$(brew --prefix rustup)/bin:\$HOME/.cargo/bin:\$PATH\"" >> ~/.zprofile
exec zsh -l
rustup toolchain install 1.93.0
# 装 cargo-nextest、cargo-watch、nightly rustfmt
make install-tools
# 装 pre-commit hook：每次提交前会跑 format + test
make install-hooks#日常开发
常用 Make 目标如下，覆盖格式化、类型检查、测试和本地运行。
| 命令 | 用途 |
|---|---|
make fmt | 自动格式化代码，需要 nightly Rust |
make fmt-check | 只检查格式，不修改文件 |
make check | cargo check，捕获类型和语法错误 |
make test | 跑单元测试 |
make dev | 本地快速 debug 运行，从 target/debug 启动 kaku-gui |
make build | 编译二进制，不打 app bundle |
make app | 编译 debug app bundle 到 dist/Kaku.app |
推荐的开发循环：
make fmt # 先格式化
make check # 确认能编译
make test # 跑测试
make dev # 本地快速运行，不打包需要调整日志等级时给 make dev 加环境变量：
RUST_LOG=debug make dev#发布构建
本地复现发布产物的几条命令，正式发布走 scripts/release.sh。
# 完整发布：app + DMG，universal 二进制
./scripts/build.sh
# 输出：dist/Kaku.app 和 dist/Kaku.dmg
# 只为当前架构构建，速度更快，本地测试用
./scripts/build.sh --native-arch
# 只打 app bundle，跳过 DMG
./scripts/build.sh --native-arch --app-only
# 构建完直接打开 app
./scripts/build.sh --native-arch --open#Pull Request
- Fork 仓库，从
main切出分支。 - 改代码。
- 本地跑
make fmt && make check && make test。 - 提交并推送。
- 开 PR，目标分支选
main。
CI 顺序：format check，单元测试，cargo check，universal 二进制构建验证。任意一步红就需要先修复。