AskaEth/Cyrene_v2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(contract): §2.0 端点计数回补（14+18+40=72）+ S6 未确证项收口（V4）

Browse Source 
- writeAuth 17→18、总数 71→72（并写明自 v0.76 起 −1 的滞后已修正；历史版本条目保留原写法）
- S6 的未确证项逐条核对：能验的给代码级证据，验不了的写明「为什么验不了」（无凭据/禁重启）
- 契约版本仍 v0.80（同版内记账回补，零形状变更）
This commit is contained in:
AskaEth committed 2026-10-06 20:25:14 +08:00
1 parent 4a04ad43fe
commit ea150ceea9
1 file changed
+12 -11
Download Patch File Download Diff File Expand all files Collapse all files
Docs/api-client.md
+12 -11
View File
@@ -142,20 +142,21 @@
| 档位 | 中间件 | 条数 | 说明 |
|---|:--:|:--:|---|
| **只读监控档** | `viewerAuth`（owner/admin/viewer） | **14** | 非敏感投影：无凭据、无他人账号数据、无消息正文。**v0.78 新增两条**：面板接入点快照（A13）与插件动作分发（A14，**写门落在 handler 内**，见 A14 行注） |
| **owner/admin 读档** | `writeAuth`（owner/admin） | **17** | viewer 不得看到的一切：记忆、LLM 栈、账号/key、后台思考、审计链、渠道消息日志、完整会话导出、配置事实面（v0.68）、最近一轮链路图快照（v0.71）、记忆整理试算（v0.75）、入库前审查留痕与回滚（**v0.79**，B16/B17）、**链路图时间轴（v0.80，B18）** |
| **owner/admin 读档** | `writeAuth`（owner/admin） | **18** | viewer 不得看到的一切：记忆、LLM 栈、账号/key、后台思考、审计链、渠道消息日志、完整会话导出、配置事实面（v0.68）、最近一轮链路图快照（v0.71）、记忆整理试算（v0.75）、入库前审查留痕与回滚（**v0.79**，B16/B17）、**链路图时间轴（v0.80，B18）** |
| **owner-only 档** | `ownerAuth`（owner） | **40** | 带审计的策略写、每个获取凭据的渠道端点、其余全部变更 |
**管理路由总数 = 14 + 17 + 40 = 71 条。**
**管理路由总数 = 14 + 18 + 40 = 72 条。**
> **v0.78 计数变更**：`viewerAuth` 段新增两条（A13 `GET /admin/panels`、A14 `POST /admin/plugins/{id}/actions/{action}`）⇒ 12 → **14**、总数 66 → **68**。A14 走 `viewerAuth` 中间件，但**写动作在 handler 内按 owner/admin 收紧**（路由中间件只能有一道门）—— 因此它**是**本表的一行，读写面却不同档，详见 §2.1 A14 与 §4.14。
> **v0.79 计数变更**：`writeAuth` 段新增两条（B16 `GET /admin/memories/reviews`、B17 `POST /admin/memories/{id}/revert`，切片 L45）⇒ 14 → **16**、总数 68 → **70**。⚠️ 同批落地的 `GET /api/v1/media/{name}`（§1.2 U19）是**用户侧**端点，**不**进入本矩阵。
> **v0.80 计数变更**：`writeAuth` 段新增一条（B18 `GET /admin/flow/timeline`，切片 W1）⇒ 16 → **17**、总数 70 → **71**。它只读、不审计，与同族的 B13（`GET /admin/flow/graph`）**同门同档**。
> **v0.80 计数变更**：`writeAuth` 段新增一条（B18 `GET /admin/flow/timeline`，切片 W1）⇒ 段内**实有 18 条**、**管理路由总数实有 72 条**（`14 + 18 + 40`）。**本版一并回补了自 v0.76 起累积的 −1 记账滞后**（见下一段），故上表「条数」记 **17 → 18**、总数记 **71 → 72**。它只读、不审计，与同族的 B13（`GET /admin/flow/graph`）**同门同档**。
> ⚠️ **已知滞后（如实登记，本版未改）**：按上面「计数口径」那句（= 三张清单**列出的行数**）核，**§2.2 当前实际列出 18 行**（B1–B18）、§2.1 = 14 行、§2.3 = 40 行 ⇒ 逐行相加应为 **14 + 18 + 40 = 72**，而本表的「条数」序列记的是 **17 / 71**。该 **−1 滞后自 v0.76 起就存在**（那一次新增 B15 时未同步条数，此后各版沿序列 +1 而未回补），**不是 v0.80 引入的**。本版**沿既有序列只 +1**、**不擅自回补**；**要不要改成 18 / 72（或修正历史序列）由主会话裁决**。
> ✅ **记账滞后已修正（2026-10-06，本版回补）**：按上一段「计数口径」那句（= 三张清单**列出的行数**）核，**§2.2 实有 18 行**（B1–B18）、**§2.1 实有 14 行**（A1–A14）、**§2.3 实有 40 行** ⇒ 逐行相加 **14 + 18 + 40 = 72**，与上表「条数」序列（`writeAuth` **18** / 总数 **72**）**已一致**（`routes.go` 交叉核对：admin 侧经 `writeAuth` 挂载 20 条，减去 §2.4(a) 按历史口径不计入本表的 `channels/events` 与 `.../counters` ⇒ **18**）。**根因**（S6 报告 §6.1 发现）：v0.76 新增 B15 时**漏把条数 +1**，此后 v0.78 / v0.79 / v0.80 各版沿旧序列 +1 而未回补 ⇒ 那个 **−1 滞后从 v0.76 一路带到 v0.80 的登记值**。
> ⚠️ **上面 v0.78 / v0.79 两个计数段的绝对值仍沿用当时未回补的写法**（其**增量正确** —— `viewerAuth` 12 → 14、`writeAuth` 各版 +1 / +2 —— 但**绝对值比真实行数少 1**）；**§6 里各版条目（v0.76 ~ v0.80）的同类计数同理**。按本文件「历史条目保留当时状态」的惯例**不逐版改数**，**以本表 + 三张清单的行数为准**。
> **计数口径（v0.71 明确）**：总数是 §2.1 / §2.2 / §2.3 三张清单里**列出的行数**（与 v0.68 起的口径一致）。⚠️ `internal/services/gateway/routes.go` 里实际经 `writeAuth` 挂载的 **admin** 路由比 §2.2 多：v0.67 登记的 `GET /admin/channels/events` 与 `.../counters`（见 §2.4(a)）**未计入本表**——这是历史口径，本版未改，也**未**把它算进上面的 **17**。逐条以代码为准。
> **计数口径（v0.71 明确）**：总数是 §2.1 / §2.2 / §2.3 三张清单里**列出的行数**（与 v0.68 起的口径一致）。⚠️ `internal/services/gateway/routes.go` 里实际经 `writeAuth` 挂载的 **admin** 路由比 §2.2 多：v0.67 登记的 `GET /admin/channels/events` 与 `.../counters`（见 §2.4(a)）**未计入本表**——这是历史口径，本版未改，也**未**把它算进上面的 **18**。逐条以代码为准。
> ⚠️ **与归档版不一致（已更正）**：`Docs/archive/api-client.v0.65.md` §2.0 写「12 + 11 + 38 = 61」（其 v0.62 条目又写「12 + 10 + 38 = 60」，自相矛盾）。**以代码为准 = 12 + 11 + 40 = 63**。
@@ -180,7 +181,7 @@
> **A13 / A14 的角色门依据**（`routes.go` 紧邻注释）：快照端点对 viewer 开放是因为它回的**本来就是被裁掉写面的只读投影**；动作端点的读来源动作对 viewer 可见，**写门落在 handler 内**（路由中间件只能有一道门）。`panels_changed` 帧（§3.4.5）**不进** `frameReachesAll` 白名单 ⇒ **viewer 收不到该帧**，需自行刷新/轮询重拉 A13。
### 2.2 owner/admin 读（17 条，`writeAuth`）
### 2.2 owner/admin 读（18 条，`writeAuth`）
| # | 方法 | 路径 | 要点 |
|---|---|---|---|
@@ -905,8 +906,8 @@
#### (d) 未确证（如实）
- **`graph_json` 破损行**：SQL 侧用嵌套 `json_valid` **保护**（坏行不会拖垮整条查询），但该行若落进本页，解码会**如实报错** ⇒ `500 flow_unavailable`（与既有 `graph` / `graph_turns` 口径一致：读不懂就报错，绝不把坏行当「没有图」）。**这条路径没有测试**。
- **前端渲染与真机面板联调**不在本条证据内（后端出口的单测覆盖见切片 W1 报告）；**未重启后端**、未跑真机。
- **`graph_json` 破损行**：SQL 侧用嵌套 `json_valid` **保护**（坏行不会拖垮整条查询），但该行若落进本页，解码会**如实报错** ⇒ `500 flow_unavailable`（与既有 `graph` / `graph_turns` 口径一致：读不懂就报错，绝不把坏行当「没有图」）。**这条路径没有测试**（2026-10-06 复核：`internal/services/gateway/admin_flow_timeline_test.go` 现有 9 条用例，无一条喂坏 `graph_json` ⇒ 结论仍是「未确证」）。
- **前端渲染与真机面板联调**不在本条证据内（后端出口的单测覆盖见切片 W1 报告）。**代码级已确证**：前端有 `view="timeline"` 模式（`frontend/web/src/admin/modules/Flow.tsx`）+ `flow/TimelineView.tsx` / `useFlowTimeline.ts`；真机 `GET /api/v1/admin/flow/timeline`（**无凭据**）回 **`401 unauthorized`**（路由已随在跑产物部署，**不是** `404`）。**仍未确证**：浏览器里真面板跑通 —— **为什么验不了**：本轮禁重启后端 / 禁换产物，且取不到 owner 凭据，无法做面板联调（红线：不重启后端、只读验证）。
---
@@ -1203,7 +1204,7 @@
**三批增量 —— ① 链路图时间轴出口（切片 W1）｜② 搜索 provider 热重载 + 主 provider / 降级链（切片 W3）｜③ 入站语音 AMR 也可回放（切片 W4）**（依据：主人 2026-10-06 要「web 后台的全链路流程图 = **所有消息按时间顺序串起来**，而不是只有最新一个来回」；面板的意义就是「不改 `.env` 不重启」⇒ 配置面必须真热生效；微信 / QQ 的 AMR 入站语音不落副本 = 无法回放 / 多端同步。）
- **① 链路图时间轴出口（切片 W1，`design/19 §7`）**：新增 1 条 `writeAuth`（owner\|admin）**只读、不审计**端点 **`GET /api/v1/admin/flow/timeline`**（`?sessionId=&limit=&before=`）—— 把多轮链路图**按时间正序**返回，每轮 `{turnId,round,startedAt,endedAt,lanes[]}`（`lanes[]` 每项 `{turnId,graph}`，`graph` 与 `graph_update` 同形）。数据源 = **已落盘的 `flow_graphs`**（迁移 `0022`/`0023`，保留期 `FLOW_GRAPH_RETENTION` 默认 168h）**+ 内存里的最近一轮**（在飞 / 刚落盘失败的那一轮）；`limit` 缺省 **50** / 硬上限 **200**（超上限钳住、`≤0` 同缺省、非整数 `400 bad_request`）；`before` 游标取「开始时刻**严格早于**它」的轮次、响应回带 `nextBefore`（**原样回带即可连续翻页**，分页不重不漏）；响应另给 `retentionHours` / `retentionEnabled` / `truncated` 供面板**如实**标注「更早的轮次已过保留期」。**未接线（内存 + 落盘都没接）⇒ `500 flow_unavailable`**，**绝不回空 `rounds`**（不假装「这个会话没有轮次」）。权限矩阵：`writeAuth` 16 → **17**、总数 70 → **71**。🔴 **老端点 `GET /admin/flow/graph`（B13）逐字未改**（`admin_flow.go` 零改动，`routes.go` 只加一行路由 + 注释）⇒ **老客户端零影响**。**§2.0 / §2.2 B18 / §4.11.1**。
- **① 链路图时间轴出口（切片 W1，`design/19 §7`）**：新增 1 条 `writeAuth`（owner\|admin）**只读、不审计**端点 **`GET /api/v1/admin/flow/timeline`**（`?sessionId=&limit=&before=`）—— 把多轮链路图**按时间正序**返回，每轮 `{turnId,round,startedAt,endedAt,lanes[]}`（`lanes[]` 每项 `{turnId,graph}`，`graph` 与 `graph_update` 同形）。数据源 = **已落盘的 `flow_graphs`**（迁移 `0022`/`0023`，保留期 `FLOW_GRAPH_RETENTION` 默认 168h）**+ 内存里的最近一轮**（在飞 / 刚落盘失败的那一轮）；`limit` 缺省 **50** / 硬上限 **200**（超上限钳住、`≤0` 同缺省、非整数 `400 bad_request`）；`before` 游标取「开始时刻**严格早于**它」的轮次、响应回带 `nextBefore`（**原样回带即可连续翻页**，分页不重不漏）；响应另给 `retentionHours` / `retentionEnabled` / `truncated` 供面板**如实**标注「更早的轮次已过保留期」。**未接线（内存 + 落盘都没接）⇒ `500 flow_unavailable`**，**绝不回空 `rounds`**（不假装「这个会话没有轮次」）。权限矩阵：`writeAuth` 段实有 **18** / 总数实有 **72**（**本版同时回补了自 v0.76 起的 −1 记账滞后**，见 §2.0）。🔴 **老端点 `GET /admin/flow/graph`（B13）逐字未改**（`admin_flow.go` 零改动，`routes.go` 只加一行路由 + 注释）⇒ **老客户端零影响**。**§2.0 / §2.2 B18 / §4.11.1**。
- **② 搜索 provider 热重载 + 主 provider / 降级链（切片 W3；裁决 2026-10-06 #1 / #2）**：`plugin.saveProvider` 成功落盘后，组合根**按落盘后的配置重建 web-search 工具并原子替换能力注册表里的条目**（新增窄方法 `registry.ReplaceTool` —— **不是** `Remove`+`Register`：中间无空窗，且**保留运行期策略**）⇒ **下一轮对话即用新配置，不需要重启**（design/09 §5.5）。**保存是一次事务**：快照文件 → 落盘 → 重建 → 换条目；③ 失败 ⇒ **文件按字节回滚**（temp+rename）+ **`409 config_unstartable`**（会 make-下次起不来的配置绝不留在盘上）；回滚也失败 ⇒ 如实 `500 config_write_failed`。响应新增机器可读事实 **`hotReload:{applied,registered}`**。声明面**增补两个文件级字段** `primary`（`select`）/ `fallback`（`multiSelect`，候选来源 `plugin:providers`）—— **缺位 = 不改动**；`primary` 给空串 / `off` / `none` = **关掉这把工具**（与 `WEB_SEARCH_PROVIDER` 共用同一套关闭语义）；点名「已登记但未配齐」的家 ⇒ **`400 primary_not_configured`**（**写盘之前**就拒）；`fallback` 元素未登记 ⇒ `400 unknown_provider`、形状错 ⇒ `400 invalid_payload`。`plugin.reauthProvider` 的 `values` **追加** `primary` / `fallback`（否则面板「清空降级链」在客户端三态写回里清不掉）。**新增错误码**：`primary_not_configured`(400) / `config_unstartable`(409)。🔴 **本版改正三处已成假话的旧口径**（此前写「面板保存后**不**热替换运行中的工具、需重启」、「面板**无**主 provider / 降级链字段」）：§4.14(b) / §4.14(c) / §7.2 / §7.4-26 / §7.4-27 已改。⚠️ **触发面只有本动作**：直接改写可变源文件（不经面板）**不**触发热重载，仍需重启。**§4.1 / §4.14(b)(c) / §7.2**。
- **③ 入站语音 AMR 也可回放（切片 W4；裁决 #11）**：组合根补齐 `channelbridge.Options.VoiceTranscoder`（`cmd/cyrene/wire_channels.go`）—— 注入的是 `wireTranscode` 装配的**同一个**引擎实例（与工具面 `transcode` 工具同源，不是第二条降级链）。⇒ **不可播格式的入站语音在落盘之前先转成 `.wav` 再落副本**（`mime: audio/wav`；本期唯一必需的转码路 = QQ OneBot v11 的 `amr → wav`），客户端的 `voice` 从此带副本事实（`name` / `mime` / `size` / `durationMs` / `url`）；**此前这些键缺席**（走 `category=transcode_not_wired` 的诚实 WARN、不落副本）。**形状零变化**（DTO `voice` 的键集合与语义一字未改）；**可播格式**（ogg/wav/mp3/m4a/aac/flac/webm/oga/opus）仍**原样落、一次转码都不发生**。稳定 `category` 列表**不变**（10 类），但 `transcode_not_wired` 在生产装配下**不再出现**（它现在只剩「引擎未装配 / 构造失败」这一档）。🔴 **本版改正 6 处已成假话的「组合根未注入 `VoiceTranscoder` ⇒ AMR 不落副本」**：§4.5（缺口① + 现状行）/ §7.1（对照注）/ §7.2（语音面行 ②）/ §7.4-16（前向提示）/ §7.4-29（②）/ 旧版本横幅与 §6 旧版条目（v0.67 / v0.78 / v0.79）。**§4.5 / §7.2 / §7.4-29**。
- **行为变更**：① 无（新端点；老端点逐字未改）；② **有**（面板保存由「需重启生效」变为**下一轮即生效**；新增两个可配字段与两个错误码；`plugin.saveProvider` / `plugin.reauthProvider` 的响应形状**加键**）；③ 无（DTO `voice` 的键集合与语义未变，只是**此前缺席的键现在会出现**）。
@@ -1570,9 +1571,9 @@
25. **（v0.78 登记 · v0.79 更新）`toolCalls[]` 的覆盖率与端到端未确证**：✅ **覆盖率已补齐（v0.79，切片 CODE-TC-2）** —— 编排器驱动的**每一路**（含普通单路回合与队首续跑路）的图都带权威 `turnId` ⇒ 字段不再只覆盖真并行路。⚠️ **仍未确证 / 仍缺席的点**：① **单路在 HTTP 出口的端到端未由本切片确证** —— 写侧（`loop` 的 3 个新用例，含真 `Run` → 真库 → 按消息那个 id 查回）已验，但网关读侧（`internal/services/gateway/history_toolcalls_gap_test.go` 那条「钉住现状缺口」的用例走的是**老入口** `StartRound`，其前提句已失效）由主会话补验；**没有**对运行中的后端发过一次真消息来实测 `GET /sessions/web/messages` 拿到单路 `toolCalls`。② **「存库里的 `lane_turn_id` 与 `chat_messages.turn_id` 逐字相等」仍是代码级结论**（两处都取 ctx 上的权威标识）。③ **老行**（v0.79 之前的单路落盘）该列仍为空，**不可能**补齐（那时的图里没有该字段）。④ **后台思考**（`sess-backthink`）仍缺席。⑤ 生产库 `data/cyrene.db` 现存行的回填命中率**未统计**（未碰生产库）。
26. **（v0.78 登记 · v0.79 更新）插件管理面板接入点 / 动作执行面的真机未确证**：`GET /api/v1/admin/panels` 与 `POST /admin/plugins/{id}/actions/{action}` 的**真实运行期响应未在 `:10942` 上验过**（换产物 / 重启有专门流程，本切片禁止）。所有证据来自 `httptest` + 进程内 bus。⇒ **未确证**：真机上 `data.pluginIds == ["web-search"]`、`groups[0].items[0].sections` 的两段声明、`route` 的前缀拼接姿势（相对片段，前端拼 `<prefix>/plugin/<pluginId>/<panelId>`）。**v0.79 新增未确证项**：① 面板动作（`plugin.listProviders` 等）在**真机上**真的回 200 + `result`（单测层已用 `httptest` 真发 HTTP 验过探针）；② **真机探针未打过真实上游**（无 key）；③ ~~面板保存 provider 后运行中的 web-search 工具不换接线（需重启）~~ ⇒ **v0.80（切片 W3）已改为保存后热重载**（`hotReload:{applied,registered}`），**真机端到端仍未跑**（真机上「保存后下一轮真的走新配置」未验；未换产物前旧二进制里仍是启动期接线）。另：`panels_changed` 的分组文案「插件」是**宿主文案**（design 未规定文案来源），改口径只改一个函数。⚠️ 且**未换产物前**，旧二进制里**没有**这些路由，属预期。
26. **（v0.78 登记 · v0.79 更新）插件管理面板接入点 / 动作执行面的真机未确证**：`GET /api/v1/admin/panels` 与 `POST /admin/plugins/{id}/actions/{action}` 的**真实运行期响应未在 `:10942` 上验过**（换产物 / 重启有专门流程，本切片禁止）。所有证据来自 `httptest` + 进程内 bus。⇒ **未确证**：真机上 `data.pluginIds == ["web-search"]`、`groups[0].items[0].sections` 的两段声明、`route` 的前缀拼接姿势（相对片段，前端拼 `<prefix>/plugin/<pluginId>/<panelId>`）。**v0.79 新增未确证项**：① 面板动作（`plugin.listProviders` 等）在**真机上**真的回 200 + `result`（单测层已用 `httptest` 真发 HTTP 验过探针）；② **真机探针未打过真实上游**（无 key）；③ ~~面板保存 provider 后运行中的 web-search 工具不换接线（需重启）~~ ⇒ **v0.80（切片 W3）已改为保存后热重载**（`hotReload:{applied,registered}`），**真机端到端仍未跑**（真机上「保存后下一轮真的走新配置」未验；未换产物前旧二进制里仍是启动期接线）。另：`panels_changed` 的分组文案「插件」是**宿主文案**（design 未规定文案来源），改口径只改一个函数。⚠️ 且**未换产物前**，旧二进制里**没有**这些路由，属预期。**为什么验不了（2026-10-06 复核）**：本波禁换产物 / 禁重启后端，且**取不到 owner 凭据** ⇒ 真机面板 e2e 无法做；代码侧已复核确证「非对象响应**不**追加 `hotReload`」（`cmd/cyrene/websearch_reload.go` 的 `withReloadOutcome`：非 `map[string]any` 原样返回）。
27. **（v0.78 登记 · v0.79 更新）`web-search` 可变源的运行期口径未确证**：组合根「先可变源、缺失回落 `.env` 播种」已有单测钉住（含「凭据不复活」「损坏文件不改写」「停用主 provider ⇒ 启动 fail-fast」等 7 条），并有一条**真机 SearXNG e2e**（`provider=searxng` 真返回结果）证明既有链路未被打断。**v0.79**：动作执行器已接线 ⇒ `plugin.saveProvider` 的**落盘链路**在 `cmd/cyrene` 的单测里真跑过（临时目录 + 真 `runtimeconfig.SaveWebSearch`）。⚠️ **仍未确证**：「在**真机面板**上新增一家 provider → **下一次搜索真的走它**」这条**端到端**（✅ v0.80 起**保存后工具热重载**：换注册表条目、**下一轮生效**（见 §4.14(c)），但**真机端到端仍未跑**，见 §7.2 / §6 v0.80 ②）。
27. **（v0.78 登记 · v0.79 更新）`web-search` 可变源的运行期口径未确证**：组合根「先可变源、缺失回落 `.env` 播种」已有单测钉住（含「凭据不复活」「损坏文件不改写」「停用主 provider ⇒ 启动 fail-fast」等 7 条），并有一条**真机 SearXNG e2e**（`provider=searxng` 真返回结果）证明既有链路未被打断。**v0.79**：动作执行器已接线 ⇒ `plugin.saveProvider` 的**落盘链路**在 `cmd/cyrene` 的单测里真跑过（临时目录 + 真 `runtimeconfig.SaveWebSearch`）。⚠️ **仍未确证**：「在**真机面板**上新增一家 provider → **下一次搜索真的走它**」这条**端到端**（✅ v0.80 起**保存后工具热重载**：换注册表条目、**下一轮生效**（见 §4.14(c)），但**真机端到端仍未跑**，见 §7.2 / §6 v0.80 ②）。**为什么验不了（2026-10-06 复核）**：真机面板 e2e 需要 owner 凭据 + 真在面板上改一次配置（本波禁改数据、禁换产物 / 禁重启后端），且**无任何第三方 key** ⇒ 只能停在 `httptest` + 单测级证据。
28. **（v0.78 登记）渠道事件实时面未做真机端到端**：`channel_event` 的「采样 → 落行 → 推帧 → 只投 owner/admin」由**真 SQLite + 真 bus + 真 WS 连接**的单测/端到端用例覆盖，但**运行中的 `cyrene.exe` 未重启**（红线：主会话换产物）⇒ **没有真机日志证据**。且当前 QQ 已停连 ⇒ 若真机启动，`qq-obv11` 账号为 `known=false`，首拍会落一行 `账号状态未知（尚未探到）`。另：**心跳通道（`meta_event.heartbeat`/`lifecycle`）驱动的迁移仍未接**（需适配器把状态投影进状态面，属 `plugins/**`），当前**唯一**迁移来源是探活（`qq_obv11/probe.go`）。