docs(api): 规划第二阶段统一接口契约

2026-08-31 20:26:53 +08:00
parent 0b20bad0a8
commit bb8091f2e6
4 changed files with 1432 additions and 3 deletions
@@ -1859,6 +1859,8 @@ POST   /api/index/rebuild
 GET    /health
 ```

+第一阶段已实现路径和第二阶段冻结草案分别见 `后端接口契约-开发版.md` 与 `第二阶段接口契约-开发版.md`。规划接口完成前不得在前端假定其可用；完成后以 OpenAPI、Pydantic Contract 和 TypeScript Wire DTO 的一致结果为准。
+
 HTTP 返回统一错误结构：

 ```json