API 参考文档
Base URL: /v1 | 外部调用认证方式: Authorization: Bearer sk_xxx；Web Console 使用登录 Session
当前阶段策略：Skill 默认保持 draft，publish/deprecate API 暂时禁用，仅管理员可通过 /v1/admin/skills/:skillId/status 修改状态。
Skills
| GET | /v1/skills | 列表查询（q；兼容 keyword/query/search） | 公开 |
| GET | /v1/skills/:id | 获取详情 | 公开 |
| GET | /v1/skills/:id/versions | 版本列表 | 公开 |
| GET | /v1/skills/:id/versions/:ver/download | 下载（公开仅限 published；管理员可下载 draft/deprecated） | 公开 / Admin Session |
| POST | /v1/skills | 创建草稿 | Session / skill:upload |
| POST | /v1/skills/with-package | 创建草稿并上传初始版本 | Session / skill:upload |
| PATCH | /v1/skills/:id | 更新元信息 | Session / skill:upload |
| POST | /v1/skills/:id/versions | 上传新版本 | Session / skill:upload |
| GET | /v1/skills/:id/versions/:ver/files | 文件列表（公开仅限 published） | 公开 / owner / admin |
| DELETE | /v1/skills/:id | 删除 draft Skill | Session / skill:upload |
| POST | /v1/skills/:id/publish | 发布（暂不可用） | ⛔ 禁用 |
| POST | /v1/skills/:id/deprecate | 下线（暂不可用） | ⛔ 禁用 |
Feedback
| POST | /v1/feedback | 提交反馈 | 公开 |
| GET | /v1/skills/:id/feedback | 查看 Skill 收到的反馈 | Owner / Admin Session |
| GET | /v1/skills/:id/stats | 统计数据 | 公开 |
Logs
| GET | /v1/logs | 查询调用日志 | Session / API Key |
| GET | /v1/logs/:requestId | 按 request_id 查询 | Session / API Key |
Admin
| PATCH | /v1/admin/skills/:skillId/status | 发布 / 下线 / 重新发布 Skill | Admin Session |
