阅微补全计划（ReaMicro Extend）是一个面向阅微的 LSPosed 扩展模块，用来补全阅微在搜索、在线源、云盘、阅读、文件编辑和字体管理上的一些日常使用能力。

• 在阅微设置中增加独立的「在线补全」页面，在线源与关联补全源分开管理。
• 支持导入阅读/Legado 书源格式的在线源：
  • 点击「添加在线源」默认读取剪贴板链接导入。
  • 长按「添加在线源」可选择单个源文件导入。
  • 一次只允许导入一个源，检测到多个源会取消导入。
• 每个在线源可单独启用/停用。需要账号密码的源会弹出登录框；暂不支持登录的源允许跳过后启用。
• 阅微首页搜索会并发搜索已启用的在线源，搜索分组显示为「在线补全-源名」。
• 搜索结果按阅微原有搜索分组方式展示：每个源默认显示首个/最佳结果，可通过列表展开按钮展开更多结果。
• 在线搜索结果展示封面、书名、作者，以及连载状态、字数、章节数、更新时间等可获取信息。
• 点击在线搜索结果会后台下载并导入阅微：
  • 小于 200 章的图书下载完成后一次性导入。
  • 大于 200 章的图书先下载前 100 章并导入书架，后续章节继续后台下载并写入。
  • 下载期间可继续阅读其他图书或切到其他应用。
  • 通知栏显示章节进度，并提供取消按钮；取消或异常中断后会清理临时下载缓存。
  • 下载失败的章节会自动重试，仍失败时跳过继续下载，后续再重试。
• 在线导入会生成标准 EPUB 结构，逐章写入 xhtml，生成目录与元数据，并清理正文开头重复章节标题。
• 支持在线源封面下载与显示，包括同源 http 封面自动升级为 https、必要时放行明文封面请求。
• 在线补全导入的图书支持在图书菜单中执行「更新章节」，从对应在线源获取目录并追加新增章节。

• 在阅微原有关联搜索基础上补充更多关联搜索源，并按「关联补全-源名」显示结果。
• 支持按源启用/停用关联补全搜索源。
• 恢复图书详情页关联操作入口，支持取消关联、重新关联和封面修复。
• 支持手动编辑关联数据入口（需要对应功能源存在）。

• 在阅微云盘体系中补充 WebDAV 入口，支持 WebDAV 登录、浏览、导入、下载与备份。
• 优化云盘/本地书库列表展示，补充图标、标题和部分状态显示。
• 支持本地书库索引与搜索刷新。
• 支持云盘下载取消，取消后同步清理进行中的任务状态。
• 增加导出到本地存储能力，方便把阅微中的图书导出到本地目录。

• 阅读页自动翻页。
• 导入覆盖检查，避免重复导入时误覆盖已有图书；在线补全的阶段性导入走静默更新。
• 阅读页全文搜索增强：
  • 建立本地索引。
  • 搜索结果列表可定位当前项。
  • 跳转后注入高亮，并在高亮未渲染到可见页面时自动纠正翻页。
• 对 ScrollPager 崩溃增加兜底：检测到上次滚动翻页崩溃后自动回退到平移翻页。
• 补充部分阅读 DOM 渲染兼容处理，降低特定书籍排版异常导致的崩溃概率。

• 增强阅微文件编辑能力，支持在图书内编辑 EPUB 元数据和文件内容。
• 支持查看和编辑 xhtml、html、xml、opf、ncx、css 等文本文件。
• 支持文件内搜索、结果跳转、替换和未保存修改确认。
• 支持预览图片和字体文件。
• 支持修改封面。
• 支持在图片菜单中将图片设置为阅微横图，自动按阅微横图命名规则重命名并刷新缓存。
• 支持新增、重命名、删除 EPUB 内部文件，并在文件变化后刷新缓存。

• 支持字体库管理，可导入 ttf / otf 字体文件。
• 支持设置全局界面字体。
• 支持宋体、楷体映射，改善阅读排版中缺字或字体不一致的问题。
• 字体库与阅读排版设置互通。

• 支持导出当前账号登录凭证。
• 支持从剪贴板或文件导入凭证。
• 支持保存并切换多个账号。
• 支持导入/导出账号数据包。
• 支持启动时清理部分缓存状态，降低异常中断后的残留影响。

• 本地自动任务支持每日轶闻、领奖后祈愿、自动阅读、自动行商和期物典当；配置与执行进度按账号保存。
• 模块应用「配置 → 权限与后台」可开启返回桌面后隐藏后台卡片；隐藏不等于保活或强制停止。
• 可选 KSU 独立执行模式（实验性），需配套 APK 和显式 root 授权；与 Android 本地模式交接状态，不同时执行。
• 配套 KSU 模块已打进 APK：点「使用 KSU」会先用内置 ZIP 自动安装模块（需要 root），装好后自动切换到 KSU 模式。CI 也会在 GitHub Releases 的预发布附件里单独提供同一份 ZIP，方便手动刷入。
• 期物典当的「禁当期物」列出席物点选锁定，弹窗内可「刷新期物清单」现拉当日期物与背包全量（名字与品质只在服务端，任务没跑过也能列全）；按品质从高到低排列，期物名用游戏内一致的品质色显示；默认跳过祈禳/传承/夺宝要用的消耗品，一项都不锁则不禁止。
• 任务通知直接显示奖励明细并给物品上品质色；自动行商通知带新行商结束时间与新运签效果。
• KSU 仍受休眠、断网、登录失效和内核策略影响，不保证绝对准点；云端任务仍由 API 服务器执行。
• 完整链路、修复和剩余边界见 自动任务审查，安装/回退见 KSU 使用说明。

• 在阅微设置中增加旋转补全：
  • 自动旋转
  • 竖向锁定
  • 横向锁定
  • 反向旋转

1. 安装模块 APK。
2. 在 LSPosed 中启用模块，并勾选阅微作用域。
3. 强制停止并重新打开阅微。
4. 进入阅微设置，打开「阅微补全计划」相关开关。
5. 如需在线源，进入「在线补全」页面导入并启用在线源。

通知相关功能需要授予模块通知权限。在线补全下载可以在后台运行，部分系统可能还需要允许模块后台启动或关闭过度省电限制。

需要：

• JDK 17
• Android SDK

运行单元测试：

./gradlew :app:testDebugUnitTest

体积与复杂度度量（只报数，不阻断构建）：

./gradlew :app:detekt

构建调试版：

./gradlew :app:assembleDebug

构建正式版：

./gradlew :app:assembleRelease

如果需要本地签名正式版，可通过环境变量或 signing/reamicro-release-secrets.txt 配置：

RELEASE_KEYSTORE_FILE=signing/reamicro-release.jks
RELEASE_KEYSTORE_PASSWORD=...
RELEASE_KEY_ALIAS=...
RELEASE_KEY_PASSWORD=...

local.properties 需要指向本机 Android SDK，例如：

sdk.dir=C:/Users/<name>/AppData/Local/Android/Sdk

包划分、分层约定与重构工具见 docs/architecture.md。

改动前值得知道的两条：

• 宿主类名只在 app/src/main/java/com/reamicro/fix/core/HostClasses.kt 里出现， 宿主升级时改这一个文件。
• 模块启动会打印 hook installed N/M, failed: [...]，设置页「关于 → 模块自检」 能看到明细。宿主升级后先看这一行定位掉线的 hook。

• 本项目为本人闲暇之余的开发项目，会因为个人生活情况延缓或者终止本项目。
• 本项目是针对阅微内部实现的 LSPosed 模块，阅微版本更新后可能需要重新适配；模块仅保证模块更新前的最后一个阅微版本可用。
• 在线补全依赖书源规则和目标站点接口，搜索、登录、目录、封面和正文获取能力会受具体书源影响。
• WebDAV 和在线补全下载涉及网络请求，请遵守对应服务和站点规则。
• 仓库未声明开源许可证，除非后续补充 License，请不要默认拥有再分发或商用授权。

特别提示

在下载、安装或使用本模块前，请务必阅读并理解本免责声明。你一旦下载、安装或使用本模块，即视为已阅读、理解并同意接受本声明的全部内容。

1. 本项目是面向阅微的 LSPosed 扩展模块，只提供本地功能补全、界面增强、文件编辑、搜索适配、在线源适配、WebDAV 适配等技术能力。
2. 本项目不提供任何小说、漫画、图片、音频或其他第三方作品内容，不提供内容存储、内容发布、内容传播或内容运营服务。
3. 本项目可能包含或支持用户配置、导入、启用第三方搜索源、在线源、WebDAV 服务或其他外部接口；相关来源、合法性、准确性、稳定性与可用性均由用户自行判断。
4. 本项目与阅微及任何第三方内容站点、规则分享平台、网盘服务、社区或交流群组均无隶属、授权、代理或合作关系，除非对应方另有明确声明。

1. 用户可自行导入、创建、编辑或使用第三方分享的在线源、搜索源、解析规则、WebDAV 地址及账号凭证。
2. 相关规则仅用于定义用户设备如何访问、获取、解析与展示目标数据；网络请求由用户设备直接向目标站点或服务发起，本项目不对第三方内容进行主动抓取、托管、修改、编辑或再分发。
3. 用户应遵守所在地法律法规、网络安全要求、目标网站或服务的用户协议、版权声明与访问规范，不得利用本模块从事侵犯知识产权、非法传播、未授权数据获取、绕过访问控制、破坏网络服务或其他违法违规行为。
4. 因用户导入规则、启用在线源、访问第三方网站、登录第三方账号、使用 WebDAV 服务或下载相关内容而产生的风险和责任，由用户自行承担。

1. 任何由第三方建立或维护的规则分享平台、书源仓库、论坛、网站、交流群组或其他社区，均属于独立运营的第三方平台。
2. 本项目开发者不参与第三方规则、内容或社区的制作、发布、运营、维护与传播，也不对第三方内容承担主动审查义务。
3. 第三方规则或服务可能失效、变更、限制访问或存在安全风险；用户应自行核验来源可信度，并自行承担使用后果。

1. 本模块主要在用户本地设备和阅微进程内运行，不设立用于提供第三方内容服务的自有服务器。
2. 本模块不会主动向开发者上传用户的阅读内容、在线源列表、账号凭证、浏览记录或下载记录。
3. 用户主动启用在线补全、关联补全、WebDAV、账号凭证导入导出等功能时，模块会在本地保存必要配置，并按用户操作向对应第三方站点或服务发起网络请求。
4. 用户应自行保护导入的书源、WebDAV 地址、账号凭证和本地导出数据，避免因分享、备份、日志上传或设备环境问题造成信息泄露。

1. 本项目尊重并保护知识产权权利人的合法权益，反对任何侵犯著作权、商标权或其他合法权益的行为。
2. 用户应确保其通过本模块访问、下载、处理或阅读相关内容的行为符合适用法律法规及权利要求。
3. 若权利人认为某些第三方规则、第三方内容或第三方服务存在涉嫌侵权情形，应优先向相关内容、规则或服务的实际托管方、发布方或运营方主张权利。
4. 如需联系本项目开发者处理与本仓库直接相关的问题，请提供有效身份证明、权属证明、具体链接、规则信息及相关说明；开发者将在合理技术能力范围内进行处理。