docs: 记录 dev/master 两侧的硬契约差异
This commit is contained in:
@@ -28,3 +28,16 @@
|
||||
- `/ai/tasks` **必须固定返回 201**。Java 端 `AiServiceClient.submitTask()` 把非 201 视为提交失败,
|
||||
所以不能用 200 表达「复用了已有任务」;复用信息放在响应体的 `reused` / `status` 字段里。
|
||||
- `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