Skip to content

Tencent/WeChatReading / skills

weread-skills

Verified

微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书

FileKindSize
SKILL.mdskill md6.6 KB
book.mdmarkdown3.7 KB
discover.mdmarkdown5.7 KB
notes.mdmarkdown13.0 KB
profile.mdmarkdown2.8 KB
readdata.mdmarkdown12.0 KB
review.mdmarkdown4.1 KB
search.mdmarkdown9.0 KB
shelf.mdmarkdown8.0 KB

discover.md

View on GitHub
# discover — 发现推荐好书

## 接口

### `/book/recommend` — 个性化推荐(为你推荐)

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

**请求参数:**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `context` | string | 是(Agent) | 触发本次推荐的用户原始问题;复杂多轮场景按下方规则整理。接口兼容层面可省略,但 Agent 调用必须传 |
| `count` | int | 否 | 每页数量,默认 12 |
| `maxIdx` | int | 否 | 翻页偏移,默认 0 |

**回包:**

| 字段 | 说明 |
|------|------|
| `books` | 推荐书籍数组 |
| `books[].bookId` | 书籍 ID |
| `books[].readerLink` | 阅读器跳转链接;展示为 `[打开阅读]({readerLink})` |
| `books[].deepLink` | 书籍详情跳转链接;没有 `readerLink` 时可展示为 `[查看详情]({deepLink})` |
| `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 |
| `context` | string | 是(Agent) | 触发本次相似书推荐的用户原始问题;复杂多轮场景按下方规则整理。接口兼容层面可省略,但 Agent 调用必须传 |
| `count` | int | 是 | 每页数量;实际调用必须显式传入,首次推荐传 12,用户明确指定数量时可传对应数量 |
| `maxIdx` | int | 是 | 翻页偏移;实际调用必须显式传入,首次传 0,翻页传上一页最后一条的 `idx` |
| `sessionId` | string | 否 | 翻页会话 ID(首次不传,后续传回包中的值) |

> `/book/similar` 实际转发到 `/book/detailinfo?listtypes=2&synckey=0`。底层要求 `listTypes`、`synckey`、`maxIdx`、`count` 四组参数长度一致,因此调用时不能省略 `count` 和 `maxIdx`,不要依赖接口文档中的默认值。

**回包:**

| 字段 | 说明 |
|------|------|
| `booksimilar.sessionId` | 会话 ID(翻页时传入下次请求) |
| `booksimilar.books` | 推荐书籍数组 |
| `booksimilar.books[].idx` | 结果序号(下次请求 maxIdx 传最后一条的 idx) |
| `booksimilar.books[].book.bookInfo` | 书籍信息(bookId, title, author, cover 等) |
| `booksimilar.books[].book.bookInfo.readerLink` | 阅读器跳转链接;展示为 `[打开阅读]({readerLink})` |
| `booksimilar.books[].book.bookInfo.deepLink` | 书籍详情跳转链接;没有 `readerLink` 时可展示为 `[查看详情]({deepLink})` |

## 对话上下文上报

调用 `/book/recommend`、`/book/similar`,以及本工作流转入的 `/store/search` 时,都必须传 `context`:

1. **单轮且语义完整**:原样传当前用户问题;其中如含 API Key、访问令牌等凭据,必须先移除。例如:`给我推荐几本推理小说`。
2. **多轮推荐**:保留当前用户原话,并摘要与推荐有关的阅读偏好、已讨论对象、反馈和限制。推荐格式为 `当前问题:<用户原话>;上下文摘要:<必要背景>`。例如:`当前问题:再轻松一点的呢?;上下文摘要:用户上一轮想找科幻小说,但认为首轮推荐过于沉重,希望本轮更轻松、节奏更快。`
3. **指向某本书的相似推荐**:若当前问题使用“这本”“类似的”等指代,在摘要中写明已确认的书名和 bookId。例如:`当前问题:有没有和这本类似的?;上下文摘要:此处“这本”指《三体》,并使用前序已确认的 bookId。`
4. **续页**:为完成同一个用户请求而自动翻页时,沿用当前 `context`。如果用户在后续轮次明确说“继续”“更多”等,或评价结果、增加偏好、改变条件,应生成新的 `context`,保留这次用户原话,并摘要此前的推荐目标和相关反馈。
5. **最小必要原则**:摘要通常用一至三句话,不复制整段历史。不要上传无关对话、系统/开发者提示、内部推理、完整工具回包、API Key、访问令牌或其他凭据。

## 工作流

1. 按“对话上下文上报”规则生成 `context`。
2. **无参数**:调 `/book/recommend` 获取个性化推荐(为你推荐),传入 `context`。
3. **有 bookId**:调 `/book/similar` 推荐相似书,必须显式传 `context`、`count` 和 `maxIdx`;首次推荐 `count=12`、`maxIdx=0`。
4. **有关键词**:调 `/store/search` 搜索发现,并按 `search.md` 传入 `context`。
5. 用户对推荐的书感兴趣时,调 `/book/info` 获取完整信息。
6. 翻页(recommend):用 `searchIdx` 作为下次的 `maxIdx`;自动翻页沿用当前 `context`,用户在新一轮要求继续时重新生成 `context`。
7. 翻页(similar):用最后一条的 `idx` 作为 `maxIdx`,继续显式传 `count` 并带上 `sessionId`;`context` 的处理与 recommend 翻页相同。

## 输出格式
- 推荐列表用编号展示,每本书含书名、作者、评分、推荐理由
- 提示用户可选择编号查看详情或继续推荐更多
- 无推荐结果时回复:`暂时没有找到合适的推荐,换个关键词试试?`
- 接口调用失败时回复:`推荐数据获取失败,请稍后再试~`
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall