Mufy 批量导出

English · 完整中文零基础教程

一个用来导出、保存、阅读和迁移你自己的 Mufy 数据的开源工具。

最初它只是一个批量导出聊天记录的用户脚本，现在已经扩展成一套比较完整的本地存档工具：Markdown / JSON 备份、EPUB 电子书、SillyTavern JSONL、人设面具与自建角色卡导出、存档体检、超大对话拆包，以及本地阅读器。

🔴 导出来很多段只有「一问一答」、文件才 1KB？请升到 v1.53。 Mufy 现在一存档，原来那段对话的正文就被清空了，完整内容只留在存档里，旧版脚本只拿得到存档自带的一问一答。 v1.53 会自动替你点「载入」把全文还原出来，每个角色导完再把「当前聊天」切回原样。 详见完整教程 · 常见问题里「存档只有 1KB」那条。

⚠️ 非官方工具，与 Mufy 官方无关。 它读取的是你自己已登录账号里、网页本身也在调用的数据接口；官方改接口后，工具可能需要跟着更新。

🔐 隐私：导出和阅读都在本地完成。 你的聊天存档不会上传到本项目的服务器。

🔞 面向成年用户。请勿向未成年人传播本工具或站点地址。

📖 阅读器：先用新版 Our Dialogues

✨ 推荐：Our Dialogues（新版）

现在更推荐用 Our Dialogues 来读导出的存档。它是原来 Mufy Reader 思路的完整升级版，是一间本地优先的「私人阅览室」。

👉 在线版：https://willwefind.github.io/our-dialogues/

仓库：https://github.com/willwefind/our-dialogues

它比旧版 Reader 多出来的主要是：

• 不止 Mufy：Mufy ZIP、ChatGPT / Claude 官方导出可以放进同一个书架；
• 本地书库：导入一次，下次打开直接回到完整书架；
• 全文搜索、书签、划线小注、阅读进度；
• 收藏与标签；
• 导出 EPUB / Markdown / 单文件 HTML；
• 可选的本地语音档案；
• 多套纸感主题与印刷风格；
• 手机也能用。

和本项目一样，纯前端、全本地，存档不会上传到任何地方。

轻量旧版：Mufy Reader（继续保留）

如果你已经用习惯原来的轻量 Reader，它不会下线，也继续可用：

👉 https://willwefind.github.io/mufy-batch-export/mufy-reader.html

旧版只认 Mufy 导出的 ZIP，功能更单纯；新版 Our Dialogues 则适合长期把不同来源的聊天一起整理成个人书库。

📌 所以第一次来的人：直接点上面的 Our Dialogues。 旧版留给已经在用它、或者只想要一个最轻量 Mufy 阅读器的人。

完整的旧版 Reader 使用说明、手机导入细节、字体、分页、搜索、批注等都还在 完整中文教程 里。

---

它能做什么

功能	结果
批量导出聊天记录	一次导一个角色，也可以一次导很多角色
长期备份	Markdown + 原始 JSON + 目录 + 角色开场白
直接出 EPUB	一个角色一本电子书，浏览器里直接生成
迁移到 SillyTavern	导出可导入的 .jsonl 对话文件
导出人设面具	可读文本 + 原始数据
导出自己写的角色卡	完整字段、原始 JSON、头像/封面、正则条目
🩺 存档体检	一次看清卡是否还在、记录是否还在
🆘 消失角色救援	卡被设为私密后，只要还有对话钥匙就能尝试把正文救回来
🚑 超大对话拆包	单段大到浏览器扛不住时，边翻页边分文件导出
🔓 存档自动还原	存档后原对话被 Mufy 清空的，自动「载入」还原全文再导，导完把当前聊天切回原样（v1.53）
手机端	iPhone / iPad / Android 都有真实用户走通过

输出方式怎么选

• ZIP / Markdown + 原始 JSON：真正的备份格式，拿不准就选它。
• 合并 Markdown：一个角色一份长文，适合通读和全文搜索。
• EPUB：最适合手机当小说读。
• SillyTavern JSONL：想把旧聊天搬去酒馆继续聊时用。

🚀 最快开始

电脑：Chrome / Edge + Tampermonkey

1. 安装 Tampermonkey。

2. 新版 Chrome / Edge 记得在扩展详情里打开 「允许用户脚本」。

3. 安装脚本：

   https://raw.githubusercontent.com/willwefind/mufy-batch-export/main/mufy-batch-export.user.js

4. 登录 Mufy，随便进一个角色聊天页。

5. 左下角点 「⬇ 批量导出」。

6. 选导出范围和输出方式，开始导出。

第一次使用、手机端、按钮不出现、429 / 403、角色消失、长对话、乱码、文件没下载下来等情况，请直接看：

👉 完整中文零基础教程

那份是原来的 2000+ 行 README，完整保留，没有删内容；它就是给零基础用户查问题用的。

为什么做这个

Mufy 自带的导出更适合一条一条处理存档。角色一多、存档一多，或者想把自己的数据长期留在平台之外，就会很麻烦。

这个项目的核心想法很简单：属于你自己账号的数据，应该能被保存成普通、可迁移、以后还能读的文件。

而且它尽量不制造「好像成功了」的假安全感。真实用户反馈已经遇到过：

• 角色设为私密后入口消失，但聊天正文其实还在；
• 角色卡被删了，但历史聊天仍然能导；
• 超大存档把手机或浏览器直接撑爆；
• 服务端迁移后，接口总数和真正剩下的消息数对不上；
• 安卓浏览器静默拦掉批量下载的后半段；
• 导出只拿到一部分，却看起来像成功；
• 一存档原对话就被清空，旧版导出来只剩一问一答（v1.53 起自动还原）。

能判断出来的情况，脚本会明确告诉你，而不是悄悄出一份残缺备份。

隐私与安全边界

脚本必须读取你浏览器里现成的 Mufy 登录状态，否则它不可能拿到你自己的数据。

边界是：

• 登录凭证只用于请求 Mufy 自己的接口；
• 本项目没有收集聊天存档的统计后端；
• 导出的文件在浏览器本地生成；
• 核心 ZIP 导出不依赖第三方运行库；
• 默认只读。唯一会动你账号的是 v1.53 的「自动载入」：替你按 Mufy 页面上的「载入」，导完用「保存 + 载入」把当前聊天切回原样（会多一条写明可删的存档）；不删除任何东西，面板上取消勾选就是完全只读；
• 源码公开，可以自己审查。

不要因为作者说「安全」就相信一个用户脚本。 看得懂就自己读源码；看不懂也可以把源码交给你信任的人或 AI 帮你检查，再决定要不要在登录状态下运行。

项目状态

• 2026-08-06 公开；
• 公开后 24 天达到 181 GitHub stars；
• 持续根据真实用户反馈维护；
• 当前脚本系列：v1.53；
• 协议：AGPL-3.0。

目标站点的接口不由本项目控制，所以站点更新后出现兼容问题是可能的。报错时，设备 / 浏览器、面板版本号、选择的导出范围、最后几行日志通常最有用。

仓库里的主要文件

文件	用途
mufy-batch-export.user.js	公开用户脚本
mufy-reader.html	原来的轻量本地 Reader
make-epub.py	把以前已经导出的 ZIP 转成 EPUB
find-keys-in-history.py	从本机浏览器历史里找对话钥匙的辅助工具
find-keys-in-history.md	上面工具的零基础教程
README.zh-CN.full.md	完整中文零基础教程 / 排障手册
README.md	英文项目首页
LICENSE	AGPL-3.0 协议正文

License

GNU Affero General Public License v3.0（AGPL-3.0），详见 LICENSE。