SkillHub一键上传工具（专业版）

这个工具解决什么问题

把本地 skill 目录发布到 SkillHub，看似只是一次 HTTP 上传，实际踩坑的人不少：

• 官方示例大多依赖 curl 构造 multipart/form-data，但 Windows 下 curl 常因 SSL/TLS 重置、cmd.exe 分号截断、bash PATH 混乱而报错，中文路径的编码问题更让人头疼；
• 平台要求元数据从 SKILL.md 的 front matter 提取，手动整理 slug、version、displayName 容易遗漏；
• 不小心把 .git、__pycache__、测试数据一起打包，会被上传过滤逻辑拒绝；
• 连续上传触发 429 限流后，没有自动重试机制就得手动等待。

SkillHub一键上传工具（专业版）就是针对这些高频痛点写的自动化脚本。

核心能力与工作流程

纯 Python 标准库实现，零外部依赖。 工具用 urllib 原生构造 multipart 请求，不再依赖 curl，在 Windows / macOS / Linux 上行为一致。

自动提取元数据。 上传前自动读取 SKILL.md 的 YAML front matter，提取 slug、version、displayName、summary、description、tags 等字段并校验必填项。

智能文件过滤。 只保留 .md、.py、.sh、.json、.yaml、.txt 等平台支持的扩展名，自动排除 .git、__pycache__、node_modules、.workspace 目录，以及 .gitignore、.DS_Store、*.pyc、*.pyo 和测试数据文件。

限流自愈。 遇到 429 响应自动等待 60 秒后重试，不用人工介入。

一次上传的完整步骤是：读取并校验 front matter → 扫描并过滤文件 → 构造 multipart 请求 → 处理响应（含 429 重试）→ 返回发布结果和 skill 信息。

适用边界与注意点

• slug 全局唯一，被占用后建议加 -pro 或用户名后缀，如 xxx-ccct；
• 同版本号不能覆盖上传，更新 SKILL.md 的 version 字段后才能发布新版本；
• 包含 .env、*.key 或硬编码密码的文件会被安全扫描拦截，发布前先自查；
• --host 默认指向 https://api.skillhub.cn，自建 registry 场景才需要改；
• 如果你还在看到 curl 相关报错，说明用的是旧版脚本，升级到基于 urllib 的最新版本即可。