# 贡献指南

## 仓库结构

- 上游 Omarchy 代码尽量不动；OmarchyCN 改动集中在 `bin/omarchy-cn-*`、`bin/omarchycn`、`cn/`、`install/cn/`
- 上游代码定期与 `basecamp/omarchy` 同步：同步 PR 由维护者或 CI 工作流发起，人工审查合并

## 提交规范

- 遵循 [AGENTS.md](AGENTS.md) 的全部代码与命令约定（Bash 5、`[[ ]]`/`(( ))`、两空格缩进、`#!/bin/bash`）
- 提交保持原子：一个提交只做一件事
- 涉及系统修改的命令必须支持 `--dry-run`，写配置前先备份

## 测试

- CLI 与 shell 改动跑 `./test/all`
- OmarchyCN 新增测试放在 `test/shell.d/*-test.sh`

## 提交流程

1. Fork 或在 issue 中讨论
2. 提交 PR 到 `quattro` 分支，说明动机与验证方式
3. 通过 CI 与代码审查后合并