@symerian/symi 3.0.20 → 3.0.22

package/docs/zh-CN/refactor/exec-host.md

@@ -1,323 +0,0 @@
----
-read_when:
-  - 设计 exec 主机路由或 exec 批准
-  - 实现节点运行器 + UI IPC
-  - 添加 exec 主机安全模式和斜杠命令
-summary: 重构计划：exec 主机路由、节点批准和无头运行器
-title: Exec 主机重构
-x-i18n:
-  generated_at: "2026-02-03T07:54:43Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 53a9059cbeb1f3f1dbb48c2b5345f88ca92372654fef26f8481e651609e45e3a
-  source_path: refactor/exec-host.md
-  workflow: 15
----
-
-# Exec 主机重构计划
-
-## 目标
-
-- 添加 `exec.host` + `exec.security` 以在**沙箱**、**Gateway 网关**和**节点**之间路由执行。
-- 保持默认**安全**：除非明确启用，否则不进行跨主机执行。
-- 将执行拆分为**无头运行器服务**，通过本地 IPC 连接可选的 UI（macOS 应用）。
-- 提供**每智能体**策略、允许列表、询问模式和节点绑定。
-- 支持*与*或*不与*允许列表一起使用的**询问模式**。
-- 跨平台：Unix socket + token 认证（macOS/Linux/Windows 一致性）。
-
-## 非目标
-
-- 无遗留允许列表迁移或遗留 schema 支持。
-- 节点 exec 无 PTY/流式传输（仅聚合输出）。
-- 除现有 Bridge + Gateway 网关外无新网络层。
-
-## 决定（已锁定）
-
-- **配置键：** `exec.host` + `exec.security`（允许每智能体覆盖）。
-- **提升：** 保留 `/elevated` 作为 Gateway 网关完全访问的别名。
-- **询问默认：** `on-miss`。
-- **批准存储：** `~/.symi/exec-approvals.json`（JSON，无遗留迁移）。
-- **运行器：** 无头系统服务；UI 应用托管 Unix socket 用于批准。
-- **节点身份：** 使用现有 `nodeId`。
-- **Socket 认证：** Unix socket + token（跨平台）；如需要稍后拆分。
-- **节点主机状态：** `~/.symi/node.json`（节点 id + 配对 token）。
-- **macOS exec 主机：** 在 macOS 应用内运行 `system.run`；节点主机服务通过本地 IPC 转发请求。
-- **无 XPC helper：** 坚持使用 Unix socket + token + 对等检查。
-
-## 关键概念
-
-### 主机
-
-- `sandbox`：Docker exec（当前行为）。
-- `gateway`：在 Gateway 网关主机上执行。
-- `node`：通过 Bridge 在节点运行器上执行（`system.run`）。
-
-### 安全模式
-
-- `deny`：始终阻止。
-- `allowlist`：仅允许匹配项。
-- `full`：允许一切（等同于提升模式）。
-
-### 询问模式
-
-- `off`：从不询问。
-- `on-miss`：仅在允许列表不匹配时询问。
-- `always`：每次都询问。
-
-询问**独立于**允许列表；允许列表可与 `always` 或 `on-miss` 一起使用。
-
-### 策略解析（每次执行）
-
-1. 解析 `exec.host`（工具参数 → 智能体覆盖 → 全局默认）。
-2. 解析 `exec.security` 和 `exec.ask`（相同优先级）。
-3. 如果主机是 `sandbox`，继续本地沙箱执行。
-4. 如果主机是 `gateway` 或 `node`，在该主机上应用安全 + 询问策略。
-
-## 默认安全
-
-- 默认 `exec.host = sandbox`。
-- `gateway` 和 `node` 默认 `exec.security = deny`。
-- 默认 `exec.ask = on-miss`（仅在安全允许时相关）。
-- 如果未设置节点绑定，**智能体可以定向任何节点**，但仅在策略允许时。
-
-## 配置表面
-
-### 工具参数
-
-- `exec.host`（可选）：`sandbox | gateway | node`。
-- `exec.security`（可选）：`deny | allowlist | full`。
-- `exec.ask`（可选）：`off | on-miss | always`。
-- `exec.node`（可选）：当 `host=node` 时使用的节点 id/名称。
-
-### 配置键（全局）
-
-- `tools.exec.host`
-- `tools.exec.security`
-- `tools.exec.ask`
-- `tools.exec.node`（默认节点绑定）
-
-### 配置键（每智能体）
-
-- `agents.list[].tools.exec.host`
-- `agents.list[].tools.exec.security`
-- `agents.list[].tools.exec.ask`
-- `agents.list[].tools.exec.node`
-
-### 别名
-
-- `/elevated on` = 为智能体会话设置 `tools.exec.host=gateway`、`tools.exec.security=full`。
-- `/elevated off` = 为智能体会话恢复之前的 exec 设置。
-
-## 批准存储（JSON）
-
-路径：`~/.symi/exec-approvals.json`
-
-用途：
-
-- **执行主机**（Gateway 网关或节点运行器）的本地策略 + 允许列表。
-- 无 UI 可用时的询问回退。
-- UI 客户端的 IPC 凭证。
-
-建议的 schema（v1）：
-
-```json
-{
-  "version": 1,
-  "socket": {
-    "path": "~/.symi/exec-approvals.sock",
-    "token": "base64-opaque-token"
-  },
-  "defaults": {
-    "security": "deny",
-    "ask": "on-miss",
-    "askFallback": "deny"
-  },
-  "agents": {
-    "agent-id-1": {
-      "security": "allowlist",
-      "ask": "on-miss",
-      "allowlist": [
-        {
-          "pattern": "~/Projects/**/bin/rg",
-          "lastUsedAt": 0,
-          "lastUsedCommand": "rg -n TODO",
-          "lastResolvedPath": "/Users/user/Projects/.../bin/rg"
-        }
-      ]
-    }
-  }
-}
-```
-
-注意事项：
-
-- 无遗留允许列表格式。
-- `askFallback` 仅在需要 `ask` 且无法访问 UI 时应用。
-- 文件权限：`0600`。
-
-## 运行器服务（无头）
-
-### 角色
-
-- 在本地强制执行 `exec.security` + `exec.ask`。
-- 执行系统命令并返回输出。
-- 为 exec 生命周期发出 Bridge 事件（可选但推荐）。
-
-### 服务生命周期
-
-- macOS 上的 Launchd/daemon；Linux/Windows 上的系统服务。
-- 批准 JSON 是执行主机本地的。
-- UI 托管本地 Unix socket；运行器按需连接。
-
-## UI 集成（macOS 应用）
-
-### IPC
-
-- Unix socket 位于 `~/.symi/exec-approvals.sock`（0600）。
-- Token 存储在 `exec-approvals.json`（0600）中。
-- 对等检查：仅同 UID。
-- 挑战/响应：nonce + HMAC(token, request-hash) 防止重放。
-- 短 TTL（例如 10s）+ 最大负载 + 速率限制。
-
-### 询问流程（macOS 应用 exec 主机）
-
-1. 节点服务从 Gateway 网关接收 `system.run`。
-2. 节点服务连接到本地 socket 并发送提示/exec 请求。
-3. 应用验证对等 + token + HMAC + TTL，然后在需要时显示对话框。
-4. 应用在 UI 上下文中执行命令并返回输出。
-5. 节点服务将输出返回给 Gateway 网关。
-
-如果 UI 缺失：
-
-- 应用 `askFallback`（`deny|allowlist|full`）。
-
-### 图示（SCI）
-
-```
-Agent -> Gateway -> Bridge -> Node Service (TS)
-                         |  IPC (UDS + token + HMAC + TTL)
-                         v
-                     Mac App (UI + TCC + system.run)
-```
-
-## 节点身份 + 绑定
-
-- 使用 Bridge 配对中的现有 `nodeId`。
-- 绑定模型：
-  - `tools.exec.node` 将智能体限制为特定节点。
-  - 如果未设置，智能体可以选择任何节点（策略仍强制执行默认值）。
-- 节点选择解析：
-  - `nodeId` 精确匹配
-  - `displayName`（规范化）
-  - `remoteIp`
-  - `nodeId` 前缀（>= 6 字符）
-
-## 事件
-
-### 谁看到事件
-
-- 系统事件是**每会话**的，在下一个提示时显示给智能体。
-- 存储在 Gateway 网关内存队列中（`enqueueSystemEvent`）。
-
-### 事件文本
-
-- `Exec started (node=<id>, id=<runId>)`
-- `Exec finished (node=<id>, id=<runId>, code=<code>)` + 可选输出尾部
-- `Exec denied (node=<id>, id=<runId>, <reason>)`
-
-### 传输
-
-选项 A（推荐）：
-
-- 运行器发送 Bridge `event` 帧 `exec.started` / `exec.finished`。
-- Gateway 网关 `handleBridgeEvent` 将这些映射到 `enqueueSystemEvent`。
-
-选项 B：
-
-- Gateway 网关 `exec` 工具直接处理生命周期（仅同步）。
-
-## Exec 流程
-
-### 沙箱主机
-
-- 现有 `exec` 行为（Docker 或无沙箱时的主机）。
-- 仅在非沙箱模式下支持 PTY。
-
-### Gateway 网关主机
-
-- Gateway 网关进程在其自己的机器上执行。
-- 强制执行本地 `exec-approvals.json`（安全/询问/允许列表）。
-
-### 节点主机
-
-- Gateway 网关调用 `node.invoke` 配合 `system.run`。
-- 运行器强制执行本地批准。
-- 运行器返回聚合的 stdout/stderr。
-- 可选的 Bridge 事件用于开始/完成/拒绝。
-
-## 输出上限
-
-- 组合 stdout+stderr 上限为 **200k**；为事件保留**尾部 20k**。
-- 使用清晰的后缀截断（例如 `"… (truncated)"`）。
-
-## 斜杠命令
-
-- `/exec host=<sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>`
-- 每智能体、每会话覆盖；除非通过配置保存，否则非持久。
-- `/elevated on|off|ask|full` 仍然是 `host=gateway security=full` 的快捷方式（`full` 跳过批准）。
-
-## 跨平台方案
-
-- 运行器服务是可移植的执行目标。
-- UI 是可选的；如果缺失，应用 `askFallback`。
-- Windows/Linux 支持相同的批准 JSON + socket 协议。
-
-## 实现阶段
-
-### 阶段 1：配置 + exec 路由
-
-- 为 `exec.host`、`exec.security`、`exec.ask`、`exec.node` 添加配置 schema。
-- 更新工具管道以遵守 `exec.host`。
-- 添加 `/exec` 斜杠命令并保留 `/elevated` 别名。
-
-### 阶段 2：批准存储 + Gateway 网关强制执行
-
-- 实现 `exec-approvals.json` 读取器/写入器。
-- 为 `gateway` 主机强制执行允许列表 + 询问模式。
-- 添加输出上限。
-
-### 阶段 3：节点运行器强制执行
-
-- 更新节点运行器以强制执行允许列表 + 询问。
-- 添加 Unix socket 提示桥接到 macOS 应用 UI。
-- 连接 `askFallback`。
-
-### 阶段 4：事件
-
-- 为 exec 生命周期添加节点 → Gateway 网关 Bridge 事件。
-- 映射到 `enqueueSystemEvent` 用于智能体提示。
-
-### 阶段 5：UI 完善
-
-- Mac 应用：允许列表编辑器、每智能体切换器、询问策略 UI。
-- 节点绑定控制（可选）。
-
-## 测试计划
-
-- 单元测试：允许列表匹配（glob + 不区分大小写）。
-- 单元测试：策略解析优先级（工具参数 → 智能体覆盖 → 全局）。
-- 集成测试：节点运行器拒绝/允许/询问流程。
-- Bridge 事件测试：节点事件 → 系统事件路由。
-
-## 开放风险
-
-- UI 不可用：确保遵守 `askFallback`。
-- 长时间运行的命令：依赖超时 + 输出上限。
-- 多节点歧义：除非有节点绑定或显式节点参数，否则报错。
-
-## 相关文档
-
-- [Exec 工具](/tools/exec)
-- [执行批准](/tools/exec-approvals)
-- [节点](/nodes)
-- [提升模式](/tools/elevated)

package/docs/zh-CN/refactor/outbound-session-mirroring.md

@@ -1,90 +0,0 @@
----
-description: Track outbound session mirroring refactor notes, decisions, tests, and open items.
-title: 出站会话镜像重构（Issue
-x-i18n:
-  generated_at: "2026-02-03T07:53:51Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: b88a72f36f7b6d8a71fde9d014c0a87e9a8b8b0d449b67119cf3b6f414fa2b81
-  source_path: refactor/outbound-session-mirroring.md
-  workflow: 15
----
-
-# 出站会话镜像重构（Issue #1520）
-
-## 状态
-
-- 进行中。
-- 核心 + 插件渠道路由已更新以支持出站镜像。
-- Gateway 网关发送现在在省略 sessionKey 时派生目标会话。
-
-## 背景
-
-出站发送被镜像到*当前*智能体会话（工具会话键）而不是目标渠道会话。入站路由使用渠道/对等方会话键，因此出站响应落在错误的会话中，首次联系的目标通常缺少会话条目。
-
-## 目标
-
-- 将出站消息镜像到目标渠道会话键。
-- 在缺失时为出站创建会话条目。
-- 保持线程/话题作用域与入站会话键对齐。
-- 涵盖核心渠道加内置扩展。
-
-## 实现摘要
-
-- 新的出站会话路由辅助器：
-  - `src/infra/outbound/outbound-session.ts`
-  - `resolveOutboundSessionRoute` 使用 `buildAgentSessionKey`（dmScope + identityLinks）构建目标 sessionKey。
-  - `ensureOutboundSessionEntry` 通过 `recordSessionMetaFromInbound` 写入最小的 `MsgContext`。
-- `runMessageAction`（发送）派生目标 sessionKey 并将其传递给 `executeSendAction` 进行镜像。
-- `message-tool` 不再直接镜像；它只从当前会话键解析 agentId。
-- 插件发送路径使用派生的 sessionKey 通过 `appendAssistantMessageToSessionTranscript` 进行镜像。
-- Gateway 网关发送在未提供时派生目标会话键（默认智能体），并确保会话条目。
-
-## 线程/话题处理
-
-- Slack：replyTo/threadId -> `resolveThreadSessionKeys`（后缀）。
-- Telegram：话题 ID 通过 `buildTelegramGroupPeerId` 映射到 `chatId:topic:<id>`。
-
-## 涵盖的扩展
-
-- Matrix、MS Teams、Mattermost、BlueBubbles、Nextcloud Talk、Zalo、Zalo Personal、Nostr、Tlon。
-- 注意：
-  - Mattermost 目标现在为私信会话键路由去除 `@`。
-  - Zalo Personal 对 1:1 目标使用私信对等方类型（仅当存在 `group:` 时才使用群组）。
-  - BlueBubbles 群组目标去除 `chat_*` 前缀以匹配入站会话键。
-  - Slack 自动线程镜像不区分大小写地匹配频道 id。
-  - Gateway 网关发送在镜像前将提供的会话键转换为小写。
-
-## 决策
-
-- **Gateway 网关发送会话派生**：如果提供了 `sessionKey`，则使用它。如果省略，从目标 + 默认智能体派生 sessionKey 并镜像到那里。
-- **会话条目创建**：始终使用 `recordSessionMetaFromInbound`，`Provider/From/To/ChatType/AccountId/Originating*` 与入站格式对齐。
-- **目标规范化**：出站路由在可用时使用解析后的目标（`resolveChannelTarget` 之后）。
-- **会话键大小写**：在写入和迁移期间将会话键规范化为小写。
-
-## 添加/更新的测试
-
-- `src/infra/outbound/outbound-session.test.ts`
-  - Slack 线程会话键。
-  - Telegram 话题会话键。
-- `src/agents/tools/message-tool.test.ts`
-  - 从会话键派生 agentId（不传递 sessionKey）。
-- `src/gateway/server-methods/send.test.ts`
-  - 在省略时派生会话键并创建会话条目。
-
-## 待处理项目 / 后续跟进
-
-- 语音通话插件使用自定义的 `voice:<phone>` 会话键。出站映射在这里没有标准化；如果 message-tool 应该支持语音通话发送，请添加显式映射。
-- 确认是否有任何外部插件使用内置集之外的非标准 `From/To` 格式。
-
-## 涉及的文件
-
-- `src/infra/outbound/outbound-session.ts`
-- `src/infra/outbound/outbound-send-service.ts`
-- `src/infra/outbound/message-action-runner.ts`
-- `src/agents/tools/message-tool.ts`
-- `src/gateway/server-methods/send.ts`
-- 测试：
-  - `src/infra/outbound/outbound-session.test.ts`
-  - `src/agents/tools/message-tool.test.ts`
-  - `src/gateway/server-methods/send.test.ts`

package/docs/zh-CN/refactor/plugin-sdk.md

@@ -1,221 +0,0 @@
----
-read_when:
-  - 定义或重构插件架构
-  - 将渠道连接器迁移到插件 SDK/运行时
-summary: 计划：为所有消息连接器提供一套统一的插件 SDK + 运行时
-title: 插件 SDK 重构
-x-i18n:
-  generated_at: "2026-02-01T21:36:45Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: d1964e2e47a19ee1d42ddaaa9cf1293c80bb0be463b049dc8468962f35bb6cb0
-  source_path: refactor/plugin-sdk.md
-  workflow: 15
----
-
-# 插件 SDK + 运行时重构计划
-
-目标：每个消息连接器都是一个插件（内置或外部），使用统一稳定的 API。
-插件不直接从 `src/**` 导入任何内容。所有依赖项均通过 SDK 或运行时获取。
-
-## 为什么现在做
-
-- 当前连接器混用多种模式：直接导入核心模块、仅 dist 的桥接方式以及自定义辅助函数。
-- 这使得升级变得脆弱，并阻碍了干净的外部插件接口。
-
-## 目标架构（两层）
-
-### 1）插件 SDK（编译时，稳定，可发布）
-
-范围：类型、辅助函数和配置工具。无运行时状态，无副作用。
-
-内容（示例）：
-
-- 类型：`ChannelPlugin`、适配器、`ChannelMeta`、`ChannelCapabilities`、`ChannelDirectoryEntry`。
-- 配置辅助函数：`buildChannelConfigSchema`、`setAccountEnabledInConfigSection`、`deleteAccountFromConfigSection`、
-  `applyAccountNameToChannelSection`。
-- 配对辅助函数：`PAIRING_APPROVED_MESSAGE`、`formatPairingApproveHint`。
-- 新手引导辅助函数：`promptChannelAccessConfig`、`addWildcardAllowFrom`、新手引导类型。
-- 工具参数辅助函数：`createActionGate`、`readStringParam`、`readNumberParam`、`readReactionParams`、`jsonResult`。
-- 文档链接辅助函数：`formatDocsLink`。
-
-交付方式：
-
-- 以 `symi/plugin-sdk` 发布（或从核心以 `symi/plugin-sdk` 导出）。
-- 使用语义化版本控制，提供明确的稳定性保证。
-
-### 2）插件运行时（执行层，注入式）
-
-范围：所有涉及核心运行时行为的内容。
-通过 `SymiPluginApi.runtime` 访问，确保插件永远不会导入 `src/**`。
-
-建议的接口（最小但完整）：
-
-```ts
-export type PluginRuntime = {
-  channel: {
-    text: {
-      chunkMarkdownText(text: string, limit: number): string[];
-      resolveTextChunkLimit(cfg: SymiConfig, channel: string, accountId?: string): number;
-      hasControlCommand(text: string, cfg: SymiConfig): boolean;
-    };
-    reply: {
-      dispatchReplyWithBufferedBlockDispatcher(params: {
-        ctx: unknown;
-        cfg: unknown;
-        dispatcherOptions: {
-          deliver: (payload: {
-            text?: string;
-            mediaUrls?: string[];
-            mediaUrl?: string;
-          }) => void | Promise<void>;
-          onError?: (err: unknown, info: { kind: string }) => void;
-        };
-      }): Promise<void>;
-      createReplyDispatcherWithTyping?: unknown; // adapter for Teams-style flows
-    };
-    routing: {
-      resolveAgentRoute(params: {
-        cfg: unknown;
-        channel: string;
-        accountId: string;
-        peer: { kind: RoutePeerKind; id: string };
-      }): { sessionKey: string; accountId: string };
-    };
-    pairing: {
-      buildPairingReply(params: { channel: string; idLine: string; code: string }): string;
-      readAllowFromStore(channel: string): Promise<string[]>;
-      upsertPairingRequest(params: {
-        channel: string;
-        id: string;
-        meta?: { name?: string };
-      }): Promise<{ code: string; created: boolean }>;
-    };
-    media: {
-      fetchRemoteMedia(params: { url: string }): Promise<{ buffer: Buffer; contentType?: string }>;
-      saveMediaBuffer(
-        buffer: Uint8Array,
-        contentType: string | undefined,
-        direction: "inbound" | "outbound",
-        maxBytes: number,
-      ): Promise<{ path: string; contentType?: string }>;
-    };
-    mentions: {
-      buildMentionRegexes(cfg: SymiConfig, agentId?: string): RegExp[];
-      matchesMentionPatterns(text: string, regexes: RegExp[]): boolean;
-    };
-    groups: {
-      resolveGroupPolicy(
-        cfg: SymiConfig,
-        channel: string,
-        accountId: string,
-        groupId: string,
-      ): {
-        allowlistEnabled: boolean;
-        allowed: boolean;
-        groupConfig?: unknown;
-        defaultConfig?: unknown;
-      };
-      resolveRequireMention(
-        cfg: SymiConfig,
-        channel: string,
-        accountId: string,
-        groupId: string,
-        override?: boolean,
-      ): boolean;
-    };
-    debounce: {
-      createInboundDebouncer<T>(opts: {
-        debounceMs: number;
-        buildKey: (v: T) => string | null;
-        shouldDebounce: (v: T) => boolean;
-        onFlush: (entries: T[]) => Promise<void>;
-        onError?: (err: unknown) => void;
-      }): { push: (v: T) => void; flush: () => Promise<void> };
-      resolveInboundDebounceMs(cfg: SymiConfig, channel: string): number;
-    };
-    commands: {
-      resolveCommandAuthorizedFromAuthorizers(params: {
-        useAccessGroups: boolean;
-        authorizers: Array<{ configured: boolean; allowed: boolean }>;
-      }): boolean;
-    };
-  };
-  logging: {
-    shouldLogVerbose(): boolean;
-    getChildLogger(name: string): PluginLogger;
-  };
-  state: {
-    resolveStateDir(cfg: SymiConfig): string;
-  };
-};
-```
-
-备注：
-
-- 运行时是访问核心行为的唯一方式。
-- SDK 故意保持小巧和稳定。
-- 每个运行时方法都映射到现有的核心实现（无重复代码）。
-
-## 迁移计划（分阶段，安全）
-
-### 阶段 0：基础搭建
-
-- 引入 `symi/plugin-sdk`。
-- 在 `SymiPluginApi` 中添加带有上述接口的 `api.runtime`。
-- 在过渡期内保留现有导入方式（添加弃用警告）。
-
-### 阶段 1：桥接清理（低风险）
-
-- 用 `api.runtime` 替换每个扩展中的 `core-bridge.ts`。
-- 优先迁移 BlueBubbles、Zalo、Zalo Personal（已经接近完成）。
-- 移除重复的桥接代码。
-
-### 阶段 2：轻度直接导入的插件
-
-- 将 Matrix 迁移到 SDK + 运行时。
-- 验证新手引导、目录、群组提及逻辑。
-
-### 阶段 3：重度直接导入的插件
-
-- 迁移 Microsoft Teams（使用运行时辅助函数最多的插件）。
-- 确保回复/正在输入的语义与当前行为一致。
-
-### 阶段 4：iMessage 插件化
-
-- 将 iMessage 移入 `extensions/imessage`。
-- 用 `api.runtime` 替换直接的核心调用。
-- 保持配置键、CLI 行为和文档不变。
-
-### 阶段 5：强制执行
-
-- 添加 lint 规则 / CI 检查：禁止 `extensions/**` 从 `src/**` 导入。
-- 添加插件 SDK/版本兼容性检查（运行时 + SDK 语义化版本）。
-
-## 兼容性与版本控制
-
-- SDK：语义化版本控制，已发布，变更有文档记录。
-- 运行时：按核心版本进行版本控制。添加 `api.runtime.version`。
-- 插件声明所需的运行时版本范围（例如 `symiRuntime: ">=2026.2.0"`）。
-
-## 测试策略
-
-- 适配器级单元测试（使用真实核心实现验证运行时函数）。
-- 每个插件的黄金测试：确保行为无偏差（路由、配对、允许列表、提及过滤）。
-- CI 中使用单个端到端插件示例（安装 + 运行 + 冒烟测试）。
-
-## 待解决问题
-
-- SDK 类型托管在哪里：独立包还是核心导出？
-- 运行时类型分发：在 SDK 中（仅类型）还是在核心中？
-- 如何为内置插件与外部插件暴露文档链接？
-- 过渡期间是否允许仓库内插件有限地直接导入核心模块？
-
-## 成功标准
-
-- 所有渠道连接器都是使用 SDK + 运行时的插件。
-- `extensions/**` 不再从 `src/**` 导入。
-- 新连接器模板仅依赖 SDK + 运行时。
-- 外部插件可以在无需访问核心源码的情况下进行开发和更新。
-
-相关文档：[插件](/tools/plugin)、[渠道](/channels/index)、[配置](/gateway/configuration)。