开发者发布KOReader手写插件PageScribe和离线词典发音插件

我想从电子阅读器上得到一个小功能：在段落旁边随手写下想法，然后继续阅读。我还想用手指选中一句话、高亮它、查一个词，而不用每隔几秒就切换模式。

这就成了 PageScribe——我为 KOReader 开发的手写插件，以及 Dictionary Audio——一个独立的离线发音插件。两者可以配合使用，但都不依赖对方。这是 Builds 的第一篇，我会在这里分享我做的项目、背后的决策，以及还有哪些地方需要改进。

最实用的交互反而最简单。在 PageScribe 默认的“笔书写·手指选择”模式下，笔负责绘制，而手指长按和拖动保留 KOReader 原生的文本选择。这意味着普通的文本高亮、查词和文本笔记都仍然可用。

这里有两种不同的高亮。Marker 会在页面上绘制自由手绘覆盖层。用手指选择文本则会创建 KOReader 的常规文本注释。保持这种区分很重要：有时我想在一个想法周围随意画个记号；有时我想要一个能再次找到的精确句子。

PageScribe 还提供橡皮擦、撤销、页面笔记、HTML 笔记本导出，以及在受支持的 KOReader 版本上导出 PDF 墨迹。它基于 SMUsamaShah 最初的 Finger Ink 项目构建，正是其开源基础让这项工作成为可能。继承的 AGPL-3.0 许可证和历史记录都予以保留。

界面经历了几次迭代。圆形菜单看起来不错，但实际使用时，很难看清当前激活的是哪个工具、下一次点击会做什么。更大的托盘让操作更清晰，却又遮挡了太多文字。

当前方案从右侧边缘中部的一个小圆形手写启动器开始。点击它会打开一个更大的内联工具栏。笔宽、输入模式和颜色在工具旁边展开，让页面保持可见。激活的工具带有填充按钮和对勾。启动器和托盘都可以拖动；× 关闭托盘，但保留启动器可用。

笔和标记的颜色分别记忆。彩色设备可以显示调色板，而单色显示屏使用可读的黑色墨水。HTML 和 PDF 导出会保留所选的笔画颜色。这样颜色就有用，但并非理解控件所必需。

阅读时，我还想听到不熟悉的单词。Dictionary Audio 在 Android 上为原生词典查询添加了“听英语”和“听西班牙语”操作。西班牙语提供译词选择和可配置的播放速度，英语和西班牙语可独立启用。

西班牙语语音包使用合成的墨西哥西班牙语语音。它提前生成并在本地播放，而不是每次选中单词时都发起在线语音请求。释义、翻译数据和发音包是分开下载的；仅安装插件并不会安装它们。

我把音频拆分成独立的仓库，这样只想要发音的人无需手写工具栏就能使用。如果两个插件都安装了，PageScribe 会提供一个音频快捷方式。如果只安装了 PageScribe，手写功能可独立工作。

一位 Reddit 读者问，为什么 PageScribe 的 ZIP 里包含的是 fingerink.koplugin 而不是 pagescribe.koplugin。这个反馈很合理。产品名称变了，但安装文件夹被保留下来，以保留设置、笔记和升级。

以下是确切的安装方法：下载 pagescribe.koplugin.zip 发布资源，解压，并将整个 fingerink.koplugin 文件夹复制到 KOReader 的插件目录。最终的文件路径必须是 koreader/plugins/fingerink.koplugin/main.lua。不要重命名该文件夹，也不要嵌套两层。它在 KOReader 内显示为 PageScribe。

完全重启 KOReader，如有需要在插件管理器中启用 PageScribe，然后打开一本书。启动器会出现在阅读器内，而不是书库或主屏幕上。点击它，选择 Pen，并检查输入模式。Read 返回普通阅读。Dictionary Audio 有自己的 ZIP、安装说明和语音包。

README 现在以该文件夹说明开头，包含目录树，并引导完成首次使用。一个能用的功能仍然需要一条从下载到首次成功操作的清晰路径。

开发和实际使用一直围绕一台 Viwoods AiPaper Mini 进行，KOReader 版本为 v2026.07.2-206。原生笔输入需要兼容的设备以及暴露 stylus 回调 API 的 KOReader 构建。手指绘图需要 KOReader 2026.03 或更新版本；PDF 墨迹导出需要 2026.07 或更新版本。测试 PageScribe 时，应禁用与之竞争的手写捕获插件。

Boox Tab Ultra C 的测试仍在进行中。PageScribe 启动器会出现，英语音频可以播放。该设备上的西班牙语播放一直无声；一个替换的 PCM WAV 包已传输并通过校验和验证，但可听播放仍在等待确认。我让这一限制保持可见，而不是把所有 Android 硬件都呈现为已验证。

可重排书籍上的手写与页面布局绑定。更改字体大小、边距或方向可能会改变其对齐。为现有墨迹保持布局稳定。这些是页面覆盖层，而不是在每次重排中自动跟随句子的手写。

本文附带的图片和动画标注为渲染的 UI 预览，使用了一个示意性的书籍页面。它们解释控件；它们不是连接设备的照片或截图，也不演示延迟或防误触性能。

如果你尝试了任一插件，请分享你的设备、KOReader 版本、输入模式，以及具体哪一步成功或失败。关于笔/手指行为、工具栏位置和发音播放的报告，有助于将个人构建变成更多人可用的东西。