Repository navigation
Releases: joeseesun/qiaomu-simpleui
Release list
v3.0.0-qiaomu.16 · 修复资讯字号与 Aa 调节（测试版）
修复
- 乔木精选中，微信公众号等富文本正文过小、Aa 调字号不生效的问题已修复。清理原文固定字号、字体和行高覆盖，同时保留显式加粗、斜体、对齐、隐藏及图片样式。
- 以前打开过的文章会在下次打开时重建 EPUB；正文等长更新或样式变化也会更新缓存。保留原有阅读设置、位置与批注文件，不需要手动清空缓存。
验证
12 组自动回归、169 个 Lua 文件语法检查、简繁中文语言包和 323 文件安装包检查通过。Kindle Paperwhite 4 / KOReader v2026.07.1 原生排版复现旧问题：字号 22→38 时正文高度仍为 14→14 px；修复后为 35→60 px，旧缓存重建及重开通过。用户重启 KOReader 后确认旧文章 Aa 调节正常。
其他机型、真实批注对齐及完整导航交互未在本轮单独实机验收；此前部分 AI 功能的验收边界沿用 .15。本项目继续以测试版发布。
升级
退出 KOReader，备份 koreader/plugins/simpleui.koplugin 和 koreader/settings/simpleui。下载 simpleui.koplugin.zip（使用 SHA256SUMS 校验），解压到 KOReader 的 plugins/ 目录后重启。不要使用 GitHub 自动生成的 Source code ZIP。详见 安装指引。
感谢 MoreCrazy 的 PR #7 初始贡献；PR #8 补全清理、缓存和回归测试，并保留原提交署名。
English: Fix rich-text news articles ignoring Aa font sizes, while preserving explicit emphasis, alignment, hidden content and image styling. Stale EPUBs rebuild automatically without deleting reading-setting, progress or annotation sidecars. All 12 automated suites pass; native Kindle rendering/cache tests and user-confirmed Aa interaction pass on one Paperwhite 4 running KOReader v2026.07.1. Other devices, real annotation alignment and full navigation were not separately device-tested; previous .15 AI acceptance limits remain. This remains a pre-release. Back up your plugin/settings, verify SHA256SUMS, extract simpleui.koplugin.zip into KOReader’s plugins directory, then restart. Includes MoreCrazy’s contribution from #7, completed in #8.
v3.0.0-qiaomu.15 · 乔木精选频道、KOReader 阅读器读文章、乔木 AI（测试版）
v3.0.0-qiaomu.15 · 乔木精选频道、KOReader 阅读器读文章、乔木 AI（测试版）
新增
- 乔木精选：频道结构与 Qiaomu AI RSS Obsidian 插件一致（全部精选、微信公众号、播客、Newsletter、博客与资讯、读者社区），每个频道记住筛选和页码；列表上下滑翻页。
- 用 KOReader 阅读器读文章：文章打包为 EPUB，原生字体、目录、词典、划线；不进阅读历史、阅读统计和「继续阅读」，异常退出后自动清理。
- 乔木阅读条：点屏幕底部出现 上一篇 · 列表 · Aa · AI · 收藏 · 下一篇；Aa 一屏调字体（朱雀仿宋、霞鹜文楷、思源宋体、思源黑体）、字号、行距、页边距，下一篇自动沿用；正文末尾可直接打开下一篇。
- 乔木 AI（可选）：手机扫码配置 DeepSeek 等 OpenAI 兼容服务，Key 只存在设备本地；划线 AI 翻译、查词卡片（可加入生词本）、词典弹窗「AI 释义」；一键问答（解释、总结要点、举个例子、补充背景、换个角度看、出题考考我、总结全文……）与追问，答案可存为批注或 Markdown 笔记。
- 首页：最近加入的书优先、书架「⋯」菜单、超高首页纵向滑动。
修复
- 缩略图撑爆 KOReader 共享图片缓存，导致点文章直接退出 KOReader。
- 底部弹层只刷出一部分（墨水屏刷新区域）。
安装
需要 KOReader v2026.03+。退出 KOReader 并备份 koreader/plugins/simpleui.koplugin 和 koreader/settings/simpleui，下载 simpleui.koplugin.zip（可用 SHA256SUMS 校验），解压到 KOReader 的 plugins/ 目录后重启。微信读书插件需另行安装，步骤和给 AI Agent 的安装指引见 README。
验证
- 11 个测试套件、中文语言包、打包脚本通过；CI 通过。
- 安装包由合并后的
main（9efc122）构建：323 个文件，与已在参考 Kindle（Paperwhite 4，KOReader v2026.07.1）上逐文件校验安装的版本内容完全一致（ZIP 本身的哈希因打包时间不同而不同）。 - 实机已确认：资讯刷新、文章打开与关闭后无历史和统计残留、手机扫码配置 DeepSeek、划线译文卡片、AI 问答返回。待实机确认：查词卡片与生词本、存为批注、AI 笔记文件、追问、频道切换完整验收。详见 开发与实机记录。
English: pre-release adding Qiaomu picks channels matching the Obsidian plugin, articles read in KOReader's reader without touching book history or statistics, a reading bar with article navigation and a typography card, and optional AI translation, word lookup and one-tap Q&A configured from a phone. Requires KOReader v2026.03+; extract simpleui.koplugin.zip into KOReader's plugins/ folder. Device acceptance covers one Kindle Paperwhite 4 and is incomplete for some AI actions.
v3.0.0-qiaomu.3 · 微信读书入口重启保持（测试版）
中文
修复微信读书入口在 KOReader 重启后消失的问题。启动时先注册外部动作再清理底栏，并一次性补回 .1/.2 已误删的入口；后续保留手动底栏选择。插件暂不可用后恢复时也会恢复原入口，底栏满时不替换已有选项。
已验证：旧版在启动顺序回归中失败；修复后连续两次冷启动、旧状态迁移、手动移除、插件禁用/缺失、底栏满等测试通过。既有隐藏/恢复、重绘生命周期、150 个 Lua 语法、简繁 PO 编译均通过。
301 个插件文件已通过已有配对的 Wi-Fi SSH/SFTP 安装并逐项校验，设备设置及隐藏记录未修改。2026-10-24，用户已在一台运行 KOReader v2026.07.1 的 Kindle 上确认隐藏/恢复画面修复，并确认 .3 微信读书入口修复正常。测试版：此反馈不代表所有交互及其他机型均已验收。
升级：退出 KOReader，备份插件与 settings/simpleui，用下方 simpleui.koplugin.zip 替换 plugins/simpleui.koplugin，然后重启。Source code ZIP 不是安装包。已有配对的设备可以经认证的 SSH/SFTP 维护，无需重复接 USB。
PR #3。基于 Doctor Hetfield 的 SimpleUI 3.0.0，GPL-3.0。
English
Fix the disappearing WeRead shortcut after restart by registering its external action before startup tab sanitization. A one-time migration repairs tabs pruned by .1/.2 while preserving subsequent manual choices. A tab suspended due to plugin unavailability returns when available; a full bar retains the user's selected tabs.
Startup-order, repeated cold-start, migration, manual-removal, disabled/missing-plugin and full-bar regressions pass, alongside visibility/redraw, Lua syntax and Chinese locale checks. All 301 plugin files were installed and hash-verified using the existing paired Wi-Fi SSH/SFTP connection without changing settings. On 2026-10-24, a user confirmed the hide/restore rendering fix and the .3 WeRead shortcut fix on one Kindle running KOReader v2026.07.1. Prerelease: this does not establish acceptance of every interaction or other devices.
Back up the plugin and settings/simpleui, replace plugins/simpleui.koplugin using the installable ZIP, and restart KOReader.
v3.0.0-qiaomu.2 · 隐藏后重绘修复（测试版）
隐藏/恢复画面已获 Kindle 用户确认；已知问题：微信读书入口可能在重启后消失，请升级 v3.0.0-qiaomu.3。
Hide/restore rendering is user-confirmed on one Kindle. Known issue: the WeRead tab can disappear after restart; upgrade to .3.
中文
修复隐藏书籍后的重复重绘路径：先更新缓存，再由当前界面关闭长按弹层并重绘一次；主页可见时不再刷新底层文件管理器。去掉隐藏后的额外提示弹层，保留已隐藏记录、原文件和阅读数据。
从 v3.0.0-qiaomu.1 升级：退出 KOReader，备份插件及 settings/simpleui，替换 plugins/simpleui.koplugin 后重启。下载下方 simpleui.koplugin.zip；Source code ZIP 不是安装包。
已验证：刷新顺序与单次绘制回归、隐藏/恢复/持久化、微信读书启动分发、150 个 Lua 文件语法及 CI。301 个插件文件已在 KOReader v2026.07.1 设备安装并逐项校验，设备已安全弹出。
测试版：修复后的真机画面、触控及微信读书页面仍待用户复测。 不将复制文件或自动测试视为真机视觉验收。
变更：PR #2，合并提交 d5ee773。基于 Doctor Hetfield 的 SimpleUI 3.0.0，保留 GPL-3.0。
English
Fix the duplicate/background redraw path after hiding a book. Invalidate caches before the initiating view closes the sheet and repaints once; do not refresh the background file browser under the home screen. Remove the extra success overlay. Hidden records, files and reading data are preserved.
Automated lifecycle/visibility/dispatch tests, Lua syntax checks and CI pass. All 301 plugin files were installed and hash-verified on KOReader v2026.07.1; the device was safely ejected. Physical-device visual and touch recheck is still pending.
Back up the plugin and settings/simpleui, replace plugins/simpleui.koplugin using the installable ZIP, and restart KOReader.
SimpleUI 乔木定制 3.0.0-qiaomu.1（测试版）
已知问题：此版本隐藏书籍后可能出现白块或内容缺失。请使用 v3.0.0-qiaomu.2 测试修复；新版真机复测仍待确认。
Known issue: hiding can cause incomplete rendering. Use the .2 prerelease for the proposed fix; device visual recheck remains pending.
中文
基于 Doctor Hetfield 的 SimpleUI 3.0.0，保留 GPL-3.0 许可证。
- 去掉顶部下拉提示箭头，保留下拉菜单能力。
- 为已安装且启用的微信读书插件增加入口；底栏有空位时自动添加一次。
- 主页和文件夹书库长按「从主页和书库隐藏」，在「设置 → 书库 → 已隐藏的书籍与文档」逐本恢复。
- 隐藏不移动或删除原文件，不清除批注或阅读历史。
下载 simpleui.koplugin.zip，退出 KOReader，备份旧插件和 settings/simpleui 后，将解压的 simpleui.koplugin 文件夹放进 plugins/，再重启。需要 KOReader v2026.03+ 和 CoverBrowser。
已验证：自动回归、150 个 Lua 文件语法、简繁中文 PO 解析编译；301 个文件已安装到 KOReader v2026.07.1 并逐项校验。
测试版：定制界面的真机视觉、触控和微信读书页面仍待确认。 其他机型未验收。隐藏只影响显示，不提供加密；外部改名或移动后旧隐藏记录不自动跟随。
English
Based on Doctor Hetfield's SimpleUI 3.0.0 under GPL-3.0. Adds a cleaner header, an optional WeRead shortcut, and reversible per-file hiding shared by the home screen and library.
Install simpleui.koplugin.zip into KOReader's plugins directory after backing up the original plugin and settings/simpleui. Requires KOReader v2026.03+ and enabled CoverBrowser.
Automated regression, Lua syntax and Chinese locale checks pass. The files were installed and hash-verified on KOReader v2026.07.1. Physical-device visual/touch acceptance of this customization is still pending. Visibility is not encryption; files, annotations and reading history are preserved. External renames/moves do not migrate hidden records.