核心用法
ClawHub Publish Doctor 是一套面向 ClawHub/ClawDHUB 技能发布场景的故障诊断与修复方案。其核心工作流分为三阶段：
1. 预检阶段 (scripts/clawhub_preflight.sh)：自动检测环境依赖、配置完整性及潜在冲突
2. 认证修复：针对浏览器登录失败、token 失效等问题，优先推荐无头环境适用的 token 登录模式 (clawhub login --token)
3. 安全发布 (scripts/clawhub_publish_safe.sh)：带重试机制的发布脚本，自动处理 transient 状态的 registry 延迟
显著优点
- 场景覆盖全面：涵盖认证失败、依赖缺失、安全扫描 pending、URL 配置错误等高频故障点
- 自动化预检：在发布前拦截环境问题，降低失败率
- Transient 容错：明确将发布后的 inspect 错误识别为"可能临时状态"，避免过度反应
- 双通道验证：同时通过 CLI (
clawhub inspect) 和 Web URL 验证发布结果 - 无头环境友好：优先 token 认证，适配 CI/CD 场景
潜在缺点与局限性
- 平台专属性强：仅针对 ClawHub/ClawDHUB 生态，无法迁移至其他技能市场
- Shell 脚本依赖：预检和安全发布脚本需 Bash 环境，Windows 原生支持有限
- Token 管理负担：无头登录依赖长期有效的 access token，存在泄露风险
- Transient 判定主观："几分钟内可能恢复"的假设缺乏定量标准，可能延误真实故障发现
适合人群
- 频繁向 ClawHub 发布技能的开发者与团队
- 在 CI/CD 流水线中集成技能发布的 DevOps 工程师
- 遭遇反复发布失败、需要系统化排查手册的技术人员
常规风险
- 认证凭证泄露：token 若以明文形式存储于环境变量或脚本中，可能被日志或版本控制暴露
- 重试风暴：自动重试机制若配置不当，可能在 registry 故障时放大请求压力
- URL 规范化陷阱：技能 slug、用户名大小写或特殊字符处理不一致可能导致 404
- 安全扫描误判：将真实安全拦截误判为 transient 延迟，导致问题技能上线