imsg¶

Skill 简介¶

imsg 是一个基于 macOS 平台的命令行工具，用于与苹果的 Messages.app 进行交互，实现 iMessage 和 SMS 的发送、接收以及聊天记录的查看等功能。该工具通过命令行接口（CLI）为开发者提供了一种便捷的方式，以编程方式管理和自动化消息相关的操作。通过 imsg，用户可以轻松地列出最近的聊天记录、查看特定对话的历史消息、发送文本和附件消息等。

这个 Skill 的核心价值在于，它填补了 macOS 上缺乏成熟命令行消息管理工具的空白。对于开发者而言，imsg 提供了一个强大的工具，可以将消息功能集成到各种自动化脚本和工作流中。例如，开发者可以编写脚本自动向特定联系人发送提醒消息，或者在服务器日志中出现特定事件时通知相关人员。

主要功能¶

imsg 提供了多个核心功能，涵盖了消息管理的各个方面：

1. 列出聊天记录
   imsg 可以列出用户最近的聊天记录，并支持按时间顺序或按联系人名称进行排序。例如，使用以下命令可以获取最新的 10 条聊天记录，并以 JSON 格式输出：
   bash imsg chats --limit 10 --json
   这种功能对于需要快速浏览对话历史或进行数据分析的场景非常有用。

2. 查看聊天历史
   通过指定聊天 ID，用户可以查看特定对话的详细历史记录。例如：
   bash imsg history --chat-id 1 --limit 20 --json
   如果需要包含附件信息，可以使用 --attachments 参数：
   bash imsg history --chat-id 1 --limit 20 --attachments --json
   这对于需要分析特定对话内容或进行聊天记录存档的场景非常实用。

3. 发送消息
   imsg 支持发送文本消息和包含附件的消息。用户可以指定消息的接收者（电话号码或 Apple ID）以及消息内容。例如，发送纯文本消息：
   bash imsg send --to "+14155551212" --text "Hello!"
   或者发送包含附件的消息：
   bash imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg
   此外，用户还可以通过 --service 参数强制使用 iMessage 或 SMS。

4. 监控新消息
   imsg 提供了监控新消息的功能，可以实时监听特定聊天中的新消息。例如：
   bash imsg watch --chat-id 1 --attachments
   这种功能对于需要实时响应消息的应用场景非常有用，例如即时通知系统或自动化响应系统。

5. 服务选项
   imsg 允许用户指定消息的发送方式，包括强制使用 iMessage（--service imessage）、SMS（--service sms）或让 Messages.app 自动选择（--service auto，默认）。例如：
   bash imsg send --to "+14155551212" --text "Hi" --service imessage

使用场景¶

imsg 适用于多种开发场景，以下是一些典型的应用案例：

1. 自动化消息发送
   开发者可以编写脚本，根据特定条件自动向用户发送提醒或通知消息。例如，在服务器出现异常时自动发送警报。

2. 聊天记录分析
   通过 imsg 提供的聊天历史接口，开发者可以编写脚本对聊天记录进行数据分析，提取有用的信息或生成统计报告。

3. 实时消息监控
   对于需要实时监控特定对话的应用，imsg 的监控功能可以派上用场。例如，开发一个即时通知系统，当特定联系人发送消息时触发某些操作。

4. 集成到工作流中
   imsg 可以作为工作流的一部分，与其他工具和系统集成。例如，将消息功能集成到项目管理工具中，实现自动化的任务分配和状态更新。

5. 测试和调试
   在开发和测试阶段，imsg 可以用于模拟消息发送和接收，验证消息功能的正确性和稳定性。

如何使用¶

安装¶

imsg 可以通过 Homebrew 安装。确保你已经安装了 Homebrew，然后运行以下命令：

brew install steipete/tap/imsg

配置¶

1. macOS 上的 Messages.app 已登录
   确保你已经在 Messages.app 上登录了 iMessage 或 SMS 账户。

2. 授予终端完全磁盘访问权限
   为了让 imsg 能够访问消息数据，需要在“系统偏好设置” -> “安全性与隐私” -> “隐私” -> “完全磁盘访问”中授予终端应用程序访问权限。

3. 授予 Messages.app 自动化权限
   在“系统偏好设置” -> “安全性与隐私” -> “隐私” -> “辅助功能”中，授予终端应用程序控制 Messages.app 的权限。

前置条件¶

• macOS 操作系统
• 已安装 Homebrew
• 已登录 Messages.app
• 授予必要的权限

示例¶

示例 1：发送消息¶

假设你想向手机号码 +14155551212 发送一条消息“Hello!”，可以使用以下命令：

imsg send --to "+14155551212" --text "Hello!"

如果需要发送带有附件的消息，例如一张图片，可以使用：

imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg

示例 2：查看聊天历史¶

要查看特定聊天的历史记录，例如聊天 ID 为 1，并限制显示 20 条消息，可以使用：

imsg history --chat-id 1 --limit 20 --json

如果需要包含附件信息，可以添加 --attachments 参数：

imsg history --chat-id 1 --limit 20 --attachments --json

总结¶

imsg 是一个功能强大的命令行工具，专为 macOS 平台设计，旨在简化与 Messages.app 的交互。它为开发者提供了一种灵活的方式来管理和自动化消息相关的操作，适用于自动化消息发送、聊天记录分析、实时消息监控等多种场景。通过 imsg，开发者可以轻松地将消息功能集成到各种应用和工作流中，提高工作效率。

对于需要在命令行环境下处理 iMessage 和 SMS 的开发者，imsg 是一个不可或缺的工具。它不仅简化了消息管理的复杂性，还为开发者提供了丰富的接口和选项，以满足不同的需求。无论是发送消息、查看历史记录，还是监控新消息，imsg 都能提供可靠的支持。