WeChat Intelligence Hub 教程：把本地微信聊天变成可检索的个人情报库

📌 项目地址：github.com/Rion-Wu-tech/wechat-intelligence-hub | 星数：2,322+ | 协议：AGPL-3.0 | 语言：Python | 版本：v0.9.2-preview.2

📋 项目简介

微信聊天记录里藏着大量"睡过站"的信息：答应别人的事、别人答应你的事、聊到一半的机会、该回未回的人。WeChat Intelligence Hub 是 2026 年 9 月冲上 2,300+ 星的微信个人情报系统，定位是把本地微信聊天变成可检索、可核查、可行动的个人情报——覆盖联系人历史、群聊主题、待回复、承诺、商机、复联线索，并能生成任意指定时间范围的情报报告。它不是提示词合集，而是带可执行入口、边界声明、测试和全虚构样例的完整工程。同类的"把私人聊天数据变成 AI 工作流"思路，可以对比阅读Easel社交媒体AI Agent教程；面向销售的 WhatsApp 版本见DeskcommCRM教程。

🔒 先讲边界：只读、本人授权、本地优先

这是评测和教学都必须放在第一节的内容。项目 README 用大量篇幅声明了安全边界：

• 只读设计：Reader 核心"不获取密钥、不重签名、不注入、不 Hook 微信"
• 本人授权：完整数据库模式需要使用者本人授权的本地数据库和访问材料，不是"装完就能读所有人历史"
• 人工确认：官方接入工作流是"有人确认关键操作"的流程，不是无条件无人值守的解密；缺少 key 时由 Codex 核验并准备固定版本工具、说明影响、经本人确认后执行
• 隐私纪律：文档明确"请勿向维护者、社群或 Issue 发送 key、密码和数据库"

这套设计让它在"个人数据自主权"与"合规边界"之间找到了目前开源社区最谨慎的落点。

🏗️ 四层架构：一个产品，两个 Skill

对用户是一次安装一套产品；对代码是四层独立测试维护。v0.9.2-preview.2 已完成：旧版接口对齐、schema-2 salt-key 授权导入、WCDB 压缩消息读取、新旧 CLI 真实数据对照、macOS 图片/视频/文件路径验证、端到端索引验证。

🚀 安装：让 Codex 帮你装

官方推荐把这段提示词直接发给 Codex：

请从 https://github.com/Rion-Wu-tech/wechat-intelligence-hub 安装微信CLI和微信个人情报库，
接入这台电脑上我自己的微信。
先读取仓库说明，检查是否已经安装、当前配置是否可用；
已有可用配置或key就复用，不覆盖我的个人Profile和数据。
缺少依赖由你处理；确实缺key时，由你核验并准备固定版本工具，
说明影响、经我确认后执行。我负责登录微信和完成系统授权，
不会把密码或key发给你。

手动安装路径：

git clone https://github.com/Rion-Wu-tech/wechat-intelligence-hub.git
cd wechat-intelligence-hub
./scripts/install.sh --with-sqlcipher   # 安装完整产品（两个skill+本地引擎）

# 或只装独立CLI：
projects/rion-wechat-reader/install.sh --with-sqlcipher
rion-wechat-cli self-test               # ready / ready_to_configure / needs_access 三态

self-test 的三态语义要记牢：ready 表示复用已有配置；ready_to_configure 才继续 setup；needs_access 表示缺访问材料，不要重复跑 setup。

💼 能干什么：情报工作流

接入后核心产出是五类情报：每日简报（指定时间范围的情报报告）、待回复清单（该回未回的人）、承诺追踪（双向承诺）、商机线索（从聊天上下文里浮现的机会）、复联线索（久未联系但值得重启关系的人）。对做销售、BD、投资人脉管理的人，这就是一个跑在本地的私人 CRM——而且数据源是你真实的行为记录，不需要手动录入。

⚖️ 许可证须知

AGPL-3.0-only：可以学习、运行、修改和商业活动；但分发修改版或通过网络向用户提供修改版，必须履行开源对应源码的义务。需要闭源集成、OEM、白标的企业可申请单独商业授权。作者同时提供付费社群与定制服务（安装适配、工作流配置），但公开项目按各自许可证使用，不购买服务不受影响。