SuperAPI AI 工具集

xapi-provider

编程与开发

查看项目

更新于 10-16 04:33

技能介绍

用途:通过 xapi-to CLI 注册和运营 xAPI 服务,适用于创建 HTTP、流式、AI 或 WebSocket 服务,配置上游认证、计费与 OAuth 用户上下文等场景。所有 xAPI 管理操作都应使用 npx xapi-to,不要直接调用管理 HTTP 端点。

主要能力:服务生命周期管理(create、list、get、versions、version update、diff、publish、review、revision start、major create);市场内容更新(provider update);使用 Skill 的生成、提交、等待、关联与指纹(skill scaffold/submit/wait/link/fingerprint/context);可观测性(metrics、events、usage wait);回滚与弃用(rollback、default-major、deprecate、restore);收益查询与转账(earnings、earnings list、earnings transfer)。

使用方式:先运行 npx xapi-to provider --help 和 npx xapi-to skill --help 检查 CLI。密钥从已保存配置、XAPI_KEY 或 XAPI_API_KEY 读取,未配置时让用户自行配置且不回显。服务契约与上游凭据放入 JSON 文件,用 --file 传入,避免密钥进入 shell 历史。创建草稿后检查 diff 再发布;发布可能改变线上行为,CLI 不会自动重试不明确的写入。回滚等操作同样不要自动重试。删除需 service:delete 权限并显式确认服务名或 ID。

限制:不同操作需要对应 scope(如 service:create、service:read、service:update、version:create、service:publish、service:rollback、observability:read、skill:read、skill:submit、earnings:read、earnings:transfer、service:delete)。scope 与所有权独立,拥有某 scope 的密钥不能管理其他 provider 的服务或 Skill。转账为单向操作,需先确认金额与已结算余额,重试只能使用相同的幂等键和金额。若命令返回缺少 scope 错误,应停止并报告确切 scope,不要尝试无关密钥。具体计费、价格与平台细节资料未提供。