| name | shelf-report |
| description | 藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。 |
藏书统计(shelf-report)
适用场景
- 「我家一共有多少书?」
- 「买书总共花了多少钱?」
- 「各分类有多少本?」
- 「谁在读几本书 / 连续阅读几天了?」
前置检查
bookshelf health
执行步骤
bookshelf stats
一期范围说明:一期 stats 为基础版,不接受任何参数。设计方案中提到的按年(--year)、按分类细分(--by)、按渠道花费细分(--spending)等命令为二期示意,一期未实现。当前返回的是全库聚合的 total_spent(仅 CNY)与 by_category 全量分类。
返回字段包括:
total_books:藏书总数
by_status:各阅读状态数量(unread/reading/finished/abandoned/dropped)
by_category:分类统计
total_spent / purchase_count:购书花费
reading_logs_pages_total:阅读日志累计页数
members:各成员在读/读完数量与 streak
回复规范
用自然语言概括 2~4 个关键数字,避免直接 dump 整段 JSON。
示例:「目前藏书 128 本,在读 5 本;购书共花费 ¥3,240。本月阅读日志累计 420 页。」
异常处理
| 情况 | 处理 |
|---|
| API 离线 | 提示检查 bookshelf health 与家庭服务器 |