How freestylefly/wechatbridge works
WeChatBridge is a local-first WeChat share-extension app for forwarding exported chat archives to AI applications, Obsidian, folders, custom targets, or the clipboard. Main flow: a user shares a WeChat ZIP, the platform share entry stages files in the inbox, and the resident app discovers the batch and routes delivery; collection mode groups multiple shares before sending. Scenes and skills add destination-specific context, while history and settings support recovery and configuration. Windows counterparts are included. Relationships below are limited to those established by the README or shown in the supplied source index and excerpts.
Main entry points: ActionRunner.swift macOS action runner · AppModel.swift Resident app model · DeliveryEngine.cs Windows delivery engine · ShareViewController.swift macOS share entry
Components 24
Share intake
- macOS share entry
macos/Sources/WeChatBridgeShare/ShareViewController.swift - Attachment importer
macos/Sources/WeChatBridgeShare/AttachmentImporter.swift - Inbox batch store
macos/Sources/WeChatBridgeCore/Inbox.swift - Windows share target
windows/src/WeChatBridge.ShareTarget/Program.cs - Windows collection service
windows/src/WeChatBridge.Windows.Core/Collections/CollectionService.cs
Delivery and archive
- macOS action runner
macos/Sources/WeChatBridgeApp/ActionRunner.swift - Windows delivery engine
windows/src/WeChatBridge.Windows.Core/Delivery/DeliveryEngine.cs - Windows Obsidian delivery
windows/src/WeChatBridge.Windows.Core/Obsidian/KnowledgeDelivery.cs - Windows folder delivery
windows/src/WeChatBridge.Windows.Core/Obsidian/FolderDelivery.cs
Scenes and skills
- Scene coordination
macos/Sources/WeChatBridgeApp/WeChat/SceneCoordinator.swift - Skill library
macos/Sources/WeChatBridgeApp/SkillLibrary.swift - Scene settings
macos/Sources/WeChatBridgeApp/Preferences.swift - Windows scene service
windows/src/WeChatBridge.Windows/Services/SceneService.cs - Windows skill service
windows/src/WeChatBridge.Windows/Services/SkillService.cs
App and history
- Resident app model
macos/Sources/WeChatBridgeApp/AppModel.swift - Local history
macos/Sources/WeChatBridgeCore/InboxReader.swift - App and settings UI
macos/Sources/WeChatBridgeApp/App.swift - Windows app view model
windows/src/WeChatBridge.Windows/MainViewModel.cs
Other components
- WeChat user
- AI agent apps
- Obsidian vault
- Chosen folder
- System clipboard
- Custom target app
Connections 24
- WeChat user → macOS share entry: shares archive
README.md - macOS share entry → Attachment importer: imports attachments
macos/Sources/WeChatBridgeShare/ShareViewController.swift - macOS share entry → Inbox batch store: stages batch
macos/Sources/WeChatBridgeShare/ShareViewController.swift - macOS share entry → Resident app model: launches app
macos/Sources/WeChatBridgeShare/ShareViewController.swift - Resident app model → Inbox batch store: reads batches
macos/Sources/WeChatBridgeApp/AppModel.swift - Resident app model → Local history: tracks history
macos/Sources/WeChatBridgeApp/AppModel.swift - App and settings UI → Resident app model: presents state
macos/Sources/WeChatBridgeApp/App.swift - Resident app model → macOS action runner: dispatches actions
macos/Sources/WeChatBridgeApp/ActionRunner.swift - macOS action runner → AI agent apps: pastes archive
README.md - macOS action runner → Obsidian vault: creates notes
README.md - macOS action runner → Chosen folder: writes files
README.md - macOS action runner → System clipboard: copies files
README.md - macOS action runner → Custom target app: forwards archive
README.md - Resident app model → Scene coordination: uses scene
- Scene coordination → Scene settings: reads settings
- Scene coordination → Skill library: resolves skills
- WeChat user → Windows share target: shares archive
README.md - Windows share target → Windows collection service: stages collections
windows/src/WeChatBridge.ShareTarget/Program.cs - Windows app view model → Windows delivery engine: requests delivery
- Windows delivery engine → Windows Obsidian delivery: delivers notes
- Windows delivery engine → Windows folder delivery: writes folder
- Windows delivery engine → System clipboard: fallback copy
- Windows delivery engine → AI agent apps: activates and pastes
windows/src/WeChatBridge.Windows.Core/Delivery/DeliveryEngine.cs - Windows scene service → Windows skill service: renders skill context