mirror of
https://github.com/hectorqin/reader.git
synced 2026-11-11 13:31:09 +08:00
cnb.dQC5J6ohAGA
0370cd98e8
朗读（Closes #13 的朗读部分） 新增服务端 HTTP TTS 代理与客户端第二、第三个朗读引擎，三者在同一个 SpeechEngine 接口下可切换： - 服务端 GET /api/v1/tts 代理 TTS_URL 指向的合成服务（edge-tts / Piper 等兼容形态），只代理不内置合成模型；GET /api/v1/tts/voices 回答 「这个实例能用什么」，未配置时返回 http:false 而不是 404。 按句合成、磁盘缓存、上游返回非 audio/* 时明确报错（一个指到网页的 TTS_URL 会以 200 返回 HTML，塞进 audio 里既没声音也没事件）。 /tts 是精确的查询串令牌白名单项之一：<audio src> 无法带 Authorization。 - 客户端 HttpTtsEngine 用 <audio> 而不是 Web Audio，事件驱动推进队列。 - 客户端 NativeTtsEngine 走 Android 外壳新增的 speech 接口（shell v3）： WebView 自带的合成器与系统的是两个引擎，手机系统装好的中文语音经常 不在 getVoices() 里，这是「朗读没有中文声音」最常见的原因。 - speechAvailability 决定 auto 用哪个引擎：native → system → http。 - 原 TtsEngine 抽出 loadQueue/onChunk/onState 为公开字段以结构化满足接口。 书架 - 排序：最近更新 / 最近入库 / 书名 / 作者，中文按数字大小排。 排序规则抽到 shelf-order.ts，离线路径与服务端用同一条规则。 - 密度、作者显隐、封面进度条；搜索一键清空 + 回车即搜；下拉刷新。 - 服务端 BookDto 增加 addedAt，否则客户端离线排序无法复现服务端结果。 自定义设置 - 朗读引擎可选（引擎多于一个时才显示该行）；音调行只对有声调的引擎出现。 - 书架设置独立成 sheet，与阅读面板分开。 测试与文档 - server: tts.test.ts（10 例）。web: tts-http / speech / shelf-order 新增 39 例，合计 245 passing。 - android/scripts/check-shell.sh 修正为同时校验嵌套的 speech 接口， 之前它只能看到一个顶层接口。 - README / docs/api.md / docs/architecture.md 补齐三个引擎的取舍、 环境变量与错误码。 Ref: #13