AskaEth
32634feefa
审计（DevDocs/audit/00-总览.md §4④ 及 02/05/09/10/11/15/16 报告）多路独立发现：本文件
自称「唯一详细参考 + 每变更必同步」，实际系统性滞后于实现，且有整段与实现逐条相反。
修正 15 类（每处都回代码核对行号）：
- §0.1 与 §6（:986/:992/:1030/:1052/:1130/:1246）：「WS 上行不鉴权 / history 回放对任何
已认证连接」→ 角色门口径（`route` 首行默认拒；`replayHistory` 首行门；下行仅 7 个状态机
信号全发），指向 design/11 §7.1/§7.2 与 api-client §3
- §5.26/§5.27 plugins install：501 → 真实 200 {installed,name,kind,transport,toolCount}
- §1.3 鉴权列：9 行 owner|admin → owner|admin|viewer（routes.go 实为 viewerAuth）
- §3.5 POST /sessions：「无 body」→ 可选 {personaId?}（未知角色 400；角色创建后不可变）
- §3.3 PersonaSummary：补 mood/thinking、修正 memoryNamespace（读侧恒 ""）与示例
- §3.1 chat：补可选 mode；stream 非必填 ｜ §4.4 kind 枚举改为 tool|skill|channel|mcp|iot
- §5.8/§5.9 IoT 501 文案、§5.29 personaId 缺省与 semantic 原因、§5.32 rotate-jwt 响应
- §7：「无 /upload 端点 / 无 REST 语音端点」→ 两者都存在并给形状（原与本文 §0.3 自相矛盾）
- §8.1/§8.4：移除已实现项；observability ×3 → ×4
结构性（根因治理）：文件头新增**权威归属声明** —— 契约以 api-client 为准，本文件是内部/
运维参考，凡重复的契约描述改为引用 api-client（复述就是两份真相）；并如实降级其自封的
「唯一详细参考」称号，注明"字段示例可能滞后"。
未补（留给后续「文档补全」批次，已登记）：session_read、message_edited/deleted、
/admin/plugins/installed、/admin/observability/logs、/admin/notifications、
/sessions/{id}/read、upload/files/audio 概览行，以及若干字段示例滞后。
验证：git diff --stat -- Docs/ 仅本文件（+65/−46）；未触碰任何 .go/.ts。