WeFlow CLI 把微信变成你的本地第二大脑：在本机读取和查询聊天记录、导出可读 HTML；把公众号文章整理成带 AI 摘要的日报；读取微信收藏；构建可语义搜索的知识库；并通过 MCP 接入 Claude Code 等 AI 编辑器。支持 Windows 与 Linux。
🔒 本地优先：完全在你的电脑上运行——零遥测、零云上报；数据库密钥以机器绑定的 AES-256-GCM 加密存储在本机。AI 功能仅在显式配置你自己的 API Key 后启用。详见安全与隐私声明。
本项目仅限于处理你有权访问的数据。请遵守适用法律、微信规则和他人的隐私边界。
⚠️ 使用边界与风险：仅在你本人控制的设备上，处理你本人拥有或明确获授权访问的数据。请勿将本项目用于监控、跟踪或读取他人的微信数据，也不要部署到他人设备或远程静默运行。使用前请自行确认适用法律、微信服务条款及账号权限；第三方工具可能触发账号风控、限制或封禁。本项目不构成法律意见，使用者需自行承担使用责任。
微信收藏查询（读取本地 favorite.db，支持类型过滤与关键词搜索）：
$ weflow-cli fav list -n 3
收藏列表 (共 1042 条, 显示 3 条):
[2026/8/21 19:42:42] [文章] “豆包型人格”爆火，可千万别学
来源: 中国研究生
https://mp.weixin.qq.com/s/eDk_kcyd8ltuqn6J3iReVg
[2026/8/21 10:50:38] [文章] 爆火插件让DeepSeek V4 Pro 0813性能拉满，全面超越 Fable 5！
来源: 智猩猩AI
https://mp.weixin.qq.com/s/3GXFjmtUsq42sXJHJGgwyg
[2026/8/21 10:47:21] [文章] 250年前，一个26岁年轻人写了一本小册子，至今仍在拷问每一个文明社会
来源: 悦读撷英
https://mp.weixin.qq.com/s/YIkB8TyyyimPP1hmgQQPZg
完整工作流，一条命令一个环节：
weflow-cli sessions # 会话列表
weflow-cli messages "联系人" -n 20 # 查询聊天消息
weflow-cli export "联系人" html # 导出 HTML / Excel / Markdown / JSON
weflow-cli fav list -t article -k AI # 微信收藏: 类型过滤 + 关键词搜索
weflow-cli daily --date 2026-08-21 # 公众号日报 + AI 摘要与分类
weflow-cli daily-server # 本地阅读器 http://localhost:8765
weflow-cli chat "RAG 的原理是什么?" # 知识库 RAG 问答
weflow-cli mcp-config # 一键接入 Claude Code 等 MCP 客户端
| 能力 | Windows | macOS | Linux |
|---|---|---|---|
| 数据目录自动发现 | ✅ | ✅ | ✅ |
| 本地数据初始化 | ✅ 自动发现/验证 | ❌ 需手动提供凭据 | |
| 聊天记录查询（NT / 本地数据库） | ✅ | ✅ | ✅ |
| WCDB 数据服务（联系人昵称等） | ✅ | ||
| 公众号日报 / 知识库 / MCP | ✅ | ✅ | ✅ |
macOS：当前不提供自动初始化；如你已通过官方或其他经授权的方式取得本地数据访问凭据，请按 weflow-cli init --path 和 config 的帮助完成配置。
# 1. 安装 sqlcipher 开发库（编译 sqlcipher3 需要）
sudo apt install libsqlcipher-dev
# 2. 安装 Python 依赖
pip3 install --user sqlcipher3 cryptography html2text zstandard
# 3. 安装 CLI 并初始化
npm install -g weflow-cli
weflow-cli init # 按提示完成本地初始化Linux 的自动初始化能力取决于微信发行版、Python 依赖和当前用户权限；请先运行 weflow-cli check，按系统安全策略配置，不要为了排障降低整机权限。
| 场景 | 能力 |
|---|---|
| 聊天记录 | 查询会话、联系人和消息；导出 JSON、TXT、Markdown、HTML、Excel。 |
| 公众号日报 | 抓取文章、AI 摘要与分类、生成本地阅读页，保留收藏和已读状态。 |
| 个人知识库 | 同步微信读书笔记、构建 Obsidian Vault、语义搜索、RAG 问答和概念 Wiki。 |
| AI 协作 | 通过 MCP 把文章、知识库、日报和受控的本地数据能力交给兼容客户端；工具清单以 weflow-cli mcp-config 和 docs/MCP.md 为准。 |
| 个人回顾 | 聊天月报、年度报告、待办提取与朋友圈本地缓存查询。 |
| 微信收藏 | 读取微信"收藏"内容（公众号文章、文字、图片、视频、聊天记录），支持类型过滤、关键词搜索与 Markdown/JSON 导出。 |
| 第二大脑 Agent | 在微信里和本地 AI 助手对话：自然语言查询聊天记录、收藏、朋友圈、日报、微信读书、待办与知识库；三层记忆跨会话延续，守护进程常驻后台。 |
⚠️ 合法使用边界：本工具仅限访问你自己拥有并登录的微信账号在自己设备上的数据。未经他人明确同意，不得用它监控配偶、员工或任何第三方，也不得部署到他人设备或远程静默运行。请同时留意微信服务条款、账号风控和当地法律要求。详见 SECURITY.md。
npm 包与 GitHub 发布分开进行；需要最新修复时，请先确认 npm 包版本，或直接使用 GitHub
master分支代码。
需要 Node.js 18+、Python 3.10+，以及已登录的 Windows 微信。安装后先检查本机环境：
npm install -g weflow-cli
weflow-cli check安装标准 Windows 4.x 工作流所需的 Python 依赖：
python -m pip install -r requirements.txt若仍在使用微信 3.x，再安装可选依赖：python -m pip install -r requirements-3x.txt。
关闭微信后运行初始化，按提示启动并登录微信，CLI 会尝试发现数据目录并提取所需密钥：
weflow-cli init微信“存储位置”、账号目录和其 db_storage 目录都可以直接指定：
weflow-cli init --path "D:\WeChat\xwechat_files"初始化完成后，先验证是否能读取到自己的数据：
weflow-cli sessions
weflow-cli contacts -k "关键词"
weflow-cli messages "联系人" -n 10遇到密钥、数据库或 Python 环境问题，请按 操作与排障手册 逐项检查。
导出一段聊天记录
weflow-cli export "联系人" html --output ./output生成当天公众号日报
weflow-cli daily --date 2026-08-12 --api-key "你的 DeepSeek API Key"
weflow-cli daily-server --date 2026-08-12
# 仅预览指定日期的文章，不调用 AI、不写入日报
weflow-cli daily --date 2026-08-12 --dry-run
# 单次生成日报时关闭所有 AI，仍保留抓取、HTML 和本地索引
weflow-cli daily --date 2026-08-12 --no-ai
# 查看最近 30 天各公众号的推送与日报处理频率
weflow-cli daily-stats --days 30 --limit 30
# 只生成指定公众号的日报（可重复，也可用逗号分隔）
weflow-cli daily --source "公众号A" --source "公众号B"
weflow-cli daily --source "公众号A,公众号B"
# 持久化日报来源；留空则恢复为全部公众号
weflow-cli config set dailySources "公众号A,公众号B"
# 持久化关闭日报 AI；恢复为 true 即重新启用
weflow-cli config set dailyAiEnabled false
weflow-cli config set dailyAiEnabled true
# 为来源设置固定类别；已分类来源只生成摘要，不再调用文章主题分类
weflow-cli config set dailySourceCategories '<JSON object: source name or gh_ ID -> AI/政治/学术/新闻/文学/投资>'阅读器默认在 http://localhost:8765/ 提供服务。
接入 AI 编辑器
weflow-cli mcp-config > .mcp.json将生成的配置放到所用 MCP 客户端的配置位置后重启客户端即可。MCP 的工具列表与配置方式见 weflow-cli mcp-config 输出。
除知识库类工具外，MCP 也暴露受控的本地微信数据能力（会话、聊天记录、收藏、朋友圈、日报、微信读书、待办、知识库与助手记忆）。工具清单以当前代码和 MCP 集成指南 为准，不固定写死数量。
在微信里挂一个本地 AI 助手（第二大脑）
weflow-cli config set deepseekApiKey "sk-..." # 或任意 OpenAI 兼容端点: aiBaseUrl + aiModel
weflow-cli login-wechat # 扫码绑定消息通道 (微信里会出现 ClawBot 联系人)
weflow-cli assistant start # 后台守护进程常驻之后在手机微信的 ClawBot 对话里直接说话，助手会自动查询本地聊天记录和收藏作答，并具备跨会话记忆：
- 「我最近都在忙什么？」— 自动检索会话与聊天记录综合回答
- 「总结我和 XX 的聊天」— 定向读取与某联系人的消息
- 「收藏里有哪些关于 AI 的文章？」— 搜索微信收藏
- 「这篇收藏讲了什么？」— 抓取收藏文章正文并总结
- 「最近朋友圈都发了啥？」「谁最爱发朋友圈？」— 朋友圈时间线与统计
- 「今天公众号推了什么？有哪些 AI 类的？」— 日报查询，按分类/关键词过滤
- 「我在读什么书？」「XX 这本书的笔记」— 微信读书书架与笔记本
- 「我有什么待办？有急事吗？」— 待办清单（按紧急度排序）
- 「知识库里怎么讲 RAG 的？」— 概念 Wiki 检索
- 「记住：我的项目叫 weflow-cli」— 写入长期记忆
运行机制：守护进程通过微信官方 Bot 通道（iLink）长轮询收发消息，Agent 循环、三层记忆（工作窗口 / 滚动摘要 / 长期事实）、数据库查询全部在本机执行；仅最终提问与回复文本会发送给所配置的 LLM，工具输出中的电话/邮箱/链接等 PII 默认自动脱敏（config set assistantPrivacy strict 可加强，ollama 本地引擎则完全不出网）。会话 24 小时未活跃需重新扫码，单窗口内主动回复有官方条数限制。
成本护栏：内置每日 100 条处理上限（防异常流量烧钱，微信内发「记忆」可查用量）；助手默认拒绝所有来信，必须明确配置白名单后才会触发 AI 调用：
weflow-cli config set assistantWhitelist "你的@im.wechat ID" # 未设置 = 拒绝所有人群聊功能目前取决于微信官方 Bot 通道是否返回明确的群事件；本项目不会通过客户端自动化或非官方协议强行入群。若上游未来提供群 ID、发送成员 ID 与 @ 提及字段，群消息仍默认拒绝，必须同时设置群白名单、成员白名单并保留 @ 门槛：
weflow-cli config set assistantGroupWhitelist "群聊ID"
weflow-cli config set assistantGroupRequireMention true仅当官方通道实际送来群事件时，上述配置才会生效；当前 ClawBot 私聊能力不受影响。
常用管理命令：weflow-cli assistant status / log / stop；微信内发送「帮助」查看助手指令。
| 目标 | 命令 |
|---|---|
| 检查环境与配置 | weflow-cli check · weflow-cli config show |
| 初始化或手动指定路径 | weflow-cli init [--path <目录>] |
| 浏览聊天数据 | weflow-cli sessions · weflow-cli messages <联系人> · weflow-cli contacts |
| 导出聊天记录 | weflow-cli export <联系人> <json|txt|md|html|excel> |
| 公众号日报与阅读器 | weflow-cli daily · weflow-cli daily-server · weflow-cli review |
| 朋友圈缓存 | weflow-cli sns timeline · weflow-cli sns users · weflow-cli sns stats |
| 微信收藏 | weflow-cli fav list · weflow-cli fav export markdown · weflow-cli fav set-key |
| 微信读书 | weflow-cli weread shelf · notes · search · stats |
| 知识库 | weflow-cli vault · weflow-cli wiki · weflow-cli search <query> · weflow-cli chat |
| 总结与任务 | weflow-cli report · annual-report · todos |
| 第二大脑助手 | weflow-cli assistant start · status · log · stop |
| AI 编辑器集成 | weflow-cli mcp-config |
运行 weflow-cli <命令> --help 可以查看某个命令的完整参数。例如：
weflow-cli export --help
weflow-cli daily --helpgit clone https://github.com/zhuobichen/weflow-cli.git
cd weflow-cli
npm install
npm run build
npm run dev -- check
npm run dev -- init主要 Python 工作流：
# 文章抓取 -> AI 分类 -> HTML 阅读页 -> Wiki / 学习日报
python scripts/pipeline.py --date YYYY-MM-DD --api-key "你的 API Key" --engine deepseek
# 分步运行
python scripts/biz_daily.py --date YYYY-MM-DD --api-key "你的 API Key"
python scripts/generate_html.py --date YYYY-MM-DD
python scripts/fav_server.py --date YYYY-MM-DD
项目分为四个边界清晰的部分：
| 目录 | 职责 |
|---|---|
bin/ |
Commander CLI 入口与交互流程。 |
src/core/ |
微信数据目录发现、密钥、NT/WCDB/SQLCipher 数据库访问。 |
src/services/ |
聊天、联系人、导出、配置、消息通道等业务能力。 |
scripts/ |
公众号日报、阅读器、知识管道、报告和搜索等 Python 工作流。 |
mcp-server/ |
供 MCP 客户端调用的 stdio 服务。 |
查看更完整的模块关系与数据流，请阅读 ARCHITECTURE.md。
- 数据库、密钥配置和导出文件默认保留在本机；密钥字段以机器绑定的加密形式存储。
- 涉及 DeepSeek、公众号抓取、微信读书或 MCP 的联网请求仅在你执行相应工作流时发生。
- 使用
whitelist、blacklist和audit管理或审计消息发送；发送前请确认目标联系人与内容。 - 升级微信、切换账号或迁移电脑后，可能需要重新初始化或扫描 NT 密钥。
init会先验证已有本地配置；验证通过时不再重复捕获密钥。仅在迁移、切换账号或访问失败后使用weflow-cli init --refresh。- 测试首次初始化或密钥失效时，优先使用
weflow-cli init --test-missing-keys；它只在本次运行模拟密钥缺失，不改动已保存配置。实际密钥失效时可使用weflow-cli config forget-keys，该命令仅清除数据库访问密钥并要求确认。 - 不指定日期运行
weflow-cli daily时，会先检查昨天的日报产物；昨天缺少README.md、文章索引或index.html时，会先补齐昨天，成功后才生成今天。指定--date或使用--dry-run时不执行补日报。
- 操作与排障手册：初始化、NT 密钥、环境问题和常见错误。
- 跨电脑部署指南：从新 Windows 电脑完成完整安装。
- MCP 集成指南：客户端配置、工具范围与安全边界。
- 详细架构说明：模块、数据流与实现边界。
- 项目维护状态：当前能力、限制、优先级与交接入口。
- 技术决策记录：长期维护中的关键设计取舍。
- 电子数据证据指南：证据保全、法律边界与使用注意事项。
- 贡献指南 与 安全策略：开发、反馈和敏感问题处理。
- 变更记录：版本更新摘要。
- GitHub Issues：请附上脱敏后的命令输出、操作系统、微信版本和复现步骤。
项目借鉴或使用了 WeFlow、koffi、ExcelJS、Scrapling 等优秀项目。
采用 MIT License 发布。