skills/weread-skills/book.md

book — 书籍信息与阅读进度

查看书籍详情、章节目录、阅读进度。

接口

/book/info — 书籍基本信息

请求参数：

参数	类型	必填	说明
bookId	string	是	书籍 ID

回包：

字段	说明
bookId	书籍 ID
title	书名
author	作者
translator	译者
cover	封面 URL
intro	简介
category	分类
publisher	出版社
publishTime	出版时间
isbn	ISBN
wordCount	总字数
newRating	评分（百分制）
newRatingCount	评分人数
newRatingDetail	评分分布详情

/book/chapterinfo — 章节目录

请求参数：

参数	类型	必填	说明
bookId	string	是	书籍 ID

回包：

字段	说明
bookId	书籍 ID
synckey	同步 key（版本号）
chapterUpdateTime	章节最后更新时间
chapters	章节数组
chapters[].chapterUid	章节 UID（用于其他接口如 underlines）
chapters[].chapterIdx	章节序号
chapters[].title	章节标题
chapters[].wordCount	章节字数
chapters[].level	目录层级（1=一级标题, 2=二级…）
chapters[].updateTime	章节更新时间
chapters[].price	章节价格（0=免费）
chapters[].paid	是否已购买（1=已购买）
chapters[].isMPChapter	是否公众号章节（1=是）
chapters[].anchors	章节内锚点/子标题数组

/book/getprogress — 阅读进度

请求参数：

参数	类型	必填	说明
bookId	string	是	书籍 ID

回包：

字段	说明
bookId	书籍 ID
book.chapterUid	当前阅读章节 UID
book.chapterOffset	当前章节内偏移
book.progress	阅读进度百分比（整数，0-100）。注意：1 表示 1%，不是 100%。0=未读，1-99=部分阅读（如 1=仅翻了几页），100=已读完。只有 100 才代表读完
book.updateTime	最后阅读时间
book.recordReadingTime	累计阅读时长（秒）
book.finishTime	读完时间（仅 progress=100 时存在，否则无此字段）
book.isStartReading	是否已开始阅读
timestamp	服务端时间戳

工作流

1. 查看书籍详情：用户提供 bookId 或书名（书名先调 /store/search），调 /book/info 获取基本信息。
2. 查看章节目录：调 /book/chapterinfo，按 level 层级缩进展示目录结构。
3. 查看阅读进度：调 /book/getprogress，展示阅读百分比和累计时长。
4. chapterUid 是后续查看章节划线热度（/book/underlines）和热门划线（/book/bestbookmarks）等接口的参数。

输出格式

• 书籍详情：展示书名、作者、评分、简介等核心信息
• 章节目录：按层级缩进展示，标注字数和付费状态
• 阅读进度：展示百分比和阅读时长（转为小时/分钟）。progress 是 0-100 的整数，必须带 % 号展示（如 progress=1 展示为"1%"，progress=45 展示为"45%"）。只有 progress=100 且有 finishTime 时才表示已读完