前言¶
手里有 EPUB 小说或电子书，想在编码环境里直接打开、边听边读，往往要单独装阅读器，再另找 TTS 工具，步骤分散。若希望把「选书 → 阅读 → 语音」交给对话里的 Agent 处理，需要一套能识别 EPUB、并接上朗读后端的 Skill。
下面介绍 SkillHub 社区技能 epub小说阅读器（坐标 @user_87147e36/epub-novel-reader）：面向 EPUB 的阅读与朗读，依赖本地 edge-tts 能力，使用前需先启动配套的 TTS 服务进程。
这是什么¶
epub小说阅读器 是 SkillHub 上的社区来源（community）技能，分类为 office-efficiency，当前版本 1.0.0，由发布者 user_87147e36 维护。
官方简介说明：利用 edge-tts 对 epub 格式的电子书进行阅读；标签标明 requires_api_key=false，即不依赖额外 API Key 配置。它解决的是「在 Agent 工作流里处理 EPUB 并配合 edge-tts 朗读」这一具体问题，而不是替代专业排版阅读器或通用书库管理。
SkillHub 页面统计（以平台展示为准）：评分 100000，下载 1213，安装 22。
核心功能¶
依据 SkillHub 与 API 摘要，可核实的能力如下：
- EPUB 阅读：以 epub 电子书为输入，由 Agent 按技能说明组织阅读流程。
- edge-tts 语音朗读：朗读走 edge-tts；需在本机先运行 TTS 服务端，否则朗读相关步骤无法接通。
- 无 API Key 门槛：技能标记为不需要 API Key，适合在本地已具备 Python 与 edge-tts 环境时使用。
说明：页面摘要未单独列出「转 HTML 阅读器」「Azure Neural 语音」等表述；正文仅以官方简介与标签为准。若你看到的营销摘要与 SkillHub 不一致，以 SkillHub 技能页 为准。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 epub小说阅读器¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install user_87147e36/epub-novel-reader --dir <你的 skills 目录>
常见路径（来自 SkillHub 安装说明，按你实际使用的客户端选择）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可让 Agent 按 SkillHub 安装指引 安装坐标 @user_87147e36/epub-novel-reader。安装或更新技能后，按你所用客户端要求重启或刷新 Agent，使技能生效。
3、启动 TTS 服务器（使用前必做）¶
官方要求在使用朗读能力前，先启动技能包内的 TTS 服务：
python tts_server.py
请在技能安装目录下执行（具体路径以你 --dir 安装后的技能文件夹为准）。该步骤负责把 edge-tts 以本地服务形式暴露给 Agent 调用的流程。
典型用法¶
经过上面的安装与服务启动，可按下面顺序在对话里使用：
- 确认
python tts_server.py已在运行且无报错。 - 在 Cursor 等已加载该技能的客户端中，用自然语言说明要阅读的 EPUB（例如提供文件路径或按技能说明上传/指定电子书）。
- 需要听书时，在同一对话中要求 Agent 按技能流程朗读；Agent 会依赖已启动的 TTS 服务与 edge-tts。
技能页提供的安装提示词示例（可直接发给 AI 代为安装）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_87147e36/epub-novel-reader`。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的环境，希望 EPUB 阅读与 edge-tts 朗读在同一对话里完成。
- 愿意在本地维护 Python 环境，并能接受使用前多一步
tts_server.py启动。
限制与注意
- 朗读依赖 edge-tts 与本地 tts_server.py；未启动服务时，阅读流程可能正常，语音部分会失败。
- 社区技能（
1.0.0），行为以技能包内SKILL.md及脚本为准；升级前可在 SkillHub 查看版本与说明。 - 安装目录务必指向当前 Agent 的 skills 路径，避免装到错误位置导致「已安装但不可用」。
结尾¶
epub小说阅读器 把 EPUB 阅读与 edge-tts 朗读接到 Agent 技能链上：先 skillhub install 到正确的 skills 目录，再 python tts_server.py 拉起 TTS，即可在对话里处理 epub 电子书。详情与安装入口见 SkillHub：epub小说阅读器；API 摘要地址：https://api.skillhub.cn/user_87147e36/epub-novel-reader。
