mirror of
https://github.com/hectorqin/reader.git
synced 2026-11-11 13:31:09 +08:00
feat(reader): deliver P0-P2 reading tools and ecosystem integrations
Add reliable reading progress, verified backup and restore, reading tools, offline downloads, source quality checks, personal credential status, OPDS serving and verified WebDAV backup uploads.
This commit is contained in:
1 parent
e3cabf4b1f
commit
7bff77eaf8
82 files changed
+6158
-166
No files matched your search
+11
-1
@@ -8,7 +8,7 @@
|
||||
|
||||
本文定义 reader 对本地书库、OPDS 书库和远程书源的统一扩展架构。目标是让核心程序只维护一套书架、阅读、缓存和任务逻辑;内置 `local`、`opds` 两种来源;远程书源以独立插件开发、安装和升级。
|
||||
|
||||
本文区分目标架构和当前交付。local、OPDS 下载、Node 来源插件、配置界面、持久化章节出版物、富文本/图片缓存、手动刷新和服务端自动追更已经接通。外部来源通过通用进程协议接入。设备只缓存已读章节,整书预下载和缓存淘汰仍未实现。交付状态见 §13,调用示例见 [API 参考](api.md#来源与插件)。
|
||||
本文区分目标架构和当前交付。local、OPDS 下载、Node 来源插件、配置界面、持久化章节出版物、富文本/图片缓存、手动刷新和服务端自动追更已经接通。外部来源通过通用进程协议接入。P1 已增加用户主动预下载与配额检查,自动缓存淘汰仍未实现。交付状态见 §13,调用示例见 [API 参考](api.md#来源与插件)。
|
||||
|
||||
## 1. 目标与范围
|
||||
|
||||
@@ -487,3 +487,13 @@ HTTP 返回宿主 DTO,凭据不回显。插件和来源配置管理需管理
|
||||
|
||||
|
||||
来源实例可声明独立配置页面与后台任务,同一插件的多个实例互不共享配置。页面的 Tab、表单和输出由通用 DTO 定义,见[扩展协议](plugin-extensions.md)。
|
||||
|
||||
## P2 接入体验补充(2026-09-24)
|
||||
|
||||
来源页按 descriptor 展示能力声明,不把声明当作站点可用性保证。个人凭据页显示配置状态和最近访问结果,用户可以编辑、保留或删除指定字段;不回显秘密。
|
||||
|
||||
插件遇到未登录、登录过期、人工验证时应分别抛出 AUTH_REQUIRED、AUTH_EXPIRED、VERIFICATION_REQUIRED(也可作为搜索部分失败项返回)。不要将登录页面当作成功正文返回。宿主不会识别任意站点的登录页面或自动绕过验证码;实际登录、验证码和网站适配仍由插件负责。未提供会话过期时间时,界面不估算过期时间。
|
||||
|
||||
换源的质量检测复用 acquire / getManifest / readResource,可能拉取内嵌图片;不要在这些读取调用中加入不可重入的副作用。检测结果是一次快照,确认换源时会重新读取并验证。宿主拒绝空白正文;正文正确性、缺段与广告识别仍须插件验证。
|
||||
|
||||
生态协议和客户端覆盖范围见 [独立方案](ecosystem-roadmap.zh-CN.md),交付证据见 [P2 记录](p2-progress-2026-09-24.md)。
|
||||
Reference in new issue
Block a user