Agent 与 Skills约 11 分钟

wechat-intelligence-hub 怎么用：安装与隐私边界

Q: 不想接入真实微信，能先体验吗？

答：能。运行 run demo.sh 即可用全虚构数据体验索引、判断与报告的完整链路，这也是官方建议的第一步。

AI 指南·更新于 2026-09-18·◉ 0 浏览

想让 AI 帮你从微信聊天记录里捞出待回复、承诺和商机？wechat-intelligence-hub 把这件事做成了一个开源的本地情报系统：只读读取微信数据，生成日报、跟进提醒和检索报告，数据不出你的电脑。本文按官方 README 与 USAGE 文档的流程，把安装、接入、排障三段讲成可照做的步骤。

截至 2026 年 9 月 18 日核实：项目在 GitHub 上约 2.4k star、2.7k fork，9 次提交，最近一次提交是 9 月 11 日；首发版本仍是 v0.9.2-preview.2。

先认清它是什么：本地优先、只读优先

项目地址是 Rion-Wu-tech/wechat-intelligence-hub，Python 编写，2026 年 9 月 4 日发布首个预览版。协议是 AGPL-3.0-only，仓库里另外单独放了一份商业授权文件，需要闭源集成、专有发行、OEM 或白标的企业要单独申请，加付费社群不会自动改变许可证。

它由两个 Skill 组成，一次安装全部到位：

wechat-cli：只读 Reader 入口，负责安全地读取本机微信数据
wechat-intelligence-hub：情报工作流，把聊天记录转成日报、待回复、承诺、商机和复联线索

代码内部其实分了四层（只读 Reader 核心、wechat-cli Skill 入口、情报 Skill 的判断规则、确定性本地引擎），但对用户仍然是一套产品、一次安装。v0.9.2-preview.2 的公开接口已与旧版 wechat-cli 1.6.19 的 29 项只读工具、266 个输入字段对齐，安装时会同时装好隔离的 SQLCipher 与 Zstandard 运行依赖。

隐私设计是这个项目最值得说的部分：Reader 核心不获取密钥、不重签名、不注入、不 Hook 微信；完整数据库模式需要本人授权的本地数据库和访问材料。注意一点，安装成功不等于已能读取聊天，这是新手最容易误解的地方。

前置准备：动手前检查这四样

一台 Mac（macOS 路径最成熟，README 注明 macOS 新机器的获取路径尚未实测，不保证所有微信版本可用）
本机已登录的微信客户端
装好 Codex，本文主推用 Codex 完成接入；不熟悉 Codex 的先看站内的 OpenAI Codex 完整使用指南
本机装有 git

第一步：克隆仓库并安装

打开终端执行：

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 及其本地引擎。即使只指定其中一个，安装器也会自动补齐依赖的另一个组件，不需要手工拼装。

预期结果：脚本执行完毕，两个 Skill 装入 Codex 目录，同时把做过隐私扫描的本地引擎放进 Codex 目录，正常调用无需再配 WECHAT_HUB_HOME。

一个容易被当成故障的行为：安装器默认拒绝覆盖已有的同名 Skill。这是保护机制，不是让你删数据重装的理由，升级要按官方提示保留 key、Profile 和历史报告。

第二步：用虚构数据验证链路

接入真实微信前，先跑官方自带的虚构 Demo，确认索引、判断与报告链路都正常：

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

看到报告正常生成，说明软件本体没问题，卡住的话问题一定在数据接入环节，好定位。

第三步：接入自己的微信数据

官方推荐直接把 README 里准备好的提示词发给 Codex，由它处理依赖检查、工具准备和配置，你只需要登录微信、确认影响、完成系统授权。

喜欢手动的话，用独立命令行入口自检：

rion-wechat-cli self-test
rion-wechat-cli access-plan --pretty

access-plan 的三种状态要分清：

状态	含义	下一步
ready	已有可用配置	直接复用，不用再配
ready_to_configure	可配置	用相同输入运行 setup
needs_access	缺访问材料	不要重复跑 setup，按官方五步接入工作流准备

注意：完整历史和实时数据库读取要求有权访问的本地数据库与访问材料，且仅覆盖已同步到本机的数据。没有数据库读取条件时，系统仍可读取 macOS 保留的微信通知预览，但那只覆盖入站预览，不代表完整聊天记录。按官方 USAGE 文档，接入状态实际分三种：

完整数据库模式：在本地授权和实际兼容范围内查询历史聊天与近期新增消息。
通知预览模式：只能读取 macOS 实际保留的入站通知预览，不等于完整聊天记录。
缺少访问材料：由 Codex 按首次接入流程准备工具并请求确认；不兼容或暂不授权时可以跑全虚构 Demo，但不能假装已读取真实聊天。

第四步：初始化个人情报库

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 类，比如客户、同行、渠道，可以用 --inspect-wechat-labels 只读查看已有标签。精确关键词检索始终覆盖全部微信记录，不受标签限制。

第五步：日常使用，直接说人话

之后在 Codex 里不用记任何参数，自然语言调用即可：

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

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

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

完整日报同时输出 Markdown 版和交互式 HTML 版，官方给出的正式产物是三个：wechat_daily_full.md（Markdown 总入口）、wechat-report/（分区 Markdown）、wechat_daily_report.html（旗舰交互式报告）。HTML 版内置综合行动、群聊日报、重点联系人和商单信号雷达四个入口，支持全局搜索、分区导航、群聊筛选、明暗主题、打印和当前分区 Markdown 下载。

注意时间窗不是硬限制：24 小时、48 小时只是常用口径，实际可查询范围取决于本地已授权的数据和索引覆盖情况。

常见坑与报错速查

这一节的事实全部来自仓库当前公开的 5 个 Issue，先看现象对号入座，再决定要不要继续折腾：

现象	已知原因	处理方式
macOS 27 首次接入失败，诊断信息丢失	Issue #3：提权 TCC 预检缺失，PBKDF 副本以 root 启动	先确认系统授权窗口，别为重试直接删锁或清空配置
接入后微信打不开或被系统拦下	Issue #2：macOS 26.4 拦截 ad-hoc 影子副本，接入流程结束后微信处于关闭状态	重开微信并确认系统对副本放行，涉及重签名先备份
提示无法绑定微信	Issue #75：多为目录或权限、多账号、版本兼容问题，不一定是 key 错	让 Codex 跑 self-test 与 access-plan，先定位再修复
更新后提示未知命令	仍在调用旧运行时或旧 Skill	核对 Skill 路径与 CLI 运行时，不要重新取 key
换了新版微信后读不到	数据库兼容性随微信版本变化	按官方能力矩阵逐项核对，先跑 access-plan

上面这张表也解释了一个动作原则：失败后不要无限重试，也不要为了重试直接删锁、清空配置或删除旧 key。管理员密码只在系统授权窗口里输入。

诊断状态码怎么读

如果你走命令行排障，会看到一串英文状态码。官方 USAGE 文档给出的处理对照如下，比反复重装靠谱得多：

ready：复用配置，按需要抽检，不重新取 key。
ready_to_configure：用同一组已验证输入执行 onboard --apply 再验收。
dependency_required：找到实际 CLI 运行环境修复依赖，别在无关 Python 环境反复安装。
needs_database_location 或 account_selection_required：核对本机登录与目录，多账号由用户选择，不能混读。
needs_access 或 provider_required：按首次接入工作流准备固定版本工具。
provider_review_required 或 authorization_required：完成来源核验或等待用户确认，检查成功不等于已获授权。
partial 或 scan_incomplete：说明缺失范围后按原因修复，不要宣称已读到完整历史。
existing_configuration_requires_review 或 verification_failed：保留原配置，核对材料与版本兼容性，不自动覆盖。

如果你的目的是让 AI 帮你处理这些判断，官方也准备了现成提示词，直接交给 Codex 让它诊断即可，不需要自己猜是不是 key 错了。

隐私边界与风险：动手前必读

这部分比功能更重要，逐条核对自官方 README：

只读是核心承诺：Reader 不获取密钥、不重签名、不注入、不 Hook 微信
实验性接入助手有独立授权和副作用边界，可能重启微信或处理重签名副本，执行前会说明影响并要求确认
数据本地处理：本地引擎随安装放进 Codex 目录，正常调用无需额外配置引擎路径
千万不要把 key、密码或数据库发给维护者、社群或 Issue；反馈只给脱敏后的版本号、固定错误码和所处步骤
项目处于 preview 阶段，微信版本兼容按能力矩阵逐项积累，接入前做好备份

关于花钱这件事要分清：软件本身免费开源，仓库里出现的付费社群、AI 指导、企业培训、定制与商务合作都是单独收费的服务，不买也能用。社群费不是软件购买费，也不会解除技术接入限制。

对 Skill 体系不熟悉的读者，可以先看站内的 Codex Skill 安装教程和 DeepSeek Harness 插件配置指南，理解 Skill 的工作方式后再动手；

想对比另一个本地 Agent 体系，可以看 OpenClaw 能做什么。

常见问题

wechat-intelligence-hub 免费吗？可以商用吗？

答：软件免费开源，协议是 AGPL-3.0-only，个人自用和商业活动都可以；但对外分发修改版或通过网络提供修改版时要履行 AGPL 的源码等义务。不想承担 AGPL 义务、需要闭源集成或白标发行的企业，要单独申请商业授权。

我的聊天记录会被上传到服务器吗？

答：不会。系统是本地优先设计，检索、统计和报告都在本机引擎完成，聊天数据不出你的电脑；个人 Profile、联系人和生成报告官方也明确要求不要提交到 Git。

不支持我的微信版本怎么办？

答：v0.9.2-preview.2 已覆盖旧版接口、schema-2 salt-key 授权导入和 WCDB 压缩消息，其他版本按能力矩阵逐项积累。建议先跑 access-plan 看本机属于 ready、ready_to_configure 还是 needs_access 哪种状态，再决定下一步。

必须用 Codex 吗？

答：不必须。Codex 只是官方推荐的自然语言入口，rion-wechat-cli 提供独立命令行，可以脱离 Codex 单独使用。

不想接入真实微信，能先体验吗？

答：能。运行 run_demo.sh 即可用全虚构数据体验索引、判断与报告的完整链路，这也是官方建议的第一步。

付费社群必须加吗？

答：不是。使用本仓库不需要付费入群，社群、AI 指导和企业培训都是自愿且单独收费的服务，不加入不影响工具功能。