参与贡献
开发环境、构建命令、代码约定与提交流程。
环境准备
版本真源是仓库根的 .fvmrc。当前稳定版 Flutter 3.44.8，最低支持 3.44.2 / Dart 3.12.2。
| 工具 | 版本 |
|---|---|
| Flutter | 3.44.8 |
| Dart SDK | >=3.12.2 <4.0.0 |
| JDK | 17 |
| Android SDK | compileSdk 36 / targetSdk 36 / minSdk 26 |
| Gradle | 8.14 |
| Kotlin | 2.2.20 |
常用命令
flutter pub get
flutter run -d android --flavor dev # 本地开发
flutter test # 测试
flutter analyze --fatal-infos # 静态分析（CI 同款）
flutter build apk --release --flavor prod --target-platform android-arm64在本仓库跑 flutter test 需要绕开本地代理，否则 flutter_tester 的本机 WebSocket 会被拦截，报 Invalid WebSocket upgrade request。这与代码无关，官方模板同样会失败。
代码约定
- 静态分析基线为 0 error、0 warning、0 info（CI 跑
--fatal-infos， info 也算失败，本地务必用同一条命令） - 界面文案统一走 l10n（ARB 文件），新增文案需同步各语言。
同步工具在
tool/下（sync_arb.dart、merge_l10n_batch.py等一批*_arb*.py脚本），改文案前先看一眼有没有现成脚本，别手工逐语言改 - 应用支持简体中文、繁体中文（台湾 / 香港）、英文、日文、韩文
- 修改超级岛规则时，需同步原生实现、预览组件与对应测试
提交与 PR
- 提交信息用中文，说明改了什么与为什么
- 小步提交，避免把无关文件一起提交
- 仓库是共享工作区，常有并行开发，提交前确认只暂存自己负责的路径
更完整的约定见仓库的 CONTRIBUTING.md 与 行为准则。
参与学校适配
教务适配在独立仓库 qingyu_warehouse。需要网页调试、抓包或 JavaScript 基础，欢迎为自己学校补充适配脚本。
也可以用 AI 协作完成一次适配：读 skill、打开教务页后由你自己登录、在已登录会话里探测接口。启动指令与安全红线见 AI 协作适配教务。
文档贡献
本站内容在仓库 site/content/docs 下，使用 MDX 编写。修改后提交 PR 即可；构建与上线步骤见构建与部署。