媒体与附件

附件如何进出、出站文本如何分块，以及 iMessage 接受哪些投递目标。

媒体、分块与投递目标¶

附件与媒体

入站附件摄取默认关闭 — 设置 channels.imessage.includeAttachments: true 可将照片、语音备忘录、视频和其他附件转发给代理。禁用时，仅包含附件的 iMessage 会在到达代理前被丢弃，可能完全不会生成 Inbound message 日志行。
当设置 remoteHost 时，可通过 SCP 获取远程入站附件路径
出站文件会被暂存到已配置或自动检测到的 Messages Mac 上仅属主可访问的临时路径，通过该远程路径传递给 imsg，并在成功、失败或超时后尽力清理；清理失败会发出警告，并可能留下仅属主可访问的残留文件
附件路径必须匹配允许的根目录：
channels.imessage.attachmentRoots（本地）
channels.imessage.remoteAttachmentRoots（远程 SCP 模式）
已配置的根目录会扩展默认根目录模式 /Users/*/Library/Messages/Attachments（合并而非替换）
SCP 使用严格的主机密钥检查（StrictHostKeyChecking=yes）
出站媒体大小使用 channels.imessage.mediaMaxMb（默认 16 MB）

出站文本与分块

文本分块限制：channels.imessage.textChunkLimit（默认 4000）
分块模式：channels.imessage.streaming.chunkMode
length（默认）
newline（优先按段落拆分）
出站 Markdown 粗体/斜体/下划线/删除线会转换为原生样式文本（macOS 15 及更高版本的接收方会渲染样式；旧版本接收方会看到不带标记的纯文本）；Markdown 表格会按照通道的 Markdown 表格模式进行转换
channels.imessage.sendTransport（默认 auto，bridge，applescript）选择 imsg 如何投递发送

寻址格式

首选的显式目标：

也支持直接句柄：

对于联系人名称或混合字母数字别名，请使用带服务限定的目标：

未加前缀的联系人名称和混合字母数字别名会被拒绝，而不是被转换为电话号码。如果现有自动化使用了其中一种，请添加 auto:、imessage: 或 sms:，以明确预期的投递服务。

imsg chats --limit 20

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw