From c419ffd814e0b0efd32c87bbd56ac177072b2f8a Mon Sep 17 00:00:00 2001 From: catShark <1716967236@qq.com> Date: Sun, 8 Nov 2026 17:58:29 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E5=88=86=E6=94=AF?= =?UTF-8?q?=E4=B8=8E=E7=8E=AF=E5=A2=83=E5=8F=A3=E5=BE=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 17 +++++++++++++++++ README.md | 11 +++++++++++ 2 files changed, 28 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index ec6f1a7..3a1c450 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -39,6 +39,23 @@ - 认证:Sa-Token,token 放请求头 `satoken`(不用 Cookie) - 只使用学习会话相关端点,**不碰 `review/*`** +## 分支与发布 + +与 `lpt-be` / `lpt-fe` / `lpt-ai` 同规则:**一个分支对一个环境**(本仓库没有服务端部署,环境差异落在“默认 API 地址”上)。 + +| 分支 | 环境 | 默认 API 地址 | +|------|------|----------------| +| `dev` | 开发 | `https://lpt-dev.cat-shark.xyz/api` | +| `master` | 生产 | `https://lpt.cat-shark.xyz/api` | + +- 两个分支的代码**只允许差 `ApiClient.DEFAULT_BASE_URL` 这一行**(其余全部一致)。改这一行时必须确认自己在哪个分支上,改完只提本分支。 +- 不要跨分支合并:`dev` 的功能要上生产时,只把常规代码改动同步过去,并保持 master 的默认地址不变。 +- 构建在 Gitea 手动触发 `.gitea/workflows/build.yml`(dev/prod 二选一),不需要签本地环境: + 1. 校验「分支 ↔ 环境」(从 dev 发 prod 直接被拒); + 2. 校验代码里的 `DEFAULT_BASE_URL` 是否与本环境一致,不一致直接失败; + 3. 容器内构建 APK(`ci/Dockerfile` 固定 JDK 17 / cmdline-tools / android-36),产物归档为 Actions artifact 并打印 sha256。 +- APK 不入 Git(`.gitignore` 已忽略 `*.apk`),分发走 Actions artifact。 + ## 提交规范 同 meta 仓库:简短中文,格式 `类型: 简述`,例如 `feat: 新增悬浮窗碎片录入`。 diff --git a/README.md b/README.md index 6fc0dbd..d60ed83 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,17 @@ LPT 的学习计时原本只能在电脑浏览器里进行;而真实的学习 > ⚠️ Compose BOM ≥ 2026.04(compose 1.11+)要求 **AGP 9.1+ 与 compileSdk 37**,配 AGP 8.13.2 会报 `requires Android Gradle plugin 9.1.0 or higher`。要么整体升 AGP 9,要么锁在 2026.03.01。 +### 分支与环境 + +| 分支 | 环境 | 默认 API 地址 | 用途 | +|------|------|----------------|------| +| `dev` | 开发 | `https://lpt-dev.cat-shark.xyz/api` | 日常开发与验证 | +| `master` | 生产 | `https://lpt.cat-shark.xyz/api` | 给真实使用打的生产包 | + +两个分支**只差 `ApiClient.DEFAULT_BASE_URL` 一行**;安装后仍可在「设置」页临时改地址(调试用)。 + +打包走 Gitea Actions 的 `lpt-android Build`(手动触发,选 `dev` 或 `prod`),它会先校验「分支 ↔ 默认地址」是否匹配,再把 APK 归档成 artifact——本地不需要配签名环境。 + ## 构建与安装 ```bash