wx-cli-again:如何快速检索本地公众号推送并批量提取文章链接(完整指南)

原创2026-10-24 14:19:041,743 阅读

wx-cli-again:如何快速检索本地公众号推送并批量提取文章链接(完整指南)

wx-cli-again 是一款开源的微信本地数据命令行工具(WeChat local data CLI),支持查询、解密与导出本机微信数据。本文将带你用它内置的 biz-articles 命令,3 步快速检索本地公众号文章推送,并一键批量提取文章链接,全程无需手动翻数据库。

一、痛点:公众号文章为什么难找?

如果你关注了几十个公众号,想回头找某篇推送,通常只能:

  • 打开微信逐个公众号翻聊天记录;
  • 或者用"搜一搜",但范围仅限你微信里手动存过的内容。

其实,所有公众号文章推送早已落盘在你的微信本地数据库中(独立存储在 biz_message_*.db 分片里)。wx-cli-again 能直接解密这些分片,把它们变成可以过滤、排序、管道处理的文本数据——这才是"本地推送检索"最快的姿势。🎯

二、工具亮点:为什么选 wx-cli-again?

亮点 说明
⚡ 毫秒级响应 后台 daemon 持久缓存解密数据库,重复查询无需重新解密
🔒 完全本地 数据不出本机,实时按需解密,无需全量预导出
📦 零依赖安装 单一 Rust 二进制,一行命令装完
🤖 机器友好 支持 --json 输出,方便用 jq 批量处理

架构上,wx 命令行通过 Unix socket 与后台 wx-daemon 通信,daemon 负责解密与查询,首次调用自动启动,日常查询连微信都不用开着。

三、快速上手:安装与初始化

1. 从源码构建

git clone https://gitcode.com/gh_mirrors/wx/wx-cli-again
cd wx-cli-again
cargo build --release

构建后将 target/release/wx 放入 PATH(Windows 为 wx.exe)。仓库内也提供了 install.sh 与 install.ps1 脚本备用,配置样例见 config.example.json。

2. 一次性初始化(取密钥)

保持微信 4.x 已登录,在本机终端执行(macOS / Linux 需要 sudo):

sudo wx init

💡 macOS 注意:不需要关闭 SIP,也不需要重签微信;系统若提示授予"开发者工具"权限,允许即可。

若提示缺分片密钥,执行 sudo wx key extract --hook-seconds 90,等待期间在微信里点开相关聊天。

3. 验证

wx doctor       # 密钥 / 分片 / SQLCipher 健康检查
wx sessions     # 能看到最近会话即正常

四、一键检索:查询本地公众号推送

公众号文章推送存在独立的 biz_message_*.db 分片,用专门的 biz-articles 命令查询(默认输出 YAML,人类可读):

wx biz-articles                              # 最近 50 篇
wx biz-articles -n 200                       # 取更多
wx biz-articles --account "返朴"             # 按公众号名模糊匹配
wx biz-articles --since 2026-05-01 --until 2026-05-10   # 时间范围
wx biz-articles --unread                    # 只看未读公众号,每号取最新 1 篇

📌 常用参数速记:

参数 作用
-n / --limit 返回条数,默认 50
--account 限定公众号(名称模糊匹配)
--since / --until 发布时间窗口(YYYY-MM-DD)
--unread 仅未读公众号,每号取最新 1 篇,适合"今天有什么新推送"扫描
--json JSON 输出,供脚本消费

多图文推送(一条消息带多篇)会被自动展开成多行,每行一篇,不会漏。

五、批量提取文章链接:3 行命令搞定

每条结果自带完整字段:account(公众号名)、account_username(gh_* 账号)、title、url(mp.weixin.qq.com 原文链接)、digest(摘要)、cover_url(封面图)、time / timestamp(发布时间)、recv_time_str(微信接收时间)。

批量提取链接只需管道接 jq:

wx biz-articles --json | jq '.[].url'

再进阶一点,把"链接 + 标题 + 公众号"导出成 TSV 清单,方便丢进 RSS 阅读器或知识管理软件:

wx biz-articles -n 200 --json \
  | jq -r '.[] | [.account, .title, .url] | @tsv' \
  | tee articles.tsv

想只抓某个号最近一周的推送?加过滤即可:

wx biz-articles --account "返朴" --since 2026-05-17 --json | jq '.[].url'

检索与提取均在本地完成,毫秒级返回;daemon 会缓存解密结果,mtime 不变则直接复用,二次查询几乎零等待。

六、常见问题 FAQ

问题 处理
提示"无法解密任何 biz_message_*.db" 密钥缺失,跑 sudo wx key extract --hook-seconds 90,等待时点开公众号聊天
结果疑似不全 / 有 unknown_shards 警告 同样先补密钥,再执行 wx doctor 复查
默认只出 50 篇? -n 只是默认值不是硬上限,wx biz-articles -n 2000 即可
daemon 无响应 wx daemon stop,下次查询会自动重启

更多细节可查阅仓库 README.md 与 SKILL.md(含命令速查表),macOS 权限问题见 docs/macos-permission-guide.md。

七、源码导航:功能都藏在哪?

模块 说明
src/cli/biz_articles.rs biz-articles 命令入口,组装请求并打印结果
src/cli/mod.rs 子命令参数定义(-n / --account / --since 等)
src/daemon/query.rs 核心查询逻辑 q_biz_articles:扫分片、解析 XML、排序、去重
src/daemon/server.rs daemon 端请求分发
docs/old-main-port-audit.md biz-articles 等功能的移植审计记录

工作原理一句话:daemon 逐个打开 biz_message_*.db 分片中的 Msg_<hash> 表,按 local_type = 49(appmsg 公众号文章)过滤,解压消息体解析 XML,按发布时间倒序输出——所以"检索本地推送"本质上就是对解密后数据库的精确查询,比微信自带的翻记录快得多。🚀

结语

wx-cli-again 把"本地公众号推送"从"翻聊天记录"变成了"一条命令的事":wx biz-articles 负责检索,--json | jq 负责批量提取链接。适合内容收藏党、RSS 玩家和做数据研究的同学。

⚠️ 免责:本工具仅用于学习和研究目的,用于处理自己的微信本地数据,请遵守相关法律法规,不得用于未经授权的数据访问。

登录后查看全文
wx-cli-again