技能检索与下载
| 方法 | 路径 | 认证 | 输入 / 输出 |
|---|---|---|---|
| GET | /api/public/skillhub |
匿名 | 筛选参数见下表；返回 skills,total,page,pageSize,industries,tags,publisher |
| GET | /api/public/skillhub/{slug} |
匿名 | 返回已发布技能详情，包括版本、来源、获取方式、包类型和可用状态 |
| GET | /api/public/school-skill |
匿名 | 固定平台入口包元数据：版本、SHA-256、字节数、下载地址 |
| GET | /api/school-skill/download?version={version} |
匿名 | 平台入口 ZIP；不存在或已下架返回 404 |
| GET | /api/skillhub/{slug}/download?version={version} |
匿名或安装口令 | 本站托管 ZIP；会员包必须携带安装口令，外部来源返回 404 并提示使用官方来源 |
| POST | /api/skillhub/{slug}/install-token |
会话 + 合法 Origin | 会员包口令；返回 token,expiresAt,version,sha256,bytes,packageType，当前不是中心 Key 接口 |
GET /api/public/skillhub 查询参数：
| 字段 | 默认 / 范围 | 说明 |
|---|---|---|
q |
空，最多 200 字符 | 空白分词，每个词都需匹配标题、简介、描述、标识、行业、标签或平台等文本 |
publisher |
空 | 发布来源固定 ID，如 link2 / ailingtu；未知来源返回空列表 |
industry |
空，最多 100 字符 | 行业 ID；从实际列表聚合值取得 |
origin |
all / community |
仅社区投稿或全部 |
tag |
空，最多 40 字符 | 标签 |
access |
all / free / postpaid / member |
获取方式；postpaid 不代表下载时自动扣费 |
page |
1，正整数 | 显式分页，客户端不自动遍历全部结果 |
pageSize |
12，1–100 | 每页条数 |
详情沿用 skillhub 契约 的 publicSkillSchema。关键字段为 slug,packageName,displayName,summary,description,version,packageType,source,publisher,publisherName,access,status,available,updatedAt，以及安装说明、平台、标签等。available 不等于当前用户有下载权限；外部来源按 installUrl 安装。普通详情不保证总有下载摘要，安装索引和会员口令响应提供可校验的包摘要。
公开目录只收录已发布且满足展示条件的作品；未精选的社区作品可能有可访问详情，但不会进入搜索和安装索引。平台入口 link2-school-skill 及历史标识不在业务目录中，使用专用入口接口获取。
匿名查询示例：
curl --fail-with-body --get 'https://link2.cn/api/public/skillhub' \
--data-urlencode 'q=跨境' --data-urlencode 'publisher=link2' \
--data-urlencode 'page=1' --data-urlencode 'pageSize=12'
curl --fail-with-body 'https://link2.cn/api/public/school-skill'
