前言¶
想查自己微信里某条消息是什么时候发的,或者统计某个群这一年的发言量,官方客户端没有提供这类入口。手动翻记录不现实,导出又只能靠截图。wechat-cli 这类 Skill 的思路是直接读本地微信的聊天数据库,把聊天记录当成一份可以查询的数据。
下面介绍的 Skill 属于社区维护(community),坐标 @user_514405d2/wechat-cli,版本 1.1.0,分类 data-analysis。线索里给出的另一个地址 user_814dbe54 与这份资料的坐标不一致,因此本文以抓取到的资料为准。两个页面本次写作时均无法访问,安装命令和配置字段在现有资料里没有给出,本文不推断,只写资料中已确认的部分。
这是什么¶
一句话定位:一个把 wechat-cli 命令行工具包装成可调用能力的 Skill,用于读取和分析本地微信的聊天记录、联系人、收藏等数据。
维护方为社区发布者 user_514405d2。它解决的问题是:当你想查看、搜索、导出或分析微信消息时,有一个统一入口,而不需要自己手工翻找。
资料中标注 requires_api_key=false,意味着使用该能力不需要额外申请密钥。
核心功能¶
根据官方简介,这个 Skill 的能力覆盖下面几项:
- 读取本地微信聊天记录、联系人、收藏等数据
- 支持 SQLCipher 数据库解密,也就是能直接打开微信那类加密过的聊天库
- 关键词搜索
- 聊天统计
- 增量新消息,只取上次之后新增的部分
- 多账号切换,本机登录过多个微信时可以分别指定
- 导出为 Markdown,或导出为单文件 HTML
前四项偏“查询”,第五项偏“持续跟进”,最后两项偏“产出”。统计和增量这两项决定了它适合做周期性核对,而不是一次性翻记录。
安装与启用¶
本次写作时,https://api.skillhub.cn/user_814dbe54/wechat-cli 和 https://www.skillhub.cn/skills/user_514405d2/wechat-cli 都无法访问,已抓取资料中也没有给出安装命令、目录路径或配置字段。因此本文不提供任何命令,避免给出无法核实的步骤。
需要启用时,建议这样做:
- 先打开上面两个地址,确认页面可访问,并记录当前发布者与版本号
- 按页面给出的安装方式操作,不要凭 Skill 名称猜测命令
- 装好后先跑一次 wechat-cli 自带的帮助输出,确认它认得到本机微信数据目录
关于 Cursor、Codex CLI、Claude Code 的差异:资料中没有任何一条信息说明这三类环境在安装或启用方式上不同,本文不做区分,也不做假设。通用 SKILL.md 格式本身不限制宿主环境,但具体怎么加载这个 Skill,必须以官方页面为准。
典型用法¶
资料中没有列出可复现的命令行示例,本文不编造参数名和输出格式。下面几类是官方简介明确支持的操作,写下来是为了说明它能落地到哪些动作上:
- 按关键词在聊天记录里搜索
- 对某个会话或某个时间段做统计
- 只拉取增量的新消息
- 在多个账号之间切换后读取
- 把结果导出成 Markdown 或单文件 HTML
实际执行时,具体命令、参数顺序和输出结构,以 wechat-cli 自身输出的帮助信息为准。先用一条最小查询验证数据库能解开,再跑统计和导出,出问题时也更容易定位是解密环节还是查询条件环节。
适用场景与注意¶
适合的场景:
- 需要按关键词回溯自己的聊天记录
- 需要对会话做量化统计,比如发言频次、活跃时间段
- 需要定期跟进新消息,而不是每次都全量扫
- 需要把聊天内容沉淀成 Markdown 或 HTML 文档
需要注意的地方:
- 数据源是本地微信客户端的数据目录。机器上没登录过对应账号、或数据目录被清理过,就读不到内容
- 涉及 SQLCipher 解密,微信版本升级可能改变数据库结构,解密或读取失败时要先确认客户端版本与数据目录是否匹配
- 聊天记录属于个人数据,导出前先想清楚落到哪里,别把含个人信息的文件直接传到不受控的位置
- 多账号切换依赖本机曾登录过这些账号,且数据仍在
结尾¶
这个 Skill 的价值在于把微信聊天记录从客户端界面里拿出来,变成可以搜索、可以统计、可以导出的数据,比手工翻记录或截图整理要省事。功能覆盖面够用,代价是它依赖本地微信数据目录,环境和版本变化会直接影响可用性。
官方地址:https://api.skillhub.cn/user_814dbe54/wechat-cli
页面地址:https://www.skillhub.cn/skills/user_514405d2/wechat-cli