发送到 Kindle
拖进来，点发送
整个窗口都能拖入，可以一次拖很多本。应用先试上次的地址，找不到就在局域网里寻找已配对的 Kindle，发完读回文件比对 SHA-256。
- 失败的可以重试，发送记录都留着
- 换了 Wi-Fi 也能重新找到设备，或手动填 IP
- 书放在 KOReader 的
documents/我的文章
- Mac转换 · 翻译
- 同一个 Wi-Fi不经云端
- KOReader校验后送达
为什么做它
墨水屏适合慢读，
把书送上去却总是很麻烦。
文章在 Obsidian 里写好、电子书下载好了，想放到 Kindle 上读，还得先转格式、找数据线、拷到对的文件夹。
以前
- 1把 Markdown 转成 EPUB，图片常常丢
- 2插上数据线，等电脑认出 Kindle
- 3找到 KOReader 的书目录，拷进去
- 4弹出设备，拔线
- 5英文书还得另找工具翻译
几分钟，每本书都来一遍
现在
拖进来发送到 Kindle
转换、翻译、传输、校验都由应用完成。打开 KOReader 的「我的文章」，书已经在那儿了。
一次拖放，不插线
怎么用
两个按钮，发到 Kindle 或留在本机。
保存到本机
不连 Kindle 也能用
「保存到本机」只转换，「翻译并保存」只翻译，完成后在访达里选中结果。拿去用别的阅读器，或者稍后再发。
- 原文件不改动，转换副本单独保存
- 文件自动用干净的书名，不带一串编号
- 翻译和普通发送分两条队列，互不等待
中文翻译
英文书，读成中英对照。
拖入 EPUB，在底部选「中英对照」或「仅中文」。先试译 3 段看看译文，满意再翻整本，图片和目录都保留。
- 可以用 ChatGPT 账号登录，用套餐额度，不按 API 计费
- 也支持 DeepSeek、OpenAI、Gemini、Kimi、通义千问、豆包、OpenRouter，或本机的 Ollama / LM Studio
- 四种风格：自然流畅、忠实准确、文学润色、技术学术
- 术语表让人名、地名全书统一；默认 3 章并行
- 可取消、可接着翻；关掉应用，后台翻译也不停
Chapter 1
The first thing to understand about the media is that they are businesses, selling a product to a market.
理解媒体，首先要明白：它们是企业，向市场出售一种产品。
What they sell is not news alone, but the attention of their readers.
它们卖的不只是新闻，还有读者的注意力。
格式
KOReader 能读的，都能发。
电子书原样发送；笔记和文档转成带目录、适合小屏的 EPUB。
原样发送
带 DRM 的 MOBI / AZW 会提前提示。PDF、MOBI 这类格式需要 Kindle 上的新版接收端，应用会识别并提醒你更新。
EPUBPDFMOBIAZW3AZWDjVuCBZ / CBRFB2XPSCHMDOCfb2.zip
转成 EPUB 再发
TXT 自动识别 GBK 编码，「第一章」「Chapter 1」变成章节标题。
MarkdownTXTWordHTMLODTRTF
Obsidian 笔记
双链转成文字，图片打进 EPUB，整篇嵌入和提示块都保留。只展开你选中文章引用到的内容。
[[置身事内]] → 置身事内 ![[图 1.png]] → 打包进 EPUB
整理文件名
⌘E 去掉 z-library、1lib 这类来源标记和「第二版」后缀，预览后再改名。
Diamond_Age (z-lib.org).epub
Diamond Age.epub
发送后校验
读回 Kindle 上的文件比对 SHA-256，确认一字不差才算送达。
书的封面和书名
列表显示 EPUB 封面、PDF 首页，书名和作者取自书本身，不显示冗长的文件名。
隐私与连接
书从你的 Mac，直接到你的 Kindle。
直接发送不经过任何云服务，也没有遥测。只有在你主动翻译时，正文才会提交给你选的模型服务。
- 局域网直传通过 KOReader 的 SSH 服务传文件，Mac 和 Kindle 在同一个 Wi-Fi 即可。
- 专用密钥私钥只在本机生成保存，Kindle 只存公钥；这把钥匙只能收发文件，不能开终端。
- 严格核对设备首次配对确认设备身份，之后每次都核对固定的主机密钥。
- Key 放在钥匙串翻译服务的 API Key 保存在 macOS 钥匙串里。
- 原文不动只读你选的文章和它引用的附件，只有在「整理文件名」里确认后才改名。
- 代码公开MIT 开源，可以自己从源码构建。
开始
配置一次，之后只用拖放。
- 1装好转换组件
在终端运行
brew install python pandoc，再下载应用 ZIP，解压后放进「应用程序」。 - 2插一次 USB，配对 Kindle
按首次配置把接收端写进 Kindle，再确认设备身份。发布包不含任何人的密钥，这一步不能跳过。
- 3拖进来，点发送
在 KOReader 的文件浏览器里打开
documents/我的文章阅读。
MacmacOS 14 或更新，Apple 芯片（arm64）
转换组件Homebrew Python 3.10+、Pandoc 3.8+
Kindle已越狱，装好并运行过 KOReader，含 SSH 插件
网络Mac 与 Kindle 在同一个能互通的局域网
好文章，留给 Kindle 慢读。
免费、开源，适用于 Apple 芯片的 Mac。
问答
常见问题
Kindle 一定要越狱吗？
是的。应用通过 KOReader 的 SSH 服务传文件，需要已越狱、装好 KOReader 并启用 SSH / Dropbear 插件的 Kindle。应用本身不包含越狱工具，也不要求安装乔木 SimpleUI。
打开时提示「无法验证开发者」怎么办？
应用使用本地 ad-hoc 签名，没有 Apple Developer ID 公证。确认来源后，在「系统设置 › 隐私与安全性」里点「仍要打开」。应用不会要求你全局关闭 Gatekeeper；不放心也可以从源码自己构建。
支持 Intel Mac 吗？
目前只提供 Apple 芯片的预编译包。Intel Mac 可以从源码构建，但还没有实机验证。
翻译要花钱吗？
直接发送完全免费。翻译需要模型服务：用 ChatGPT 账号登录走套餐额度；用 API Key 则按所选服务计费，整本的耗时和费用取决于书的长度、模型和限流。取消后再开始会复用已保存的检查点。
换了网络还能用吗？
两台设备换到同一个新 Wi-Fi 后，应用会重新寻找设备，设备身份不随 IP 改变。常见家庭网络可以自动扫描，更大的网络可以手动填 IP。访客网络隔离、不同 Wi-Fi、跨互联网推送不在支持范围内。
测试过哪些设备？
实机测试过 Kindle Paperwhite 3（第七代），固件 5.16.2.1.1，KOReader v2026.07.1。其他型号和旧版 KOReader 尚未实机验证，欢迎在 GitHub 反馈。
这个项目从哪来？
它基于 chasepal/kindle-push-macos：原作者看了乔木的 Kindle / KOReader 分享后做了这个 Mac 小工具，乔木在此基础上加入了 EPUB 中文对照翻译等功能。翻译引擎是 MIT 开源的 bilingual_book_maker。