Compare commits
4
Commits
0c0c5be299
...
dev
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0d27ee84d9 | ||
|
|
1c8a846635 | ||
|
|
499e218072 | ||
|
|
4a667a5d91 |
@@ -4,7 +4,7 @@ on:
|
|||||||
workflow_dispatch:
|
workflow_dispatch:
|
||||||
inputs:
|
inputs:
|
||||||
environment:
|
environment:
|
||||||
description: '部署环境(本仓库仅 main 分支;dev/prod 均从 main 部署)'
|
description: '部署环境(dev 仅允许 dev 分支;prod 仅允许 master 分支)'
|
||||||
required: true
|
required: true
|
||||||
type: choice
|
type: choice
|
||||||
options:
|
options:
|
||||||
@@ -14,7 +14,7 @@ on:
|
|||||||
env:
|
env:
|
||||||
REGISTRY: 192.168.123.199:5000
|
REGISTRY: 192.168.123.199:5000
|
||||||
APP: lpt-ai
|
APP: lpt-ai
|
||||||
REPO_URL: http://git.cat-shark.xyz/cat-shark/lpt-ai.git
|
REPO_URL: https://git.cat-shark.xyz/cat-shark/lpt-ai.git
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
build-and-deploy:
|
build-and-deploy:
|
||||||
@@ -33,18 +33,31 @@ jobs:
|
|||||||
fi
|
fi
|
||||||
ENV="${{ inputs.environment }}"
|
ENV="${{ inputs.environment }}"
|
||||||
echo "branch=$BRANCH environment=$ENV sha=${{ gitea.sha }}"
|
echo "branch=$BRANCH environment=$ENV sha=${{ gitea.sha }}"
|
||||||
# lpt-ai 仅维护 main:dev/prod 都从 main 出包,靠 environment 区分 namespace/镜像 tag
|
# lpt-ai 与 lpt-be/lpt-fe 同规则:master 发 prod,dev 发 dev。
|
||||||
|
# 不允许跨环境出包:本服务的入参/出参结构与 lpt-be 的版本强耦合,
|
||||||
|
# 把 dev 的代码推到 prod 会让旧版 lpt-be 读到不认识的字段(静默降级)。
|
||||||
|
case "$ENV" in
|
||||||
|
prod)
|
||||||
case "$BRANCH" in
|
case "$BRANCH" in
|
||||||
main|master)
|
master) echo "OK: prod 允许从 $BRANCH 部署" ;;
|
||||||
echo "OK: lpt-ai 从 $BRANCH 部署到 $ENV"
|
|
||||||
;;
|
|
||||||
*)
|
*)
|
||||||
echo "ERROR: lpt-ai 只能从 main/master 部署,当前分支是 '$BRANCH'"
|
echo "ERROR: prod 只能从 master 部署,当前分支是 '$BRANCH'"
|
||||||
|
echo "请切换到 master 后再 Run workflow,并选择 environment=prod"
|
||||||
exit 1
|
exit 1
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
case "$ENV" in
|
;;
|
||||||
dev|prod) ;;
|
dev)
|
||||||
|
case "$BRANCH" in
|
||||||
|
dev) echo "OK: dev 允许从 $BRANCH 部署" ;;
|
||||||
|
*)
|
||||||
|
echo "ERROR: dev 只能从 dev 分支部署,当前分支是 '$BRANCH'"
|
||||||
|
echo "请切换到 dev 后再 Run workflow,并选择 environment=dev"
|
||||||
|
echo "(禁止用 master 代码部署到 lpt-dev,避免环境错配)"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
;;
|
||||||
*)
|
*)
|
||||||
echo "ERROR: 未知 environment=$ENV"
|
echo "ERROR: 未知 environment=$ENV"
|
||||||
exit 1
|
exit 1
|
||||||
|
|||||||
@@ -2,6 +2,12 @@
|
|||||||
|
|
||||||
> TypeScript + Fastify 独立 AI 服务,集成 DeepSeek LLM,为后端提供异步 AI 任务。
|
> 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/`
|
- 通用规则(跨仓库):meta 仓库 `.agents/roles/`
|
||||||
@@ -164,6 +170,20 @@ npm run typecheck # 同时校验 src 与测试文件
|
|||||||
- 暴露端口:5199。
|
- 暴露端口:5199。
|
||||||
- 健康检查:`curl http://localhost:5199/health`。
|
- 健康检查:`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**(见顶部版本耦合警告)。
|
||||||
|
|
||||||
## 关联项目
|
## 关联项目
|
||||||
|
|
||||||
| 项目 | 路径 | 端口 | 说明 |
|
| 项目 | 路径 | 端口 | 说明 |
|
||||||
|
|||||||
@@ -28,3 +28,16 @@
|
|||||||
- `/ai/tasks` **必须固定返回 201**。Java 端 `AiServiceClient.submitTask()` 把非 201 视为提交失败,
|
- `/ai/tasks` **必须固定返回 201**。Java 端 `AiServiceClient.submitTask()` 把非 201 视为提交失败,
|
||||||
所以不能用 200 表达「复用了已有任务」;复用信息放在响应体的 `reused` / `status` 字段里。
|
所以不能用 200 表达「复用了已有任务」;复用信息放在响应体的 `reused` / `status` 字段里。
|
||||||
- `TaskRecord` 的 `status` / `result` / `error` 字段名被 Java 端轮询逻辑依赖,新增字段可以,改名不行。
|
- `TaskRecord` 的 `status` / `result` / `error` 字段名被 Java 端轮询逻辑依赖,新增字段可以,改名不行。
|
||||||
|
|
||||||
|
### 跨分支契约差异(`dev` 与 `master` 配对不同的 lpt-be)
|
||||||
|
|
||||||
|
**分支即契约版本**:`dev` 配 lpt-be `dev`,`master` 配 lpt-be `master`。
|
||||||
|
下面两处是本仓库历史上唯一让旧版 lpt-be 静默降级的地方,改动前必须确认对应分支的 lpt-be 能读新形状。
|
||||||
|
|
||||||
|
| 能力 | `dev`(新 lpt-be) | `master`(旧 lpt-be) | 旧端读不到时的表现 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| `aggregate-report` 结果 | `{sessionSummary, expectationVerdict, freeSummary, model}` | `{report: "<纯文本>", model}` | 旧 be 读 `result.report` 得 null → 降级为内置按序拼接,界面无报错 |
|
||||||
|
| `generate-mind-map` 的 `reports` 入参 | 对象数组 `{ref, taskName, sessionSummary, expectationVerdict, freeSummary}` | `string[]`(纯报告正文) | 新提示词把字符串渲染成 `[报告 undefined]`,报告正文被丢弃 |
|
||||||
|
|
||||||
|
- `compare-recall` 的入参(`taskName` / `standardOutline` / `recallOutline`)与结果 JSON 字段两侧一致,可放心改提示词但不要改字段名。
|
||||||
|
- 从 `dev` 合并到 `master`(= 上生产)时必须与 lpt-be 的升级同步进行。
|
||||||
|
|||||||
Reference in New Issue
Block a user