目录发布
本组仅接受已授权学堂且账号获发布权限的中央 API Key，不接受平台发布口令。已授权账号可维护平台目录；不再按来源隔离或选择来源。
| 方法 | 路径 | 请求与结果 |
|---|---|---|
| GET | /api/skillhub/publish |
支持技能列表筛选；返回平台目录（含草稿和下架项）、status,maxZipBytes,publishAllowed |
| 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，且不支持会员获取方式。新版本通过上传发布，不覆盖同一已发布版本；发布 Key 不能调用管理员永久删除接口。
GET 列表包含未上架目录，不应把它当作公开目录。批量上下架先逐项读取 version,updatedAt 并核对清单；冲突后重新读取，不自动覆盖。账号发布权限见认证方式。个人投稿已停用。
技能图标
目录发布支持可选 icon 和 iconColor，详情读取返回保存值。更新时省略字段保留已有选择，新条目省略时由服务端分配。图标使用内置标识，不上传图片或提供任意 URL。
icon：blocks、book-open、images、shield-check、download、wrench、clipboard-list、notebook-pen、send、image-play、chart-no-axes-combined、messages-square、clapperboard、list-todo。iconColor：blue、purple、green、orange、rose、teal。
