imsg

📨 macOS消息终端全能管家

由PSPDFKit创始人steipete开发的开源macOS工具,通过CLI实现iMessage/SMS的读取、历史查询与发送,需Full Disk Access和Automation权限。

收藏
1.8k
安装
717
版本
v1.0.0
CLS 安全性认证2026-05-11
点击查看完整报告 >

使用说明

核心用法

imsg是一款专为macOS设计的命令行工具,通过封装Messages.app的能力,让用户能够在终端中直接操作iMessage和SMS消息。其核心功能包括四大模块:聊天列表查询(imsg chats)、历史记录读取(imsg history)、实时消息监听(imsg watch)以及消息发送(imsg send)。所有命令均支持--json格式输出,便于开发者进行程序化数据处理。工具通过--service参数灵活控制消息投递渠道(iMessage/SMS/自动选择),并支持附件处理与批量限制,满足从日常查询到自动化脚本的多场景需求。

显著优点

权威开发者背书:由PSPDFKit创始人Peter Steinberger(steipete)维护,T2级可信来源保障代码质量与长期维护。原生系统集成:直接调用macOS Messages.app,无需第三方服务器中转,数据完全本地处理。功能边界清晰:开源CLI工具配合详尽的权限说明,用户可精确控制数据访问范围。开发友好设计:JSON输出格式、参数默认值、完善的错误提示,大幅降低自动化集成门槛。权限机制透明:Full Disk Access和Automation权限需求与功能完全匹配,macOS系统级管控确保用户主导权。

潜在缺点与局限性

平台强绑定:仅支持macOS系统,且要求Messages.app已登录,Windows/Linux用户无法使用。权限门槛较高:首次使用需手动配置两项系统级权限,对普通用户有一定操作成本。功能依赖外部:核心能力由独立的imsg二进制文件提供,需通过Homebrew额外安装维护。无跨设备同步:消息操作仅限于当前Mac设备,无法直接管理iPhone上的消息记录。运营商费用风险:SMS发送可能产生运营商资费,且工具本身无发送频率限制或二次确认机制。

适合的目标群体

macOS开发者:需要自动化测试消息功能、集成消息处理到CI/CD流程的工程师。效率工具爱好者:希望通过Alfred、Raycast等工具快速查询聊天记录的高级用户。数据归档需求者:需要定期备份iMessage历史、导出重要对话记录的个人用户。客服/运营人员:在Mac工作流中需要批量发送通知、管理客户沟通的轻量级场景。

使用风险

隐私数据暴露:工具可读取全部iMessage/SMS内容,包含敏感个人信息,需确保运行环境安全。误发送风险:命令行发送缺乏图形界面的视觉确认,脚本中硬编码号码可能导致消息错发。权限持久化隐患:授予的Full Disk Access权限范围较广,长期保留可能扩大潜在攻击面。依赖维护成本:Homebrew包的更新节奏、macOS系统升级后的兼容性需持续关注。日志泄露可能--json输出若被重定向到日志文件,可能无意留存敏感对话内容。

安全解读

核心用法

imsg 是一款面向 macOS 的命令行工具,通过 SKILL.md 文档形式提供使用指南,让用户能够在终端直接操作 Messages.app 的 iMessage 和短信功能。

主要功能模块:

  • 会话列表imsg chats --limit 10 --json 列出最近聊天会话
  • 历史记录imsg history --chat-id 1 --limit 20 --attachments --json 导出指定聊天内容
  • 实时监控imsg watch --chat-id 1 --attachments 持续监听新消息
  • 消息发送imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg 发送文本或图片

服务类型控制--service imessage|sms|auto 可指定发送通道,自动模式由系统智能选择。

显著优点

1. 原生集成:直接调用 macOS Messages.app,无需额外服务器或中间件
2. JSON 输出:所有查询命令支持结构化输出,便于脚本集成和数据处理

3. 附件支持:图片、视频等多媒体文件可通过命令行直接发送

4. 实时监控watch 模式适合构建自动化工作流,如新消息触发通知

潜在缺点与局限性

  • 平台限制:仅支持 macOS,且要求 Messages.app 已登录 Apple ID
  • 权限门槛高:需授予终端「完全磁盘访问权限」和「自动化控制权限」,涉及系统安全敏感区域
  • 无官方背书:由社区开发者维护(steipete),非 Apple 官方工具
  • 误操作风险:命令行发送消息缺乏二次确认机制,可能因参数错误导致消息误发

适合人群

  • 开发者构建消息自动化脚本(如客服机器人、状态通知)
  • 系统管理员批量导出/备份聊天记录
  • 进阶用户偏好终端工作流,希望脱离 GUI 操作 Messages

常规风险

| 风险类型 | 说明 |
|---------|------|
| 权限滥用 | Full Disk Access 和 Automation 权限若被恶意利用,可能读取其他应用数据 |
| 隐私泄露 | 聊天记录导出包含完整通信内容,需妥善保管 JSON 输出文件 |
| 短信费用 | 误用 SMS 通道可能产生运营商资费 |
| 账号安全 | 频繁 API 调用可能触发 Apple 安全机制 |

安全等级 A:该 Skill 本身为纯文档类型,无可执行代码;但依赖的 imsg 二进制工具需审慎管理权限。

imsg 内容

手动下载zip · 929 B
SKILL.mdtext/markdown
请选择文件