iMessage 与 Signal 分析器

分析 iMessage（macOS）和 Signal 对话，生成关系报告。

前置条件

macOS（iMessage）

iMessage 数据本地存储在 macOS 上。根据您的安全设置，您可能需要授予“完全磁盘访问”权限：

选项 1： 直接使用 Python 运行脚本（若您对 ~/Library/Messages/chat.db 具有读取权限，则无需特殊权限）

选项 2： 若出现权限错误，请授予“完全磁盘访问”权限：

• 打开 系统设置 → 隐私与安全性 → 完全磁盘访问
• 点击 +，添加 Python 或您使用的终端应用

Linux / Windows（仅 Signal）

• iMessage 在 Linux/Windows 上不可用
• Signal 分析通过导出的 JSON 文件进行

Signal（所有平台）

• 安装 signal-cli：brew install signal-cli（macOS），或参见 https://github.com/AsamK/signal-cli
• 绑定设备：signal-cli link，并扫描二维码
• 导出消息：signal-cli export --output ~/signal_export.json

使用方法

iMessage 分析

python3 skills/message-analyzer/scripts/analyze.py imessage 

示例：

python3 skills/message-analyzer/scripts/analyze.py imessage "+15551234567"
python3 skills/message-analyzer/scripts/analyze.py imessage "+15551234567" --limit 500

Signal 分析

首先，导出您的 Signal 数据（一次性操作）：

signal-cli export --output ~/signal_export.json

然后执行分析：

python3 skills/message-analyzer/scripts/analyze.py signal ~/signal_export.json 

示例：

python3 skills/message-analyzer/scripts/analyze.py signal ~/signal_export.json "+15551234567"
python3 skills/message-analyzer/scripts/analyze.py signal ~/signal_export.json "+15559876543"

查找联系人的号码

iMessage

如果您只有姓名而无号码：

DB=$(ls ~/Library/Application Support/AddressBook/Sources/*/AddressBook-v22.abcddb 2>/dev/null | head -1)
sqlite3 "$DB" "SELECT ZFIRSTNAME, ZLASTNAME FROM ZABCDRECORD WHERE ZFIRSTNAME LIKE '%Name%';"

若 AddressBook 未返回结果，请向用户询问对应号码。

Signal

Signal 导出的 JSON 中包含电话号码，可通过姓名或号码搜索。

关键数据注意事项

iMessage

• 您发送的消息 可能仅从当前设备的初始设置日期起存在——更换设备时，更早发送的消息将丢失。这会影响对话发起统计的准确性。
• 二进制消息（attributedBody）为部分解码——某些格式化痕迹（如 +@ 前缀）可能出现在样本中；此属正常现象。
• 多个句柄：同一联系人可能拥有 2–3 个重复句柄（iMessage + SMS + RCS）。脚本会自动聚合这些句柄。

Signal

• 需先导出数据：必须先使用 signal-cli export 导出 Signal 数据
• 媒体文件：导出的 JSON 仅含消息文本；图片、文件等媒体内容不包含在内
• 表情反应：Emoji 反应以独立消息条目的形式包含在导出数据中

分析输出

该脚本生成以下内容：

• 总消息数（您 vs. 对方）
• 时间范围
• 按年统计的消息数量及柱状图
• 对话发起分布（新对话定义为间隔 > 4 小时）
• 显著沉默期（>30 天）
• 按年选取的样本消息
• 最近 10 条消息

结果解读

运行脚本后，请以自然对话方式综合分析结果：

• 消息量模式：这段友谊在哪一阶段最活跃？是否存在明显激增或骤降？
• 发起倾向性：谁更常主动联系对方？（注意：您早期发送的消息可能因设备更换而缺失）
• 间隔期：长时间沉默是双方自然疏远，还是可解释的（如更换设备、切换平台、生活事件等）？
• 语气与内容：样本消息反映出的关系能量如何？
• 用户补充的上下文：始终请用户补全背景信息中的空白

请以对话式语言呈现分析结果，而非仅罗列原始数据。提供对双方关系动态的真实洞察。