Cyrene_v2

- model 层新增可选 UsageSink（nil ⇒ 逐字不变，既有用例零改动）
- 组合根注入 UsageWriter：有界队列 1024 + 单写者 + 批量事务（128/批、2s 兜底），
  队列满丢弃 + 限流 WARN，绝不阻塞模型调用；sink 挂 RuntimeLLM（热重载不断）
- 迁移 0017：表 llm_usage（13 列，session_id 可空）+ idx_created_at + idx_session_id
- 新端点 GET /api/v1/admin/llm/usage（owner|admin 读；缺省近 24h、上限 90 天、
  超限 400 不静默裁剪；hitRate = cacheHit/(cacheHit+cacheMiss)，分母 0 ⇒ 0；
  绝不含凭据与正文；未接线/查库失败 ⇒ 500 usage_unavailable）
- LLM_USAGE_RETENTION（默认 720h，≤0 = 关闭清理）：启动清一次 + 每小时
- 面板 LLM 页「用量（近 24h）」小卡 + Docs 两份同步 v0.64
- 已知缺口（如实登记）：session_id 恒 NULL，需 loop 侧在请求上打标，留列后接

2026-10-04 22:16:26 +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_backthink_push_test.go

feat(gateway,admin-web): Skill 运行时安装 + backthink 打扰原因 + 建提醒入口（P0-19/P0-20/P0-22，审计 §4.3）

2026-10-04 14:21:41 +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

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

admin_channels_platform_test.go

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

admin_channels_platform.go

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

admin_channels_rescan_test.go

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

admin_channels_rescan.go

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

admin_channels_weixin_test.go

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

admin_channels_weixin.go

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

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_context_window_test.go

feat(admin): 面板暴露 contextWindow（可见可改）+ DocumentRef 语义注释同步

2026-10-04 18:11:43 +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(admin): 面板暴露 contextWindow（可见可改）+ DocumentRef 语义注释同步

2026-10-04 18:11:43 +08:00

admin_llm_usage_test.go

2026-10-04 22:16:26 +08:00

admin_llm_usage.go

2026-10-04 22:16:26 +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_skill_test.go

feat(gateway,admin-web): Skill 运行时安装 + backthink 打扰原因 + 建提醒入口（P0-19/P0-20/P0-22，审计 §4.3）

2026-10-04 14:21:41 +08:00

admin_plugins_skill.go

feat(gateway,admin-web): Skill 运行时安装 + backthink 打扰原因 + 建提醒入口（P0-19/P0-20/P0-22，审计 §4.3）

2026-10-04 14:21:41 +08:00

admin_plugins_test.go

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

admin_plugins.go

feat(gateway,admin-web): Skill 运行时安装 + backthink 打扰原因 + 建提醒入口（P0-19/P0-20/P0-22，审计 §4.3）

2026-10-04 14:21:41 +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): Skill 运行时安装 + backthink 打扰原因 + 建提醒入口（P0-19/P0-20/P0-22，审计 §4.3）

2026-10-04 14:21:41 +08:00

admin_rag_delete_test.go

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

admin_system_storage_test.go

feat(admin): 面板「存储」卡片接真数据（含 PG 增强状态）+ 契约 v0.60

2026-10-04 19:44:53 +08:00

admin_system_storage.go

feat(admin): 面板「存储」卡片接真数据（含 PG 增强状态）+ 契约 v0.60

2026-10-04 19:44:53 +08:00

admin_system_test.go

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

admin_system.go

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

admin_write_channel_config_test.go

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): 余下 3 处行尾注释中文化（存量注释债结项）

2026-10-04 18:57:58 +08:00

admin_write_llm_channels.go

feat(admin): 面板暴露 contextWindow（可见可改）+ DocumentRef 语义注释同步

2026-10-04 18:11:43 +08:00

admin_write_llm_reset_guard_test.go

feat(admin): 面板「重置为 env 默认」动作（materialize 的反方向）+ 契约 v0.62

2026-10-04 21:33:11 +08:00

admin_write_llm_reset_test.go

feat(admin): 面板「重置为 env 默认」动作（materialize 的反方向）+ 契约 v0.62

2026-10-04 21:33:11 +08:00

admin_write_llm_reset.go

feat(admin): 面板「重置为 env 默认」动作（materialize 的反方向）+ 契约 v0.62

2026-10-04 21:33:11 +08:00

admin_write_memory_rag.go

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

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

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

admin_write_reminder_test.go

feat(gateway,admin-web): Skill 运行时安装 + backthink 打扰原因 + 建提醒入口（P0-19/P0-20/P0-22，审计 §4.3）

2026-10-04 14:21:41 +08:00

admin_write_test.go

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

admin.go

feat(admin): 面板暴露 contextWindow（可见可改）+ DocumentRef 语义注释同步

2026-10-04 18:11:43 +08:00

audio_test.go

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

audio.go

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

audit.go

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

auth_refresh_test.go

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

auth_refresh.go

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

broadcast.go

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

chat_documents_bounds_test.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

chat_documents_test.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

chat_documents.go

feat(documents): PDF 文本层抽取（S6 第一段；扫描件仍诚实拒绝）

2026-10-04 19:46:36 +08:00

chat_idempotency_test.go

fix(gateway,history): REST 流式不再静默失败（G2）+ clientMsgId 幂等（G4）（协同 §G，均标「中高/中」）

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

chat_stream_dispatch.go

feat(gateway): chat.documents 解析 + 修两处静默吞掉（design/24 S3-B）

2026-10-04 17:25:35 +08:00

contracts.go

2026-10-04 22:16:26 +08:00

deps.go

2026-10-04 22:16:26 +08:00

documents_pdf_test.go

feat(documents): PDF 文本层抽取（S6 第一段；扫描件仍诚实拒绝）

2026-10-04 19:46:36 +08:00

documents_test.go

feat(gateway): 文档存储端点 POST/GET /api/v1/documents（design/24 S1）

2026-10-04 17:07:20 +08:00

documents.go

feat(documents): PDF 文本层抽取（S6 第一段；扫描件仍诚实拒绝）

2026-10-04 19:46:36 +08:00

extra_test.go

fix(gateway,history): REST 流式不再静默失败（G2）+ clientMsgId 幂等（G4）（协同 §G，均标「中高/中」）

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

findchannel_test.go

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

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

history_after_test.go

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

history_document_test.go

feat(gateway): 文档多值化 + 抽取结论回写（design/24 S3.5）

2026-10-04 17:42:16 +08:00

history_handler_test.go

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

history_lastmessage_test.go

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

history_messages_test.go

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

history_persona_test.go

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

history_session_guard_test.go

feat(api): documents[].reason + messages 对不存在会话回 404（安卓回执九两条；契约 v0.63）

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

history_session_guard.go

feat(api): documents[].reason + messages 对不存在会话回 404（安卓回执九两条；契约 v0.63）

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

history_write_broadcast_test.go

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

feat(api): documents[].reason + messages 对不存在会话回 404（安卓回执九两条；契约 v0.63）

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

interrupt_scope_test.go

feat(gateway): interrupt 支持 scope（当前/全部），默认维持现状（协同 A2）

2026-10-04 14:21:52 +08:00

interrupt_scope_unit_test.go

feat(gateway): interrupt 支持 scope（当前/全部），默认维持现状（协同 A2）

2026-10-04 14:21:52 +08:00

meta_test.go

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

meta.go

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

middleware.go

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

mood_test.go

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

notifications_test.go

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

notifications.go

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

observability_audit.go

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

observability_logs_test.go

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

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

observability_metrics.go

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

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

persona_read_test.go

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

proactive_test.go

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

proactive.go

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

rbac_viewer_test.go

feat(admin): 面板「重置为 env 默认」动作（materialize 的反方向）+ 契约 v0.62

2026-10-04 21:33:11 +08:00

rest_chat_image_test.go

refactor(gateway): 图片上限单一真源 —— 以 vision 硬顶为准，配置只能收紧（消除「网关照放、vision 拒」）

2026-10-04 16:27:35 +08:00

rest.go

feat(gateway): chat.documents 解析 + 修两处静默吞掉（design/24 S3-B）

2026-10-04 17:25:35 +08:00

routes.go

2026-10-04 22:16:26 +08:00

server.go

2026-10-04 22:16:26 +08:00

session_attribution_test.go

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

session_document_e2e_test.go

feat(gateway): 文档多值化 + 抽取结论回写（design/24 S3.5）

2026-10-04 17:42:16 +08:00

session_document_reason_test.go

feat(api): documents[].reason + messages 对不存在会话回 404（安卓回执九两条；契约 v0.63）

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

session_document_status_test.go

feat(api): documents[].reason + messages 对不存在会话回 404（安卓回执九两条；契约 v0.63）

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

session_document_status.go

feat(api): documents[].reason + messages 对不存在会话回 404（安卓回执九两条；契约 v0.63）

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

session_events.go

feat(loop,gateway): 13.4.5 目标态 —— 回合内 steer（不打断、新消息进同一上下文流）+ steer_ack 帧

2026-10-04 14:53:40 +08:00

session_interrupt.go

feat(gateway): interrupt 支持 scope（当前/全部），默认维持现状（协同 A2）

2026-10-04 14:21:52 +08:00

session_orchestrator_test.go

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

session_orchestrator.go

fix(gateway,loop,tools): 失败回合必落可见回复 + knowledge 角色可信

2026-10-04 22:14:42 +08:00

session_pending_full_test.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

session_persist.go

fix(gateway,loop,tools): 失败回合必落可见回复 + knowledge 角色可信

2026-10-04 22:14:42 +08:00

session_read_test.go

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

session_read.go

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

session_reject.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

session_steer_test.go

feat(loop,gateway): 13.4.5 目标态 —— 回合内 steer（不打断、新消息进同一上下文流）+ steer_ack 帧

2026-10-04 14:53:40 +08:00

session_steer.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

session_tail.go

feat(gateway): chat.documents 解析 + 修两处静默吞掉（design/24 S3-B）

2026-10-04 17:25:35 +08:00

session_transcript.go

feat(gateway): 文档多值化 + 抽取结论回写（design/24 S3.5）

2026-10-04 17:42:16 +08:00

session_turn_fence.go

fix(loop): 所有非崩溃退出一律废弃可恢复快照（主人 2026-10-04 裁决「修」）

2026-10-04 14:17:58 +08:00

session_turn_reply_test.go

fix(gateway,loop,tools): 失败回合必落可见回复 + knowledge 角色可信

2026-10-04 22:14:42 +08:00

session_turn_reply.go

fix(gateway,loop,tools): 失败回合必落可见回复 + knowledge 角色可信

2026-10-04 22:14:42 +08:00

session_voice.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

static.go

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

upload_test.go

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

upload.go

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_turn_test.go

test(flake): 清掉最后三条墙钟/条件竞态（mcp 订阅门控 + vision 注入时钟 + voice 兜底期限）

2026-10-04 21:11:17 +08:00

voice.go

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +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(loop,gateway): 13.4.5 目标态 —— 回合内 steer（不打断、新消息进同一上下文流）+ steer_ack 帧

2026-10-04 14:53:40 +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

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

feat(gateway): 语音回合进编排+落库、G5 队列满带回身份、voice_output 归属（安卓 G5/C1/C3）

2026-10-04 17:59:28 +08:00

ws_hub_message_event.go

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

ws_hub_origin.go

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

ws_hub_stream_scope_test.go