初始发布: 21 个 skills (Claude Code / Codex / DSH)

weread-skills/discover.md

@@ -0,0 +1,70 @@
+# discover — 发现推荐好书
+
+## 接口
+
+### `/book/recommend` — 个性化推荐（为你推荐）
+
+基于用户阅读记录的个性化推荐，与 App 首页「为你推荐」一致。
+
+**请求参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `count` | int | 否 | 每页数量，默认 12 |
+| `maxIdx` | int | 否 | 翻页偏移，默认 0 |
+
+**回包：**
+
+| 字段 | 说明 |
+|------|------|
+| `books` | 推荐书籍数组 |
+| `books[].bookId` | 书籍 ID |
+| `books[].title` | 书名 |
+| `books[].author` | 作者 |
+| `books[].cover` | 封面图 URL |
+| `books[].intro` | 简介 |
+| `books[].category` | 分类 |
+| `books[].reason` | 推荐理由 |
+| `books[].readingCount` | 在读人数 |
+| `books[].searchIdx` | 结果序号（用于翻页） |
+| `books[].newRating` | 评分（0-100） |
+| `books[].newRatingCount` | 评分人数 |
+| `books[].newRatingDetail.title` | 评分标签（如"神作""力荐"） |
+| `books[].price` | 价格（分） |
+| `books[].payType` | 付费类型 |
+| `books[].type` | 书籍类型（0=电子书） |
+
+### `/book/similar` — 相似书推荐
+
+基于某本书推荐相似书籍，与 App 书籍详情页「相似推荐」一致。
+
+**请求参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `bookId` | string | 是 | 书籍 ID |
+| `count` | int | 否 | 每页数量，默认 12 |
+| `maxIdx` | int | 否 | 翻页偏移，默认 0 |
+| `sessionId` | string | 否 | 翻页会话 ID（首次不传，后续传回包中的值） |
+
+**回包：**
+
+| 字段 | 说明 |
+|------|------|
+| `booksimilar.sessionId` | 会话 ID（翻页时传入下次请求） |
+| `booksimilar.books` | 推荐书籍数组 |
+| `booksimilar.books[].idx` | 结果序号（下次请求 maxIdx 传最后一条的 idx） |
+| `booksimilar.books[].book.bookInfo` | 书籍信息（bookId, title, author, cover 等） |
+
+## 工作流
+
+1. **无参数**：调 `/book/recommend` 获取个性化推荐（为你推荐）。
+2. **有 bookId**：调 `/book/similar` 推荐相似书。
+3. **有关键词**：调 `/store/search` 搜索发现。
+4. 用户对推荐的书感兴趣时，调 `/book/info` 获取完整信息。
+5. 翻页（recommend）：用 `searchIdx` 作为下次的 `maxIdx`。
+6. 翻页（similar）：用最后一条的 `idx` 作为 `maxIdx`，带上 `sessionId`。
+
+## 输出格式
+- 推荐列表用编号展示，每本书含书名、作者、评分、推荐理由
+- 提示用户可选择编号查看详情或继续推荐更多