栖读 Qidu Reader：本地优先的桌面阅读器

运行发布包：Windows x64；本地阅读不需要账号与网络。在线找书、下载方案查找、网盘/磁链下载与百科概述需要网络访问对应站点。数据保存在本机应用数据目录，Windows 通常为 %APPDATA%/栖读/；删除该目录会删除书架，请先导出备份。 从源码运行：Node.js 22.12+ 与 pnpm。首次构建需访问 GitHub 下载 aria2 官方发行文件（校验 SHA-256 后缓存到 vendor/aria2/）。端到端测试会启动独立的隐藏 Electron 实例并使用专用测试资料目录。

直接运行（Windows x64，无需安装 Node.js）：

1. 双击 release/Qidu-Reader-1.7.0-Windows.exe（便携版，首次启动会解压到临时目录，可能需要几秒）。
2. 或运行 release/win-unpacked/栖读.exe；该目录下的其他文件是运行所必需的，不要只移动其中的 exe。

从源码运行（需要 Node.js 22.12+ 与 pnpm，项目已提供锁文件）： pnpm install pnpm desktop:dev # 桌面开发模式 pnpm dev # 浏览器预览，打开 http://127.0.0.1:5173 浏览器预览与桌面版的本地数据相互独立；网页导入在浏览器中受目标网站 CORS 限制，桌面版通过受限 IPC 获取正文；站点窗口、动态页面读回与下载队列只在桌面版提供。

构建与检查： pnpm dist # 生成 Windows x64 便携可执行文件 pnpm pack # 生成完整免安装目录 pnpm typecheck # TypeScript 严格检查 pnpm test # Vitest 单元测试 pnpm test:e2e / test:discovery / test:search-session / test:new-sources / test:downloads / test:resources / test:local-cache / test:reading-upgrade # 独立 Electron 端到端测试，使用专用测试资料目录，不接触用户书架 pnpm test:packaged # 发布包测试，会短暂显示独立测试窗口 pnpm check:downloads / check:sources # 可选联网检查（来源状态、下载一本公版 EPUB 到隔离目录） pnpm dist 会复制 PDF 所需的本地字体、CMap、WASM 资源，并准备固定版本的 aria2 引擎；首次构建需访问 GitHub 下载官方发行文件，校验 SHA-256 后缓存到 vendor/aria2/。

1. 「发现好书」输入书名或作者；「管理搜索站点」可添加网站。搜索结果可查看详情、加入书架和取消收藏。在线书目只保存资料与原站链接，不会自动下载整本正文；需要文件时点「下载方案」，在当前界面检查结果并选择格式下载，选择「加载到本地」后，支持的书籍下载完成会自动关联作品并加入书架，右上角「下载」可查看任务。
2. 点「导入书籍」，选择文件、拖入文件，或切换「网页链接」。
3. 点封面进入阅读。左侧可打开目录、查找和本书收藏；右上角可添加或取消书签、调整样式、写书评。
4. 选中正文，添加想法并保存摘录。阅读位置和样式会自动保存。
5. 书籍卡片上的 ··· 打开详情，可调整状态、收藏到书单或移出书架。
6. 在偏好设置中定期导出完整备份；恢复备份会在确认后替换当前资料。

快捷键：Ctrl K 搜索书架；Ctrl O 导入文件；Ctrl F 书内查找；Ctrl D 添加/取消阅读书签；← / →、PageUp / PageDown 前后翻页；Esc 收起浮层/侧栏、退出专注或返回书架。

1. 当前交付为 Windows x64 便携版（93,395,827 字节），未进行代码签名；macOS / Linux 未打包验证。
2. 不支持 DRM 加密 EPUB；加密 PDF 请先解锁后导入。扫描 PDF 可按原页查看，但没有 OCR，不能搜索或摘录扫描图像中的文字。
3. 单文件最大 100 MB，每次最多导入 30 本；网页正文上限 8 MB、20 秒超时。
4. 需要登录、付费权限或 JavaScript 动态加载的网页可能无法提取正文，可在浏览器中保存 HTML 后导入；HTML/网页采用安全正文模式，保留文字与基本排版，不加载远程图片、脚本和交互表单。
5. 网盘下载受验证码、账号权限与分享有效期限制；验证使用受控分享页与原生 Chromium 下载，未使用真实个人账号，不声称所有平台账号、会员资源或客户端专用链接均可下载。
6. 番茄小说官网搜索在本次网络环境返回空响应，应用提示暂不可用；优书站内匿名搜索跳转登录，仅提供公开搜索引擎入口。
7. 应用不提供账号、遥测、云同步或公开书评服务；书评不会发布到网络。
8. 内置六本书为原创导读示例，不是原著全文；书名与作者仅用于示例展示，正式阅读请导入自己有权阅读的文件。
9. 依赖组件许可证汇总在 public/THIRD_PARTY_NOTICES.txt，随应用打包；项目自身未声明开源许可证。

记录来源：项目 docs/验证记录.md、docs/release-1.7.0.json 与各 *-report.json（验证日期 2026-10-26，平台 Windows x64，桌面运行时 Electron 40.10.6）。

1.7.0 已完成的检查：

• TypeScript 检查、Vite 生产构建与 117 项单元测试通过；新增覆盖真实 ZIP/RAR/7Z、嵌套与加密归档、路径及体积限制、失败保留资源、替换后重启和章节识别。
• 开发版阅读升级流程 9 项通过（右上角日夜切换、三种压缩包自动替换、直接阅读、TXT 章节跳转、主题与进度重启恢复、密码重试、无目录 EPUB、两种 PDF 目录、缓存物理删除）；最终发布版同样通过 9 项（reading-upgrade-1.7.0-packaged-report.json）。
• 下载流程 11 项、本地缓存 8 项、网盘/磁链资源 14 项、Windows 基础 6 项检查通过；最终发布版资源流程 14 项全部通过。回归中发现并修复“网盘窗口关闭时向已销毁主页面发送状态”的问题，退出与重启恢复复查通过。
• 解压使用官方 7-Zip 26.05；发布包含许可证、来源记录、哈希与上游对应源码。交付文件 release/Qidu-Reader-1.7.0-Windows.exe，93,395,827 字节，SHA-256 10eafc94ff260a6442aff6207d39ec094d8b39bef27e06f109ab2b2554a087a6。
• 测试使用自行生成的文件、受控 HTTP/分享页与隔离资料目录，不使用个人网盘账号。PDF 扫描页无文本时不进行 OCR。

历史版本要点：1.6.0 本地缓存与百科概述（105 项单元测试、实网查询确认《红楼梦》百度百科与维基百科概述可在应用内展示）；1.5.x 百度提取码、压缩包筛选与网盘/磁链下载（真实启动 aria2，本地 BitTorrent 节点验证无 xs 磁链经 BEP9 取得文件列表，测试禁用公网 DHT、使用回环地址，不代表任意公网磁链可用）；1.4.0 站内查找与下载（Project Gutenberg 实网下载 EPUB3 共 1,228,855 字节并完成入架；书格中转入口当时返回 HTTP 404，界面如实显示错误）；1.2.0 新源（刺猬猫匿名实网查询“魔女”前两页共 19 本去重展示；番茄官网搜索在本次网络环境返回 HTTP 200 空响应，应用显示“暂未返回有效数据”，未声称已恢复）。

本次发布说明：本轮只做资料整理，未重新启动应用或重跑测试，上述结果来自项目既有验证记录；未做新的实网或运行验证的部分（例如真实账号网盘权限、扫描 PDF 的 OCR、DRM EPUB）在“限制”中另行说明。随附 6 张截图取自 docs/screenshots，是上述验证过程中的真实界面截图（书架、阅读界面、EPUB、PDF、下载方案查找、在线找书），本次未重新采集。