docs(audit): 14 页 API 契约审计与凭据轮询 SSOT 收尾

记录凭据轮询/pending 契约对照与生产验证，更新功能指南与附录 J，并将 pending 相关类型集中到 api.ts。

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/project/nexus-functional-development-guide.md

@@ -533,12 +533,17 @@ main.ts → App.vue（侧栏/搜索）→ router-view
 | 功能 | API |
 |------|-----|
 | CRUD | `/servers/` |
+| **快速添加（仅 IP）** | `POST /servers/add-by-ip` — 轮询全部密码/SSH 预设；成功返回 `matched_preset` / `matched_username` |
+| **连接失败列表** | `GET /servers/pending` |
+| **失败重试 / 删除** | `POST /servers/pending/{id}/retry`、`DELETE /servers/pending/{id}` |
 | 批量选择 | 安装/升级/卸载 Agent、健康检查、删除 |
 | CSV 导出 | 客户端生成（无密码列） |
 | CSV 导入 | `POST /servers/import` FormData |
 | 详情面板 | 系统信息 + `GET /servers/{id}/logs` |
 | 表单 | `ServerFormDialog` + `useServerFormDialog` |
 
+详见附录 J（凭据轮询契约）。
+
 ### 12.3 TerminalPage `/terminal`
 
 | 功能 | 说明 |
@@ -589,6 +594,14 @@ main.ts → App.vue（侧栏/搜索）→ router-view
 
 三 Tab：密码预设、SSH 密钥、DB 凭据；编辑时空密码表示不修改。
 
+| Tab | API | 契约要点 |
+|-----|-----|----------|
+| 密码预设 | `GET/POST /presets/`、`PUT/DELETE /presets/{id}` | 字段 `name`、`username`（默认 `root`）、`encrypted_pw`；列表返回 `username` |
+| SSH 密钥 | `GET/POST /ssh-key-presets/`、`PUT/DELETE /ssh-key-presets/{id}` | 同上 `username`；私钥 `private_key` 仅创建/更新时传 |
+| DB 凭据 | `GET/POST /scripts/credentials`、`PUT/DELETE /scripts/credentials/{id}` | 脚本执行用 DB 连接，与 SSH 轮询无关 |
+
+`username` 供 `credential_poller` 在 `add-by-ip` / retry 时与预设密码或私钥组合尝试 SSH。
+
 ### 12.8 SchedulesPage `/schedules`
 
 Cron 调度推送；`runNow` → `POST /sync/files`；cron 前端正则校验。