AskaEth 20d452a51a fix(gateway)+docs(api): F5 区分「字段缺失/值为空白」+ E4/E5 契约文档治理 ...

- F5：PATCH /sessions/{id} 的 400 文案区分两类——都缺 → at least one of title or pinned is required；
  存在但空白 → title must not be blank（此前空白也回 title is required，误导排查方向）。
  「空串不能清空标题」的既有语义保持不变（用例显式钉住），新增 history_write_test.go 4 段断言
- E4：/auth/logout 的两种真实响应形状（单撤 {revoked} / 全撤 {revoked,revokedCount}）+ 错误码；
  /auth/refresh 补 role；登录响应与一次性接入段补 refreshToken（两份文档一致）
- E5：api-reference §3.2 补 pinned/unreadCount/lastMessage/personaId 与准确排序规则
  （pinned DESC, (type='main') DESC, created_at ASC ⇒ 置顶的次级会话可排在主会话之前）；
  新增 §3.6a PATCH /sessions/{id}（请求体/错误码/部分更新/title 不可清空）与 §3.6b POST /sessions/{id}/read；
  端点表补 read 行
- api-client 删掉「主会话恒在前」的错误断言（两处），PATCH 错误码文案同步
- DevDocs/02-development-constraints.md：上传上限 50MB → **硬 5 MiB**（常量、无配置项）

2026-10-04 14:13:27 +08:00

..

admin_approval_test.go

feat(capability,gateway): 工具策略落盘 + 主代理代审真接线（裁决 1.1 核对/1.3/10.4.2/13.4.3）

2026-10-04 12:30:16 +08:00

admin_approval.go

feat(capability,gateway): 工具策略落盘 + 主代理代审真接线（裁决 1.1 核对/1.3/10.4.2/13.4.3）

2026-10-04 12:30:16 +08:00

admin_channel_config_patch_test.go

fix(gateway,runtimeconfig): 渠道配置写路径改为 patch 语义，修凭据静默丢失（P0 级数据安全）

2026-10-04 13:42:37 +08:00

admin_channel_persona_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_channels_platform_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_channels_platform.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_channels_rescan_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_channels_rescan.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_channels_weixin_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_channels_weixin.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_entry_test.go

feat(config,gateway,web): 路径式安全入口 ADMIN_PATH + 数据目录 platform 哨兵（裁决 1.6/16.4.7/12.4.2 + 1.5/12.4.3 核对）

2026-10-04 14:00:25 +08:00

admin_honest501_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_llm_catalog_cache.go

feat(gateway,admin-web): 模型目录自动化 —— GET /admin/llm/catalog（裁决 03.4.2 次件）

2026-10-04 12:43:04 +08:00

admin_llm_catalog_source.go

feat(gateway,admin-web): 模型目录自动化 —— GET /admin/llm/catalog（裁决 03.4.2 次件）

2026-10-04 12:43:04 +08:00

admin_llm_catalog_test.go

feat(gateway,admin-web): 模型目录自动化 —— GET /admin/llm/catalog（裁决 03.4.2 次件）

2026-10-04 12:43:04 +08:00

admin_llm_catalog.go

feat(gateway,admin-web): 模型目录自动化 —— GET /admin/llm/catalog（裁决 03.4.2 次件）

2026-10-04 12:43:04 +08:00

admin_llm_provider_test.go

feat(gateway,admin-web): 面板可编辑 provider 推理形状 / 角色级路由 / multimodal 真语义（裁决 03.4.2/03.4.1）

2026-10-04 13:06:54 +08:00

admin_llm_provider.go

feat(gateway,admin-web): 面板可编辑 provider 推理形状 / 角色级路由 / multimodal 真语义（裁决 03.4.2/03.4.1）

2026-10-04 13:06:54 +08:00

admin_mutate.go

refactor(gateway): 拆 admin.go 666 行 → admin.go / admin_query.go / admin_mutate.go（纯搬移）

2026-10-04 10:46:51 +08:00

admin_owner_profile.go

fix(loop,gateway,persona): awakening 逐 turn 按角色生效 + 修「面板保存角色抹掉 5 个块」的数据丢失（裁决 14.4.3）

2026-10-04 13:07:52 +08:00

admin_plugins_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_plugins.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_policy_persist_test.go

feat(capability,gateway): 工具策略落盘 + 主代理代审真接线（裁决 1.1 核对/1.3/10.4.2/13.4.3）

2026-10-04 12:30:16 +08:00

admin_query.go

feat(gateway,admin-web): 面板可编辑 provider 推理形状 / 角色级路由 / multimodal 真语义（裁决 03.4.2/03.4.1）

2026-10-04 13:06:54 +08:00

admin_rag_delete_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_system_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_system.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_write_channel_config_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_write_channel_config.go

fix(gateway,runtimeconfig): 渠道配置写路径改为 patch 语义，修凭据静默丢失（P0 级数据安全）

2026-10-04 13:42:37 +08:00

admin_write_iot_automations.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_write_llm_channels.go

feat(gateway,admin-web): 面板可编辑 provider 推理形状 / 角色级路由 / multimodal 真语义（裁决 03.4.2/03.4.1）

2026-10-04 13:06:54 +08:00

admin_write_memory_rag.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_write_persona_blocks_test.go

fix(loop,gateway,persona): awakening 逐 turn 按角色生效 + 修「面板保存角色抹掉 5 个块」的数据丢失（裁决 14.4.3）

2026-10-04 13:07:52 +08:00

admin_write_persona_thinking_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_write_personas_users_test.go

feat(auth,gateway,user): X-API-Key 真接线 + key 一律超管 + owner 档案真落盘（裁决 15.4.2/15.4.3/10.4.5/08.4.2）

2026-10-04 12:07:51 +08:00

admin_write_personas_users.go

fix(loop,gateway,persona): awakening 逐 turn 按角色生效 + 修「面板保存角色抹掉 5 个块」的数据丢失（裁决 14.4.3）

2026-10-04 13:07:52 +08:00

admin_write_plugins_memory_sessions.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin_write_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

admin.go

feat(gateway,admin-web): 面板可编辑 provider 推理形状 / 角色级路由 / multimodal 真语义（裁决 03.4.2/03.4.1）

2026-10-04 13:06:54 +08:00

audio_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

audio.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

audit.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

auth_refresh_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

auth_refresh.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

broadcast.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

contracts.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

deps.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

extra_test.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

findchannel_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

flow_update_ws_test.go

fix(trace): 让 graph_update 的分支根节点 props.persona 真的前送（白名单漏登记）

2026-10-04 10:37:22 +08:00

gateway_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

history_after_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

history_handler_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

history_lastmessage_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

history_messages_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

history_persona_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

history_write_broadcast_test.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

history_write_test.go

fix(gateway)+docs(api): F5 区分「字段缺失/值为空白」+ E4/E5 契约文档治理

2026-10-04 14:13:27 +08:00

history_write.go

fix(gateway)+docs(api): F5 区分「字段缺失/值为空白」+ E4/E5 契约文档治理

2026-10-04 14:13:27 +08:00

history.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

meta_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

meta.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

middleware.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

mood_test.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

notifications_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

notifications.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

observability_audit.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

observability_logs_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

observability_logs.go

feat(gateway,admin-web): 可观测面从轮询改为 WS 帧推送（裁决 05.4.3 + 16.4.3-WS）

2026-10-04 13:58:03 +08:00

observability_metrics_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

observability_metrics.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

observability_push_test.go

feat(gateway,admin-web): 可观测面从轮询改为 WS 帧推送（裁决 05.4.3 + 16.4.3-WS）

2026-10-04 13:58:03 +08:00

observability_push.go

feat(gateway,admin-web): 可观测面从轮询改为 WS 帧推送（裁决 05.4.3 + 16.4.3-WS）

2026-10-04 13:58:03 +08:00

observability_trace.go

feat(gateway,admin-web): 可观测面从轮询改为 WS 帧推送（裁决 05.4.3 + 16.4.3-WS）

2026-10-04 13:58:03 +08:00

observability.go

feat(gateway,admin-web): 可观测面从轮询改为 WS 帧推送（裁决 05.4.3 + 16.4.3-WS）

2026-10-04 13:58:03 +08:00

persona_env.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

persona_read_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

proactive_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

proactive.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

rbac_viewer_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

rest.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

routes.go

feat(config,gateway,web): 路径式安全入口 ADMIN_PATH + 数据目录 platform 哨兵（裁决 1.6/16.4.7/12.4.2 + 1.5/12.4.3 核对）

2026-10-04 14:00:25 +08:00

server.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

session_attribution_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

session_orchestrator_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

session_orchestrator.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

session_persist.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

session_read_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

session_read.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

session_tail.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

session_transcript.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

static.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

upload_test.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

upload.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

voice_signal_test.go

docs(gateway): gateway 第 2 批 5 个文件注释改中文（只改注释，代码零字节改动）

2026-10-03 22:10:33 +08:00

voice.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

ws_bridge_subagent_result_test.go

feat(orchestration,gateway): 子代理结果登 WS 帧 subagent_result（裁决 02.4.3）

2026-10-04 12:07:46 +08:00

ws_bridge.go

feat(gateway,admin-web): 可观测面从轮询改为 WS 帧推送（裁决 05.4.3 + 16.4.3-WS）

2026-10-04 13:58:03 +08:00

ws_frame_scope_test.go

docs(api): api-client v0.51 补管理面契约 + api-reference 去假陈述 + 帧名口径统一（裁决 15.4.2/15.4.3/10.4.5/08.4.2）

2026-10-04 12:10:21 +08:00

ws_frame_scope.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

ws_history.go

docs(gateway): gateway 第 2 批 5 个文件注释改中文（只改注释，代码零字节改动）

2026-10-03 22:10:33 +08:00

ws_hub_conn.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

ws_hub_message_event.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

ws_hub_origin.go

docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动）

2026-10-03 22:28:25 +08:00

ws_hub_stream_scope_test.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

ws_hub_turn.go

docs(gateway): WS 帧门相关 11 个文件的注释改中文（只改注释，代码零字节改动）

2026-10-03 22:07:56 +08:00

ws_hub.go

docs(gateway): gateway 第 2 批 5 个文件注释改中文（只改注释，代码零字节改动）

2026-10-03 22:10:33 +08:00

ws_role_gate_test.go

docs(gateway): gateway 第 2 批 5 个文件注释改中文（只改注释，代码零字节改动）

2026-10-03 22:10:33 +08:00

ws_route_chat_test.go

fix(history,loop,gateway): 上下文续接的最新性/一致性三条（裁决 13.4.5 的面内部分）

2026-10-04 13:56:35 +08:00

ws_route.go

fix(history,loop,gateway): 上下文续接的最新性/一致性三条（裁决 13.4.5 的面内部分）

2026-10-04 13:56:35 +08:00

ws_stream_events_test.go

feat(loop,gateway): 事件批 — tool_execution 三事件 + streamId + turn.start/end（裁决 01.4.1/01.4.2/01.4.3/01.4.5/03.4.4/1.12）

2026-10-04 11:26:35 +08:00