贡献指南
HappyRO 接受客户端、服务端、Gateway、Admin、API、部署、文档和中文本地化改进。开始修改前先确认代码归属，避免把一个产品变更拆到错误仓库。
仓库
| 仓库 | 内容 |
|---|---|
| happyro | 跨仓库编排、部署、资源、本地化和文档 |
| happyro-client | 浏览器客户端和冒险工具 |
| happyro-server | rAthena 服务端 |
| happyro-gateway | HTTP、WebSocket 和资源网关 |
| happyro-admin | 管理后台 |
| happyro-api | Go API、后台会话与游戏工具接口 |
| happyro-doc | 公开文档站、玩家指南与安装说明 |
基本流程
- 从目标仓库
main创建主题分支。 - 阅读目标仓库的
AGENTS.md和相关设计文档。 - 一次提交只处理一个逻辑变更；产品变更在所属仓库补充 changelog，文档站不为纯文档修改新增产品日志。
- 运行相关测试、构建和真实交互验收；纯站点文档修改运行
npm run docs:build并检查链接，不等同产品验收。 - 检查工作区，避免提交 kRO 资源、密钥、数据库、日志和中间产物。
HappyRO 自有提交使用 type(scope): subject 格式。玩家可见文本使用中文；代码标识、技术日志和上游内容保持其约定语言。