docs: 鸿蒙计划补权限档位(plan/workspace/full)与SSE档位字段(据 pi API 梳理)

This commit is contained in:
dsh
2026-09-07 07:28:39 +08:00
parent 9cdf4b9e3f
commit 314c3224ce

View File

@ -45,7 +45,8 @@
| 回复/转发 | 回复落回原会话、转发开新线索(附件随行) | `POST /me/mail/{id}/forward` |
| 权限决策 | 待决请求列表、同意/拒绝/备注 | `GET /permission/pending``POST /permission/decide` |
| 实时推送 | 新邮件、权限决策、会话更新SSE | `GET /events/stream?access_token=` |
| 会话管理 | 改名、预算调整、改名提议展示/接受/驳回、归档 | `PUT /sessions/{id}/alias``GET\|PUT /sessions/{id}/budget``rename-proposal` 组、`POST /contacts/archive` |
| 会话管理 | 改名、预算调整、**权限档位调整plan / workspace / full**、改名提议展示/接受/驳回、归档 | `PUT /sessions/{id}/alias``GET\|PUT /sessions/{id}/budget``PUT /sessions/{id}/permission``rename-proposal` 组、`POST /contacts/archive` |
| 权限档位 | 会话头部展示当前档位与强制力(`permission_mode` / `permission_enforcement`),可随时调整 | 见会话管理行;档位三值 `plan / workspace / full` |
| 附件 | 下载(保存到本地/分享) | `GET /me/attachments/{id}` |
明确**不做**首版管理员后台、Agent 侧接口、日历(`/calendar/*`Web 端新功能,待 api 解读后二版评估)。
@ -101,6 +102,9 @@ entry/src/main/ets/
- 手工按 `\n\n` 分帧,解析 `event:` / `data:` 行;事件表与 API.md 一致:
`new_mail` / `permission_decision` / `session_update` / `session_archived` / `agent_online`
pi 梳理补充:`new_mail``session_update` 事件还带 `session_alias` /
`permission_mode` / `permission_enforcement` 字段 —— 鸿蒙端模型层按此定义,
会话卡片同时显示档位徽标。)
- **断线重连**:指数退避 1s→15s 上限(对齐 Web 端 `api/sse.ts``AbortController` 优雅停止。
- `new_mail` 到达 → 通知 MailStore 刷新收件箱与未读数;`permission_decision` → 刷新权限卡片。
- 生命周期App 前台订阅、后台/退到 `onBackground` 暂停,回到前台重连(省电 + 避免无谓重连风暴)。
@ -180,7 +184,7 @@ Agent 回信后在本端看到详情并可继续回复;新信未读计数正
### M3 实时 + 会话 + 权限2-3 天)
- `SseClient`(解析 + 退避重连 + 生命周期);未读徽标与列表随事件刷新;
- 会话列表(列表/卡片)、改名提议条(接受/驳回)、预算调整;
- 会话列表(列表/卡片)、改名提议条(接受/驳回)、预算调整、**权限档位调整与档位徽标**
- 权限待决列表 + 决策卡片。
**验收**:另一浏览器标签给本账号发信,鸿蒙端 ≤3s 内未读 +1SSE 路径);