wechat-intelligence-hub

WeChat Intelligence Hub 快速入门

本地优先微信个人情报库：把本地微信聊天变成可检索、可核查、可行动的个人情报（AGPL-3.0，v0.9.2-preview.2）

这是什么？适合谁？

WeChat Intelligence Hub（Rion-Wu-tech/wechat-intelligence-hub）是一个本地优先的微信个人情报系统。它把你自己电脑上的微信聊天记录变成可检索、可核查、可行动的个人情报资产：联系人历史、群聊主题、待回复事项、承诺、商机和复联线索，并能生成任意时间范围的情报日报（Markdown + 交互式 HTML 双版本）。

它不是”Prompt 大礼包”，而是一个包含独立只读 Reader 核心（rion-wechat-reader）、Agent CLI 入口（wechat-cli Skill）、情报工作流（wechat-intelligence-hub Skill）和确定性本地引擎的完整工程，配有可执行入口、边界声明、测试和全虚构样例。核心安全承诺：只读——不获取密钥、不重签名、不注入、不 Hook 微信、不发送消息、不操作微信 UI。

适合谁：重度微信用户（销售、BD、自媒体、微商、创业者）每天有大量群聊和私聊，需要”昨天聊到哪了""谁还没回复我""上月那个商机进展如何”这类答案；已在用 Codex CLI 且希望用自然语言调用微信情报能力的开发者。不适合：想在手机上用、想多端同步、或希望”装完即读全部历史”的用户——完整读取需要本人授权的本地数据库访问材料。

准备工作

• 设备要求：macOS（当前实测重点平台；其他微信版本按能力矩阵逐项积累，Windows 未实测）
• 软件要求：git、Python 3、Codex CLI（Skill 宿主）；安装脚本会自动装隔离的 SQLCipher 与 Zstandard 运行依赖
• 账号要求：GitHub 账号（克隆仓库）；本机已登录自己的微信
• 付费要求：软件本身免费（AGPL-3.0）；付费社群（Rion AI 实践与商业化 Club）是自愿加入的社群服务，不是软件购买费，不使用软件无需付费
• 关键前置认知：安装成功 ≠ 已能读取聊天。完整历史读取需要本人授权的本地数据库和访问材料（schema-2 salt-key）；没有数据库读取条件时，仍可运行全虚构 Demo 验证索引、判断与报告链路
• 权限/安全边界：微信能力只读；真实聊天、联系人、Profile、数据库和输出报告不得提交到 Git；涉及账号、支付、发布或外部写入的动作前由使用者最终确认

3 步快速上手

第 1 步：克隆仓库并安装完整产品

git clone https://github.com/Rion-Wu-tech/wechat-intelligence-hub.git
cd wechat-intelligence-hub
./scripts/install.sh --with-sqlcipher

不传 Skill 名称时会安装 wechat-cli、wechat-intelligence-hub 及其本地引擎；即使只指定 wechat-intelligence-hub，安装器也会自动补齐它依赖的 wechat-cli。

也可以直接把 README 中的”请 Codex 安装和配置”提示词发给 Codex，由它代为检查环境、安装和配置——关键操作仍需本人确认。

第 2 步：先跑全虚构 Demo（无数据库也能用）

安装 wechat-intelligence-hub 后，本地引擎已放入 Codex 目录。先验证链路：

bash projects/wechat-intelligence-hub/scripts/run_demo.sh

预期结果：Demo 用仓库内置的全虚构样例数据跑通”索引 → 判断 → 报告”全链路，不触碰任何真实聊天数据。这是官方推荐的零风险验证方式。

第 3 步：个性化初始化并生成第一份日报

把你的背景和当前计划变成日报的排序依据：

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 会先生成本地准备清单；补齐前系统仍能生成通用报告（会标明尚未个性化）。

然后在 Codex 中直接说：

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

成功判定：输出 wechat_daily_full.md（Markdown 总入口）、wechat-report/（分区 Markdown）和 wechat_daily_report.html（旗舰交互式报告，含综合行动、群聊日报、重点联系人和商单信号雷达四个入口，支持搜索/筛选/明暗主题/打印）。

初级用法

• 每日情报日报：$wechat-intelligence-hub 查看过去 24 小时微信里最需要我处理的事情——快速版，只看重点。
• 联系人上下文：$wechat-intelligence-hub 总结我和「联系人名字」最近聊到哪里，还有什么承诺没有完成——会前/跟进前必查。
• 关键词检索：$wechat-intelligence-hub 搜索过去 7 天所有微信聊天里关于「AI 培训」的讨论——精确关键词检索覆盖全部微信记录，不受标签限制。
• 标签运营：$wechat-intelligence-hub 总结微信标签「品牌方」里最近一个月值得跟进的人和事情——按人脉分层运营。
• 优先级队列：$wechat-intelligence-hub 查看今天最需要我处理的 10 件事。

高级玩法

• 长周期情报报告：24/48 小时只是常用窗口，可指定一天、一周、一个月、某段起止日期或已有索引覆盖的更长范围：$wechat-intelligence-hub 查找 8 月 1 日至今所有与「某个产品」有关的信息，合并同一件事的上下文并总结进展。
• 双版本归档：在请求中明确说”同时输出 Markdown 和 HTML”，定向调查也会保存双版本，方便归档和交给 AI 继续加工。
• 自定义标签体系：profile-init --inspect-wechat-labels 只读查看已有标签并生成候选建议；推荐按自己的工作流建 2–5 类（客户、同行、渠道、供应商、品牌方等），标签用于排序，关键词检索不受限。
• 接入诊断工作流：rion-wechat-cli self-test / access-plan --pretty 输出结构化状态：ready=复用已有配置，ready_to_configure=继续 setup，needs_access=缺访问材料不要重复 setup。注意 JSON 顶层 ok: true 仅表示诊断完成，真实状态看 data.state。
• 回复草稿生成：$wechat-intelligence-hub 根据最新聊天上下文，帮我给「联系人名字」写一条符合我语气的回复草稿——只生成草稿，发送仍由你本人在微信完成。

常见踩坑

1. 症状：装完发现读不了聊天记录。 原因：完整数据库读取需要本人授权的本地数据库和访问材料（schema-2 salt-key），安装脚本不捆绑获取工具。解决：先跑全虚构 Demo 验证链路，再按仓库 skills/wechat-cli/references/access-onboarding.md 的五步首次接入工作流，由 Codex 准备固定版本工具、说明影响、经你确认后尝试获取（可能重启微信和重签名副本，macOS 新机器路径尚未实测）。
2. 症状：self-test 返回 ok: true 但功能不可用。 原因：JSON 顶层 ok: true 仅表示诊断完成，不代表接入就绪。解决：查看 data.state 字段——ready/ready_to_configure/needs_access 分别对应不同下一步，needs_access 时不要重复运行 setup。
3. 症状：想读完整历史但只有通知预览。 原因：无数据库读取条件时，macOS 可读取系统保留的微信通知预览，但只覆盖入站预览、非完整聊天记录。解决：将其作为降级来源使用，完整读取仍需授权数据库材料；且仅覆盖已同步到本机的数据。
4. 症状：担心工具会动我的微信。 原因：对边界的误解。解决：Reader 核心只读——不获取密钥、不重签名、不注入、不 Hook；可选的实验性接入助手有独立授权和副作用边界，运行前会说明影响并需确认。
5. 症状：微信升级后读取失败。 原因：Reader 的数据库兼容性可能随微信版本变化（官方明确声明）。解决：查看 Reader 说明与 USAGE.md 的排障提示词，让 Codex 按既有配置排障，不要把密钥或数据库发给维护者、社群或 Issue。
6. 症状：fork 了仓库想把真实聊天数据放进样例。 原因：违反仓库红线。解决：真实聊天、联系人、Profile、数据库和输出报告不得提交到 Git；仓库样例均为虚构数据，贡献前运行 ./scripts/validate.sh。
7. 症状：fork 数比 star 还多，怀疑项目真实性。 原因：4 天内 1.8k star / 2.3k fork，fork 超 star 的比例异常（社区搬运扩散的典型特征），且仓库仅 8 commits、3 open issues。解决：保持观察——本文所有功能描述均来自官方 README 声明，我们未做真实微信数据实测；引用时注意区分”官方声明”与”独立实测”。

小技巧

• 个性化是日报质量的杠杆：--personal-doc 写清身份、业务、擅长领域、资源、约束和长期目标；--plan-doc 写近期目标、推进项目、交付/收入优先级和截止时间，排序会显著更准。
• 标签别照搬维护者的名字，按自己的工作流建立 2–5 类即可；标签影响排序，但精确关键词检索始终覆盖全部记录。
• 简单问题（单个对象、回复建议）默认直接在 Codex 中回答，不会额外生成网页；需要归档时才说”同时输出 Markdown 和 HTML”。
• 完整多会话复合报告默认同时输出 Markdown 与交互式 HTML 两版，HTML 版支持全局搜索、分区导航、话题日报/重点群聊切换、群聊展开、原链接跳转和明暗主题。
• 涉及账号、支付、发布或外部写入的动作，系统会要求你最终确认——这是设计而非打扰。

常见问题 FAQ

Q1: 这个工具会上传我的聊天记录吗？

A: 官方声明本地优先：Reader 只读本机数据，README 明确”真实聊天、联系人、Profile、数据库和输出报告不得提交到 Git”，仓库样例均为虚构数据。但请注意本项目尚无独立安全审计，敏感数据使用请自行评估（我们未实测）。

Q2: Windows 能用吗？

A: 当前实测重点为 macOS（本机已完成新旧 CLI 真实数据对照、macOS 图片/视频/文件路径验证、端到端索引验证）；其他微信版本按能力矩阵逐项积累，Windows 未实测，不保证可用。

Q3: 免费吗？付费社群是必须的吗？

A: 软件 AGPL-3.0 开源免费。付费社群（Rion AI 实践与商业化 Club）是自愿加入的长期社群，README 明确”使用本仓库不需要付费入群”，社群费也不解除技术接入限制。

Q4: 和 robbin/wechat-exporter 这类聊天导出工具有什么区别？

A: wechat-exporter 偏一次性导出聊天记录为可读格式；本项目在导出之上叠加了持续性的”情报层”——索引、个性化排序、待回复/承诺/商机/复联线索追踪和交互式日报，且以 Codex Skill 为主要交互方式。

Q5: 商用需要注意什么？

A: AGPL-3.0 允许学习、运行、修改和商业使用；但分发修改版本或通过网络向用户提供修改版本时必须履行对应源码义务。需要闭源集成、OEM、白标的企业可申请单独商业授权（COMMERCIAL-LICENSE.md）。

Q6: 读不到数据时还能干什么？

A: 可以运行全虚构 Demo 验证索引、判断与报告链路；macOS 上还可读取系统保留的微信通知预览（仅入站、非完整）作为降级来源。

参考链接

• 官方仓库
• 使用教程 docs/USAGE.md
• Reader 核心说明
• 首次接入工作流 access-onboarding.md
• 商业授权 COMMERCIAL-LICENSE.md

本文基于公开资料（GitHub 官方 README）整理，AI 辅助生成，未做真实微信数据实测；采集日期 2026-09-08。功能与边界描述以官方仓库最新说明为准。