@symerian/symi 3.0.21 → 3.0.22

package/docs/zh-CN/channels/groups.md

@@ -1,369 +0,0 @@
----
-read_when:
-  - 更改群聊行为或提及限制
-title: 群组
-x-i18n:
-  generated_at: "2026-02-03T07:47:08Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: b727a053edf51f6e7b5c0c324c2fc9c9789a9796c37f622418bd555e8b5a0ec4
-  source_path: channels/groups.md
-  workflow: 15
----
-
-# 群组
-
-## 新手入门（2 分钟）
-
-Symi"运行"在你自己的消息账户上。没有单独的 WhatsApp 机器人用户。如果**你**在一个群组中，Symi 就可以看到该群组并在其中回复。
-
-默认行为：
-
-- 群组受限（`groupPolicy: "allowlist"`）。
-- 除非你明确禁用提及限制，否则回复需要 @ 提及。
-
-解释：允许列表中的发送者可以通过提及来触发 Symi。
-
-> 简而言之
->
-> - **私信访问**由 `*.allowFrom` 控制。
-> - **群组访问**由 `*.groupPolicy` + 允许列表（`*.groups`、`*.groupAllowFrom`）控制。
-> - **回复触发**由提及限制（`requireMention`、`/activation`）控制。
-
-快速流程（群消息会发生什么）：
-
-```
-groupPolicy? disabled -> 丢弃
-groupPolicy? allowlist -> 群组允许? 否 -> 丢弃
-requireMention? 是 -> 被提及? 否 -> 仅存储为上下文
-否则 -> 回复
-```
-
-![群消息流程](/images/groups-flow.svg)
-
-如果你想...
-| 目标 | 设置什么 |
-|------|-------------|
-| 允许所有群组但仅在 @ 提及时回复 | `groups: { "*": { requireMention: true } }` |
-| 禁用所有群组回复 | `groupPolicy: "disabled"` |
-| 仅特定群组 | `groups: { "<group-id>": { ... } }`（无 `"*"` 键） |
-| 仅你可以在群组中触发 | `groupPolicy: "allowlist"`、`groupAllowFrom: ["+1555..."]` |
-
-## 会话键
-
-- 群组会话使用 `agent:<agentId>:<channel>:group:<id>` 会话键（房间/频道使用 `agent:<agentId>:<channel>:channel:<id>`）。
-- Telegram 论坛话题在群组 ID 后添加 `:topic:<threadId>`，因此每个话题都有自己的会话。
-- 私聊使用主会话（或按发送者配置时使用各自的会话）。
-- 群组会话跳过心跳。
-
-## 模式：个人私信 + 公开群组（单智能体）
-
-是的——如果你的"个人"流量是**私信**而"公开"流量是**群组**，这种方式效果很好。
-
-原因：在单智能体模式下，私信通常落在**主**会话键（`agent:main:main`）中，而群组始终使用**非主**会话键（`agent:main:<channel>:group:<id>`）。如果你启用 `mode: "non-main"` 的沙箱隔离，这些群组会话在 Docker 中运行，而你的主私信会话保持在主机上。
-
-这给你一个智能体"大脑"（共享工作区 + 记忆），但两种执行姿态：
-
-- **私信**：完整工具（主机）
-- **群组**：沙箱 + 受限工具（Docker）
-
-> 如果你需要真正独立的工作区/角色（"个人"和"公开"绝不能混合），请使用第二个智能体 + 绑定。参见[多智能体路由](/concepts/multi-agent)。
-
-示例（私信在主机上，群组沙箱隔离 + 仅消息工具）：
-
-```json5
-{
-  agents: {
-    defaults: {
-      sandbox: {
-        mode: "non-main", // 群组/频道是非主 -> 沙箱隔离
-        scope: "session", // 最强隔离（每个群组/频道一个容器）
-        workspaceAccess: "none",
-      },
-    },
-  },
-  tools: {
-    sandbox: {
-      tools: {
-        // 如果 allow 非空，其他所有工具都被阻止（deny 仍然优先）。
-        allow: ["group:messaging", "group:sessions"],
-        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],
-      },
-    },
-  },
-}
-```
-
-想要"群组只能看到文件夹 X"而不是"无主机访问"？保持 `workspaceAccess: "none"` 并仅将允许的路径挂载到沙箱中：
-
-```json5
-{
-  agents: {
-    defaults: {
-      sandbox: {
-        mode: "non-main",
-        scope: "session",
-        workspaceAccess: "none",
-        docker: {
-          binds: [
-            // hostPath:containerPath:mode
-            "~/FriendsShared:/data:ro",
-          ],
-        },
-      },
-    },
-  },
-}
-```
-
-相关：
-
-- 配置键和默认值：[Gateway 网关配置](/gateway/configuration#agentsdefaultssandbox)
-- 调试为什么工具被阻止：[沙箱 vs 工具策略 vs 提权](/gateway/sandbox-vs-tool-policy-vs-elevated)
-- 绑定挂载详情：[沙箱隔离](/gateway/sandboxing#custom-bind-mounts)
-
-## 显示标签
-
-- UI 标签在可用时使用 `displayName`，格式为 `<channel>:<token>`。
-- `#room` 保留用于房间/频道；群聊使用 `g-<slug>`（小写，空格 -> `-`，保留 `#@+._-`）。
-
-## 群组策略
-
-控制每个渠道如何处理群组/房间消息：
-
-```json5
-{
-  channels: {
-    whatsapp: {
-      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
-      groupAllowFrom: ["+15551234567"],
-    },
-    telegram: {
-      groupPolicy: "disabled",
-      groupAllowFrom: ["123456789", "@username"],
-    },
-    signal: {
-      groupPolicy: "disabled",
-      groupAllowFrom: ["+15551234567"],
-    },
-    imessage: {
-      groupPolicy: "disabled",
-      groupAllowFrom: ["chat_id:123"],
-    },
-    msteams: {
-      groupPolicy: "disabled",
-      groupAllowFrom: ["user@org.com"],
-    },
-      groupPolicy: "allowlist",
-      guilds: {
-        GUILD_ID: { channels: { help: { allow: true } } },
-      },
-    },
-    slack: {
-      groupPolicy: "allowlist",
-      channels: { "#general": { allow: true } },
-    },
-    matrix: {
-      groupPolicy: "allowlist",
-      groupAllowFrom: ["@owner:example.org"],
-      groups: {
-        "!roomId:example.org": { allow: true },
-        "#alias:example.org": { allow: true },
-      },
-    },
-  },
-}
-```
-
-| 策略          | 行为                                    |
-| ------------- | --------------------------------------- |
-| `"open"`      | 群组绕过允许列表；提及限制仍然适用。    |
-| `"disabled"`  | 完全阻止所有群组消息。                  |
-| `"allowlist"` | 仅允许与配置的允许列表匹配的群组/房间。 |
-
-注意事项：
-
-- `groupPolicy` 与提及限制（需要 @ 提及）是分开的。
-- WhatsApp/Telegram/Signal/iMessage/Microsoft Teams：使用 `groupAllowFrom`（回退：显式 `allowFrom`）。
-- Slack：允许列表使用 `channels.slack.channels`。
-- Matrix：允许列表使用 `channels.matrix.groups`（房间 ID、别名或名称）。使用 `channels.matrix.groupAllowFrom` 限制发送者；也支持每个房间的 `users` 允许列表。
-- Telegram 允许列表可以匹配用户 ID（`"123456789"`、`"telegram:123456789"`、`"tg:123456789"`）或用户名（`"@alice"` 或 `"alice"`）；前缀不区分大小写。
-- 默认为 `groupPolicy: "allowlist"`；如果你的群组允许列表为空，群组消息将被阻止。
-
-快速心智模型（群组消息的评估顺序）：
-
-1. `groupPolicy`（open/disabled/allowlist）
-2. 群组允许列表（`*.groups`、`*.groupAllowFrom`、渠道特定允许列表）
-3. 提及限制（`requireMention`、`/activation`）
-
-## 提及限制（默认）
-
-群组消息需要提及，除非按群组覆盖。默认值位于 `*.groups."*"` 下的每个子系统中。
-
-```json5
-{
-  channels: {
-    whatsapp: {
-      groups: {
-        "*": { requireMention: true },
-        "123@g.us": { requireMention: false },
-      },
-    },
-    telegram: {
-      groups: {
-        "*": { requireMention: true },
-        "123456789": { requireMention: false },
-      },
-    },
-    imessage: {
-      groups: {
-        "*": { requireMention: true },
-        "123": { requireMention: false },
-      },
-    },
-  },
-  agents: {
-    list: [
-      {
-        id: "main",
-        groupChat: {
-          mentionPatterns: ["@symi", "symi", "\\+15555550123"],
-          historyLimit: 50,
-        },
-      },
-    ],
-  },
-}
-```
-
-注意事项：
-
-- `mentionPatterns` 是不区分大小写的正则表达式。
-- 提供显式提及的平台仍然通过；模式是回退。
-- 每个智能体覆盖：`agents.list[].groupChat.mentionPatterns`（当多个智能体共享一个群组时有用）。
-- 提及限制仅在提及检测可行时强制执行（原生提及或 `mentionPatterns` 已配置）。
-- 群组历史上下文在渠道间统一包装，并且是**仅待处理**（由于提及限制而跳过的消息）；使用 `messages.groupChat.historyLimit` 作为全局默认值，使用 `channels.<channel>.historyLimit`（或 `channels.<channel>.accounts.*.historyLimit`）进行覆盖。设置 `0` 以禁用。
-
-## 群组/频道工具限制（可选）
-
-某些渠道配置支持限制**特定群组/房间/频道内**可用的工具。
-
-- `tools`：为整个群组允许/拒绝工具。
-- `toolsBySender`：群组内的按发送者覆盖（键是发送者 ID/用户名/邮箱/电话号码，取决于渠道）。使用 `"*"` 作为通配符。
-
-解析顺序（最具体的优先）：
-
-1. 群组/频道 `toolsBySender` 匹配
-2. 群组/频道 `tools`
-3. 默认（`"*"`）`toolsBySender` 匹配
-4. 默认（`"*"`）`tools`
-
-示例（Telegram）：
-
-```json5
-{
-  channels: {
-    telegram: {
-      groups: {
-        "*": { tools: { deny: ["exec"] } },
-        "-1001234567890": {
-          tools: { deny: ["exec", "read", "write"] },
-          toolsBySender: {
-            "123456789": { alsoAllow: ["exec"] },
-          },
-        },
-      },
-    },
-  },
-}
-```
-
-注意事项：
-
-- 群组/频道工具限制在全局/智能体工具策略之外额外应用（deny 仍然优先）。
-
-## 群组允许列表
-
-当配置了 `channels.whatsapp.groups`、`channels.telegram.groups` 或 `channels.imessage.groups` 时，键作为群组允许列表。使用 `"*"` 允许所有群组，同时仍设置默认提及行为。
-
-常见意图（复制/粘贴）：
-
-1. 禁用所有群组回复
-
-```json5
-{
-  channels: { whatsapp: { groupPolicy: "disabled" } },
-}
-```
-
-2. 仅允许特定群组（WhatsApp）
-
-```json5
-{
-  channels: {
-    whatsapp: {
-      groups: {
-        "123@g.us": { requireMention: true },
-        "456@g.us": { requireMention: false },
-      },
-    },
-  },
-}
-```
-
-3. 允许所有群组但需要提及（显式）
-
-```json5
-{
-  channels: {
-    whatsapp: {
-      groups: { "*": { requireMention: true } },
-    },
-  },
-}
-```
-
-4. 仅所有者可以在群组中触发（WhatsApp）
-
-```json5
-{
-  channels: {
-    whatsapp: {
-      groupPolicy: "allowlist",
-      groupAllowFrom: ["+15551234567"],
-      groups: { "*": { requireMention: true } },
-    },
-  },
-}
-```
-
-## 激活（仅所有者）
-
-群组所有者可以切换每个群组的激活状态：
-
-- `/activation mention`
-- `/activation always`
-
-所有者由 `channels.whatsapp.allowFrom` 确定（未设置时为机器人自身的 E.164）。将命令作为独立消息发送。其他平台目前忽略 `/activation`。
-
-## 上下文字段
-
-群组入站负载设置：
-
-- `ChatType=group`
-- `GroupSubject`（如果已知）
-- `GroupMembers`（如果已知）
-- `WasMentioned`（提及限制结果）
-- Telegram 论坛话题还包括 `MessageThreadId` 和 `IsForum`。
-
-智能体系统提示在新群组会话的第一轮包含群组介绍。它提醒模型像人类一样回复，避免 Markdown 表格，避免输入字面量 `\n` 序列。
-
-## iMessage 特定内容
-
-- 路由或允许列表时优先使用 `chat_id:<id>`。
-- 列出聊天：`imsg chats --limit 20`。
-- 群组回复始终返回到相同的 `chat_id`。
-
-## WhatsApp 特定内容
-
-参见[群消息](/channels/group-messages)了解 WhatsApp 专有行为（历史注入、提及处理详情）。

package/docs/zh-CN/channels/imessage.md

@@ -1,300 +0,0 @@
----
-read_when:
-  - 设置 iMessage 支持
-  - 调试 iMessage 发送/接收
-summary: 通过 imsg（基于 stdio 的 JSON-RPC）实现 iMessage 支持、设置及 chat_id 路由
-title: iMessage
-x-i18n:
-  generated_at: "2026-02-03T07:44:18Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: bc19756a42ead80a0845f18c4830c3f1f40948f69b2b016a4026598cfb8fef0d
-  source_path: channels/imessage.md
-  workflow: 15
----
-
-# iMessage (imsg)
-
-状态：外部 CLI 集成。Gateway 网关生成 `imsg rpc`（基于 stdio 的 JSON-RPC）。
-
-## 快速设置（新手）
-
-1. 确保在此 Mac 上已登录"信息"。
-2. 安装 `imsg`：
-   - `brew install steipete/tap/imsg`
-3. 配置 Symi 的 `channels.imessage.cliPath` 和 `channels.imessage.dbPath`。
-4. 启动 Gateway 网关并批准所有 macOS 提示（自动化 + 完全磁盘访问权限）。
-
-最小配置：
-
-```json5
-{
-  channels: {
-    imessage: {
-      enabled: true,
-      cliPath: "/usr/local/bin/imsg",
-      dbPath: "/Users/<you>/Library/Messages/chat.db",
-    },
-  },
-}
-```
-
-## 简介
-
-- 基于 macOS 上 `imsg` 的 iMessage 渠道。
-- 确定性路由：回复始终返回到 iMessage。
-- 私信共享智能体的主会话；群组是隔离的（`agent:<agentId>:imessage:group:<chat_id>`）。
-- 如果多参与者会话以 `is_group=false` 到达，你仍可使用 `channels.imessage.groups` 按 `chat_id` 隔离（参见下方"类群组会话"）。
-
-## 配置写入
-
-默认情况下，iMessage 允许写入由 `/config set|unset` 触发的配置更新（需要 `commands.config: true`）。
-
-禁用方式：
-
-```json5
-{
-  channels: { imessage: { configWrites: false } },
-}
-```
-
-## 要求
-
-- 已登录"信息"的 macOS。
-- Symi + `imsg` 的完全磁盘访问权限（访问"信息"数据库）。
-- 发送时需要自动化权限。
-- `channels.imessage.cliPath` 可以指向任何代理 stdin/stdout 的命令（例如，通过 SSH 连接到另一台 Mac 并运行 `imsg rpc` 的包装脚本）。
-
-## 设置（快速路径）
-
-1. 确保在此 Mac 上已登录"信息"。
-2. 配置 iMessage 并启动 Gateway 网关。
-
-### 专用机器人 macOS 用户（用于隔离身份）
-
-如果你希望机器人从**独立的 iMessage 身份**发送（并保持你的个人"信息"整洁），请使用专用 Apple ID + 专用 macOS 用户。
-
-1. 创建专用 Apple ID（例如：`my-cool-bot@icloud.com`）。
-   - Apple 可能需要电话号码进行验证 / 2FA。
-2. 创建 macOS 用户（例如：`symihome`）并登录。
-3. 在该 macOS 用户中打开"信息"并使用机器人 Apple ID 登录 iMessage。
-4. 启用远程登录（系统设置 → 通用 → 共享 → 远程登录）。
-5. 安装 `imsg`：
-   - `brew install steipete/tap/imsg`
-6. 设置 SSH 使 `ssh <bot-macos-user>@localhost true` 无需密码即可工作。
-7. 将 `channels.imessage.accounts.bot.cliPath` 指向以机器人用户身份运行 `imsg` 的 SSH 包装脚本。
-
-首次运行注意事项：发送/接收可能需要在*机器人 macOS 用户*中进行 GUI 批准（自动化 + 完全磁盘访问权限）。如果 `imsg rpc` 看起来卡住或退出，请登录该用户（屏幕共享很有帮助），运行一次 `imsg chats --limit 1` / `imsg send ...`，批准提示，然后重试。
-
-示例包装脚本（`chmod +x`）。将 `<bot-macos-user>` 替换为你的实际 macOS 用户名：
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-
-# Run an interactive SSH once first to accept host keys:
-#   ssh <bot-macos-user>@localhost true
-exec /usr/bin/ssh -o BatchMode=yes -o ConnectTimeout=5 -T <bot-macos-user>@localhost \
-  "/usr/local/bin/imsg" "$@"
-```
-
-示例配置：
-
-```json5
-{
-  channels: {
-    imessage: {
-      enabled: true,
-      accounts: {
-        bot: {
-          name: "Bot",
-          enabled: true,
-          cliPath: "/path/to/imsg-bot",
-          dbPath: "/Users/<bot-macos-user>/Library/Messages/chat.db",
-        },
-      },
-    },
-  },
-}
-```
-
-对于单账户设置，使用扁平选项（`channels.imessage.cliPath`、`channels.imessage.dbPath`）而不是 `accounts` 映射。
-
-### 远程/SSH 变体（可选）
-
-如果你想在另一台 Mac 上使用 iMessage，请将 `channels.imessage.cliPath` 设置为通过 SSH 在远程 macOS 主机上运行 `imsg` 的包装脚本。Symi 只需要 stdio。
-
-示例包装脚本：
-
-```bash
-#!/usr/bin/env bash
-exec ssh -T gateway-host imsg "$@"
-```
-
-**远程附件：** 当 `cliPath` 通过 SSH 指向远程主机时，"信息"数据库中的附件路径引用的是远程机器上的文件。Symi 可以通过设置 `channels.imessage.remoteHost` 自动通过 SCP 获取这些文件：
-
-```json5
-{
-  channels: {
-    imessage: {
-      cliPath: "~/imsg-ssh", // SSH wrapper to remote Mac
-      remoteHost: "user@gateway-host", // for SCP file transfer
-      includeAttachments: true,
-    },
-  },
-}
-```
-
-如果未设置 `remoteHost`，Symi 会尝试通过解析包装脚本中的 SSH 命令自动检测。建议显式配置以提高可靠性。
-
-#### 通过 Tailscale 连接远程 Mac（示例）
-
-如果 Gateway 网关运行在 Linux 主机/虚拟机上但 iMessage 必须运行在 Mac 上，Tailscale 是最简单的桥接方式：Gateway 网关通过 tailnet 与 Mac 通信，通过 SSH 运行 `imsg`，并通过 SCP 获取附件。
-
-架构：
-
-```
-┌──────────────────────────────┐          SSH (imsg rpc)          ┌──────────────────────────┐
-│ Gateway host (Linux/VM)      │──────────────────────────────────▶│ Mac with Messages + imsg │
-│ - symi gateway           │          SCP (attachments)        │ - Messages signed in     │
-│ - channels.imessage.cliPath  │◀──────────────────────────────────│ - Remote Login enabled   │
-└──────────────────────────────┘                                   └──────────────────────────┘
-              ▲
-              │ Tailscale tailnet (hostname or 100.x.y.z)
-              ▼
-        user@gateway-host
-```
-
-具体配置示例（Tailscale 主机名）：
-
-```json5
-{
-  channels: {
-    imessage: {
-      enabled: true,
-      cliPath: "~/.symi/scripts/imsg-ssh",
-      remoteHost: "bot@mac-mini.tailnet-1234.ts.net",
-      includeAttachments: true,
-      dbPath: "/Users/bot/Library/Messages/chat.db",
-    },
-  },
-}
-```
-
-示例包装脚本（`~/.symi/scripts/imsg-ssh`）：
-
-```bash
-#!/usr/bin/env bash
-exec ssh -T bot@mac-mini.tailnet-1234.ts.net imsg "$@"
-```
-
-注意事项：
-
-- 确保 Mac 已登录"信息"，并已启用远程登录。
-- 使用 SSH 密钥使 `ssh bot@mac-mini.tailnet-1234.ts.net` 无需提示即可工作。
-- `remoteHost` 应与 SSH 目标匹配，以便 SCP 可以获取附件。
-
-## 访问控制（私信 + 群组）
-
-私信：
-
-- 默认：`channels.imessage.dmPolicy = "pairing"`。
-- 未知发送者会收到配对码；消息在批准前会被忽略（配对码在 1 小时后过期）。
-- 批准方式：
-  - `symi pairing list imessage`
-  - `symi pairing approve imessage <CODE>`
-- 配对是 iMessage 私信的默认令牌交换方式。详情：[配对](/channels/pairing)
-
-群组：
-
-- `channels.imessage.groupPolicy = open | allowlist | disabled`。
-- 设置 `allowlist` 时，`channels.imessage.groupAllowFrom` 控制谁可以在群组中触发。
-- 提及检测使用 `agents.list[].groupChat.mentionPatterns`（或 `messages.groupChat.mentionPatterns`），因为 iMessage 没有原生提及元数据。
-- 多智能体覆盖：在 `agents.list[].groupChat.mentionPatterns` 上设置每个智能体的模式。
-
-## 工作原理（行为）
-
-- `imsg` 流式传输消息事件；Gateway 网关将它们规范化为共享渠道信封。
-- 回复始终路由回相同的 chat id 或 handle。
-
-## 类群组会话（`is_group=false`）
-
-某些 iMessage 会话可能有多个参与者，但根据"信息"存储聊天标识符的方式，仍以 `is_group=false` 到达。
-
-如果你在 `channels.imessage.groups` 下显式配置了 `chat_id`，Symi 会将该会话视为"群组"用于：
-
-- 会话隔离（独立的 `agent:<agentId>:imessage:group:<chat_id>` 会话键）
-- 群组允许列表 / 提及检测行为
-
-示例：
-
-```json5
-{
-  channels: {
-    imessage: {
-      groupPolicy: "allowlist",
-      groupAllowFrom: ["+15555550123"],
-      groups: {
-        "42": { requireMention: false },
-      },
-    },
-  },
-}
-```
-
-当你想为特定会话使用隔离的个性/模型时这很有用（参见[多智能体路由](/concepts/multi-agent)）。关于文件系统隔离，参见[沙箱隔离](/gateway/sandboxing)。
-
-## 媒体 + 限制
-
-- 通过 `channels.imessage.includeAttachments` 可选附件摄取。
-- 通过 `channels.imessage.mediaMaxMb` 设置媒体上限。
-
-## 限制
-
-- 出站文本按 `channels.imessage.textChunkLimit` 分块（默认 4000）。
-- 可选换行分块：设置 `channels.imessage.chunkMode="newline"` 在长度分块前按空行（段落边界）分割。
-- 媒体上传受 `channels.imessage.mediaMaxMb` 限制（默认 16）。
-
-## 寻址 / 投递目标
-
-优先使用 `chat_id` 进行稳定路由：
-
-- `chat_id:123`（推荐）
-- `chat_guid:...`
-- `chat_identifier:...`
-- 直接 handle：`imessage:+1555` / `sms:+1555` / `user@example.com`
-
-列出聊天：
-
-```
-imsg chats --limit 20
-```
-
-## 配置参考（iMessage）
-
-完整配置：[配置](/gateway/configuration)
-
-提供商选项：
-
-- `channels.imessage.enabled`：启用/禁用渠道启动。
-- `channels.imessage.cliPath`：`imsg` 路径。
-- `channels.imessage.dbPath`："信息"数据库路径。
-- `channels.imessage.remoteHost`：当 `cliPath` 指向远程 Mac 时用于 SCP 附件传输的 SSH 主机（例如 `user@gateway-host`）。如未设置则从 SSH 包装脚本自动检测。
-- `channels.imessage.service`：`imessage | sms | auto`。
-- `channels.imessage.region`：短信区域。
-- `channels.imessage.dmPolicy`：`pairing | allowlist | open | disabled`（默认：pairing）。
-- `channels.imessage.allowFrom`：私信允许列表（handle、邮箱、E.164 号码或 `chat_id:*`）。`open` 需要 `"*"`。iMessage 没有用户名；使用 handle 或聊天目标。
-- `channels.imessage.groupPolicy`：`open | allowlist | disabled`（默认：allowlist）。
-- `channels.imessage.groupAllowFrom`：群组发送者允许列表。
-- `channels.imessage.historyLimit` / `channels.imessage.accounts.*.historyLimit`：作为上下文包含的最大群组消息数（0 禁用）。
-- `channels.imessage.dmHistoryLimit`：私信历史限制（用户轮次）。每用户覆盖：`channels.imessage.dms["<handle>"].historyLimit`。
-- `channels.imessage.groups`：每群组默认值 + 允许列表（使用 `"*"` 作为全局默认值）。
-- `channels.imessage.includeAttachments`：将附件摄取到上下文。
-- `channels.imessage.mediaMaxMb`：入站/出站媒体上限（MB）。
-- `channels.imessage.textChunkLimit`：出站分块大小（字符）。
-- `channels.imessage.chunkMode`：`length`（默认）或 `newline` 在长度分块前按空行（段落边界）分割。
-
-相关全局选项：
-
-- `agents.list[].groupChat.mentionPatterns`（或 `messages.groupChat.mentionPatterns`）。
-- `messages.responsePrefix`。