WeChatBridge（微信流）

从微信转发菜单，把聊天记录送进 AI Agent 与本地知识库。

原生、轻量、完全本地的 macOS 微信聊天记录转发与归档工具。

简体中文 · English

官网 · render.qmuse.pub

macOS 微信 4.1.13 起，多选聊天记录后可以“合并转发”给第三方应用。微信会生成一份包含 TXT、图片和视频的 ZIP，天然适合交给 AI Agent 处理，也适合沉淀进本地知识库。

系统的“转发到其他应用”列表只展示带有 Share Extension 的 App。微信流补齐这层入口，让一次转发直接抵达 Codex、Claude、豆包、千问办公、WorkBuddy、WeSight、DeepSeek Harness、Obsidian、剪贴板或你指定的其他应用。

flowchart LR
    A[微信多选聊天记录] --> B[合并转发]
    B --> C[WeChatBridge Share Extension]
    C --> D[AI Agent]
    C --> E[Obsidian]
    C --> F[剪贴板]
    C --> G[自定义应用]

需要整理超过 100 条时，每批在微信手动选取并分享到「分批收集到微信流」。浮条显示已收批次和上一批首尾参考；收齐后点击「完成并发送」。原始图片、视频保留在 ZIP 中，未完成的收集可在记录页继续，失败可重试。微信的单次多选上限保持不变。

在微信「转发到其他应用」里直接选择目标，不需要先打开微信流主窗口：

入口开关	场景化
十二个入口随时开关，未安装的应用直接标注	场景保存提示词与适用 Agent，转发时挑一个
技能中心	沉淀到 Obsidian
给 Agent 装上能力包，群里的链接和视频都能读	笔记保留原始归档，附件按微信样式渲染

完整操作步骤、权限说明和常见问题见 使用指南。

微信流的处理边界保持清晰：

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

更完整的能力边界见 产品能力文档。

• macOS 14 Sonoma 或更高版本
• Xcode 16 或兼容 Swift 6 的 Command Line Tools
• 使用自动粘贴时，需要在系统设置中授予辅助功能权限
• 使用聊天名识别时，需要授予屏幕录制权限

前往 GitHub Releases 下载最新 DMG，打开后将“微信流”拖入“应用程序”。安装包同时支持 Apple Silicon 和 Intel Mac。

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

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

Scripts/install-dev-build.sh

随后打开“微信流 → 设置 → 入口”，启用需要的分享入口。也可以前往“系统设置 → 通用 → 登录项与扩展 → 共享”管理它们。

macos/                  # macOS 端 — 完整 SwiftPM 包
├── Sources/
│   ├── WeChatBridgeApp/      # 主应用、设置、转发编排与权限管理
│   ├── WeChatBridgeCore/     # 批次、场景、归档和剪贴板核心逻辑
│   └── WeChatBridgeShare/    # macOS Share Extension
├── Resources/          # 图标、Plist、entitlements、本地化与 DMG 素材
├── Scripts/            # 构建、安装、签名和发布脚本
└── Tests/              # Swift Testing / XCTest 测试

windows/                # Windows 端 — .NET WPF 解决方案
├── src/WeChatBridge.Windows/        # 主程序（WPF）
├── src/WeChatBridge.Windows.Core/   # Inbox 契约、投递、场景、技能（无 UI 依赖）
├── src/WeChatBridge.ShareTarget/    # Windows Share Target 助手
├── packaging/SparsePackage/         # 稀疏包 MSIX（Share Target 注册）
├── scripts/            # 打包与开发注册脚本
└── tests/              # xUnit 测试

shared/                 # 两端共用的资产与契约
├── AppLogos/           # 各 Agent 的 logo（两端 UI 都用）
├── Design/             # 品牌源图与图标生成基准
├── Screenshots/        # macOS 截图（Windows 视觉移植的对照基准）
├── Skills/             # 技能目录与技能包
└── README.md           # Inbox 共享契约 + 文件级端口对照表

site/                   # Sparkle 更新源与版本说明

项目使用 Swift Package Manager 管理 macOS 源码和 Sparkle 依赖。macos/Scripts/make-app.sh 会把主程序与十二个 Share Extension 组装成完整的 .app。Windows 侧见 windows/AGENTS.md 与 windows/docs/README.zh-CN.md。

# macOS（在 macos/ 目录下运行）
cd macos
swift test                                    # 运行测试
swift Scripts/check-localizations.swift       # 校验中英文资源
Scripts/check-release-config.sh               # 签名 / Bundle ID / App Group 检查
Scripts/dev-preview.sh                        # 构建、安装并打开开发版本

# Windows
dotnet test windows/WeChatBridge.Windows.sln -c Release

欢迎提交 Issue 和 Pull Request：

1. 先查看 Issues 中是否已有相关讨论。
2. Fork 仓库并从 main 创建功能分支。
3. 保持改动聚焦，为行为变化补充测试。
4. 提交前运行 swift test 和本地化检查。
5. 在 Pull Request 中说明动机、验证方式与界面变化。

涉及安全问题时，请通过 GitHub 的 Security Advisories 私下报告，避免在公开 Issue 中附上敏感细节。

• 微信原生合并转发接入
• Codex、Claude、豆包、千问办公、WorkBuddy 与 WeSight
• Obsidian 本地归档
• 场景提示词与技能管理
• Universal 2 构建、签名与公证流程
• 首个公开 DMG Release
• Homebrew Cask
• 更多社区场景和技能包

欢迎加入 WeChatBridge 交流群，与开发者和社区用户交流使用经验、反馈问题与分享工作流。

_{使用微信扫码加入交流群}

关注项目动态、使用交流与后续更新，可通过微信搜索“向明”或“苍何”联系我们。

向明	苍何

WeChatBridge 使用 MIT License 发布。

• Dukou（渡口）：微信流基于该项目二次开发。
• Sparkle 提供安全的 macOS 应用更新能力。
• 感谢所有参与测试、提出建议和贡献代码的朋友。