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
# search — 搜索

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

## 核心约束

1. 所有回复必须基于接口返回数据,不编造、不推断、不补充接口未返回的信息。
2. `scope` 选择必须基于用户意图,不要默认全部使用 `scope=10`。
3. 始终显式传 `scope`,不要依赖服务端默认值。
4. 禁止输出中间推理过程,不要在回复中暴露 scope 选择逻辑、参数拼装思路等内部过程。
5. 搜索结果是分页片段,不代表全量结果;回复中使用"为您找到",不要使用"共有""一共""总共"等暗示结果完整的措辞。
6. 请求参数 `scope` 和回包字段 `results[].scope` 不是同一个语义:找书时仍传 `scope=10`,但电子书分组回包可能是 `results[].scope=17`;不要用 `results[].scope == 10` 过滤电子书结果。
7. 每次搜索都传 `context`,用于记录触发搜索的用户问题及必要对话背景;`context` 不等同于抽取后的 `keyword`。

## 接口

`/store/search`

**请求参数:**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `keyword` | string | 是 | 搜索关键词 |
| `context` | string | 是(Agent) | 触发本次搜索的用户原始问题;复杂多轮场景按下方规则整理。接口兼容层面可省略,但 Agent 调用必须传 |
| `scope` | int | 否 | 搜索类型。接口层可省略,但 Agent 必须按下方“scope 选择指引”显式选择;未传时服务端默认 10(电子书) |
| `maxIdx` | int | 否 | 翻页偏移,默认 0 |
| `count` | int | 否 | 每页数量,不传则服务端默认 15。用户未指定数量时不要传此参数 |

**scope 对应关系:**

| scope | 名称 | 说明 |
|-------|------|------|
| `0` | 全部 | 综合搜索,results 中包含多个分组;适合用户只说“搜一下”且未限定类型 |
| `10` | 电子书 | 只搜电子书(不含网文小说);适合用户明确“搜书/找书/搜某本书” |
| `16` | 网文小说 | 只搜网文小说 |
| `14` | 微信听书 | 有声书/专辑/播客(三者同义) |
| `6` | 作者 | 搜索作者 |
| `12` | 全文 | 搜索书籍正文内容 |
| `13` | 书单 | 搜索书单 |
| `2` | 公众号 | 搜索公众号 |
| `4` | 文章 | 搜索公众号文章 |

> `scope=17` 是服务端回包中电子书分组常见的加载/分页标识,不是 Agent 的首选请求参数。用户找书时仍按 `scope=10` 请求。

**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`。

## 对话上下文上报

`context` 用于了解用户在什么对话和场景下触发搜索,按以下规则构造:

1. **单轮且语义完整**:原样传当前用户问题,不改写成关键词;其中如含 API Key、访问令牌等凭据,必须先移除。例如用户说“帮我搜一下三体”,则 `context="帮我搜一下三体"`,同时单独传 `keyword="三体"`。
2. **多轮或存在指代**:保留当前用户原话,再补充理解本次搜索必需的简短摘要。推荐格式为 `当前问题:<用户原话>;上下文摘要:<必要背景>`。例如:`当前问题:他的其他书呢?;上下文摘要:前文正在讨论作者刘慈欣,用户想继续查找该作者的其他作品。`
3. **由其他任务间接触发搜索**:仍传触发调用的真实用户问题,并摘要说明搜索用途。例如用户要求“看看《三体》的笔记”,为解析 bookId 调用搜索时,可传:`当前问题:看看《三体》的笔记;上下文摘要:本次搜索用于确认用户所指书籍并获取 bookId。`
4. **续页**:为完成同一个用户请求而自动翻页时,沿用首次调用的 `context`。如果用户在后续轮次明确说“继续”“更多”等,应生成新的 `context`,保留这次用户原话,并摘要此前的搜索对象和条件;不要把 Agent 自己生成的“继续搜索”等文案冒充用户问题。
5. **最小必要原则**:摘要通常用一至三句话,只保留搜索对象、用户目标、已明确的指代和约束。不要上传无关历史、系统/开发者提示、内部推理、完整工具回包、API Key、访问令牌或其他凭据。

## 参数提取规则

从用户输入中提取 `keyword` 时:

1. 去掉"帮我""搜一下""找一下""有没有""请问"等口语化前缀/后缀,只保留核心检索词。
2. 保留真正要搜索的实体或主题:
   - "帮我搜一下三体" → `keyword=三体`
   - "有没有刘慈欣的书" → `keyword=刘慈欣`
   - "找一本关于量子力学的入门书" → `keyword=量子力学入门`
3. 用户使用"这个作者""他的其他书"等代词时,结合对话上下文补全为实际实体名称再搜索。
4. 同时提到书名和作者时,优先使用更具区分度的词作为 `keyword`,如"刘慈欣的三体"优先搜 `三体`。

**回包(V3 格式):**

| 字段 | 说明 |
|------|------|
| `sid` | 搜索会话 ID |
| `hasMore` | 是否有更多(1=有, 0=无) |
| `results` | 搜索结果分组数组 |
| `results[].title` | 分组标题(如"电子书""作者") |
| `results[].scope` | 回包分组类型,不保证等于请求参数 `scope`。例如请求 `scope=10` 搜电子书时,电子书分组可能返回 `scope=17` |
| `results[].scopeCount` | 该分组总结果数 |
| `results[].currentCount` | 本次返回数量 |
| `results[].books` | 书籍/结果数组 |
| `results[].books[].searchIdx` | 搜索序号(用于翻页) |
| `results[].books[].bookInfo` | 书籍信息对象 |
| `results[].books[].bookInfo.bookId` | 书籍唯一标识 |
| `results[].books[].bookInfo.readerLink` | 阅读器跳转链接;展示为 `[打开阅读]({readerLink})` |
| `results[].books[].bookInfo.deepLink` | 书籍详情跳转链接;没有 `readerLink` 时可展示为 `[查看详情]({deepLink})` |
| `results[].books[].bookInfo.title` | 书名 |
| `results[].books[].bookInfo.author` | 作者 |
| `results[].books[].bookInfo.cover` | 封面图 URL |
| `results[].books[].bookInfo.intro` | 书籍简介 |
| `results[].books[].bookInfo.publisher` | 出版社 |
| `results[].books[].bookInfo.category` | 分类 |
| `results[].books[].bookInfo.payType` | 付费类型 |
| `results[].books[].bookInfo.price` | 价格(分) |
| `results[].books[].bookInfo.soldout` | 是否下架 |
| `results[].books[].readingCount` | 在读人数 |
| `results[].books[].newRating` | 评分(0-100) |
| `results[].books[].newRatingCount` | 评分人数 |
| `results[].books[].newRatingDetail` | 评分标签(如 `{"title":"神作"}` ) |

> `scope=0`(全部)时 results 会返回多个分组(电子书、作者、书单等),每个分组有自己的 title 和 scope。展示时按回包内容处理,不要把请求 scope 当作分组过滤条件。

## 工作流

1. 按“对话上下文上报”规则生成 `context`。
2. 根据用户意图选择 `scope`,调 `/store/search`,显式传入 `scope` 和 `context`。
3. 从 `results` 取搜索结果。单 tab 模式(scope>0)可能返回多个同类分组;全部模式(scope=0)有多个分组。
4. 展示结果:书名、作者、评分、在读人数、分类。已下架(soldout=1)需标注;如有 `readerLink`,展示为 `[打开阅读]({readerLink})`;否则如有 `deepLink`,展示为 `[查看详情]({deepLink})`。
5. 用户选择某本书后,调 `/book/info` 获取完整信息。
6. 翻页:`hasMore` 为 1 时,用最后一条的 `searchIdx` 作为下一页的 `maxIdx`;自动翻页沿用当前 `context`,用户在新一轮要求继续时按上方规则生成新的 `context`。

### 结果处理细则

- 用户找书时请求 `scope=10`;回包中标题为"电子书"或包含 `books` 的分组都可以展示,不要要求 `results[].scope == 10`。

## 输出格式
- 搜索结果用编号列表展示,方便用户通过数字选择
- scope=0 时按分组标题(电子书/作者/书单…)分区展示
- 重点展示:书名、作者、评分、在读人数、分类
- 空结果(`results` 为空数组或无匹配项)时回复:`抱歉,没有找到与"{keyword}"相关的结果。你可以换个关键词、检查错别字,或尝试更简短的关键词。`
- 接口调用失败时回复:`搜索服务暂时不可用,请稍后再试。如果持续出现问题,可以换个关键词尝试。`
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