diff --git a/AGENTS.md b/AGENTS.md index a19b0f6..079af61 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,6 +2,12 @@ > TypeScript + Fastify 独立 AI 服务,集成 DeepSeek LLM,为后端提供异步 AI 任务。 +> **版本耦合警告**:本服务的 `/ai/tasks` 入参与任务结果字段**直接对接着 lpt-be**。 +> 改 `aggregate-report` 的结果字段(曾经把 `report` 字符串改成 `{sessionSummary,expectationVerdict,freeSummary}`) +> 或 `generate-mind-map` 的 `reports` 入参形状(曾经从 `string[]` 改成对象数组)时, +> 必须同时确认 lpt-be 侧已经能读新形状;否则旧版 lpt-be 读不到字段会**静默降级**,界面无报错。 +> 具体做法:两边同分支同环境一起发(`dev` 配 `dev`、`master` 配 `master`),不要跨环境出包。 + ## 规则与技能位置 - 通用规则(跨仓库):meta 仓库 `.agents/roles/` @@ -164,6 +170,20 @@ npm run typecheck # 同时校验 src 与测试文件 - 暴露端口:5199。 - 健康检查:`curl http://localhost:5199/health`。 +## 分支与发布 + +本仓库与 `lpt-be` / `lpt-fe` 同规则,**一个分支对一个环境**,靠分支而不是靠参数区分: + +| 分支 | 环境 | namespace | 镜像 tag | +|------|------|-----------|----------| +| `dev` | 开发 | `lpt-dev` | `lpt-ai:dev` | +| `master` | 生产 | `lpt-prod` | `lpt-ai:prod` | + +- 发版在 Gitea 上手动触发 `lpt-ai Build & Deploy`(`workflow_dispatch`),选择 `environment`。 +- 流水线第一步会校验**分支 ↔ 环境**:从 `dev` 发 `prod`、或从 `master` 发 `dev` 都会被直接拒绝。 + - 例外:`main` 仅作为历史分支保留在 `7c751bf`(prod 冻结点),不再用于发版。 +- 日常开发在 `dev`;需要上生产时,把 `dev` 合并进 `master`,并**同步升级 lpt-be**(见顶部版本耦合警告)。 + ## 关联项目 | 项目 | 路径 | 端口 | 说明 |