docs: 同步当前工程实现与验证基线

docs/后端接口契约-开发版.md

@@ -1,6 +1,6 @@
 # 后端接口契约（开发版）
 
-> 本文档记录当前前后端联调使用的接口壳子。业务服务尚未实现，最终字段以 FastAPI 运行时生成的 OpenAPI 为准。
+> 更新日期：2026-08-30。本文档记录当前前后端联调使用的已实现接口；机器可读字段、校验规则和响应模型以 FastAPI 运行时生成的 OpenAPI 为准。
 
 ## 契约入口
 
@@ -68,12 +68,16 @@
 | 方法 | 路径 | 用途 |
 | --- | --- | --- |
 | GET | `/api/providers` | 获取 Provider 配置列表 |
+| GET | `/api/providers/presets` | 获取 OpenAI、DeepSeek 与 Ollama 配置预设 |
 | POST | `/api/providers` | 新建 Provider 配置 |
 | GET | `/api/providers/{provider_id}` | 获取 Provider 配置 |
 | PATCH | `/api/providers/{provider_id}` | 更新 Provider 配置 |
 | DELETE | `/api/providers/{provider_id}` | 删除 Provider 配置 |
 | GET | `/api/providers/{provider_id}/models` | 获取模型及 Capability 列表 |
 | POST | `/api/providers/test` | 测试 Provider 连接 |
+| GET | `/api/credentials/{credential_id}` | 查询凭据是否已配置，不返回明文 |
+| PUT | `/api/credentials/{credential_id}` | 加密保存开发阶段 API Key |
+| DELETE | `/api/credentials/{credential_id}` | 删除已保存凭据 |
 
 Provider Contract 只传递 `credential_id` 或临时 `credential_context_id`。当前前后端开发阶段通过独立的 `PUT /api/credentials/{credential_id}` 接收 API Key，并立即加密落盘；该接口只返回配置状态，不返回密钥。Provider CRUD、模型列表和测试接口均不携带明文 API Key。Tauri 集成后由 Stronghold 接管存储实现。
 
@@ -99,8 +103,8 @@ Provider Contract 只传递 `credential_id` 或临时 `credential_context_id`。
 ```json
 {
   "error": {
-    "code": "NOT_IMPLEMENTED",
-    "message": "The contract is available, but its business service is not implemented.",
+    "code": "RESOURCE_NOT_FOUND",
+    "message": "Resource was not found.",
     "details": {}
   }
 }
@@ -155,6 +159,8 @@ RunCancelled
 
 ## 当前实现状态
 
+更新至 2026-08-30：后端 71 项回归测试通过。
+
 - Chat、Agent Run、Agent Events、Tool 列表、Provider 配置生命周期、模型列表和连接测试已经接入 AI Core。
 - Provider Adapter 当前包含 Mock、真正增量 SSE 的 OpenAI-Compatible Chat Completions，以及 Ollama JSONL Streaming。
 - Notes、Search、Index、Skills、Plugins、Tasks 和 Provider 生命周期均已接入业务服务。