by freestylefly
微信聊天记录一键转发到 AI Agent 与 Obsidian 的原生 macOS 工具
# Add to your Claude Code skills
git clone https://github.com/freestylefly/WeChatBridgeLast scanned: 9/23/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-09-23T09:06:39.497Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how WeChatBridge compares with popular alternatives.
WeChatBridge is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by freestylefly. 微信聊天记录一键转发到 AI Agent 与 Obsidian 的原生 macOS 工具. It has 1,379 GitHub stars.
Yes. WeChatBridge passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/freestylefly/WeChatBridge" and add it to your Claude Code skills directory (see the Installation section above).
WeChatBridge is primarily written in Swift. It is open-source under freestylefly on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh WeChatBridge against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
[!NOTE] 已发布经过 Developer ID 签名和 Apple 公证的 WeChatBridge 0.1.15 DMG。
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[自定义应用]
| 能力 | 使用体验 |
|---|---|
| 十二个原生入口 | 在微信转发菜单直接选择目标，无需打开微信流主窗口 |
| AI Agent 转发 | 激活目标 App，附加场景指令并自动粘贴聊天归档 |
| Obsidian 沉淀 | 生成 Markdown 笔记，保存原始 ZIP，并按聊天名组织内容 |
| 自定义目标 | 添加任意 macOS 应用，终端类应用可只接收文件路径 |
| 场景与技能 | 为不同群聊保留场景提示词，并管理兼容 Agent 的 SKILL.md |
| 本地记录 | 查看批次状态、重新发送、复制、定位文件和清理历史 |
| 失败兜底 | 目标未安装或权限不足时，文件仍会保留在剪贴板 |
| 双语界面 | 完整支持简体中文与 English |
| 入口 | 行为 |
|---|---|
| 发给 Codex | 激活 ChatGPT/Codex 并粘贴聊天归档 |
| 发给 Claude | 激活 Claude 并粘贴聊天归档 |
| 发给豆包 | 激活豆包并粘贴聊天归档 |
| 发给千问办公 | 激活千问办公并粘贴聊天归档 |
| 发给 WorkBuddy | 激活 WorkBuddy 并粘贴聊天归档 |
| 发给 WeSight | 激活 WeSight 并粘贴聊天归档 |
| 发给 DeepSeek Harness | 激活 DeepSeek Harness 并粘贴聊天归档 |
| 沉淀到 Obsidian | 创建 Markdown 笔记并保存原始附件，通知可打开笔记 |
| 沉淀到文件夹 | 写入选定目录中的 Markdown 与附件，通知可在访达中定位 |
| 分批收集到微信流 | 连续分享多批原始 ZIP，收齐后一次选择目标和场景 |
| 复制到剪贴板 | 保留文件，交给用户手动粘贴 |
| 发送到自定义 | 转发到用户维护的应用列表 |
需要整理超过 100 条时，每批在微信手动选取并分享到「分批收集到微信流」。浮条显示已收批次和上一批首尾参考；收齐后点击「完成并发送」。原始图片、视频保留在 ZIP 中，未完成的收集可在记录页继续，失败可重试。微信的单次多选上限保持不变。
在微信「转发到其他应用」里直接选择目标，不需要先打开微信流主窗口：
完整操作步骤、权限说明和常见问题见 使用指南。
微信流的处理边界保持清晰：
更完整的能力边界见 产品能力文档。
前往 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
随后打开“微信流 → 设置 → 入口”，启用需要的分享入口。也可以前往“系统设置 → 通用 → 登录项与扩展 → 共享”管理它们。
[!TIP] 本地构建会优先使用钥匙串中的 Apple Development 或 Developer ID 签名。没有可用证书时会使用 ad-hoc 签名，macOS 可能要求重新授予辅助功能权限。
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：
main 创建功能分支。swift test 和本地化检查。涉及安全问题时，请通过 GitHub 的 Security Advisories 私下报告，避免在公开 Issue 中附上敏感细节。
欢迎加入 WeChatBridge 交流群，与开发者和社区用户交流使用经验、反馈问题与分享工作流。
关注项目动态、使用交流与后续更新，可通过微信搜索“向明”或“苍何”联系我们。
WeChatBridge 使用 MIT License 发布。