# SkillPKG 搜索

Canonical page: https://skillpkg.com/search

站内搜索按内容模块分别检索文章、技能包和在线助手。提示词库目前不在站内搜索范围内，请通过 [提示词分类](https://skillpkg.com/prompts) 浏览。

## 网页参数

| 参数 | 说明 |
| --- | --- |
| `q` | 搜索关键词，需要非空；URL 中应编码特殊字符 |
| `collection` | `articles`、`packages` 或 `assistants`；未指定时默认文章 |
| `page` | 从 `1` 开始的页码；切换关键词或模块后从第一页开始 |

示例：[搜索技能包中的 code](https://skillpkg.com/search?q=code&collection=packages&page=1)。其中 code 是查询示例，不表示网站一定有匹配结果。

搜索文章时匹配标题、文章文本及分类名；搜索技能包或助手时匹配名称或标题、简介及分类名。网页搜索不是一次同时检索全部模块的聚合结果。

## 推荐流程

1. 打开搜索页，选择“文章”“技能包”或“助手”。
2. 输入关键词后点击“搜索”。单独切换页签并不提交新的查询，需要再次搜索。
3. 等待搜索请求完成，跟随结果链接进入详情；通过分页控件继续读取结果。
4. 结果为空时尝试更简短的名称、同义词或分类入口。空结果仅表示当前查询未匹配，不表示网站没有该能力。

搜索结果在浏览器中通过请求加载。只获取初始 HTML 的客户端可能看不到结果，应等待页面加载，或读取以下同源搜索接口。

## 网页搜索使用的只读接口

`GET /api/search?q={query}&collection={collection}&page={page}&pageSize={pageSize}`。

- 支持的 collection 仍为 `articles`、`packages`、`assistants`。不要传 `prompts` 或任意集合名。
- 使用非空 q、从 `1` 开始的页码和合理的 pageSize；网页每页使用 `20` 条。
- 成功结果位于 `data.docs`，分页信息位于 `data.meta`，包含 `page`、`totalPages`、`totalDocs` 和 `limit`。
- 文章和助手的结果包含标题与 slug，技能包结果包含名称、slug 和 publicId；网页详情应优先使用返回的实际 slug。
- 该接口服务于网页搜索，不提供下载、投稿或助手运行功能。程序化的 Skill/Solution 分类、筛选、详情和下载请使用 [API Key 接口](https://skillpkg.com/api.md)。

Related: [分类浏览](https://skillpkg.com/categories.md)、[提示词](https://skillpkg.com/prompts.md)、[网站指南](https://skillpkg.com/index.md)。