AskaEth b90811fae4 docs(voice): 收口「没会话/没绑定就走 default」的镜像注释（r4） ...

唯一 finding：audio.go 的 speechRequest.SessionID 注释原本写「省略它时本口没有会话
概念 ⇒ 走 emotionTTS 的 default 分支」——**反了**。真实链路是
effectivePersona(ctx,"") → sessionPersona("") 为空**不是终点** → Effective =
defaultPersonaID() → 常规安装必有全局默认人格 ⇒ personaId 非空 ⇒ 走 personas 映射。
照那句话改的人会写出 `if req.SessionID == "" { personaID = "" }`，正是 r2 修掉的病。
改为：省略时按**全局默认人格**选发音人（会话绑定 → 全局默认人格 → 两者都没有才落到
default 字符），并显式写了"不要写成 if SessionID == \"\" { personaID = \"\" }"。

顺手同根三处（不留第四轮）：
- tts/config.go 的 Config.Default 注释：成因表「会话无绑定 / 读取失败 / 该出口本身
  没有会话」已过时 ⇒ 改为「空串的唯一合法成因是连全局默认人格都没有」，并写明不是
  "会话未绑定"、也不是"出站口没有会话"。
- runtimeconfig/voicetts.go 的 Default 字段注释与文件头同族措辞同步；
- selection.go 的 WithPersonaID / Resolve 分支表、service.go 的分支小标把
  「解析不到」统一改成「连全局默认人格都没有」；
- voice_emotiontts_test.go 的 TestSpeechEndpointNoSessionUsesDefault 注释同步（该用例
  没接人格库，所以确实落到 default —— 但成因写对了）；
- wire_voice_tts_test.go nit：改成「已废弃的全局 `character` 不生效」（墓碑键仍在）。

纯注释：`git diff` 里非注释改动行为空。go build/vet 通过；四包 go test -count=1 全绿。

2026-10-26 13:40:00 +08:00

..

.gitkeep

chore: 清空 v2 实现，重建新架构骨架（人格化通用 Agent 运行时）

2026-09-05 23:09:26 +08:00

channels_obv11_transport_test.go

feat(qq_obv11): OneBot v11 四端齐备（裁决 1.4 / 12.4.1）

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

channels_obv11_wiring_test.go

fix(channels): QQ 适配器接上注入 logger（帧取证复活）+ 兜底不再静默降级（Warn 说明 Debug 会被丢）

2026-10-05 12:53:17 +08:00

channels_test.go

feat(channels): 流控可配 —— 陌生人私聊额度走账号配置 directMsgPerMin（裁决 13）

2026-10-05 13:50:29 +08:00

channels.go

fix(channel/flowgate): 审查移出准入路径、节流覆盖失败路径、BOM 解析韧性

2026-10-24 19:43:57 +08:00

emotion_test.go

feat(emotion): A1 情绪系统接线 + refactor: 拆分 channelbridge.go

2026-09-30 08:51:38 +08:00

emotion.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

enums_factory_test.go

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

2026-10-03 16:55:22 +08:00

extractor_test.go

feat(session,runtime): 多角色并存—按会话选角（迁移0011 + 按回合解析 + agent池 + 提取器修正）

2026-10-03 20:12:29 +08:00

extractor.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

main.go

feat(memory): 护栏抬高+时间预算闸+试算加性异步 与 D3 入库前审查（耦合两片一起落）

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

mcp.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

models_materialize_test.go

feat(config,cyrene): .env → 面板配置的启动期 materialize（主人裁决：面板是一等来源，.env 退回入口/播种）

2026-10-04 16:39:33 +08:00

models_materialize.go

feat(config,cyrene): .env → 面板配置的启动期 materialize（主人裁决：面板是一等来源，.env 退回入口/播种）

2026-10-04 16:39:33 +08:00

observability_test.go

feat(observability): 日志聚合后端 — logger环形缓冲 + GET /admin/observability/logs

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

observability.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

persona_agents.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

persona_emotion_test.go

feat(session,runtime): 多角色并存—按会话选角（迁移0011 + 按回合解析 + agent池 + 提取器修正）

2026-10-03 20:12:29 +08:00

persona_identity_test.go

fix(guardrail): 输入护栏上限按推导预算派生（修「大附件被拦死」）+ 第 5 条 flake

2026-10-04 19:15:12 +08:00

persona_identity.go

feat(cyrene,config,loop): 护栏/压缩/身份知识三条落地（P0-5/P0-10/P0-11）+ 身份注入收窄到主人会话

2026-10-04 14:30:26 +08:00

persona_prompt_test.go

feat(persona,model,loop): 人格 thinking 配置 + 5 个死字段接线 + 推理旋钮（按 provider 映射）

2026-10-03 19:54:22 +08:00

persona_prompt.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

plugins_test.go

feat(plugin): 插件热安装(MCP server) — POST /admin/plugins/install 连接+发现+注册工具进registry+落盘plugins.json

2026-09-08 23:20:12 +08:00

plugins.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

sessionread_tool_test.go

feat(runtime,ai): session_read — 跨会话只读「主动读取」能力（design/22 §8-3/§8.1）

2026-10-03 21:33:40 +08:00

sessionread_tool.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

skills.go

docs(comments): 清掉两处已过期的状态注释（ErrRunPending 早已不存在）

2026-10-06 18:46:58 +08:00

stream.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

subagent_tool_test.go

fix(orchestration,loop): 子代理现在真的收到任务（P0）+ 工具白名单 + 超时可配（裁决 02.4.2/02.4.1/02.4.4）

2026-10-04 11:30:39 +08:00

subagent_tool.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

terminal_tool.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

vision.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

voice.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

websearch_action_data.go

feat(search): 面板上终于能改「结果条数上限」（原来改了会被静默丢弃）

2026-10-07 11:10:56 +08:00

websearch_actions_config_test.go

feat(plugins): 面板动作执行器接线 —— 动作真可用，不再 501 兜底（L1）

2026-10-06 14:12:23 +08:00

websearch_maxresults_test.go

feat(search): 面板上终于能改「结果条数上限」（原来改了会被静默丢弃）

2026-10-07 11:10:56 +08:00

websearch_new_providers_test.go

feat(search): 新增腾讯云·元宝搜索与秘塔搜索两家 provider

2026-10-07 13:42:41 +08:00

websearch_probe.go

feat(plugins): 面板动作执行器接线 —— 动作真可用，不再 501 兜底（L1）

2026-10-06 14:12:23 +08:00

websearch_projection_test.go

feat(search): 新增腾讯云·元宝搜索与秘塔搜索两家 provider

2026-10-07 13:42:41 +08:00

websearch_providers.go

feat(search): 新增腾讯云·元宝搜索与秘塔搜索两家 provider

2026-10-07 13:42:41 +08:00

websearch_reload_test.go

feat(search): provider 热重载 + primary/fallback（W3）

2026-10-06 15:59:12 +08:00

websearch_reload.go

feat(search): provider 热重载 + primary/fallback（W3）

2026-10-06 15:59:12 +08:00

websearch_selection_test.go

fix(websearch): 面板「填 key + 同一次选它当主 provider」不再被自己的校验回滚

2026-10-07 09:56:37 +08:00

websearch_selection.go

feat(search): 面板上终于能改「结果条数上限」（原来改了会被静默丢弃）

2026-10-07 11:10:56 +08:00

websearch_testenv_test.go

feat(search): provider 热重载 + primary/fallback（W3）

2026-10-06 15:59:12 +08:00

wire_approval_test.go

feat(security): 代审口径 A 落地（仅子代理发起的敏感调用做实质判定 + fail-closed + 理由进审计与小字）

2026-10-05 12:12:31 +08:00

wire_approval.go

feat(security): 代审口径 A 落地（仅子代理发起的敏感调用做实质判定 + fail-closed + 理由进审计与小字）

2026-10-05 12:12:31 +08:00

wire_body_fallback_test.go

fix(browser): 启动失败要说出原因；预算耗尽 ≠ 浏览器坏了

2026-10-07 10:37:33 +08:00

wire_body_fallback.go

fix(browser): 启动失败要说出原因；预算耗尽 ≠ 浏览器坏了

2026-10-07 10:37:33 +08:00

wire_browser_context_test.go

feat(browser): 补上 B3/B4 的两行接线（Z2）—— 面板页与截图进上下文真生效

2026-10-07 09:34:44 +08:00

wire_browser_context.go

feat(browser): B3 截图→上下文闭环 + B4 面板声明页（Y4）

2026-10-06 21:48:50 +08:00

wire_browser_e2e_test.go

feat(browser): B1 接线 + B2 薄层工具面（V5）

2026-10-06 20:25:16 +08:00

wire_browser_lifecycle_test.go

feat(browser): 方案 A 落地 —— 显式端口 + 去掉 stealth flag（主人 2026-10-07 拍板）

2026-10-07 11:18:25 +08:00

wire_browser_panel_data.go

feat(browser): B3 截图→上下文闭环 + B4 面板声明页（Y4）

2026-10-06 21:48:50 +08:00

wire_browser_panel_test.go

feat(browser): B3 截图→上下文闭环 + B4 面板声明页（Y4）

2026-10-06 21:48:50 +08:00

wire_browser_panel.go

feat(browser): B3 截图→上下文闭环 + B4 面板声明页（Y4）

2026-10-06 21:48:50 +08:00

wire_browser_test.go

feat(backthink,browser): 自排工具面 C1-3 + 浏览器两处偏离收口（X2+X3 同文件一并落）

2026-10-06 21:16:23 +08:00

wire_browser.go

feat(browser): B3 截图→上下文闭环 + B4 面板声明页（Y4）

2026-10-06 21:48:50 +08:00

wire_capability_surface_test.go

feat(backthink): 思考轮工具面补齐（裁决 15）—— 能力面接入 + 只读 capability_list + 本轮状态快照

2026-10-05 13:54:57 +08:00

wire_capability_surface.go

feat(backthink): 思考轮工具面补齐（裁决 15）—— 能力面接入 + 只读 capability_list + 本轮状态快照

2026-10-05 13:54:57 +08:00

wire_capacity_awakening_test.go

feat(persona,capacity): persona awakening 档位真生效 + 当前主角色已填（裁决 14.4.3）

2026-10-04 12:49:40 +08:00

wire_capacity_role_test.go

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

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

wire_capacity.go

docs(cyrene): cmd/cyrene 存量英文注释中文化（22 个非测试文件，仅注释）

2026-10-04 16:58:06 +08:00

wire_channel_events_test.go

feat(events): 渠道事件桥接接线 + 组合根（design/26 E3+E4）

2026-10-05 14:10:24 +08:00

wire_channel_events.go

feat(flow): 链路图本地落盘 + 多轮历史回放（design/19 §P3，契约 v0.73）

2026-10-05 16:19:32 +08:00

wire_channels_adminids_test.go

fix(channel,user): owner 车道只认白名单，堵住群主/伪造 role 冒充主人（裁决 06.4.2/06.4.3/06.4.4）

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

wire_channels_documents_test.go

refactor+feat(documents,channelbridge): 共享存储核心 + IM 入站附件摄取（主人 2.3）

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

wire_channels_test.go

fix: 修「假话但绿」的用例 + 补 VoiceTranscoder 注入（W4）

2026-10-06 15:59:14 +08:00

wire_channels.go

feat(channelbridge): 群聊静默窗口合并与回合中续跑（M23）

2026-10-24 21:11:22 +08:00

wire_context_test.go

fix(guardrail): 输入护栏上限按推导预算派生（修「大附件被拦死」）+ 第 5 条 flake

2026-10-04 19:15:12 +08:00

wire_context.go

feat(config,runtime): 上下文预算按模型窗口推导 + usage/缓存可观测 + sidecar 存全文（T1）

2026-10-04 17:57:08 +08:00

wire_document_budget_test.go

feat(config,runtime): 上下文预算按模型窗口推导 + usage/缓存可观测 + sidecar 存全文（T1）

2026-10-04 17:57:08 +08:00

wire_document_gc_test.go

feat(documents): 引用计数 + 文档/侧车 GC（主人 2.2 裁决；S7）

2026-10-04 21:01:30 +08:00

wire_document_gc.go

feat(documents): 引用计数 + 文档/侧车 GC（主人 2.2 裁决；S7）

2026-10-04 21:01:30 +08:00

wire_flow_graphs_test.go

feat(flow): 链路图本地落盘 + 多轮历史回放（design/19 §P3，契约 v0.73）

2026-10-05 16:19:32 +08:00

wire_flow_graphs.go

feat(flow): 链路图本地落盘 + 多轮历史回放（design/19 §P3，契约 v0.73）

2026-10-05 16:19:32 +08:00

wire_frontend_test.go

fix(auth): API Key 落盘（修「每次重启 key 全失效」）

2026-10-04 19:55:18 +08:00

wire_frontend.go

feat(voice): emotionTTS 接成一级发音人（UTF-8 请求体 + 失败回落既有链）

2026-10-26 12:46:57 +08:00

wire_guardrail_limit_test.go

fix(guardrail): 输入上限与附件注入预算统一换算（多附件不再被拦）

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

wire_guardrail_multidoc_test.go

fix(guardrail): 输入上限与附件注入预算统一换算（多附件不再被拦）

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

wire_guardrail_test.go

fix(guardrail): 输入护栏上限按推导预算派生（修「大附件被拦死」）+ 第 5 条 flake

2026-10-04 19:15:12 +08:00

wire_guardrail.go

fix(guardrail): 输入上限与附件注入预算统一换算（多附件不再被拦）

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

wire_io_tools.go

refactor(search): provider 配置面去 env 化 —— 加新家不再需要动 .env

2026-10-07 10:18:58 +08:00

wire_memory_extract_test.go

feat(gateway): 子代理结果回填父会话（系统注记）+ 记忆抽取排除（M32）

2026-10-24 22:02:11 +08:00

wire_memory_extract.go

feat(gateway): 子代理结果回填父会话（系统注记）+ 记忆抽取排除（M32）

2026-10-24 22:02:11 +08:00

wire_memory_review_test.go

test(memory): 修播种日志用例的偶发假红 + 补 TempTTL 接线缝断言

2026-10-13 20:26:46 +08:00

wire_memory_review.go

feat(memory): D3 第五态 defer（入库审查）+ 提取留存规则闸 + 临时 TTL 配置面

2026-10-13 20:22:48 +08:00

wire_memory_tidy_seed_test.go

feat(memory): 启动时自动播种面板配置文件（缺失才写、绝不覆盖）

2026-10-07 20:38:37 +08:00

wire_memory_tidy_test.go

refactor(memory): 到期清扫挂点从 wait 注入缝改为 TidyService.Start

2026-10-13 21:43:27 +08:00

wire_memory_tidy.go

refactor(memory): 到期清扫挂点从 wait 注入缝改为 TidyService.Start

2026-10-13 21:43:27 +08:00

wire_panels_test.go

feat(plugin): 组合根装配「MCP 服务器」页（声明 + 动作处理器成对）

2026-10-24 19:38:38 +08:00

wire_plugin_actions_test.go

feat(admin): 搜索提供商下拉/多选/表格显示中文名（值仍是 ASCII id）

2026-10-07 10:08:19 +08:00

wire_plugin_actions.go

feat(search): 面板上终于能改「结果条数上限」（原来改了会被静默丢弃）

2026-10-07 11:10:56 +08:00

wire_runtime_test.go

feat(gateway): 链路图冷启动快照（v0.71）+ 面板来源说明条 —— 修「轮次结束后打开页面一片空白」

2026-10-05 15:38:53 +08:00

wire_runtime.go

feat(gateway): 子代理结果回填父会话（系统注记）+ 记忆抽取排除（M32）

2026-10-24 22:02:11 +08:00

wire_services.go

feat(backthink,browser): 自排工具面 C1-3 + 浏览器两处偏离收口（X2+X3 同文件一并落）

2026-10-06 21:16:23 +08:00

wire_subagent_backfill_test.go

feat(gateway): 子代理结果回填父会话（系统注记）+ 记忆抽取排除（M32）

2026-10-24 22:02:11 +08:00

wire_subagent_backfill.go

feat(gateway): 子代理结果回填父会话（系统注记）+ 记忆抽取排除（M32）

2026-10-24 22:02:11 +08:00

wire_test.go

feat: 修复审计落差 #1/#2/#3/#6 + 管理面板移动端适配

2026-09-07 13:43:18 +08:00

wire_transcode_test.go

feat(capability): 转码能力装配进组合根（工具真进注册表、日志带 source）+ design/25 非bit-exact 留痕更正

2026-10-05 13:23:52 +08:00

wire_transcode.go

feat(capability): 转码能力装配进组合根（工具真进注册表、日志带 source）+ design/25 非bit-exact 留痕更正

2026-10-05 13:23:52 +08:00

wire_usage_test.go

feat(llm): 用量落库 + 只读汇总端点 + 面板用量小卡（契约 v0.64）

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

wire_usage.go

feat(llm): 用量落库 + 只读汇总端点 + 面板用量小卡（契约 v0.64）

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

wire_voice_tts_test.go

docs(voice): 收口「没会话/没绑定就走 default」的镜像注释（r4）

2026-10-26 13:40:00 +08:00

wire_voice_tts.go

fix(voice): 修 r1 复审四条（正文进日志的隐私泄漏 / format 假开关 / Stats 无消费者 / redactURL 兜底）

2026-10-26 13:06:39 +08:00

wire_web_search_panel_test.go

feat(search): 新增腾讯云·元宝搜索与秘塔搜索两家 provider

2026-10-07 13:42:41 +08:00

wire_web_search_providers_test.go

feat(search): 新增腾讯云·元宝搜索与秘塔搜索两家 provider

2026-10-07 13:42:41 +08:00

wire_web_search_test.go

feat(search): 搜索 provider 可变源 + 插件声明面板（PLG-4）

2026-10-06 09:04:04 +08:00

wire.go

feat(memory): 护栏抬高+时间预算闸+试算加性异步 与 D3 入库前审查（耦合两片一起落）

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