WeChatBridge README

The project's README from github.com/freestylefly/WeChatBridge. As one markdown file: README.md.

WeChatBridge（微信流）

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

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

简体中文 · English

官网 · render.qmuse.pub

[!NOTE] 已发布经过 Developer ID 签名和 Apple 公证的 WeChatBridge 0.1.14 DMG。

为什么做微信流

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

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

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

核心能力

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

内置转发入口

入口	行为
发给 Codex	激活 ChatGPT/Codex 并粘贴聊天归档
发给 Claude	激活 Claude 并粘贴聊天归档
发给豆包	激活豆包并粘贴聊天归档
发给千问办公	激活千问办公并粘贴聊天归档
发给 WorkBuddy	激活 WorkBuddy 并粘贴聊天归档
发给 WeSight	激活 WeSight 并粘贴聊天归档
沉淀到 Obsidian	创建 Markdown 笔记并保存原始附件
复制到剪贴板	保留文件，交给用户手动粘贴
发送到自定义	转发到用户维护的应用列表

实际效果

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

入口开关	场景化

_{九个入口随时开关，未安装的应用直接标注}	_{场景保存提示词与适用 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
swift test
CONFIG=release Scripts/make-app.sh

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

Scripts/install-dev-build.sh

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

[!TIP] 本地构建会优先使用钥匙串中的 Apple Development 或 Developer ID 签名。没有可用证书时会使用 ad-hoc 签名，macOS 可能要求重新授予辅助功能权限。

项目结构

Sources/
├── WeChatBridgeApp/      # 主应用、设置、转发编排与权限管理
├── WeChatBridgeCore/     # 批次、场景、归档和剪贴板核心逻辑
└── WeChatBridgeShare/    # macOS Share Extension
Resources/                # 图标、Plist、entitlements 与内置技能
Scripts/                  # 构建、安装、签名和发布脚本
Tests/                    # Swift Testing / XCTest 测试
site/                     # Sparkle 更新源与版本说明

项目使用 Swift Package Manager 管理源码和 Sparkle 依赖。Scripts/make-app.sh 会把主程序与九个 Share Extension 组装成完整的 .app。

开发与验证

# 运行测试
swift test

# 校验中英文资源
swift Scripts/check-localizations.swift

# 检查签名、Bundle ID、App Group 与发布配置
Scripts/check-release-config.sh

# 构建、安装并打开开发版本
Scripts/dev-preview.sh

参与贡献

欢迎提交 Issue 和 Pull Request：

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

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

路线图

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

交流群

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

WeChatBridge 微信交流群二维码

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

关于我们

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

向明	苍何

许可证

WeChatBridge 使用 MIT License 发布。

致谢

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

_{如果微信流对你有帮助，欢迎点亮 ⭐️，让更多需要本地工作流的人看到它。}

Searching Database…

1.5K ·GitHub

这是什么东西？

WeChatBridge（微信流）是一款原生、轻量的 macOS 小工具，可以把微信聊天记录转发给 AI 助手，或者归档到 Obsidian 里——全程本地运行。

它是微信里的插件，还是一个独立的软件？

是一个独立的 macOS 应用，外加九个共享扩展（Share Extensions），会注册到微信自带的“转发给其他应用”菜单里，所以你不用打开主窗口就能直接转发。

它需要什么版本的 macOS，会申请哪些权限？

需要 macOS 14 Sonoma 或更新版本。它会申请辅助功能（Accessibility）权限，用于自动粘贴到目标应用；另外只在读取微信标题栏里的聊天名称时才用到屏幕录制权限，且仅在内存中处理。

从微信的菜单里可以把聊天转发到哪里？

内置九个入口：Codex、Claude、豆包、通义千问（Qianwen Office）、WorkBuddy、WeSight、Obsidian、剪贴板，以及你自己添加的任意 macOS 应用。转发给每个 AI 助手时，它会激活目标应用，追加你选好的场景提示词，并自动粘贴聊天归档。

转发到 Obsidian 时实际保存了什么？

它会创建一篇 Markdown 笔记，连同导出的原始 ZIP 文件一起，按聊天名称归入对应的文件夹，附件会在笔记里以微信的样式展示。

场景（Scenarios）和技能（Skills）是什么？

场景是针对每个群聊设置的提示词，转发给 AI 助手时会一并附上；技能中心（Skill Center）负责管理 SKILL.md 能力包，让 AI 助手能够做到比如读取转发聊天里的链接和视频。

能用 Homebrew 安装吗？

暂时还不行——Homebrew Cask 已列入开发计划，目前获取的方式是从 GitHub Releases 下载 DMG，或者用 Swift Package Manager 通过 Scripts/make-app.sh 从源码构建。

What are similar projects?

greenbubbles, pickoo-your-favorites, claude-obsidian, open-knowledge, second-brain-os, chubbyskills, echoes-vault-codex, ambient-context

Which topics is it in?

sandboxing, obsidian, wechat, note-taking, macos-app, knowledge-base, apple-silicon, swift, utility, local-first, claude, markdown

Creator: freestylefly
Size: 31.8 MB
Stars: 1.5K
Updated: CommitOct 16
Age: 28d
Commits · 90 Days