WeChatBridge 是什么
WeChatBridge，中文名“微信流”，是一款原生、轻量且完全本地运行的 macOS 工具。它利用 macOS 微信 4.1.13 及更高版本提供的“合并转发”能力，把聊天记录生成的 TXT、图片和视频归档，经由系统分享扩展发送给 AI Agent、本地知识库、剪贴板或其他指定应用。
它不会读取微信数据库，也不会解密、注入或修改微信进程。聊天内容只来自微信主动导出的文件，归档、场景配置和转发记录均保存在本机。
核心功能
九个原生转发入口
安装并启用分享扩展后，可以直接在微信的“转发到其他应用”菜单中选择以下目标，无需提前打开微信流主窗口：
- 发给 Codex：激活 ChatGPT/Codex，并粘贴聊天归档。
- 发给 Claude：激活 Claude，并粘贴聊天归档。
- 发给豆包：激活豆包，并粘贴聊天归档。
- 发给千问办公：激活千问办公，并粘贴聊天归档。
- 发给 WorkBuddy：激活 WorkBuddy，并粘贴聊天归档。
- 发给 WeSight：激活 WeSight，并粘贴聊天归档。
- 沉淀到 Obsidian：创建 Markdown 笔记并保存原始附件。
- 复制到剪贴板：保留文件，由用户手动粘贴。
- 发送到自定义：转发到用户维护的 macOS 应用列表。
场景、技能与本地记录
微信流支持为不同群聊或任务保存场景提示词，并指定适用的 Agent。技能中心可以管理兼容 Agent 的 SKILL.md。主应用还会保存本地批次记录，便于查看状态、重新发送、复制内容、定位文件或清理历史。
失败兜底
如果目标应用没有安装，或者系统权限不足，微信流仍会将文件保留在剪贴板中，方便手动完成后续操作。
安装前准备
使用微信流前，请确认环境符合以下要求：
- macOS 14 Sonoma 或更高版本。
- 需要自动粘贴时，在系统设置中授予辅助功能权限。
- 需要识别微信标题栏中的聊天名时，授予屏幕录制权限。
- 如果从源码构建，需要 Xcode 16 或兼容 Swift 6 的 Command Line Tools。
屏幕录制权限只用于识别微信标题栏中的聊天名，图像仅在内存中处理。辅助功能权限只用于激活目标应用并执行粘贴。
方法一：安装发布版
打开 WeChatBridge GitHub Releases，下载最新 DMG。README 中说明已发布经过 Developer ID 签名和 Apple 公证的安装包。
打开 DMG，将“微信流”拖入“应用程序”目录。安装包同时支持 Apple Silicon 和 Intel Mac。
启动微信流，进入“设置 → 入口”。
启用需要的分享入口，例如 Claude、Codex、Obsidian 或复制到剪贴板。
如果入口没有出现在系统分享菜单中，前往“系统设置 → 通用 → 登录项与扩展 → 共享”，检查并启用对应扩展。
方法二：从源码构建
开发者可以克隆仓库、运行测试并生成发布构建：
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安装后打开“微信流 → 设置 → 入口”，启用需要的分享入口。
本地构建会优先使用钥匙串中的 Apple Development 或 Developer ID 证书。没有可用证书时会采用 ad-hoc 签名，macOS 可能因此要求重新授予辅助功能权限。
基础用法：把微信聊天发送给 AI Agent
在 macOS 微信中打开目标聊天。
多选需要处理的聊天记录，并选择“合并转发”。
进入“转发到其他应用”，选择“发给 Claude”“发给 Codex”或其他已启用的 AI 入口。
微信流接收微信生成的 ZIP 归档，其中可能包含 TXT、图片和视频。
微信流激活目标应用，附加所选场景指令，并自动粘贴聊天归档。
例如，在处理工作群讨论时，可以先创建一个“会议整理”场景，并保存类似下面的任务指令：
请根据这份聊天归档整理：
1. 已确认的决策
2. 待办事项与负责人
3. 尚未解决的问题
4. 涉及的链接和附件转发时选择该场景，即可让兼容的 Agent 按固定结构处理内容。场景提示词由用户自行维护，实际执行效果取决于所使用的目标应用和模型。
基础用法：归档到 Obsidian
确保已在微信流中启用“沉淀到 Obsidian”入口。
在微信中多选记录并执行“合并转发”。
从分享菜单选择“沉淀到 Obsidian”。
微信流生成 Markdown 笔记，并保存原始 ZIP 与相关附件。
内容会按聊天名组织，便于在本地知识库中检索和继续整理。
这种方式适合沉淀项目讨论、学习资料或群聊中的重要信息，同时保留微信导出的原始归档。
使用剪贴板和自定义目标
复制到剪贴板
如果不希望立即打开其他应用，可以选择“复制到剪贴板”。微信流会保留文件，之后可以手动切换到目标应用并粘贴。这也是权限不足或目标应用未安装时的实用兜底方案。
发送到自定义应用
内置入口之外，还可以维护自己的 macOS 应用列表。对于终端类应用，可以配置为只接收文件路径，便于把聊天归档交给现有脚本或命令行工作流。具体目标应根据本机已经安装的应用进行设置。
进阶技巧
按任务建立场景
不要为所有聊天使用同一段提示词。可以分别建立会议总结、需求分析、客户反馈、链接提取或学习笔记等场景，并为每个场景指定适用的 Agent。这样可以减少重复输入，并保持结果结构一致。
按需启用入口
九个分享入口可以独立开关。只保留日常使用的目标，可以让微信分享菜单更简洁。微信流也会标注尚未安装的目标应用，便于检查配置。
管理 Agent 技能
技能中心用于管理兼容 Agent 的 SKILL.md。如果工作流需要处理群聊中的链接、视频或特定类型资料，可以结合项目内置或自行维护的技能配置，但应先确认目标 Agent 支持对应格式。
利用本地记录重试
转发后可以在主应用查看批次状态。如果发送过程被打断，可从记录中重新发送、复制内容或定位归档文件，而不必再次从微信选择同一批消息。
定期清理历史
图片、视频和原始 ZIP 可能持续占用磁盘空间。确认重要内容已经进入知识库后，可以通过本地记录清理不再需要的历史批次。
开发与验证命令
修改源码后，可以使用仓库提供的脚本完成测试、资源校验和开发预览：
# 运行测试
swift test
# 校验中英文资源
swift Scripts/check-localizations.swift
# 检查签名、Bundle ID、App Group 与发布配置
Scripts/check-release-config.sh
# 构建、安装并打开开发版本
Scripts/dev-preview.sh项目通过 Swift Package Manager 管理源码和 Sparkle 依赖。Scripts/make-app.sh 会将主程序与九个 Share Extension 组装成完整的 macOS 应用。需要注意的是，虽然项目为 GitHub Releases 自动更新机制预留了配置，但当前源码配置尚未启用自动检查。
隐私与安全边界
- 只处理微信主动导出的聊天文件。
- 不读取微信数据库，也不执行解密、注入或进程修改。
- 聊天归档、场景和记录均保存在本机。
- Share Extension 在 macOS 沙盒中运行，并且没有网络权限。
- 屏幕录制只用于聊天名识别，图像仅在内存中处理。
- 辅助功能权限只用于激活应用和执行粘贴。
结语
WeChatBridge 把微信原生合并转发、AI Agent 和本地知识库连接成一条简洁的 macOS 工作流。普通用户可以直接安装 DMG 并启用分享入口，开发者也可以从源码构建和扩展。通过场景提示词、技能管理、自定义目标与 Obsidian 归档，可以在不读取微信数据库的前提下，更高效地处理和沉淀聊天信息。