这是一个面向本地微信聊天数据的“个人情报库”项目,核心目标是把用户有权访问的本地微信记录转化为可搜索、可核查、可行动的信息资产。它包含只读微信 Reader/CLI、Codex Skill 调用入口、本地索引与分析引擎,可生成微信日报、待回复事项、承诺跟踪、商机线索、复联提醒、联系人历史总结和交互式 HTML 报告。项目强调 local-first、本地只读、不 Hook、不注入、不自动提取密钥,适合希望用 AI 管理微信沟通、客户关系和商业机会的个人或小团队开发者。目前版本为 preview,微信数据库兼容性和完整历史读取依赖用户自行提供本地数据库与授权材料。
适用领域
微信数据分析 / 个人知识管理 / 本地优先 AI 工具 / 聊天记录检索 / 客户关系管理 CRM / 销售线索管理 / Codex Skills / CLI 工具 / 隐私计算 / 个人自动化工作流
配置难度
中高。普通 Demo 和基础安装相对直接,但要实现完整微信历史读取、数据库授权材料配置、SQLCipher/WCDB 兼容、Codex Skill 工作流和个性化 Profile 调优,需要一定 Python、命令行、macOS/本地文件权限、数据库和隐私安全经验。
商业价值
较高。对依赖微信开展销售、咨询、自媒体、社群运营、客户维护和商务合作的中文用户非常有价值,可以把分散聊天记录转化为待办、承诺、复联线索和商机雷达,减少人工翻聊天成本。对开发者而言,它也提供了一个本地优先 AI Agent 工具的参考架构。不过商业化落地需重点处理微信数据授权、隐私合规、AGPL 许可证义务和不同微信版本适配问题。
01
技术亮点
- 本地优先设计,强调真实聊天数据、联系人、Profile 和报告不应提交到 Git
- 微信能力只读,不发送消息,不操作微信 UI,不从微信进程提取密钥,不重签名、不注入、不 Hook 微信
- 提供完整的产品化工作流,而不只是 Prompt 模板
- 同时包含 Reader、CLI、Codex Skill、本地引擎、Demo 和测试,结构分层清晰
- 支持自然语言调用,适合与 Codex/Agent 工作流集成
- 支持日报、联系人总结、关键词搜索、群聊分析、承诺跟踪、商机识别和回复草稿等实用场景
- 完整报告可同时输出 Markdown 和交互式 HTML,便于归档、筛选、搜索和展示
- 提供虚构 Demo,用户在没有真实数据库条件下也能体验核心分析链路
- 明确说明 AGPL-3.0-only 许可证和商业授权路径,对企业评估较友好
- GitHub 星标和 Fork 数较高,说明已有一定关注度
02
目标用户
- 希望整理和检索微信聊天历史的个人开发者
- 需要从微信沟通中提取客户线索、待办和承诺的销售、咨询、自媒体或自由职业者
- 使用 Codex/Agent 工作流,希望通过自然语言调用本地数据工具的开发者
- 关注隐私、希望数据尽量留在本地的用户
- 需要分析社群、客户群、品牌方、渠道或供应商沟通记录的小团队
- 想学习本地数据 Reader、CLI、AI 工作流和报告生成架构的 Python 开发者
03
配置要求
- 需要 Python 3 环境以及项目安装脚本所需的本地依赖
- 完整数据库读取需要用户自行提供其有权访问的本地微信数据库和访问材料
- 如需读取加密数据库,需要 SQLCipher 支持,安装时建议使用 --with-sqlcipher
- 项目涉及 WCDB 压缩消息时可能依赖 Zstandard 运行环境
- macOS 上可读取系统实际保留的微信通知预览,但该模式只覆盖入站预览,不能代表完整聊天记录
- 若在 Codex 中使用,需要安装 wechat-cli 和 wechat-intelligence-hub 两个 Skill;安装完整产品时会自动补齐依赖
- 建议准备个人说明文档、当前计划文档和 2–5 类微信标签,以提升日报和优先级排序效果
- 开发调试仓库源码时需要设置 WECHAT_HUB_HOME;普通安装后通常不需要手动配置
- 只有显式设置 RION_WECHAT_CLI_BIN 时才会调用兼容后端,默认使用 Rion 自有只读 Reader
04
适用场景
- 生成过去 24 小时、7 天、一个月或指定时间范围的微信情报日报
- 搜索聊天记录中关于某个产品、项目、客户、关键词或事件的上下文
- 总结与某个联系人的最近沟通进展、未完成承诺和下一步动作
- 从微信群聊中提取热点话题、重点联系人、待回复消息和商机信号
- 根据当前聊天上下文生成符合用户语气的回复草稿
- 跟踪潜在客户、品牌合作、渠道资源和复联对象
- 为个人 Profile、当前计划和微信标签建立本地化优先级体系
- 输出 Markdown 和交互式 HTML 报告,用于归档、搜索、筛选和二次分析
- 在没有真实微信数据库的情况下运行虚构 Demo,验证索引、判断和报告链路
05
部署与配置
- 克隆仓库:git clone https://github.com/Rion-Wu-tech/wechat-intelligence-hub.git
- 进入目录:cd wechat-intelligence-hub
- 安装完整产品:./scripts/install.sh --with-sqlcipher
- 如只需独立 CLI,可执行:projects/rion-wechat-reader/install.sh --with-sqlcipher
- 运行 CLI 自检:rion-wechat-cli self-test
- 验证 SQLCipher 依赖:rion-wechat-cli self-test --require-sqlcipher
- 执行初始设置检查:rion-wechat-cli setup --pretty
- 运行虚构数据 Demo:bash projects/wechat-intelligence-hub/scripts/run_demo.sh
- 开发或调试源码时设置引擎路径:export WECHAT_HUB_HOME="$PWD/projects/wechat-intelligence-hub"
- 初始化个人 Profile:python3 wechat_intelligence_hub.py profile-init --owner-alias "你的微信昵称" --personal-doc "/path/to/个人说明.md" --plan-doc "/path/to/本月计划.md" --priority-label "重点联系人标签"
- 发布或改动前运行校验:./scripts/validate.sh
06
风险与注意事项
- 当前为 preview 版本,生产稳定性和微信多版本兼容性仍需验证
- 完整聊天历史读取不等于开箱即用,依赖用户自行提供数据库、salt-key 等授权材料
- 微信数据库结构、加密方式或系统权限变化可能导致 Reader 失效或覆盖范围下降
- 通知预览模式只是降级来源,只包含入站预览,不能代表完整聊天记录
- 处理微信聊天记录具有较高隐私风险,用户需要严格管理本地文件、输出报告和备份
- AGPL-3.0-only 对闭源集成、SaaS 网络服务和企业内部分发有合规要求,商业项目需谨慎评估
- 涉及微信生态,可能存在平台规则、商标、兼容性和合规边界风险
- 中文 README 中带有社群和商业推广内容,企业采用时需要区分开源能力与付费服务
- 非技术用户可能难以完成数据库授权材料准备、SQLCipher 依赖安装和环境排错
2026-09-06
第20名
新收录 · github_search