来源目录发布
本组仅接受已授权学堂且具有本地发布来源范围的中央 API Key。没有来源授权的 Key 只能使用本人投稿接口，不接受平台发布口令。
| 方法 | 路径 | 请求与结果 |
|---|---|---|
| GET | /api/skillhub/publish |
支持技能列表筛选；返回授权来源目录（含草稿和下架项）、status,maxZipBytes,publishers,requiresPublisherSelection |
| GET | /api/skillhub/publish?slug={slug} |
查询一个授权来源条目，取得版本与 updatedAt |
| POST | /api/skillhub/publish |
multipart catalog JSON 字符串、可选 file ZIP、可选 importOnly=true；或 JSON {catalog,importOnly?} |
| POST | /api/skillhub/publish |
JSON {action:"set-status",slug,status:"archived"或"published",version,updatedAt}；上下架并校验并发版本 |
发布响应为 {mode,slug,version}；完成后读取单条详情核对来源与状态。目录字段以 skillCatalogSchema 为准，新目录至少提供 slug,version,displayName。多来源密钥必须指定 catalog.publisher；单来源可省略。外部来源需提供 sourceUrl,installUrl，且不支持会员获取方式。新版本通过上传发布，不覆盖同一已发布版本；来源密钥不能跨来源覆盖或删除目录。
GET 列表包含授权来源范围信息，不应把它当作公开目录。批量上下架先逐项读取 version,updatedAt 并核对清单；冲突后重新读取，不自动覆盖。详细规则见 技能发布来源 和 学员 Skill 发布与分享。
