Murmur 微语
把多年微信和 QQ 聊天 + 朋友圈，在你电脑上做成一张可以旋转、缩放、聚焦的 3D 关系网，再让本地的 Claude / Codex 给每个朋友写一份关系档案。
100% 本地分析，不上云。Windows 内置 QQ NT 解密。
只处理本机、本人的数据。 Murmur 只读取这台电脑上你自己登录的微信 / QQ 留下的聊天记录，解密、索引、分析全部在本机完成，不上传任何内容。不要用它去读别人的电脑或别人的账号。
重签名或注入微信有账号风险。 Mac 抓密钥需要对微信重签名、用 Frida 附加进程，或启动一份注入了 Murmur 小组件的微信私有副本；Windows 要把 hook 装进微信进程。这些都不是腾讯官方支持的用法，有触发风控、被要求重新登录甚至限制账号的可能。请确认你能接受这个风险再用；介意的话可以用「手动粘贴密钥」或干脆不用。
下载最新版
当前版本：v0.5.0
更新日志
v0.5.0 — 抓 key 新路径、实时同步、聊天浏览与搜索、界面改版
这一版是一次大更新，完整说明见 docs/RELEASE_0.5.0.md。
- Frida 实时抓 key（Mac，微信 4.1.9+）：4.1.9 之后密钥不再常驻内存，扫内存经常一个都抓不到。现在 App 里可以直接用 Frida 在你正常使用微信时把密钥截下来，大约 1–2 分钟。
- 一轮拿到全部库的 key：抓取时直接截获账号口令，在本机用 PBKDF2 派生出每个数据库的 key，不用再一个个点开对话「解锁」。
- Mac 免 Frida 私有副本：不装 Frida、不输管理员密码的另一条路——把微信复制一份到
~/.murmur/wechat-copy/，只对副本重签名并注入一个只记录加密调用的小 dylib，原版 /Applications/WeChat.app 不动。真机（微信 4.1.15）结论：副本和原版共用同一个 xwechat_files 容器，没有弹「访问其他 App 的数据」的授权框，需要在副本里重新登录一次，23/23 个库的 key 全部通过 HMAC 校验。用之前要先完全退出原版微信（Murmur 检测到原版在运行会拒绝开始）。
- 实时同步（WAL）：首页可以打开「实时同步」，后台每隔几秒检查微信数据库，连还没写回主库的 WAL 新消息一起增量解密，不用再手动点「更新数据」。
- 本机 AI agent：除了 Claude Code 和 Codex，现在也能识别 Gemini CLI、Kimi Code、OpenCode；工具权限收紧为只读分析包，不让它们执行命令或改文件。
- MCP 服务：
etcli mcp 让 Claude Code / Codex 等 AI 助手以只读方式查你本机的联系人、聊天、搜索和关系统计，可加 --privacy 全程脱敏。见 docs/MCP.md。
- 全局搜索 + 语义搜索：全部聊天记录建本地全文索引（SQLite FTS5，增量更新）；可选开启「按意思搜」——本地 bge-small-zh 向量模型（约 24MB，默认关闭，下载时校验 SHA-256），找「一起去看海的那次」这种没有固定关键词的内容。
- 聊天浏览：新的聊天页按时间往前翻、跳到某一天、从搜索结果直接定位到那条消息；几十万条的大会话翻页也只读当前这一页。
- 错误码与诊断包：所有报错带稳定错误码，界面上直接告诉你原因和怎么办；「复制诊断信息」不管开没开隐私模式都会脱敏（路径里的用户名、wxid、key 等），可以直接贴到 issue。
- 应用锁：可以给 Murmur 设密码，闲置一段时间自动上锁；锁定期间本地服务对所有数据接口一律拒绝。见 docs/app-lock.md。
- 新引导：初始化改成步骤条——环境自检 → 数据目录 →（Mac）授权/重签 → 取得密钥 → 解密 → 完成，每一步出错都有错误码和处理建议，已完成的步骤可以单独重做；Mac 会按微信版本推荐抓取方式。
- 界面改版：新的设计 token 和组件、浅色 / 深色主题（可跟随系统）、左侧导航和设置页、各页面补齐加载骨架 / 空状态 / 错误状态，手机宽度不再横向溢出。
- 安全：本地服务现在只接受发往
127.0.0.1 / localhost / [::1] 的请求，挡住借域名指向本机的网页（DNS 重绑定）。
v0.4.4 — 手动填路径找不到数据 + QQ 索引并发
- 手动粘贴微信路径仍提示「找不到 wxid_*/db_storage」（Windows 为主，Mac 同样受影响）。两个独立原因：
- 识别逻辑只认一组固定的目录名（
Tencent/xwechat_files 等）。微信「文件管理」里显示的是你自己选的存储目录，只要不叫这几个名字之一——WeChat\、Weixin\、微信文件\、任何自定义名——粘贴的路径完全正确也会被判定为找不到。实测 8 种常见布局有 5 种失败。现在改为在你给的路径下有界搜索，任何层级结构都能认出来。
- 微信号别名以
all 开头的账号（如 allen_9f3a）被误当成微信自带的 all_users 共享目录跳过，导致无论粘贴哪一层都找不到。
- QQ：修复首次加载时多个请求并发建索引互相撞锁，导致索引被跳过、大库性能优化白做的问题（#24 后续）。
v0.4.3 — Mac 重签名补丁
- 修复 Sequoia 上 codesign
Operation not permitted (1)：重签名前彻底退出微信全部 helper / crashpad / wx* 进程（旧版只杀主进程，helper 仍映射 bundle 内 Mach-O，导致改不动主二进制）。
v0.4.2 — Mac 重签名 + Windows QQ 大库性能
- Mac：修复 Sequoia (15+) 微信重签名失败导致装不上的根因（放弃
--remove-signature）。
- Windows：10GB+ QQ
nt_msg.db 首次加载自动建 4 个索引，关系网 / 首页加载从 ~4 分钟超时降到 10 秒内（#24，最高约 85×）。
v0.4.1
- Win + Mac 稳定版：QQ NT 导入向导 + 安装 / QQ 导入视频教程。
v0.4.0
- 年度总览 — 跨所有朋友的「Spotify Wrapped」：Top 5、月度冠军、最忙的一天、最长连续聊天、24×7 热力图、深夜之王、最对等的关系、谁先开聊、口头禅、走丢的人。Home 顶栏 📅 进入。
- 双人关系档案导出 — Murmur 独有：导出朋友 A 与朋友 B 之间的完整关系（共群对话 + 朋友圈互动 + 你私聊里互相提及 + 各自和你的对话样本），三种格式（MD/JSON/HTML）。Friend 页关联朋友卡片每条朋友右侧 📤 一键。
- AI 助手抽屉 — 替换原来三步弹窗。左侧抽屉滑入选 AI / 范围 / 侧重，本机 AI 跑完直接进两栏读报视图。报告顶部一行「硬证据指纹」（最长连聊 / 你主导 % / 深夜偏向 / 全年趋势）让 AI 引用真数字。
- 微信 4.x 完整文本恢复 — 修复 4.x 把文本塞进
compress_content 列导致 Murmur 看到空白的问题，引用 / 链接 / 转账 / 红包 / 文件等 type 49 现在能渲染真实内容。
- WAL 实时合并 — 解密时把 WAL 里没 checkpoint 的最新消息也补进来，不再卡在「上次微信关之前」。
- 增量解密缓存 — 第二次 refresh 大部分 DB 秒过（mtime 没变 + key 没变就跳过），10GB 历史的用户从分钟级降到秒级。
- 解密前阻断 — 微信还在运行时拒绝解密 + 中文友好提示，避免拿到半页损坏 DB。
- 原子 swap — 解密产物先写
*.tmp 再 os.replace 落地，Ctrl-C 不再留半截 DB。
它能做什么
- 3D 关系网：自己在中心，朋友按亲密度散布周围。同一个核心圈的人会落在同一片区域，球面整体保留壮观的星空感。
- 核心圈聚焦：右下角点「N 个核心圈」→ 列表里选一个 → 半透明 3D 包络贴合包裹该圈成员，圈外的人和连线全部变暗。
- 点人看档案：点任意节点 → 右侧弹出关系详情。私聊 / 群聊 / 朋友圈互动，每年沟通频率，有没有沉默后重连，全是离线就能算的硬证据。
- AI 关系报告：让本机的 Claude Code 或 Codex CLI 给每个朋友、每对朋友写一份关系分析。Murmur 把脱敏样本和 prompt 整理好喂给 CLI，不上云。
- 双人关系档案：分析你认识的两个人之间的关系（市面工具只能看你和某人）。
- 年度总览：所有朋友所有聊天的 Wrapped 风格回顾。
- 隐私模式：左侧栏一键切，所有真名变「朋友 XX」「群 1」，wxid 和本机路径都隐藏。
- 聊天浏览 + 全局搜索：按时间翻完整聊天、跳到某一天；全部聊天记录本地全文搜索，可选「按意思搜」。
- 实时同步：打开后微信里的新消息几秒内进到 Murmur。
- 应用锁：给 Murmur 设密码，闲置自动上锁。
- 给 AI 助手用（MCP）：
etcli mcp 让 Claude Code / Codex 只读查询本机聊天数据。
- QQ NT 支持：Windows 版顶栏可以加 QQ 账号，独立解密 + 独立分析。
单人档案页
每位朋友有独立档案：人物介绍、AI 摘要、离线证据、关联朋友、相册、整对话浏览、双人年代记。关系层级（A 老朋友 / B 常聊 / C 有联系 / D 弱联系 / E 已疏远）由本地算法基于持续年限、电话次数、朋友圈互动等离线证据自动判定。
AI 关系档案
Murmur 把每个朋友的样本消息 + 离线证据 + 数据指纹（最长连聊、谁主导、深夜比例、年度趋势）+ 评估准则打包，让本机 Claude Code 或 Codex 出一份长文分析。报告里会评估关系定性、列时间持续性、沉默后重连、表达密度等具体证据。
报告默认存到：
~/Desktop/Murmur/agent_reports/
下载哪个文件
Windows 用户：
- 推荐：
Murmur_0.5.0_x64-setup.exe
- 备用：
Murmur_0.5.0_x64_en-US.msi
Mac 用户：
- Apple Silicon：
Murmur_macOS_AppleSilicon.dmg
- 备用：
Murmur_macOS_AppleSilicon.app.zip
- 只支持腾讯官网版 WeChat for Mac。Mac App Store 版 WeChat 目前不支持自动抓密钥；请先换成腾讯官网版再走 Murmur 引导。
Intel Mac 暂时没有安装包，需要从源码运行。
视频教程
Windows 安装（微信）
- 双击
Murmur_0.5.0_x64-setup.exe，按引导装。
- 打开微信，退出登录回到登录页，但不要关闭微信进程。
- 打开 Murmur，点「开始抓密钥」。
- 看到等待提示后，回微信扫码登录一次。
- 抓到 key → 自动解密 → 进入关系网。
如果杀毒软件拦截 wx_key.dll：把 Murmur 安装目录加白名单后重新安装。
Windows 安装（QQ）
走完微信流程后，顶栏点「+ 添加新账号 → 🐧 QQ」（或 Welcome 页底部「🐧 切换到 QQ」）。具体见 QQ 安装视频。
⚠️ 开始前先把电脑端 QQ 完全退出：手机 QQ 上点登录设备 → 退出电脑端 QQ → 再确认电脑端 QQ 没在后台跑（任务管理器搜 QQ.exe / QQEX.exe 全部杀掉）。否则 Murmur 启动的带调试器 QQ 会被已登录的实例抢走，抓不到 key。
Mac 安装
- 双击
Murmur_macOS_AppleSilicon.dmg。
- 把
Murmur.app 拖到「应用程序」。
- 不要直接在 dmg 窗口里运行，要从「应用程序」打开。
- 第一次打开如果被 Gatekeeper 拦：「系统设置 → 隐私与安全性」滚到底部点「仍要打开」。
Mac 微信要求：请使用 腾讯官网版 WeChat for Mac。App Store 版 WeChat 的程序结构和权限保护不同，Murmur 当前不支持它的自动重签名 / 自动抓密钥流程。
如果完全没有「仍要打开」按钮，开 Terminal：
xattr -dr com.apple.quarantine /Applications/Murmur.app
open /Applications/Murmur.app
首次使用时 Murmur 会用步骤条引导你完成「环境自检 → 数据目录（含完全磁盘访问）→ 授权/重签 → 取得密钥 → 解密 → 完成」，详见 docs/ONBOARDING_MAC.md。
Mac 取得密钥有三种方式，引导会按你的微信版本推荐：
| 方式 | 适合 | 需要 |
|---|
| 实时抓取 · Frida | 微信 4.1.9 及以上（推荐） | 微信先重签名；第一次要安装 Frida；会弹管理员密码 |
| 实时抓取 · 免 Frida（私有副本） | 不想装 Frida、不想输管理员密码 | 先完全退出原版微信；在副本里重新登录一次 |
| 内存扫描 | 4.1.9 以前的微信 | 微信先重签名；点开几个对话再抓 |
三种方式都只在你自己的电脑上、对你自己登录的微信操作，都有账号风控风险（见页首）。
年度总览
Home 顶栏点 📅 进入。第一次打开会扫所有聊天历史 10-30 秒（之后缓存 24 小时）。包含：
- Top 5 最常聊的朋友
- 12 个月度冠军（每月聊得最多的人）
- 最忙的一天 + 那天主要在和谁聊
- 最长连续聊天天数
- 24×7 热力图
- 深夜之王（23-4 点对话最多）
- 最对等的关系（一来一回最平衡）
- 谁先开聊（按 6h 间隔切对话窗）
- 你的口头禅 top 10
- 走丢的人（前后半年掉幅最大）
双人关系档案
任意朋友页 → 关联朋友卡片 → 每个朋友右侧 📤 → 弹出三格式下载（MD / JSON / HTML）。
也可以从 3D 关系网里点两人之间的连线 → pair drawer 里下。
包含的证据：
- 你私聊里提到对方的样例（双向）
- 你和 A / 你和 B 各自的对话样本
- 共同群里 A↔B 的真实对话窗口
- 朋友圈互动（A 给 B 点赞评论数 + 原文）
- 适合直接拖给 ChatGPT / Claude / 豆包 / Kimi 在线 AI 让它推断关系
AI 分析使用（批量）
报告页（顶部）选：
- 小样本自检（先验证几个人）
- Top 朋友 + Top 关系
- 全部朋友 + 朋友间关系
- 只补朋友间关系报告
并行数和引擎（Claude / Codex / 双跑）可以在面板里设。
隐私模式
右下角「🔓 隐私模式：关 / 🔒 隐私模式：开」一键切。开启后会隐藏：
- 朋友昵称、群名（变「朋友 XX」「群 N」）
- wxid、chatroom id
- 本机路径
- 邮箱、手机号样式文本
- 64 位 hex key 字符串
- 身份证号 / 银行卡号样式
- 引用文本里的人名（启发式）
录视频 / 公开截图前点一下，不用反复手动打码。
遇到问题
~/Documents/Murmur/logs/ 下有 serve.log 和 tauri-shell.log，涵盖后端启动 / 解密失败 / 抓 key 失败的细节。
报错界面会显示一个错误码（如 WECHAT_HARDENED、KEY_NOT_FOUND），并直接写出原因和处理办法；反馈问题时带上错误码最快。
报错界面和「设置 → 关于」里都有 「复制诊断信息」 按钮，会打包版本号 / 平台 / 账号概况 / 启动错误 / 日志末尾，不管开没开隐私模式都会先脱敏（用户名、wxid、key、手机号等），直接粘到 GitHub issue 即可。
如果解密报「encrypted database is malformed」之类的，多半是微信升级了 schema：
python cli/refresh.py --force
会清空旧解密目录重新解。
隐私 / 数据流向
- 所有解密、分析、可视化 100% 本地，无任何网络上传；只处理这台电脑上你本人账号的数据
- 本地服务只监听
127.0.0.1:9100，只接受 Murmur 自己的页面（CORS）和发往本机地址的请求（Host 白名单，防 DNS 重绑定）
- 开了应用锁时，锁定期间本地服务拒绝所有数据接口
- MCP 服务只读，不会修改任何数据；
--privacy 下名字、wxid 全部脱敏
- 语义搜索默认关闭；开启时只下载一次固定版本的模型文件并校验 SHA-256，之后完全离线
- AI 报告由你本机已登录的 Claude Code / Codex CLI 生成（这俩 CLI 自己会调云，但 Murmur 把样本脱敏后才喂给它们）
- 抓密钥只在初始化（或你手动重新抓取）时进行，之后不再 attach 微信 / QQ 进程；私有副本每轮结束都会关掉，用完可以在界面里删除
- 解密数据放在
~/Documents/Murmur/decrypted/，可随时手动删除
- 双人导出包同样 100% 本地生成
