docs: 同步第二阶段进度与扩展复盘

2026-09-02 20:22:06 +08:00
parent ff3da5d6b1
commit 1e32b2e0f4
18 changed files with 505 additions and 37 deletions
@@ -1,6 +1,6 @@
 # 后端接口契约（开发版）

-> 更新日期：2026-09-01。本文档记录当前前后端联调使用的已实现接口；机器可读字段、校验规则和响应模型以 FastAPI 运行时生成的 OpenAPI 为准。第二阶段尚未实现的规划接口见 `第二阶段接口契约-开发版.md`，不要将规划路径视为当前服务能力。
+> 更新日期：2026-09-02。本文档记录当前前后端联调使用的已实现接口；机器可读字段、校验规则和响应模型以 FastAPI 运行时生成的 OpenAPI 为准。第二阶段尚未实现的规划接口见 `第二阶段接口契约-开发版.md`，不要将规划路径视为当前服务能力。

 ## 契约入口

@@ -176,7 +176,7 @@ RunCancelled

 ## 当前实现状态

-更新至 2026-09-02：后端 126 项回归测试通过；第二阶段 Plugin Command 与 Plugin Settings/Secret 接口已实现，详细 DTO 和边界见《第二阶段接口契约-开发版》第 7 节。
+更新至 2026-09-02：后端 136 项回归测试通过；第二阶段 Plugin Command 与 Plugin Settings/Secret 接口已实现，详细 DTO 和边界见《第二阶段接口契约-开发版》第 7 节。

 - Chat、Agent Run、Agent Events、Tool 列表、Provider 配置生命周期、模型列表和连接测试已经接入 AI Core。
 - Agent Run/Event 已持久化到 SQLite；SSE 帧携带 sequence `id`，断线后可以回放缺失事件。Trace API 与 Benchmark 共用同一事件事实，并在入库前执行 Secret 脱敏和结果限长。
@@ -2,7 +2,7 @@

 > 文档状态：接口冻结草案
 >
-> 更新日期：2026-09-01
+> 更新日期：2026-09-02
 >
 > 依据：`../architecture/第二阶段团队分工表.md`、`../architecture/AI笔记软件技术栈说明-团队版-v2.3.md`、`后端接口契约-开发版.md`

@@ -27,7 +27,7 @@

 | 标记 | 含义 |
 | --- | --- |
-| 已实现 | 第一阶段接口已经存在，第二阶段保持兼容 |
+| 已实现 | 接口已经落地并由当前 OpenAPI 与自动化测试覆盖 |
 | 扩展 | 路径已存在，第二阶段增加字段、事件或行为 |
 | 计划新增 | 第二阶段需要新增实现 |
 | 内部 Contract | 不直接暴露 HTTP，由两个模块共同遵守 |