Weread Skills

WeRead — 微信读书助手

通过 Agent API Gateway 调用微信读书接口，提供搜索、书架、笔记、书评等能力。

支持的能力

根据用户意图参考对应说明文件了解接口参数、回包结构和工作流。

---

接口调用规范

统一入口

POST https://i.weread.qq.com/api/agent/gateway

鉴权

• Header：Authorization: Bearer $WEREAD_API_KEY
• WEREAD_API_KEY 从环境变量获取，格式 wrk-xxxxxxxx
• 若未设置，提示用户：export WEREAD_API_KEY=<你的apikey>
• API Key 绑定用户身份（vid），需要用户身份的接口会自动注入，无需手动传 vid

请求格式

• Method：POST
• Content-Type：application/json
• Body：JSON，api_name 指定接口，其余为接口参数，每次请求必须带 `skill_version`

curl -X POST "https://i.weread.qq.com/api/agent/gateway" \
  -H "Authorization: Bearer $WEREAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_name": "/store/search", "keyword": "三体", "count": 10, "skill_version": "1.0.3"}'

请求 few-shot

正确：业务参数平铺在 body 顶层。

{"api_name":"/user/notebooks","count":100,"skill_version":"1.0.5"}

正确：下一页继续平铺 `lastSort`。

{"api_name":"/user/notebooks","count":100,"lastSort":1516907353,"skill_version":"1.0.5"}

错误：不要把业务参数包在 `params` 内。

{"api_name":"/user/notebooks","params":{"count":100,"lastSort":1516907353},"skill_version":"1.0.5"}

上面的错误写法会导致 count、lastSort 未被转发，后端按默认值返回第一页，看起来像分页失效。

响应格式

• JSON，回包经过字段裁剪，只返回核心字段
• errcode 非 0 时表示错误，给出中文提示
• 发送 {"api_name": "/_list"} 可查看所有可用接口及参数定义

通用规则

1. 版本上报：每次请求 body 必须包含 "skill_version": "1.0.3"（取本文件顶部 version 字段的值），用于服务端检查版本更新。如果回包中出现 `upgrade_info` 字段，必须立即暂停当前操作，按照 `upgrade_info.message` 中的指引完成升级，升级完成后再重新执行用户请求，不得忽略该字段 2. 参数平铺：业务参数必须和 api_name、skill_version 放在同一层；不要包在 params、data、body 等对象里。只有接口文档明确声明的数组/对象字段（如 /book/readreviews 的 reviews）才允许作为业务字段传入。 3. 能力文档预检：调用任何接口前，必须先根据「支持的能力」表阅读对应说明文件（如阅读统计先读 readdata.md，书架先读 shelf.md），确认接口参数、字段含义、单位、计数口径和工作流；禁止仅凭字段名或经验猜测含义。 4. 字段解释优先级：解释接口回包时，以对应说明文件中的字段说明为准；如果回包字段名和直觉含义冲突，必须服从说明文件，不得直接翻译字段名。 5. bookId 解析：用户输入书名时，先调 /store/search 获取 bookId，再执行后续操作 6. 书架数量：使用 /shelf/sync 回答“书架有多少本书/多少条目”时，必须按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算；albums[] 是专辑/有声书，也属于书架里的书，详细规则见 shelf.md 7. 结果展示：列表用编号展示方便选择；搜索结果重点展示书名、作者、评分；展示接口回包信息时，字段禁止直接翻译，应该参考文件中的说明内容提供 8. 上下文衔接：对话中记住已查询的 bookId，后续操作无需用户重复提供 9. 深度链接：在展示划线、想法、章节等内容时，拼接对应的跳转链接方便用户直接在 App 中打开，具体格式见下方「深度链接（URL Schema）」章节 10. 数据展示规范：

• 时间戳：所有 Unix 时间戳字段（如 updateTime、createTime、finishTime、readUpdateTime 等），展示时须转为 YYYY-MM-DD 格式（如 1748563200 展示为"2025-05-30"），不得直接展示原始数字
• 阅读时长：单位为秒，展示时转为"X小时Y分钟"格式

---

深度链接（URL Schema）

在展示书籍、章节、划线等内容时，如果回包字段足以构造链接，应附上对应的跳转链接，方便用户点击后直接在微信读书 App 中打开对应位置。想法/点评不一定都有划线位置，只有具备 chapterUid 和 range 时才生成划线位置链接。

打开书籍（跳转到上次阅读进度）

weread://reading?bId={bookId}

示例：

weread://reading?bId=3300045871

使用场景：

• 展示书架列表时，每本书附上跳转链接
• 展示搜索结果时，附上「打开阅读」链接
• 展示阅读进度时，提供「继续阅读」链接

跳转到指定章节

weread://reading?bId={bookId}&chapterUid={chapterUid}

示例：

weread://reading?bId=3300045871&chapterUid=107

使用场景：

• 展示章节目录时，每个章节附上跳转链接

跳转到划线/想法所在位置

weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid}

range 解析：划线接口返回的 range 格式为 "起始-结束"（如 "900-2004"），拆分后分别填入 rangeStart 和 rangeEnd。

示例：

weread://bestbookmark?bookId=3300045871&chapterUid=107&rangeStart=900&rangeEnd=2004&userVid=583802764

使用场景：

• 展示划线列表（/book/bookmarklist）时，每条划线附上跳转链接（range 字段可直接解析）
• 展示热门划线（/book/bestbookmarks）时，每条附上跳转链接；/book/underlines 只是划线热度统计，不含划线文本
• 展示想法（/review/list/mine、/book/readreviews）时，只有返回内容包含 chapterUid 和 range 时才附上跳转到对应划线位置的链接；整本书评或无法定位到划线的点评不强制生成该链接

book — 书籍信息与阅读进度

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

接口

/book/info — 书籍基本信息

请求参数：

回包：

/book/chapterinfo — 章节目录

请求参数：

回包：

/book/getprogress — 阅读进度

请求参数：

回包：

工作流

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 时才表示已读完

discover — 发现推荐好书

接口

/book/recommend — 个性化推荐（为你推荐）

基于用户阅读记录的个性化推荐，与 App 首页「为你推荐」一致。

请求参数：

回包：

/book/similar — 相似书推荐

基于某本书推荐相似书籍，与 App 书籍详情页「相似推荐」一致。

请求参数：

回包：

工作流

1. 无参数：调 /book/recommend 获取个性化推荐（为你推荐）。 2. 有 bookId：调 /book/similar 推荐相似书。 3. 有关键词：调 /store/search 搜索发现。 4. 用户对推荐的书感兴趣时，调 /book/info 获取完整信息。 5. 翻页（recommend）：用 searchIdx 作为下次的 maxIdx。 6. 翻页（similar）：用最后一条的 idx 作为 maxIdx，带上 sessionId。

输出格式

• 推荐列表用编号展示，每本书含书名、作者、评分、推荐理由
• 提示用户可选择编号查看详情或继续推荐更多

notes — 笔记/划线

本文档区分两种口径：

• 统计口径：笔记数 = 书签数 + 划线数 + 想法/点评数。这里的"想法/点评"对应后端 reviewCount，包含划线想法、书评想法/个人点评、书摘、非书籍想法等个人内容。
• 内容导出口径：当前可导出的单本书笔记内容 = 划线内容 + 想法/点评内容。书签只在统计数量中体现，当前 /book/bookmarklist 已过滤书签，不能导出书签内容。

公开的他人点评不属于个人笔记，见 review.md。

接口

/user/notebooks — 笔记本概览（所有有笔记的书）

请求参数：

回包：

概念解释

• 用户问“有多少笔记”时，使用统计口径：reviewCount + noteCount + bookmarkCount。
• noteCount 字段名容易误读：它不是单本书总笔记数，而是划线/高亮原文条数；单本书总笔记数必须自行计算。
• /user/notebooks 不返回 highlightCount 字段；如果用户或上游说“高亮数/划线数”，对应字段是 noteCount。
• reviewCount 已包含个人点评/书评想法，因此计算总笔记数时不要再额外加“点评数”，否则会重复计算。
• /user/notebooks 概览无法把 reviewCount 拆成“划线想法”和“个人点评”的独立数量；如需内容明细，需继续查询 /review/list/mine。

分页规则

• /user/notebooks 使用基于时间排序值的游标分页，不支持 offset/limit 分页。
• 第一次请求只传 count；如果 hasMore 为 1，取本页 books 最后一项的 sort，下一次作为 lastSort 传入。
• 所有业务参数必须平铺在 JSON body 顶层，和 api_name、skill_version 同级；不要包在 params 对象里。
• 不要传 offset、limit、start、size；这些参数不会被后端分页逻辑读取，可能导致重复第一页或结果不符合预期。
• 拉取完整列表时循环请求直到 hasMore 为 0，再按 reviewCount + noteCount + bookmarkCount 计算并降序排序。

分页 few-shot

正确：首页请求，参数平铺。

{"api_name":"/user/notebooks","count":20,"skill_version":"1.0.5"}

正确：下一页请求，lastSort 取上一页 books 最后一项的 sort。

{"api_name":"/user/notebooks","count":20,"lastSort":1778312777,"skill_version":"1.0.5"}

错误：不要使用 params 包裹业务参数，否则后端收不到 count 和 lastSort。

{"api_name":"/user/notebooks","params":{"count":20,"lastSort":1778312777},"skill_version":"1.0.5"}

错误：不要使用 offset/limit，这些字段不是本接口分页参数。

{"api_name":"/user/notebooks","offset":20,"limit":20,"skill_version":"1.0.5"}

/book/bookmarklist — 单本书的划线内容列表（不含书签内容）

自动过滤书签（type=0），只返回划线（type=1）。

请求参数：

回包：

/review/list/mine — 单本书的个人想法与点评

返回当前用户在该书上的所有个人内容，包括划线想法、章节点评和整本书评。

请求参数：

回包：

/book/underlines — 章节划线热度统计

获取某章节每条划线的热度统计（人数/得分/类型），不含划线文本，主要用于阅读器内显示"X人划线"热度标签。

请求参数：

回包：

/book/bestbookmarks — 书籍热门划线

获取全书的 Popular Highlights，包含划线原文和划线人数，按热度排序。服务端固定返回前 20 条（count=20, maxIdx=0），不支持分页。

请求参数：

回包：

/book/readreviews — 划线下的想法/评论

请求参数：

回包：

/review/single — 单条想法详情

请求参数：

回包：

工作流

1. 无参数/问笔记数量排行：调 /user/notebooks 展示笔记本概览；如需完整排行，必须按 count + lastSort 遍历到 hasMore=0，且所有分页参数平铺在 body 顶层；每本书笔记数按 reviewCount + noteCount + bookmarkCount 计算并排序。 2. 有 bookId 或书名，问单本书笔记内容：同时调 /book/bookmarklist（划线内容）和 /review/list/mine（想法/点评内容），合并展示当前可导出的笔记内容。 3. 明确要求书签内容：说明当前接口只在 /user/notebooks 提供书签数量，不能导出书签内容；不要把划线误当书签。 4. 用户从概览中选择某本书后，同样调上述两个接口。 5. 通过 chapters 中的 chapterUid/title 将划线按章节分组。 6. 翻页（notebooks）：只使用顶层平铺的 count + lastSort 游标分页；hasMore 为 1 时，用最后一条的 sort 值作为下一页 lastSort；禁止使用 params 嵌套或 offset/limit。 7. 查看书籍热门划线及想法：

• 调 /book/bestbookmarks 获取热门划线列表（含划线原文和人数）
• 调 /book/underlines 获取章节内划线热度统计（人数/得分，无文本，用于展示"X人划线"标签）
• 用 /book/bestbookmarks 返回的 range 值调 /book/readreviews 获取每条划线下的想法
• 如需查看单条想法完整详情（含评论/点赞），调 /review/single

输出格式

• 笔记本概览：编号列表，每本书显示书名、作者、总笔记数、想法/点评数、划线数、书签数、阅读进度
• 单本笔记内容：按章节分组展示当前可导出的内容
• 划线：用引用格式 > 标注原文
• 想法/点评：区分划线想法、章节点评、整本书评；能关联划线时放在对应划线下方，不能关联时单独列出
• 书签：只展示数量（来自 /user/notebooks 的 bookmarkCount），不展示内容

概念理清

• 统计笔记数 = `reviewCount + noteCount + bookmarkCount`；不要把 noteCount 单独当作总笔记数。
• 内容导出 = 划线内容 + 想法/点评内容；当前不能导出书签内容。
• reviewCount 已包含个人点评/书评想法，计算总笔记数时不要再额外加“点评数”。
• 当用户说“所有笔记内容”时，必须同时查询 /book/bookmarklist 和 /review/list/mine，不能只返回划线。

profile — 用户信息与阅读统计

说明

通过组合已有接口获取用户阅读概况。

工作流

1. 获取书架

调 /shelf/sync，了解用户在读什么书、总数等。 书架数量必须按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算；albums[] 是专辑/有声书，也属于书架里的书，不能只统计 books[]。 具体逻辑参考 shelf.md。

2. 获取阅读进度

对书架中的书调 /book/getprogress，获取进度和阅读时长，具体见book.md

3. 获取笔记

调 /book/bookmarklist，获取划线数量，具体见notes.md

输出格式

• 综合书架和阅读进度信息，展示用户阅读概况
• 每本书显示：书名、进度、最近阅读时间
• 无参数时展示阅读概况（书架 + 最近阅读进度）

readdata — 阅读统计

查看个人阅读数据统计，包含阅读时长、天数、读书排行、偏好分析等。

⚠️ 使用前必须阅读本文件字段说明。 阅读统计字段容易因字段名产生误判，尤其是所有阅读时长字段的单位。调用 /readdata/detail 前必须先确认本文件中的参数、字段单位和统计口径；禁止凭字段名或数值大小推断单位。

接口

/readdata/detail — 阅读统计详情

请求参数：

回包字段说明（字段按 `mode` 和数据条件可选返回）：

年度报告相关字段（如 annualList2023、preferBooks2023、2025 年报模块字段等）会随活动配置变化，不作为通用阅读统计字段依赖。

周期特点与区间组合

/readdata/detail 只支持按固定自然周期查询，不支持直接传任意起止日期。遇到"某天至今"、"某月中旬到现在"、"跨年区间"这类请求时，应通过多个固定周期结果组合计算。

组合原则：

1. 优先用较大周期减少调用次数：整年用 annually，整月用 monthly。 2. 跨年区间按自然年拆分：历史整年 + 当前年至今。 3. 起点落在年/月中间时，可用"大周期 - 起点之前的完整小周期"近似组合；如果接口返回 dailyReadTimes，可对边界日期做日级精确扣减。 4. 完整周期使用该周期回包的 totalReadTime；不完整边界周期优先使用 dailyReadTimes 精确扣除起点前/终点后的日期。若没有日级明细，只能使用月级/年级近似，并在回答中说明口径。 5. 不要把截断展示的 readTimes 当作主结果；readTimes 仅用于明细展示或交叉校验。

Few-shot：

• 用户问："2024 年 1 月 31 日至今，我的总阅读时长是多少？"
• 推荐做法：查询 2024 至当前年份的 annually，累加年度 totalReadTime；再查询 2024-01 的 monthly，从总和中扣除 2024 年 1 月的 totalReadTime，得到近似的 2024-02-01 至今 口径。
• 若年度返回 dailyReadTimes 且需要精确到 1 月 31 日，则只扣除 2024-01-01 至 2024-01-30 的日级时长，保留 1 月 31 日。
• 用户问："2025 年以来读了多久？"
• 查询 mode=annually，baseTime 取 2025 年内任一时间戳；如果当前年份大于 2025，再继续查询后续每个自然年并累加。
• 用户问："去年 3 月到今年 2 月读了多久？"
• 查询去年 3-12 月各月 monthly，再查询今年 1-2 月各月 monthly，累加 totalReadTime。

工作流

1. 默认：调 /readdata/detail，不传参数使用默认 mode=monthly 展示本月阅读数据。 2. 用户问本周/今年/总共：对应传 mode=weekly/annually/overall。 3. 用户问历史数据：如"上个月读了多少"，将上月某天的时间戳作为 baseTime 传入；如"2025 年读了多久"，传 mode=annually 且 baseTime 取 2025 年内任一时间戳。 4. 用户问跨年区间：如"2024 年至今""2025 年以来"，必须按自然年逐年查询：从起始年份到当前年份分别调用 mode=annually，每次 baseTime 取该年份内时间戳；历史年份返回的是该自然年全年数据，当前年份返回的是本年至今数据。不要把 2025 年度结果标注为"2025 年至今"，也不要漏查当前年份。 5. 用户问任意起止日期区间：先判断是否能拆成完整自然年/月/周；完整周期使用 totalReadTime 累加，不完整边界优先使用 dailyReadTimes 做日级扣减；如果没有日级明细，则使用月级近似并说明口径。例如"2024 年 1 月 31 日至今"可用 2024 年至今的年度数据合计，减去 2024 年 1 月月度数据，得到 2024-02-01 至今 口径；若有日级明细，则只扣除 1 月 1-30 日，保留 1 月 31 日。 6. 总时长口径：单个完整周期优先采用回包 totalReadTime；跨周期区间按"完整周期 totalReadTime 累加/相减 + 边界周期 dailyReadTimes 日级修正"计算。不要手动把截断输出里的 readTimes 相加作为主结果；回答时明确标注使用了哪些完整周期，以及是否使用了日级边界扣减或月级近似。 7. 日均口径：dayAverageReadTime 是按自然日平均，不是按阅读天数平均；如果需要“阅读日均”，必须说明该字段不是接口直接返回值，需要用 totalReadTime / readDays 另行计算。 8. 综合展示：总时长、阅读天数、自然日均时长、与上期对比，读得最多的书，偏好分类和作者。

输出格式

• 总览：阅读天数、总时长（转为 x 小时 y 分钟）、自然日均时长、与上期对比（增长/下降百分比）
• 读书排行：列出读得最多的书/有声内容，书名或专辑名 + 阅读/收听时长
• 阅读统计：读过本数、读完本数、阅读天数、笔记数等
• 偏好分析：偏好分类、偏好时段、偏好作者、偏好出版社/版权方（如有）
• 时长单位统一转换：所有阅读时长字段均按秒处理，秒 → "x 小时 y 分钟"格式；不得把 totalReadTime 当成分钟或小时

review — 书籍点评

书籍的公开点评（区别于个人笔记/划线，个人笔记见 notes.md）。

接口

/review/list — 书籍公开点评

请求参数：

回包（经裁剪）：

工作流

1. 确定书籍：用户提供 bookId 直接使用，提供书名则先调 /store/search 获取 bookId。 2. 调 /review/list 获取公开点评列表。

• 默认 reviewListType=0 看全部
• 用户要看推荐的传 reviewListType=1
• 用户要看最新的传 reviewListType=3
• 用户要看差评的传 reviewListType=2
• 用户要看一般的传 reviewListType=4

3. 每条点评展示：评论者昵称、评分星级、点评内容（长内容截取摘要）。 4. 翻页：用上一页最后一条的 idx 作为 maxIdx，带上 synckey。

输出格式

• 点评列表每条清晰分隔
• 评分转为星级展示（100=⭐⭐⭐⭐⭐，80=⭐⭐⭐⭐，60=⭐⭐⭐，40=⭐⭐，20=⭐）
• 长点评截取前 200 字，提示可展开

search — 搜索

支持多种搜索类型，通过 scope 参数切换 tab，来指定不同的搜索结果 tab 页面。

接口

/store/search

请求参数：

scope 对应关系：

scope 选择指引（Agent 根据用户意图自动选择）：

• 用户明确说"搜书""找书""查某本书"或请求获取 bookId → scope=10（电子书）
• 用户只说"搜一下 xx"，未说明要搜书/作者/文章/公众号等具体类型 → scope=0（全部）
• 用户说"网文""网络小说" → scope=16（网文小说）；如果只是普通语义中的"小说"且想找书，仍用 scope=10
• 用户说"听书""有声书""播客""专辑" → scope=14
• 用户说"搜一下 xx 作者""查作者 xx" → scope=6
• 用户说"书里提到了 xx""全文搜索" → scope=12
• 用户说"有什么书单""推荐书单" → scope=13
• 用户说"搜公众号" → scope=2
• 用户说"搜文章" → scope=4
• 不要把"没特别指定"同时解释成 scope=10 和 scope=0；判断标准是：有明确找书意图用 scope=10，泛搜索用 scope=0。

回包（V3 格式）：

scope=0（全部）时 results 会返回多个分组（电子书、作者、书单等），每个分组有自己的 title 和 scope。

工作流

1. 根据用户意图选择 scope，调 /store/search。 2. 从 results 取搜索结果。单 tab 模式（scope>0）通常只有一个分组；全部模式（scope=0）有多个分组。 3. 展示结果：书名、作者、评分、在读人数、分类。已下架（soldout=1）需标注。 4. 用户选择某本书后，调 /book/info 获取完整信息。 5. 翻页：hasMore 为 1 时，用最后一条的 searchIdx 作为下一页的 maxIdx。

输出格式

• 搜索结果用编号列表展示，方便用户通过数字选择
• scope=0 时按分组标题（电子书/作者/书单…）分区展示
• 重点展示：书名、作者、评分、在读人数、分类

shelf — 书架管理

重要概念

专辑 = 有声书，两者是同一概念。微信读书中，有声书/听书内容以"专辑"形式存在，存放在书架的 albums 字段中，与 books（电子书）完全独立。

书架里的“书”包含电子书和专辑/有声书。 当用户问“我的书架里有多少本书”“书架有多少本”“书架总数”时，不能只数 books[]，必须同时计入 albums[]。

常见错误：

• ⚠️ 不要通过遍历 books 逐个调 /book/info 检查 format 来判断有声书——/book/info 不返回 format 字段，且效率极低。直接使用 albums 字段即可。
• ⚠️ 书架数量必须用实际返回数组计算，且必须包含 albums[]；不要只用 books.length 回答“书架里有多少本书”。
• ⚠️ 公开/私密阅读数量也必须遍历实际返回条目，不能使用任何未出现在数组中的补丁项。

接口

/shelf/sync

请求参数： 无（用户身份通过 API Key 自动识别）

回包：

数量口径

⚠️ 强制回答规则：当用户问任何书架数量问题时，必须使用实际可枚举数组计算：books.length + albums.length + (mp 非空 ? 1 : 0)。其中 albums.length 必须计入，因为专辑/有声书在书架里也按“书”管理。不要使用其他服务端内部计数字段或基于内部计数字段的公式。

Few-shot：正确计算书架总数

例 1：有电子书和专辑，无文章收藏

回包关键信息：

• books.length = 10
• albums.length = 3
• mp 为空

用户问：“我的书架里有多少本书？”

正确回答：

你的书架共有 13 个条目：10 本电子书 + 3 个专辑/有声书。

错误回答：

你的书架共有 10 本书，另外还有 3 个有声书。

错误原因：用户问的是书架里的书，专辑/有声书也在书架里按“书”管理，必须计入总数，不能“另外还有”。

例 2：无专辑，有文章收藏

回包关键信息：

• books.length = 15
• albums.length = 0
• mp 非空
• 统计出 books 中包含 13 个公开阅读书籍 + 2 个私密阅读书籍

用户问：“我的书架有多少本书？”

正确回答：

你的书架共有 16 个条目：15 个书籍条目 + 1 个文章收藏；其中公开阅读 13 个、私密阅读 3 个。

解释：mp 非空时，文章收藏计入书架总数，并固定计入私密阅读数量。

错误回答：

你的书架共有 15 本纯书籍，另外还有 1 个文章收藏。

错误原因：用户问的是书架总数，文章收藏必须计入总数，不能用“另外还有”把它排除在总数之外。

例 3：有专辑，有文章收藏

回包关键信息：

• books.length = 130
• albums.length = 3
• mp 非空

用户问：“我的书架一共有多少本？”

正确回答：

你的书架可见条目共有 134 个：130 个书籍条目 + 3 个专辑/有声书 + 1 个文章收藏。

错误回答：

你的书架共有 133 个条目，另外还有 1 个文章收藏。

错误原因：文章收藏必须计入书架总数，不能用“另外还有”把它排除在总数之外。

公开/私密阅读数量

公开/私密阅读必须遍历实际返回条目：

• 私密阅读数 = books[].secret == 1 的数量 + albums[].albumInfoExtra.secret == 1 的数量 + (mp 非空 ? 1 : 0)
• 公开阅读数 = books[].secret == 0 的数量 + albums[].albumInfoExtra.secret == 0 的数量
• mp 只表示文章收藏目录入口，不包含具体内容；如果 mp 不存在则不影响公开/私密数量，如果 mp 非空则私密阅读数量固定 +1。

注意：只统计 books[]、albums[] 和 mp 这些实际返回的可见条目；未出现在数组中的服务端补丁项不能纳入公开/私密分组。

工作流

1. 调 /shelf/sync 获取书架列表。 2. 如果用户问“书架有多少本书/多少条目”，先计算可见条目数：total = books.length + albums.length + (mp 非空 ? 1 : 0)；注意 albums[] 是专辑/有声书，也必须计入书架里的书。 3. 如果用户问公开/私密阅读数量，遍历 books[] 和 albums[] 的 secret 字段分组计数；mp 不看 secret，只要非空就给私密阅读数量 +1。 4. 展示：书名、作者、分类，置顶书籍（isTop）标记提示，显示总数。 5. 查询有声书/专辑数量：直接读取 albums 数组长度即可，无需额外接口调用。 6. 用户选择某本书后，调 /book/info 获取详情。 7. 调 /book/getprogress 可查看某本书的阅读进度。

输出格式

• 书架列表用编号展示，支持通过编号选择查看详情
• 无参数时显示书架全览，第一句给出可见书架条目数：books.length + albums.length + (mp 非空 ? 1 : 0)；其中 albums[] 必须作为专辑/有声书计入书架总数
• 如果展示分类构成，各分类数量相加必须等于可见书架条目数；mp 非空时，文章收藏作为 1 个书架条目计入总数
• 公开/私密阅读数量必须展示为遍历 books[]、albums[] 后得到的分组计数，并在 mp 非空时给私密阅读数量 +1
• 传书名/bookId 时查看该书详情或进度
• 涉及有声书/专辑/听书的问题，直接使用 albums 字段回答