核心用法
Skill Hub Gateway 是一个面向 AI Agent 的异步任务调度网关，采用执行-轮询（Execute-Poll）架构。开发者通过 POST /skill/execute 提交任务，获取 run_id 后，使用 GET /skill/runs/:run_id 轮询状态直至 succeeded 或 failed 终端状态。成功时返回 output，失败时返回包含 code 和 message 的 error。
网关提供全自动引导流程：通过 install_code 机制，Agent 可在无预置密钥的情况下完成自举（bootstrap），获取 api_key 后持久化调用。手动模式支持直接传入 api_key 或读取 SKILL_API_KEY 环境变量覆盖。
内置能力清单
| 能力 ID | 功能 |
|---------|------|
| `human_detect` | 人体检测 |
| `image_tagging` | 图像标签 |
| `tts_report` / `tts_low_cost` | 文本转语音（标准/低成本） |
| `embeddings` | 文本向量化 |
| `reranker` | 重排序 |
| `asr` | 语音识别 |
| `markdown_convert` | Markdown 转换 |
技术约束
- 图像输入需为直接文件 URL（
Content-Type: image/*），不接受网页链接 - 仅支持
node运行时环境 - CLI 脚本提供最小依赖的 JavaScript 实现
显著优点
- 零配置启动：
install_code自动引导消除密钥管理负担 - 异步解耦：执行与结果分离，适合长时 AI 任务
- 多模态统一：单端点调度图像、语音、NLP 能力
- 运行时友好：提供
runtime-auth.mjs缓存助手，避免重复引导
潜在缺点与局限性
- 轮询开销：无 WebSocket/Push 机制，高频轮询增加延迟与成本
- Node 强依赖：非 Node 环境需自行实现协议
- 能力黑盒：仅暴露 ID 列表，无能力参数文档（需查
references/） - 单点依赖：
binaryworks.app域名绑定，迁移成本未明
适合人群
- 构建 AI Agent 或自动化工作流的开发者
- 需要快速集成多模态能力（CV/ASR/TTS/NLP）但不愿分别对接多个服务商的团队
- 具备 Node.js 基础、接受异步编程模型的技术栈
常规风险
| 类别 | 说明 |
|------|------|
| 密钥安全 | `api_key` 经网络传输，需确保 `bootstrap` 端 TLS 合规；缓存文件权限需限制 |
| 轮询风暴 | 未实现指数退避的轮询逻辑可能触发限流 |
| 输入验证 | 图像 URL 校验由调用方负责，错误类型导致任务失败 |
| 供应商锁定 | 能力实现细节未开源，迁移需重新适配接口 |