talebook /talebook

一个简单好用的个人书库

★ 5,905⑂ 634👁 37⑃ 552● 521▤ 25
HTMLBSD-2-ClauseCreated 2016-09-13www.talebook.org
下载:v26.10.18v26.10.18 ↓26.10.182026-10-18
-1
日增长
5,905
stars
634
forks
37
watchers
552
prs
521
issues
25
releases

README

Tale Book: My Calibre WebServer

中文 | English

A better online books library management website built on Calibre + Vue

 简单好用的个人图书管理系统

友情提醒:中国境内网站,个人是不允许进行在线出版的,维护公开的书籍网站是违法违规的行为!建议仅作为个人使用!

这是一个基于Calibre的简单的个人图书管理系统,支持在线阅读。主要特点是:
 美观的界面:基于 Nuxt 4 + Vue 3 + Vuetify 全新编写的现代化界面,支持PC访问和手机浏览,支持中英文多语言、白天/夜间主题切换;
 支持多用户:为了网友们更方便使用,开发了多用户功能,支持~~豆瓣~~(已废弃)、QQ、微博、Github等社交网站的登录;完善的用户管理、访客权限控制,密码采用 bcrypt 加密存储,支持图形验证码与极验人机验证;
 支持在线阅读:内置 candle-reader 阅读器,网页在线阅读电子书,非EPUB格式自动转换;
 支持网络书库:可导入 Legado(开源阅读)风格的书源,在线搜索、阅读网络小说,并可一键保存为 txt/epub 入库;提供书源管理界面,支持批量导入、启停、有效性体检;
 支持批量扫描导入书籍,自动填充元数据,并提供回收站、批量删除等管理功能;
 支持邮件推送:可管理多个 Kindle 等接收设备,一键推送,自动批量转换格式;
 支持OPDS:可使用KyBooks等APP方便地读书;也支持从其它OPDS书库浏览并导入书籍;
 支持一键安装,网页版初始化配置,轻松启动网站,并可在线检查版本更新;
 优化大书库时文件存放路径,可以按字母分类、或者文件名保持中文;
 支持快捷更新书籍信息:支持从百度百科、豆瓣、新华书店、番茄小说等多信息源并行搜索导入,还可接入 AI 大模型自动识别书籍信息;
 支持私人模式:需要输入访问码,才能进入网站,便于小圈子分享网站;支持将单本书设为私藏,仅自己可见;

本项目曾用名:calibre-webserver

 AI Skills — 用自然语言管理 Talebook

Talebook 提供独立的 Agent Skill,可让支持 Agent Skills 的 AI 工具通过自然语言安全地操作自托管实例:

 书库操作:搜索和浏览书籍,上传、下载与收藏图书,管理书架、阅读状态和接收设备;
 有声书:列出、查看和下载已发布的有声书;
 远程书库:浏览远程书库与网络书源,将搜索到的内容保存到本地书库;
 管理与部署:执行经过确认的管理员操作,并辅助使用 Docker Compose 部署或更新 Talebook。

在支持 Agent Skills 的 AI 工具中,可使用以下命令全局安装 talebook Skill:

bash
npx skills add talebook/skills -g


连接实例时建议通过环境变量提供站点和登录信息,避免密码进入命令历史:

bash
export TALEBOOK_URL="https://books.example.com"
export TALEBOOK_USERNAME="your-username"
export TALEBOOK_PASSWORD="your-password"


安装后直接用自然语言描述任务即可,Skill 会自动触发:

text
帮我在书库里找一下《三体》,把找到的那本加入收藏。
把 ~/Downloads/三体.epub 上传到我的书库。
把《三体》的 mobi 推送到我的 Kindle。


在 Claude Code 中也可以用 /talebook 显式调用。

Skill 会在写入前确认目标与权限,对管理员写入、删除和批量操作先展示影响并请求确认,执行后再查询状态进行核验。完整说明与源码见 talebook/skills。

DeepSeek Harness(DSH)用户可安装社区插件 dsh-talebook-plugin,在 DSH 中通过 12 个强类型工具搜索、下载、上传和管理书籍与有声书,管理 Legado 书源并执行管理员操作。写入前同样需要确认,密码只保存在 DSH 凭据存储中:

bash
dsh plugin --profile web add github:hehetoshang/dsh-talebook-plugin


 近一年更新亮点

 网络书库与书源:新增 Legado 风格书源解析引擎,可在线搜索、阅读网络小说并保存为 txt/epub 入库;配套书源管理界面(批量启停/删除、有效性体检、分页搜索)。
 前端全面重写:从 Nuxt 2 升级至 Nuxt 4 + Vue 3 + Vuetify 3,全站多语言国际化(中/英),新增白天/夜间主题切换,重做登录注册、书籍编辑等页面。
 AI 与多源元数据:新增 AI 大模型识别书籍信息接口;元数据信息源扩展至豆瓣、百度百科、新华书店、番茄小说、Calibre,多源并行查询。
 在线阅读体验:默认 EPUB 阅读器切换为自研 candle-reader;非 EPUB 书籍在线阅读时自动转换。
 推送与转换:新增用户设备管理,支持多设备推送;后台批量转换 Kindle 专有格式为 EPUB。
 OPDS 导入:支持添加外部 OPDS 源,浏览、批量导入书籍,含失败重试与进度查询。
 安全加固:用户密码从 SHA256 自动迁移至 bcrypt;登录/注册/找回密码支持图形验证码与极验 GeeTest;修复多处安全告警(ReDoS、代码注入等)。
 管理后台增强:新增用户管理界面、访客上传权限控制、回收站、批量删除图书、检查更新、用户反馈入口。
 基础设施:升级 Tornado 6.5,改用 uv 管理 Python 依赖,新增数据库迁移工具;使用独立维护的 talebook/talebook-base slim 基础镜像,构建提速。


 全平台客户端 — Moke

Moke 是 Talebook 的全平台客户端,跨平台支持 Windows、macOS、Linux、Android、iOS、iPadOS 及 OpenHarmony(Alpha,这个需要自己编译)。启动后输入你的 Talebook 服务器地址即可浏览、搜索、下载并阅读电子书。
 专业阅读器:内嵌 readest 阅读器,支持 EPUB、PDF 等多种格式,提供高亮、笔记、书签、标注等进阶阅读功能;
 离线下载:将服务器上的书籍一键下载到本地,断网也能随时打开阅读;支持批量下载和 EPUB 完整性校验;
 局域网友好:完美支持自签名证书和 HTTP/HTTPS 局域网服务器,NAS 用户开箱即用;
 完整认证:支持访问码、登录、注册、密码重置等 Talebook 的全部认证方式,内置 GeeTest 人机验证;
 墨水屏模式:专为墨水屏设备优化的高对比度黑白显示模式,支持手动开启及自动检测(Kindle 等设备),去除所有半透明、模糊和渐变效果;
 阅读进度同步:自动与服务器同步阅读进度(页码、章节、

Top issues

Latest release

v26.10.18 v26.10.18 2026-10-18
v26.10.18

 距 v26.10.10,共合并 4 个提交、1 个 PR。本版是一次修复版本,解决部分 NAS 上容器启动后无限重启的问题。

 🚀 修复

- NAS 上容器不再无限重启(1086):飞牛 fnOS 等 NAS 的 Docker 以 umask 0002 启动容器,v26.10.10 的在线升级执行器创建的运行时目录因此变成组可写,被自身的安全检查拒绝,导致容器反复重启。现在执行器统一使用 umask 0022 并以 0755 创建运行时目录;之前崩溃循环遗留的空目录会自动收紧权限,非空、被符号链接替换或非 root 所有的目录仍会被拒绝。

 ⚠️ 升级说明

- 在 v26.10.10 上遇到容器反复重启的 NAS 用户,直接拉取新镜像重建容器即可,无需手动清理目录。
- 可从 GHCR 拉取镜像:ghcr.io/talebook/talebook:v26.10.18;原 Docker Hub 地址继续保留。

---

感谢反馈问题的用户,祝阅读与聆听愉快!🎉

完整变更:https://github.com/talebook/talebook/compare/v26.10.10...v26.10.18

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON