EPUB 小说阅读器

解决的问题

阅读 EPUB 时，很多人不想只依赖默认电子阅读器：有的需要离线网页版，有的想把长文本拆分后检索，有的还要听书。传统流程通常要手动解包、转换章节、拼接 HTML，再接第三方语音接口，链路分散且容易踩端口和缓存坑。

核心能力与工作流程

该技能把 EPUB 解析、网页阅读器生成、TTS 朗读拆成三步脚本化流程：

• extract_epub.py 解析 EPUB 文件，输出章节 JSON，方便后续检索与渲染。
• build_reader.py 从章节 JSON 生成 HTML 阅读器，内置目录、搜索、翻页、主题和进度记忆。
• tts_server.py 启动本地 Edge TTS 代理，提供语音列表、合成接口、语速调节和 .tts_cache/ 缓存。

流程上先启动 TTS 服务器，再启动阅读器服务，最后在浏览器中打开本地阅读器。语音侧支持普通话、粤语、台语和方言音色，适合中文长篇小说的朗读场景。

适用边界与注意点

它偏重 本地中文阅读与听书链路，不适合作为通用文档编辑或复杂排版系统使用。使用前要注意 Python 环境版本、edge-tts 依赖、首次合成网络延迟，以及 TTS 服务器地址必须与前端配置一致；多个 Python 进程同时运行可能造成端口冲突。