Dukou 渡口：微信聊天记录转发与备份

项目简介

Dukou（渡口）是一款原生、轻量、完全本地的 macOS 微信聊天记录转发工具。macOS 微信 4.1.13 起支持把多选的聊天记录「合并转发」给第三方应用：微信自己把文字、图片和视频打包成 ZIP，并附一份按时间排好的 TXT。但转发窗口的「转发到其他应用」列表里只有装了共享扩展的 App，Finder、终端、Codex、Claude 都不在其中。Dukou 把它们补进去，点哪条就直接到哪。

它同时也是一款合规的批量文本化备份工具：群聊和朋友圈批量导出成按时间排好的 TXT，附原图、原视频和离线 HTML 预览。全程只用微信自带的转发和导出，不读数据库、不解密、不注入。

主要功能

• 多种转发入口：暂存到渡口（放到屏幕角落的暂存架，从图标拖进任何 App）、复制到剪贴板、发给 Codex / Claude / 任何 App（激活对方并粘贴到输入框）。
• 入口可开关：每条入口是独立的系统扩展，在「设置 → 入口」里逐条开关；删掉的 App，入口也从系统里一起删掉。
• 暂存架：不抢焦点的浮动方块，常驻屏幕角落；拖出去被接受就消化，文件转进「记录」。
• 记录到期自清：超过保留时长（默认 7 天）自动移到废纸篓，随时能放回暂存架。
• 附加 Prompt：发给任何 App 时先粘一条 Prompt，最多保存 3 条；每个群还能记住自己的 Prompt，同群再次发送时提示只处理上次之后的新消息。
• 失败有兜底：目标没装、没给权限、没到前台，文件一定已在剪贴板，并可放到暂存架。
• 快捷微信转发（实验）：填群名和条数，自动完成多选、合并转发，ZIP 粘给当前 App 或存进文件夹；图片视频可不带，超过 100 条自动分批，可合并成一个 ZIP，按 ESC 中断。
• HTML 离线预览：ZIP 里附一个 index.html，解压后在浏览器里按聊天气泡翻阅，可搜索、按日期查看、看图片和音视频。
• 快捷朋友圈转发（实验）：按条数导出朋友圈，正文按时间线整理成 TXT，图片和视频放进同一个 ZIP，按 ESC 中断。
• Markdown 导出：存到文件夹时可选 Markdown，得到一篇笔记加附件的文件夹，可直接放进 Obsidian。
• 批量文本化备份：快捷转发选「存到文件夹」即是一次备份，按名称、时间范围和条数命名。
• 安全更新与双语界面：Sparkle 检查签名过的新版本，只从 GitHub Release 下载；界面、菜单项和提示支持简体中文与 English。

安装与使用

系统要求：macOS 14 或更高版本；「发给 Codex / Claude」需要装有 ChatGPT.app 或 Claude.app。

Homebrew 安装：

brew install --cask qzz0518/tap/dukou

后续更新用 brew upgrade --cask dukou，或等 App 通过 Sparkle 提示。也可以从 Releases 下载最新的 Dukou-*.dmg，打开后拖入 Applications。两种方式都是同一份经过 Developer ID 签名和 Apple 公证的 Universal 2 DMG。

第一次使用：

1. 打开 Dukou，四步向导会带你打开需要的入口。已装的 Codex、Claude 和后来添加的 App 默认打开，「暂存到渡口」「复制到剪贴板」在向导里自己选。
2. 想用自动粘贴，给「辅助功能」授权；跳过也行，第一次转发失败时会再引导一次。
3. 微信里多选聊天记录 → 合并转发 → 其他应用 → 选你要的那一条。

注意事项

• 已知问题：部分微信账号上，「快捷微信转发」和「快捷朋友圈转发」读不到微信界面，会提示「微信没有向这个账号开放界面控件」。此时手动多选后从转发菜单送到 Dukou 不受影响。原因是微信 4.1 起由微信自己决定是否暴露界面控件，该状态跟着微信账号走，重装、重新授权、换系统或微信版本都无效，作者正在寻找不依赖控件树的实现方式。
• 不读微信数据库，不解密、不注入、不改微信；聊天内容只来自微信自己导出的 ZIP。
• 除了检查更新不联网，所有入口都是沙盒里的扩展，没有网络权限；切换应用和代按 ⌘V 都走系统公开接口，且需你先授权。
• 卸载前请先在「设置 → 入口」里关掉各 App 的入口再删 Dukou，否则需手动删除 ~/Library/Application Support/Dukou。

---

本作品整理自 GitHub 开源项目 qzz0518/Dukou，原作者 @qzz0518，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。