Chuyển đến nội dung chính
Hướng dẫn AI

Hướng dẫn WeChatBridge: Chuyển tiếp trò chuyện WeChat đến AI Agent và Obsidian

Hướng dẫn này chỉ cách cài đặt và cấu hình WeChatBridge, dùng menu chia sẻ gốc của WeChat để gửi lịch sử trò chuyện đã hợp nhất đến các AI Agent như Codex, Claude hoặc lưu trữ vào Obsidian; đồng thời giải thích về quyền, lời nhắc theo ngữ cảnh, đích tùy chỉnh và cách xây dựng từ mã nguồn.

Thời gian đọc khoảng 19 phút
Hướng dẫn WeChatBridge: Chuyển tiếp trò chuyện WeChat đến AI Agent và Obsidian

WeChatBridge là gì

WeChatBridge, có tên tiếng Trung là “微信流”, là một công cụ macOS nguyên bản, nhẹ và chạy hoàn toàn cục bộ. Công cụ tận dụng khả năng “chuyển tiếp hợp nhất” do WeChat cho macOS phiên bản 4.1.13 trở lên cung cấp để lưu trữ TXT, hình ảnh và video được tạo từ lịch sử trò chuyện, sau đó gửi chúng qua tiện ích chia sẻ hệ thống đến AI Agent, cơ sở kiến thức cục bộ, bảng nhớ tạm hoặc ứng dụng được chỉ định khác.

Công cụ không đọc cơ sở dữ liệu WeChat, không giải mã, chèn mã hay chỉnh sửa tiến trình WeChat. Nội dung trò chuyện chỉ đến từ các tệp do WeChat chủ động xuất; kho lưu trữ, cấu hình ngữ cảnh và lịch sử chuyển tiếp đều được lưu trên máy cục bộ.

Tính năng chính

Chín điểm chuyển tiếp gốc

Sau khi cài đặt và bật tiện ích chia sẻ, bạn có thể chọn trực tiếp các đích sau trong menu “Chuyển tiếp đến ứng dụng khác” của WeChat mà không cần mở trước cửa sổ chính của 微信流:

  • Gửi đến Codex: Kích hoạt ChatGPT/Codex và dán kho lưu trữ trò chuyện.
  • Gửi đến Claude: Kích hoạt Claude và dán kho lưu trữ trò chuyện.
  • Gửi đến 豆包: Kích hoạt 豆包 và dán kho lưu trữ trò chuyện.
  • Gửi đến 千问办公: Kích hoạt 千问办公 và dán kho lưu trữ trò chuyện.
  • Gửi đến WorkBuddy: Kích hoạt WorkBuddy và dán kho lưu trữ trò chuyện.
  • Gửi đến WeSight: Kích hoạt WeSight và dán kho lưu trữ trò chuyện.
  • Lưu vào Obsidian: Tạo ghi chú Markdown và lưu tệp đính kèm gốc.
  • Sao chép vào bảng nhớ tạm: Giữ lại tệp để người dùng dán thủ công.
  • Gửi đến tùy chỉnh: Chuyển tiếp đến danh sách ứng dụng macOS do người dùng quản lý.

Ngữ cảnh, kỹ năng và lịch sử cục bộ

微信流 cho phép lưu lời nhắc theo ngữ cảnh cho các cuộc trò chuyện nhóm hoặc tác vụ khác nhau, đồng thời chỉ định Agent áp dụng. Trung tâm kỹ năng có thể quản lý SKILL.md tương thích với Agent. Ứng dụng chính cũng lưu lịch sử lô cục bộ để xem trạng thái, gửi lại, sao chép nội dung, định vị tệp hoặc xóa lịch sử.

Dự phòng khi thất bại

Nếu ứng dụng đích chưa được cài đặt hoặc quyền hệ thống không đủ, 微信流 vẫn giữ các tệp trong bảng nhớ tạm để bạn hoàn tất thao tác thủ công.

Chuẩn bị trước khi cài đặt

Trước khi sử dụng 微信流, hãy đảm bảo môi trường đáp ứng các yêu cầu sau:

  • macOS 14 Sonoma hoặc mới hơn.
  • Khi cần tự động dán, hãy cấp quyền Trợ năng trong phần cài đặt hệ thống.
  • Khi cần nhận diện tên cuộc trò chuyện trên thanh tiêu đề WeChat, hãy cấp quyền Ghi màn hình.
  • Nếu xây dựng từ mã nguồn, cần Xcode 16 hoặc Command Line Tools tương thích với Swift 6.

Quyền Ghi màn hình chỉ được dùng để nhận diện tên cuộc trò chuyện trên thanh tiêu đề WeChat; hình ảnh chỉ được xử lý trong bộ nhớ. Quyền Trợ năng chỉ được dùng để kích hoạt ứng dụng đích và thực hiện thao tác dán.

Phương pháp 1: Cài đặt bản phát hành

  1. Mở WeChatBridge GitHub Releases và tải DMG mới nhất. README cho biết gói cài đặt đã phát hành được ký bằng Developer ID và Apple công chứng.

  2. Mở DMG và kéo “微信流” vào thư mục “Ứng dụng”. Gói cài đặt hỗ trợ cả Apple Silicon và Intel Mac.

  3. Khởi chạy 微信流, rồi vào “Cài đặt → Điểm truy cập”.

  4. Bật các điểm chia sẻ cần dùng, chẳng hạn Claude, Codex, Obsidian hoặc sao chép vào bảng nhớ tạm.

  5. Nếu điểm truy cập không xuất hiện trong menu chia sẻ hệ thống, hãy vào “Cài đặt hệ thống → Cài đặt chung → Mục đăng nhập & Tiện ích mở rộng → Chia sẻ” để kiểm tra và bật tiện ích tương ứng.

Phương pháp 2: Xây dựng từ mã nguồn

Nhà phát triển có thể sao chép kho lưu trữ, chạy kiểm thử và tạo bản dựng phát hành:

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

Sau khi xây dựng, ứng dụng nằm tại dist/微信流.app. Sử dụng tập lệnh sau để cài đặt bản phát triển vào thư mục “Ứng dụng” của người dùng hiện tại và đăng ký tiện ích chia sẻ:

Scripts/install-dev-build.sh

Sau khi cài đặt, mở “微信流 → Cài đặt → Điểm truy cập” và bật các điểm chia sẻ cần dùng.

Bản dựng cục bộ sẽ ưu tiên sử dụng chứng chỉ Apple Development hoặc Developer ID trong chuỗi khóa. Khi không có chứng chỉ phù hợp, ứng dụng sẽ dùng chữ ký ad-hoc; macOS có thể yêu cầu cấp lại quyền Trợ năng.

Cách dùng cơ bản: Gửi trò chuyện WeChat đến AI Agent

  1. Mở cuộc trò chuyện cần xử lý trong WeChat cho macOS.

  2. Chọn nhiều bản ghi trò chuyện cần xử lý và chọn “Chuyển tiếp hợp nhất”.

  3. Vào “Chuyển tiếp đến ứng dụng khác”, rồi chọn “Gửi đến Claude”, “Gửi đến Codex” hoặc điểm AI đã bật khác.

  4. 微信流 nhận kho lưu trữ ZIP do WeChat tạo, có thể chứa TXT, hình ảnh và video.

  5. 微信流 kích hoạt ứng dụng đích, đính kèm chỉ dẫn theo ngữ cảnh đã chọn và tự động dán kho lưu trữ trò chuyện.

Ví dụ, khi xử lý thảo luận trong nhóm công việc, bạn có thể tạo ngữ cảnh “Tổng hợp cuộc họp” trước và lưu chỉ dẫn tác vụ như sau:

Hãy tổng hợp kho lưu trữ trò chuyện này:
1. Các quyết định đã xác nhận
2. Việc cần làm và người phụ trách
3. Các vấn đề chưa được giải quyết
4. Các liên kết và tệp đính kèm liên quan

Khi chuyển tiếp, chọn ngữ cảnh đó để Agent tương thích xử lý nội dung theo cấu trúc cố định. Người dùng tự quản lý lời nhắc theo ngữ cảnh; hiệu quả thực tế phụ thuộc vào ứng dụng đích và mô hình được sử dụng.

Cách dùng cơ bản: Lưu trữ vào Obsidian

  1. Đảm bảo đã bật điểm “Lưu vào Obsidian” trong 微信流.

  2. Chọn nhiều bản ghi trong WeChat và thực hiện “Chuyển tiếp hợp nhất”.

  3. Chọn “Lưu vào Obsidian” từ menu chia sẻ.

  4. 微信流 tạo ghi chú Markdown và lưu ZIP gốc cùng các tệp đính kèm liên quan.

  5. Nội dung được sắp xếp theo tên cuộc trò chuyện, thuận tiện cho việc tìm kiếm và tiếp tục整理 trong cơ sở kiến thức cục bộ.

Cách này phù hợp để lưu trữ thảo luận dự án, tài liệu học tập hoặc thông tin quan trọng trong nhóm trò chuyện, đồng thời giữ lại kho lưu trữ gốc do WeChat xuất.

Sử dụng bảng nhớ tạm và đích tùy chỉnh

Sao chép vào bảng nhớ tạm

Nếu không muốn mở ngay ứng dụng khác, bạn có thể chọn “Sao chép vào bảng nhớ tạm”. 微信流 sẽ giữ lại tệp; sau đó bạn có thể chuyển thủ công sang ứng dụng đích và dán. Đây cũng là phương án dự phòng hữu ích khi quyền không đủ hoặc ứng dụng đích chưa được cài đặt.

Gửi đến ứng dụng tùy chỉnh

Ngoài các điểm tích hợp sẵn, bạn có thể quản lý danh sách ứng dụng macOS của riêng mình. Với các ứng dụng dạng terminal, có thể cấu hình để chỉ nhận đường dẫn tệp, thuận tiện chuyển kho lưu trữ trò chuyện cho tập lệnh hiện có hoặc quy trình dòng lệnh. Đích cụ thể nên được thiết lập dựa trên các ứng dụng đã cài trên máy.

Mẹo nâng cao

Tạo ngữ cảnh theo tác vụ

Không nên dùng cùng một lời nhắc cho mọi cuộc trò chuyện. Bạn có thể tạo riêng các ngữ cảnh như tóm tắt cuộc họp, phân tích yêu cầu, phản hồi khách hàng, trích xuất liên kết hoặc ghi chú học tập, đồng thời chỉ định Agent phù hợp cho từng ngữ cảnh. Cách này giúp giảm thao tác nhập lặp lại và duy trì cấu trúc kết quả nhất quán.

Bật điểm truy cập khi cần

Chín điểm chia sẻ có thể được bật hoặc tắt độc lập. Chỉ giữ lại các đích thường dùng sẽ giúp menu chia sẻ WeChat gọn gàng hơn. 微信流 cũng đánh dấu các ứng dụng đích chưa được cài đặt để tiện kiểm tra cấu hình.

Quản lý kỹ năng Agent

Trung tâm kỹ năng dùng để quản lý SKILL.md tương thích với Agent. Nếu quy trình cần xử lý liên kết, video hoặc loại tài liệu cụ thể trong nhóm trò chuyện, bạn có thể kết hợp kỹ năng tích hợp trong dự án hoặc tự quản lý cấu hình kỹ năng, nhưng trước tiên cần xác nhận Agent đích hỗ trợ định dạng tương ứng.

Tận dụng lịch sử cục bộ để thử lại

Sau khi chuyển tiếp, bạn có thể xem trạng thái lô trong ứng dụng chính. Nếu quá trình gửi bị gián đoạn, có thể gửi lại, sao chép nội dung hoặc định vị tệp lưu trữ từ lịch sử mà không cần chọn lại cùng một nhóm tin nhắn trong WeChat.

Dọn dẹp lịch sử định kỳ

Hình ảnh, video và ZIP gốc có thể liên tục chiếm dung lượng đĩa. Sau khi xác nhận nội dung quan trọng đã được đưa vào cơ sở kiến thức, bạn có thể xóa các lô lịch sử không còn cần thiết thông qua lịch sử cục bộ.

Lệnh phát triển và xác minh

Sau khi sửa mã nguồn, bạn có thể dùng các tập lệnh do kho lưu trữ cung cấp để kiểm thử, xác minh tài nguyên và xem trước bản phát triển:

# Chạy kiểm thử
swift test

# Xác minh tài nguyên tiếng Trung và tiếng Anh
swift Scripts/check-localizations.swift

# Kiểm tra chữ ký, Bundle ID, App Group và cấu hình phát hành
Scripts/check-release-config.sh

# Xây dựng, cài đặt và mở bản phát triển
Scripts/dev-preview.sh

Dự án sử dụng Swift Package Manager để quản lý mã nguồn và phần phụ thuộc Sparkle. Scripts/make-app.sh lắp ráp chương trình chính cùng chín Share Extension thành một ứng dụng macOS hoàn chỉnh. Lưu ý rằng dù dự án đã dành sẵn cấu hình cho cơ chế cập nhật tự động từ GitHub Releases, cấu hình trong mã nguồn hiện tại chưa bật tính năng tự động kiểm tra.

Quyền riêng tư và ranh giới bảo mật

  • Chỉ xử lý các tệp trò chuyện do WeChat chủ động xuất.
  • Không đọc cơ sở dữ liệu WeChat, không giải mã, chèn mã hoặc chỉnh sửa tiến trình.
  • Kho lưu trữ trò chuyện, ngữ cảnh và lịch sử đều được lưu trên máy cục bộ.
  • Share Extension chạy trong sandbox macOS và không có quyền mạng.
  • Ghi màn hình chỉ dùng để nhận diện tên cuộc trò chuyện; hình ảnh chỉ được xử lý trong bộ nhớ.
  • Quyền Trợ năng chỉ dùng để kích hoạt ứng dụng và thực hiện thao tác dán.

Kết luận

WeChatBridge kết nối tính năng chuyển tiếp hợp nhất gốc của WeChat, AI Agent và cơ sở kiến thức cục bộ thành một quy trình macOS đơn giản. Người dùng thông thường có thể cài đặt trực tiếp DMG và bật các điểm chia sẻ; nhà phát triển cũng có thể xây dựng và mở rộng từ mã nguồn. Với lời nhắc theo ngữ cảnh, quản lý kỹ năng, đích tùy chỉnh và lưu trữ Obsidian, bạn có thể xử lý và lưu trữ thông tin trò chuyện hiệu quả hơn mà không cần đọc cơ sở dữ liệu WeChat.