墨屿：把 Kindle 和 Mac 连起来
墨屿是一个免费的 macOS 应用，给 Kindle 用户（尤其是越狱并装了 KOReader 的 Kindle）用：在 Mac 上看书架和阅读进度，整理划线和生词，统计阅读时间，拖文件就能传书，插上线自动备份，还能把闲置的 Kindle 变成桌面墨水屏。
curl -fsSL https://zkindle.meluon.fun/install.sh | bash
功能
下面每一项都是墨屿 1.0.0 里已经有的功能。标了“KOReader”的需要 Kindle 已越狱并装好 KOReader，其余插 USB 就能用。
书架
- 读取 Kindle 上
documents/里的书和 KOReader 的.sdr记录：进度、读完没有、划线数量 - 封面优先用书里自带的（EPUB、MOBI、原生缩略图），没有就按书名排版生成一张
- 按在读、读毕、未读、只能用原生阅读器读（KFX 等）筛选；在所有划线里全文搜索
- 空间占用一览；从备份里找回 Kindle 上丢了的书
札记和词笺
- 合并 KOReader 的划线批注和原生阅读器的
My Clippings.txt，同一位置的笔记并到划线上 - 导出 Markdown，或同步到 Obsidian 仓库里的「Kindle 札记」文件夹（每本书一个文件）
- 把一句划线做成分享卡片，存成 PNG
- 生词来自原生
vocab.db和 KOReader 生词本，用 macOS 自带词典查释义；按“忘了 / 模糊 / 记得”间隔复习；导出 Anki
阅读记录（KOReader）
- 读取 KOReader 的
statistics.sqlite3：总时长、连续天数、读完几本、每小时读几页 - 一年的阅读热力图、24 小时分布、每本书花了多少时间
- 月度读书卡片（右键存图）；周报导出到桌面
投递和书源
- 拖文件进来就传：TXT（自动识别 GB18030 / Big5 编码，按“第 X 章”分章）、Markdown、HTML、DOCX、RTF、ODT 转成 EPUB；PDF 裁白边；字体放进
koreader/fonts；StarDict 词典放进koreader/data/dict - 贴网页链接，提取正文和图片做成 EPUB
- 插着线走 USB；拔了线走 Wi-Fi（KOReader SSH）；都不在就排队，下次连上自动补发
- 书源：搜索本机书库、Calibre、Standard Ebooks、Project Gutenberg、维基文库；Readwise / Wallabag / Instapaper 稍后读合成每日简报 EPUB
还有这些
防卡死
插上时关掉 Mac 对 Kindle 盘的 Spotlight 索引、删掉 ._ 文件，减少拔线后停在 USB 界面的情况。
自动备份
每天第一次插上做一次增量备份到 ~/KindleBackup/日期，再逐个文件校验 SHA-256。
Mac 上读书
EPUB 和 TXT 可以直接在墨屿里读，单页、双页或滚动，翻页有卷页效果；在 Mac 上划的线会写回 KOReader。
进度同步（KOReader）
墨屿内置 KOReader 的进度同步服务（kosync），Mac 和 Kindle 读到哪里互相同步。
遥控和截屏（KOReader）
在 Mac 上看 Kindle 的实时画面，用方向键和空格翻页，一键全刷。
墨水屏信息屏（KOReader）
Kindle 插电放桌上，按时段轮换显示晨报和单词卡、大钟、屏保照片。
图像
预览图片在 16 级灰度下的效果，可选抖动；设成屏保轮播；把漫画打包成 CBZ。
菜单栏
点菜单栏图标看设备状态、在读的书和待复习生词；文件直接拖到图标上就能传。
下载和安装
| 系统 | macOS 14 Sonoma 或更高版本 |
|---|---|
| 芯片 | Apple 芯片（M1 及以后） |
| Kindle | 能以 USB 磁盘方式连接 Mac 的 Kindle；Wi-Fi、同步、信息屏等功能需要越狱 + KOReader。测试设备：Kindle Paperwhite 2 |
| 大小 | 约 2 MB |
| 价格 | 免费 |
方法一：一行命令（推荐）
打开“终端”，粘贴下面这行并回车。它会下载墨屿、放进“应用程序”、去掉下载隔离标记，然后打开。
curl -fsSL https://zkindle.meluon.fun/install.sh | bash方法二：手动下载
- 下载 Moyu-1.0.0.zip，双击解压，把“墨屿”拖进“应用程序”。
- 第一次打开时，在“应用程序”里右键墨屿，选“打开”。如果还是打不开，到“系统设置 → 隐私与安全性”，在页面下方点“仍要打开”。墨屿还没有经过 Apple 公证，所以需要这一步。
- 插上 Kindle。macOS 会问“墨屿想访问可移除宗卷上的文件”，点“允许”。
- 想用 Wi-Fi 功能的话，到墨屿的「Kindle」页点“一键配置”，然后在 Kindle 的 KOReader 里重启一次。
墨屿会在 Mac 上开一个局域网服务（端口 8686），给 Kindle 提供信息屏画面、OPDS 书库和进度同步。同一网络里的设备都能访问它，在公共 Wi-Fi 上使用时请留意。
常见问题
墨屿需要越狱 Kindle 吗？
不一定。插 USB 能用的功能（看书架、读原生阅读器的划线 My Clippings 和生词本、备份、传书、防卡死）不需要越狱。Wi-Fi 传书、OPDS 书库、阅读进度同步、墨水屏信息屏、遥控翻页和实时截屏，需要 Kindle 已越狱并装好 KOReader。墨屿不提供越狱工具。
支持哪些 Mac？
需要 macOS 14 或更高版本，目前的安装包只支持 Apple 芯片（M1 及以后）的 Mac。
在哪些 Kindle 上测试过？
开发和测试用的是 Kindle Paperwhite 2（越狱 + KOReader）。其他能以 USB 磁盘方式连接 Mac 的 Kindle，理论上也能读书架和划线，但没有逐一测试过。
墨屿收费吗？
免费下载使用，没有内购和广告。
我的书和划线会上传吗？
不会。书目、划线、生词、阅读记录都保存在你的 Mac 上（~/Library/Application Support/Moyu/），墨屿没有自己的服务器，也不收集使用数据。只有你主动使用书源搜索、每日简报、Readwise 等功能时，才会访问对应的网站。
打开时提示“无法验证开发者”怎么办？
墨屿还没有经过 Apple 公证。用一行命令安装会自动处理；手动安装时，第一次在“应用程序”里右键墨屿选“打开”，或者到“系统设置 → 隐私与安全性”点“仍要打开”。
为什么会问“访问可移除宗卷上的文件”？
墨屿要读插着的 Kindle 磁盘，macOS 会弹这个提示，点“允许”即可。因为安装包没有固定的开发者签名，更新到新版本后可能会再问一次。
Wi-Fi 功能需要什么条件？
Mac 和 Kindle 在同一个局域网里，Kindle 上的 KOReader 开着 SSH（端口 2222）。墨屿的“一键配置”会在插 USB 时把这些设置写好，重启 KOReader 后生效。