iMessage 媒体和附件

• 入站附件摄取默认为 off — 设置 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（优先按段落拆分）
• 出站标记 bold/italic/underline/strikethrough 转换为本机样式文本（macOS 15+ 收件人呈现样式；较早的收件人看到没有标记的纯文本）；降价表按通道降价表模式进行转换
• channels.imessage.sendTransport（默认 auto，可选 bridge、applescript）用于选择 imsg 的发送投递方式

推荐的显式目标：

• chat_id:123（推荐用于稳定路由）
• chat_guid:...
• chat_identifier:...

还支持直接句柄：

• +1555...
• tel:+1555...
• imessage:+1555...
• sms:+1555...
• [email protected]

使用联系人姓名或混合字母数字别名的服务限定目标：

• auto:<contact> 让消息选择 iMessage 或 SMS
• imessage:<contact> 需要 iMessage
• sms:<contact> 需要 SMS

纯联系人姓名和混合字母数字别名将被拒绝，而不是转换为电话号码。如果现有自动化使用其中之一，请添加 auto:、imessage: 或 sms: 以使预期的交付服务明确。

imsg chats --limit 20