微信聊天记录变情报库：WeChat Intelligence Hub 安装与接入实录

如果你也有几万条微信聊天散落在各个群聊和联系人对话里，想找一条关键信息时只能靠“我记得谁大概什么时候说过”——那么这套工具就是你在找的东西。

WeChat Intelligence Hub 做的事情不复杂：让本地微信聊天变成可检索、可核查、可行动的个人情报。它不是一个写 Prompt 的教程合集，而是一个有可执行入口、有边界、有测试的独立项目。

这篇文章站在一个实际装过、配过、踩过坑的人的角度，把安装流程、配置要点、日常使用方式和常见问题拆开来讲。能跑通的步骤直接给命令，容易卡住的地方说清楚判断依据。

这东西到底能干什么，不能干什么

先给答案：它能帮你把微信记录整理成日报、待回复清单、承诺跟踪、商机信号和复联线索。但它不是装完就自动读取你全部聊天历史的工具。

完整数据库读取需要两个条件：

• 你有权访问本机的微信本地数据库
• 你有对应的访问材料（schema-2 salt-key 授权）

没有这些材料时，这套工具仍然可以跑全虚构样例，验证索引、判断和报告链路是否正常。在 macOS 上，即使没有第三方二进制，自带的 Reader 核心也能读取系统保留的微信通知预览——但这只是入站预览，不是完整聊天记录，不能代替真实数据库。

它的实际能力分成四个层：

对使用者来说，这是一套产品、一次安装。日常用自然语言调用就行，不需要记命令行参数。

安装：两种入口，一种结果

最省事的办法：让 Codex 直接装

把这段话发给 Codex：

请从 https://github.com/Rion-Wu-tech/wechat-intelligence-hub 安装微信CLI和微信个人情报库，接入这台电脑上我自己的微信。
先读取仓库说明，检查是否已经安装、当前配置是否可用；已有可用配置或key就复用，不覆盖我的个人Profile和数据。
缺少依赖由你处理；确实缺key时，由你核验并准备固定版本工具，说明影响、经我确认后执行。我负责登录微信和完成系统授权，不会把密码或key发给你。
完成数据库验证和配置后，告诉我能读取哪些范围、还有什么未就绪；再协助初始化个人情报库。遇到错误请定位并修复，不要把一堆命令交给我，也不要无限重试。

这个做法的关键点是：已有配置就复用，缺 key 时由 Codex 准备工具，你只需要登录微信和完成系统授权。不需要把密码或 key 发给任何人。

手动安装

如果想自己控制每一步，先克隆仓库：

git clone https://github.com/Rion-Wu-tech/wechat-intelligence-hub.git
cd wechat-intelligence-hub

然后安装完整产品：

./scripts/install.sh --with-sqlcipher

安装器会自动补齐依赖。即使你只指定了 wechat-intelligence-hub，它依赖的 wechat-cli 也会一并装上，不需要手工拼装。

装完之后可以用自检命令确认状态：

rion-wechat-cli self-test
rion-wechat-cli self-test --require-sqlcipher

这两个命令的区别在于：第一个检查基础环境，第二个额外要求 SQLCipher 可用。输出里需要关注的是顶层的 ok 和 data.state：

• ready：已有可用配置，直接复用
• ready_to_configure：配置就绪，可以继续用相同输入运行 setup
• needs_access：缺少访问材料，别重复跑 setup，先解决材料问题

部分覆盖、驱动缺失、多账号和权限问题会分别给出下一步提示，不是笼统报错。

接入配置：密钥、数据库和授权边界

安装成功不等于能读取聊天。这是最容易卡住的地方，也是判断最需要说清楚的地方。

先确定你在哪个状态

运行接入诊断：

rion-wechat-cli access-plan --pretty

输出会告诉你当前处于哪种状态。JSON 顶层 ok: true 只表示诊断本身完成了，真正的结论在 data.state 里。

有 key 的情况

如果已经有本机访问材料，可以直接导入验证，然后配置。

没有 key 的情况

如果缺 key，不要自己乱试。接入流程由 Codex 按五步首次接入工作流处理：

1. 准备固定版本工具
2. 说明影响范围
3. 经你确认后执行
4. 你可能需要重启微信或重签名副本
5. 完成系统授权

这个过程中你只需要做两件事：登录微信、完成系统授权。不需要复制 key、不需要把密码发给任何人。

仓库本身不捆绑获取工具，安装和日常日报都不会触发获取。macOS 新机器的获取路径目前还没有实测，不保证所有版本可用。

一个重要的边界

可选的实验性接入助手有独立授权和副作用边界。Reader 核心本身不获取密钥、不重签名、不注入、不 Hook 微信。

只读模式只能覆盖已同步到本机的数据。通知预览是入站降级来源，不是完整的，不要把它当成全量聊天记录来用。

初始化个人情报库：把通用引擎变成你自己的

装好 CLI 和 Hub 之后，下一步是初始化 Profile。这一步把你正在做的事、你的背景、你的重点联系人变成日报排序的依据。

cd projects/wechat-intelligence-hub
python3 wechat_intelligence_hub.py profile-init \
  --owner-alias "你的微信昵称" \
  --personal-doc "/path/to/个人说明.md" \
  --plan-doc "/path/to/本月计划.md" \
  --priority-label "你的重点联系人标签"

这三个文档的作用：

如果还没有这些文档，直接运行 profile-init 会生成本地准备清单。在补齐之前，系统仍然能生成通用报告，但会标注“尚未个性化”。

微信标签不需要照搬别人的分类。推荐按自己的工作流建 2 到 5 类，比如客户、同行、渠道、供应商、自媒体网友、品牌方。可以用这条命令只读查看已有标签：

profile-init --inspect-wechat-labels

会列出你现有的标签并给出分类建议。精确关键词检索不受标签限制，始终可以覆盖全部微信记录。

在 Codex 里也可以直接说：

$wechat-intelligence-hub 帮我初始化微信个人情报库。先查找我现有的个人说明和当前计划；如果没有，给我准备清单，再只读检查现有微信标签并建议如何分类。

日常用法：不需要记命令

初始化完成后，日常使用直接用自然语言。以下是几个高频场景和对应的说法。

生成日报

$wechat-intelligence-hub 生成过去 24 小时的完整微信情报日报，分析群聊、重点联系人、待回复事项和商业机会。

日报同时输出 Markdown 和交互式 HTML 两个版本：

wechat_daily_full.md          # Markdown 总入口
wechat-report/                # 分区 Markdown
wechat_daily_report.html      # 旗舰交互式报告

HTML 版支持全局搜索、分区导航、话题日报/重点群聊切换、群聊展开、原链接跳转、明暗主题、打印和当前分区 Markdown 下载。

24 小时只是常用窗口，不是上限。可以指定任意时间范围：

$wechat-intelligence-hub 生成过去 7 天的微信情报日报
$wechat-intelligence-hub 生成 8 月 1 日到 8 月 15 日的完整报告

定向查询

$wechat-intelligence-hub 总结我和「联系人名字」最近聊到哪里，还有什么承诺没有完成。

$wechat-intelligence-hub 搜索过去 7 天所有微信聊天里关于「AI 培训」的讨论。

$wechat-intelligence-hub 查找 8 月 1 日至今所有与「某个产品」有关的信息，合并同一件事的上下文并总结进展。

$wechat-intelligence-hub 总结微信标签「品牌方」里最近一个月值得跟进的人和事情。

生成回复草稿

$wechat-intelligence-hub 根据最新聊天上下文，帮我给「联系人名字」写一条符合我语气的回复草稿。

单个对象和回复建议默认直接在 Codex 中回答，不额外生成网页。如果需要保存成文件，在请求里明确说“同时输出 Markdown 和 HTML”。

查看最紧急的事

$wechat-intelligence-hub 查看今天最需要我处理的 10 件事。

隐私边界和你能控制什么

这部分原文写得很克制，但实际使用中很重要，单独拎出来说。

• 微信相关能力只读，不发送消息，不操作微信 UI
• 真实聊天、联系人、Profile、数据库和输出报告不得提交到 Git
• 仓库中的聊天、账号、品牌、金额样例全部是虚构数据
• Reader 的数据库兼容性可能随微信版本变化
• 通知预览只是入站降级来源，不是完整的
• 运行任何涉及账号、支付、发布或外部写入的动作前，由使用者最终确认

发布前可以运行验证脚本做一次检查：

./scripts/validate.sh

升级和排障

微信升级后如果出现读取异常，诊断流程和首次接入一样。在 Codex 里说：

$wechat-cli 检查当前配置是否可用，微信升级后有没有影响读取。

已有的安装升级方式见 docs/USAGE.md 中的配置与排障提示词。

操作清单速览

1. 发消息给 Codex，按模板让 Codex 安装和配置
2. 运行 rion-wechat-cli self-test 确认基础环境
3. 运行 rion-wechat-cli access-plan --pretty 确认访问状态
4. 运行 profile-init 初始化个人 Profile（至少填昵称，其他文档可以后补）
5. 日常用自然语言调用 $wechat-intelligence-hub，不需要记命令行
6. 遇到问题时，让 Codex 定位并修复，不要自己乱试
7. 发布前运行 ./scripts/validate.sh 检查隐私和完整性

FAQ

装完就能马上看到我所有微信聊天记录吗？

不能。安装成功不等于能读取聊天。需要有本机数据库访问材料和授权。没有 key 时，由 Codex 按接入流程准备工具，经你确认后获取。

我没有 key，需要自己找解密工具吗？

不需要。由 Codex 按固定流程准备工具，你只需要登录微信和完成系统授权，不需要复制 key 或密码。

通知预览模式和完整数据库模式有什么区别？

通知预览只覆盖入站消息的预览内容，不是完整的聊天记录。在没有数据库访问材料时作为降级来源使用，不要把它当成全量数据。

我不想让工具读到某些聊天，能控制吗？

可以。只读 Reader 不主动获取任何数据，读取范围取决于你授权的数据库和访问材料。不要提交真实数据到 Git，仓库中的样例全部虚构。

个人 Profile 不填完整能用吗？

能用。系统会生成通用报告，但会标注尚未个性化。填得越完整，日报排序越符合你的实际优先级。

微信升级之后会坏吗？

有可能。Reader 的数据库兼容性可能随微信版本变化。升级后运行诊断命令检查，让 Codex 按排障流程处理。