Cyrene_v2

真缺陷（上一片登记）：`maxResults` 在面板上**根本改不了** —— ① 字段表里没有这个
字段（UI 不显示输入框）；② `saveProvider` 只并 provider/apiKey/baseUrl/enabled；
③ `mergeSelectionPatch` 只处理 primary/fallback ⇒ **手工塞进 values 也会被静默丢弃**
（文件不变、也不报错）。「我改了它却没变」正是要消灭的那种假话。

- `panel.go`：表单加 `{Key: FieldMaxResults, Type: sdk.FieldNumber, Min: 1}`（**SDK 本就有
  数字类型**，未自造；前端本就渲染 number ⇒ **不需要改前端**）。刻意不设 `Default`
  （设了会让一次「只改 key」的保存把默认值固化进文件、还可能盖掉 `.env`）。
- `websearch_selection.go`：`mergeSelectionPatch` 里按**三态**落 `maxResults` ——
  缺位/null ⇒ **不改动**；正整数（含整数字符串）⇒ 采用；0/负数/小数/空串/非数/
  布尔/数组 ⇒ **400 `invalid_payload`** 且**盘上一字节不动**（绝不静默忽略）。
- `reauth` 回填该值（否则一保存就把上限清掉）。
- `.env.example`：该键的示例值与「默认 5」注释同步为 **10**（代码默认已改；⚠️ `.env` 未动）。

验收（主会话复跑 + 亲自变异）：**整树 `go build ./...` 通过**；三包 vet/测试绿；
端到端「面板存 20 ⇒ 模型要 50 也只给 20、要 3 给 3」（走真 action hub → 落盘 →
热重载 → WithSearchMaxResults → 真 dispatcher，未重启后端）；
我用 -overlay 把 `f.MaxResults = maxResults` 摘掉 ⇒ 两条用例变红
（「面板给的值必须真的落盘」/「回填的 maxResults = 5, want 20」）。

⚠️ 已知取舍（如实登记）：**清空输入框 = 400**（后端按「非数 ⇒ 报错」拒），因此面板上
没有「去掉上限」的手势 —— 要回到 `.env` 兜底得改文件；要支持「清空 = 去掉覆盖」
需另定哨兵语义，未自行发挥。
⚠️ 契约面已变更（面板声明多一个 number 字段 + saveProvider 的 values 多一个可写键 +
响应多一个回显键）⇒ 主会话登记。

2026-10-07 11:10:56 +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

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

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

emotion_test.go

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

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

emotion.go

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

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

main.go

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

mcp.go

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

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

persona_agents.go

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

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

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

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

skills.go

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

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

stream.go

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

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

terminal_tool.go

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

vision.go

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

voice.go

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

websearch_action_data.go

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

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

websearch_probe.go

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

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

websearch_projection_test.go

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

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

websearch_providers.go

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

2026-10-07 10:18:58 +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

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

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

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

wire_browser_panel_data.go

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

wire_browser_panel_test.go

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

wire_browser_panel.go

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

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

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

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

2026-10-06 15:59:14 +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(browser): 补上 B3/B4 的两行接线（Z2）—— 面板页与截图进上下文真生效

2026-10-07 09:34:44 +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_review_test.go

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

wire_memory_review.go

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

wire_memory_tidy_test.go

feat(memory): 整理不再只产建议 —— 轮末自动落地高置信 + 停产 link 候选

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

wire_memory_tidy.go

feat(memory): 整理不再只产建议 —— 轮末自动落地高置信 + 停产 link 候选

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

wire_panels_test.go

feat(plugins): 插件管理器接线 —— 面板接入点快照 + 动作分发（PLG-2）

2026-10-06 09:03:57 +08:00

wire_plugin_actions_test.go

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

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

wire_plugin_actions.go

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(browser): 取正文能力 + web-fetch 浏览器降级档接线（解封 Z5/B5）

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

wire_services.go

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

2026-10-06 21:16:23 +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_web_search_panel_test.go

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

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

wire_web_search_providers_test.go

feat(search): 原生 provider 层（searxng/智谱/阿里IQS/博查/火山/百度）+ 降级链（契约无改动）

2026-10-05 22:38:20 +08:00

wire_web_search_test.go

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

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

wire.go