feat(contract,gateway): B4 枚举权威表 — GET /api/v1/meta/enums + 未知值回落约定

- 新增 internal/contract/enums 叶子包：platform/mood/mode 三表 + UnknownFallback="display-raw"；每次调用返回新切片，无包级可变全局
- GET /api/v1/meta/enums（anyAuth 只读、纯投影、无 store/无错误路径）
- 反漂移 4 处：真构造内置适配器断言 Name() 与表双向相等、真工厂 buildAccountAdapter 逐项可建、mood 对齐 emotion 常量 + 默认转移表、mode 对齐前端 MODES（跨语言，文件缺失则 skip）
- Docs/api-client §1.1 枚举权威表 + 行15 + v0.38；api-reference §3.7 + 行12

Docs/api-reference.md

@@ -68,6 +68,7 @@
 | 9 | PATCH | `/api/v1/sessions/{id}` | owner\|admin | 200 | 会话改名(A4) + 置顶(`pinned`, D5) body `{title?,pinned?}` | M16 |
 | 10 | PATCH | `/api/v1/messages/{id}` | owner\|admin | 200 | 编辑单条消息(D3) body `{content}` | M16 |
 | 11 | DELETE | `/api/v1/messages/{id}` | owner\|admin | 200 | 删除单条消息(D3) | M16 |
+| 12 | GET | `/api/v1/meta/enums` | JWT | 200 | 客户端共享枚举权威表(B4)：`platform`/`mood`/`mode` + `unknown` 回落约定 | M8 |
 
 ### 1.3 管理后台（`/api/v1/admin/*`）
 
@@ -364,6 +365,40 @@ curl -s -X DELETE http://<host>:8080/api/v1/sessions/web:0123abcd... \
 
 ---
 
+### 3.7 GET /api/v1/meta/enums
+- **鉴权**：`Authorize()`（**任意已认证角色**：owner/admin/viewer）——只读、无敏感信息，与 `GET /api/v1/sessions`（§3.2）同级。无 token 回 `401`。
+- **用途**：客户端共享枚举权威表（Android 协同 B4，design/07 §6）。`platform`（消息来源平台）/ `mood`（情绪）/ `mode`（行为·呈现模式）此前只在文档里给示例，客户端各自硬编码映射导致来源角标与情绪标签漂移；本端点把三张表做成**机器可读的单一事实来源**，Web / Android / IM bridge 共用。
+- **响应**：`200`
+  ```json
+  {"data":{
+    "platforms":[{"id":"web","label":"网页"},{"id":"kook","label":"KOOK"},{"id":"qq-obv11","label":"QQ"},{"id":"weixin-ilink","label":"微信"},{"id":"telegram","label":"Telegram"},{"id":"webhook","label":"Webhook"}],
+    "moods":[{"id":"calm","label":"平静"},{"id":"happy","label":"开心"},{"id":"excited","label":"兴奋"},{"id":"sad","label":"低落"},{"id":"angry","label":"生气"}],
+    "modes":[{"id":"chat","label":"对话"},{"id":"code","label":"代码"},{"id":"home","label":"家居"},{"id":"work","label":"工作"},{"id":"docs","label":"文档"},{"id":"voice","label":"语音"},{"id":"vision","label":"视觉"},{"id":"agents","label":"智能体"},{"id":"settings","label":"设置"}],
+    "unknown":"display-raw"
+  }}
+  ```
+- **字段**：
+  | 字段 | 类型 | 说明 |
+  |------|------|------|
+  | `platforms` | `[]{id,label}` | 来源平台：各内置适配器 `Name()`（`kook`/`qq-obv11`/`weixin-ilink`/`telegram`/`webhook`）+ Web 主会话来源 `web`（`history.PlatformWeb`） |
+  | `moods` | `[]{id,label}` | 情绪：`internal/persona/emotion` 内置状态。状态机**可扩展**（persona 可经 `AddTransition` 注册更多状态），此表**非封闭集合** |
+  | `modes` | `[]{id,label}` | 九模式（design/07 §1）；mode 只驱动呈现，不构成能力边界 |
+  | `unknown` | string | 恒 `"display-raw"`：未知值回落约定（机器可读） |
+  | `label` | string | **默认中文标签**，客户端可直接显示、也可按 i18n 覆盖；客户端比对应以 `id` 为准（小写、大小写敏感） |
+- **错误**：仅 `401`（未认证）。无存储依赖，不会 `501`/`500`。
+- **备注**：
+  - **未知值回落约定（红线）**：客户端遇不在表中的取值**原样显示原始字符串**——**不丢弃、不报错、不替换占位符**；**服务端新增取值是非破坏性变更**（forward-compatible），旧客户端无需升级，也不得因未知值清空角标或抛错。
+  - **单一事实来源在 Go 侧**：`internal/contract/enums`（`Platforms()`/`Moods()`/`Modes()`/`UnknownFallback`），网关只做投影（`internal/services/gateway/meta.go`）。
+  - **反漂移**：`internal/contract/enums` 的测试断言三张表与「适配器 `Name()`」「`emotion` 内置状态」「前端 `types.ts` 的 `MODES`」一致；`cmd/cyrene` 另断言表内每个平台都能被渠道工厂构建——漏登记或幽灵条目即 FAIL。
+  - Web 侧镜像：`frontend/web/src/lib/enums.ts`（`labelFor(kind, value)` 未知值返回原值），顶栏 / 侧栏 / 消息气泡的心情标签已改用。
+  - curl：
+    ```bash
+    curl -s http://<host>:8080/api/v1/meta/enums -H "Authorization: Bearer $TOKEN" -H 'X-API-Version: 1'
+    # => {"data":{"platforms":[...],"moods":[...],"modes":[...],"unknown":"display-raw"}}
+    ```
+
+---
+
 ## 4. 管理后台 · 读端点（`owner|admin`）
 
 > 以下端点 `鉴权 = Authorize(owner, admin)`（除特别标注 owner）。所有管理**读**不审计；管理**写**（§5）全程审计（who/what/when/result，见 §4.15）。