messages
在终端或AI工作流中模糊搜索和浏览iMessage/SMS消息
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：messages。 它的用途是：在终端或AI工作流中模糊搜索和浏览iMessage/SMS消息 完整的 Skill 内容见：https://321skill.com/skills/messages/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我找一下上周妈妈提到的晚餐安排'，它会自动调用 messages 技能，在你的 iMessage 历史中模糊搜索相关对话并返回结果。或者，你也可以直接使用斜杠命令，如输入 `/messages:search "项目会议" --from "同事姓名"` 来精确查找特定联系人的消息。
介绍
messages 是一个专为 macOS 设计的工具，它解决了用户难以在大量 iMessage/SMS 历史记录中快速定位特定信息的痛点。通过命令行、Claude Code 插件或 MCP 服务器等多种方式，它允许用户对本地 Apple Messages 数据库进行模糊搜索和浏览，支持联系人解析、上下文查看和日期过滤等功能。
用户可以通过 Homebrew、npm 或直接安装 Claude Code 插件来使用它。安装后，需要授予终端“完全磁盘访问权限”以读取消息数据库。作为插件使用时，Claude 能自动识别相关查询并调用技能，或通过丰富的斜杠命令进行手动搜索。
这个工具非常适合那些经常需要回溯短信内容、查找特定对话细节或管理个人通信记录的 macOS 用户。无论是开发者、项目经理还是普通用户，只要对消息历史有检索需求，都能从中受益。
使用建议是，首次使用前务必正确配置系统权限。作为插件使用时，体验最佳，因为 Claude 能自动触发搜索，无需手动输入命令。注意，由于其设计原理，它仅支持 macOS 系统，且需要 Node.js 22+ 环境。
核心特点
核心区别在于其深度集成 Apple Messages 原生数据库，提供带容错的模糊搜索能力，并能自动重建索引；同时，它提供了 CLI、MCP 服务器和 Claude Code 插件三种使用界面，其中插件模式支持技能自动调用，实现了最无缝的 AI 辅助消息检索体验。
注意事项
仅限 macOS 系统使用，且需要授予终端完全磁盘访问权限，无法用于搜索其他即时通讯软件（如微信、Telegram）的消息。
常见问题
为什么需要完全磁盘访问权限？
为了读取存储在 ~/Library/Messages/chat.db 的 Apple Messages 加密数据库。
支持搜索微信聊天记录吗？
不支持，本工具仅针对 Apple 原生的 iMessage/SMS 消息数据库。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/messages/raw/index.md 读取 messages 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/messages/raw/index.md（查看排版版本）