AB
AiBoss
project

WeChatBridge - 把微信聊天记录直接转发进 AI Agent 与本地知识库的 macOS 工具

WeChatBridge(微信流)是一个面向 macOS 的原生微信聊天记录转发与归档工具,由 freestylefly 维护,MIT 许可。它补齐微信「转发到其他应用」的入口层,让一次合并转发直接抵达 Codex、Claude、豆包、千问办公、Obsidian 等目标,聊天内容全程留在本机。

WeChatBridge(中文名「微信流」)是一个面向 macOS 的原生微信聊天记录转发与归档工具,由 freestylefly 维护,采用 MIT 许可证。据项目自述,它要解决的问题是:macOS 微信从 4.1.13 起支持把多选聊天记录「合并转发」给第三方应用,微信会生成一份包含 TXT、图片和视频的 ZIP,这份归档天然适合交给 AI Agent 处理,也适合沉淀进本地知识库;但系统的「转发到其他应用」列表只展示带有 Share Extension 的 App,于是微信流补齐了这层入口。它适合经常把微信群聊内容整理给 AI 处理、或希望把聊天记录归档进 Obsidian 这类本地笔记系统的 macOS 用户。

维护者与状态

项目由 freestylefly 维护,仓库创建于 2026-09-21,最后提交时间为 2026-09-29。最新 release 为 v0.1.14,发布于 2026-09-22。截至 2026-09-29,仓库星标数为 908。项目另有官网页面可访问。

主要能力

以下能力均来自项目自述(README 与产品说明),并非第三方评测结论。

  • 九个原生入口:据项目说明,用户可以在微信转发菜单里直接选择目标,无需先打开微信流主窗口。
  • AI Agent 转发:项目自述会激活目标 App、附加场景指令并自动粘贴聊天归档。内置入口包括发给 Codex、Claude、豆包、千问办公、WorkBuddy、WeSight。
  • Obsidian 沉淀:README 中称可生成 Markdown 笔记、保存原始 ZIP,并按聊天名组织内容。
  • 自定义目标:支持添加任意 macOS 应用,终端类应用可只接收文件路径。
  • 场景与技能:可为不同群聊保留场景提示词,并管理兼容 Agent 的 SKILL.md。
  • 本地记录:可查看批次状态、重新发送、复制、定位文件和清理历史。
  • 失败兜底:据项目说明,目标未安装或权限不足时,文件仍会保留在剪贴板。
  • 双语界面:完整支持简体中文与 English。

在隐私设计上,项目自述其处理边界为:聊天内容只来自微信主动导出的文件;不读取微信数据库,不解密、不注入、不修改微信进程;聊天归档、场景和记录保存在本机;Share Extension 在 macOS 沙盒中运行且没有网络权限;屏幕录制权限只用于识别微信标题栏中的聊天名,图像仅在内存中处理;辅助功能权限只用于激活目标应用和执行粘贴。项目还说明自动更新机制预留给 GitHub Releases,当前源码配置尚未启用自动检查。

使用入口

仓库地址:https://github.com/freestylefly/WeChatBridge;官网:https://render.qmuse.pub/p/muse/2413870555736078/index.html。

据项目说明,安装方式为前往 GitHub Releases 下载最新 DMG,打开后将「微信流」拖入「应用程序」,安装包同时支持 Apple Silicon 和 Intel Mac。从源码构建的流程如下:

git clone https://github.com/freestylefly/WeChatBridge.git
cd WeChatBridge
swift test
CONFIG=release Scripts/make-app.sh

构建产物位于 dist/微信流.app。安装到当前用户的「应用程序」目录并注册分享扩展:

Scripts/install-dev-build.sh

随后打开「微信流 → 设置 → 入口」启用需要的分享入口,也可以前往「系统设置 → 通用 → 登录项与扩展 → 共享」管理它们。项目自述还提供了若干开发与验证命令,例如运行测试的 swift test、校验中英文资源的 swift Scripts/check-localizations.swift、检查签名与发布配置的 Scripts/check-release-config.sh。

许可与限制

许可证为 MIT。使用前需要留意项目自述的系统要求与边界:需要 macOS 14 Sonoma 或更高版本;需要 Xcode 16 或兼容 Swift 6 的 Command Line Tools;使用自动粘贴时需要在系统设置中授予辅助功能权限;使用聊天名识别时需要授予屏幕录制权限。项目还提示,本地构建会优先使用钥匙串中的 Apple Development 或 Developer ID 签名,没有可用证书时会使用 ad-hoc 签名,macOS 可能要求重新授予辅助功能权限。此外,README 的路线图中 Homebrew Cask 与更多社区场景、技能包仍标记为未完成项。