SkillHub 发布管家

它解决什么问题

手动调用 SkillHub API 发布技能时，有几个坑几乎必踩：上传目录里混入图片或 _meta.json，接口直接返回 400「不允许的文件类型」；封面图不知道该塞到哪个字段；遇到 429 限流只能干等；slug 被占用时发布会莫名其妙地 500。这个技能把这些修复全部固化进了 scripts/skillhub_publish.py，发布过程不需要手写任何 API 调用。

核心能力与工作流程

发布流程被拆成几个明确步骤，每一步都可以单独检查：

• 登录检查：先确认是否已登录，未登录时才需要传入 skh_ 开头的 token，且 token 全程脱敏，不会出现在输出里。
• 技能识别：用 list 命令列出本地全部技能，用户给出目录路径、名字甚至 zip 都可以。
• 元数据校验：缺 slug、displayName、version 时自动补进 SKILL.md 的 frontmatter，这些字段不影响技能本地运行。
• 预检与确认：发布前展示摘要供确认，支持 --dry-run 只做预检不上传。
• 自动发布：脚本完成文件过滤、封面走 cover 专用 multipart 字段上传、429 指数退避重试（30s 起、封顶 600s、最多 7 次）、slug 冲突时自动加 wb- 前缀重试并回写 SKILL.md。

适用边界与注意点

• 需要 Python 3.10+ 和已登录的 SkillHub CLI；首次使用前要从 skillhub.cn 个人设置拿到 API token。
• 新发布的技能状态是 pending，需要等平台审核才会公开，这不是发布失败。
• 脚本只补 SkillHub 专用元数据，不会改动技能本身的功能字段，但用它更新已发布技能时记得升版本号。
• token 是敏感信息，工具层面做了脱敏，自己也不要在截图或日志里泄露。