前言¶
在 Agent 里做 3D Gaussian Splatting（3DGS）的重建或生成，往往要按顺序处理多步 OpenAPI：上传素材、创建异步任务、轮询状态、再拉取 PLY / SPZ / SOG 等产物。步骤分散在文档里，容易漏掉 worldId 或 poll 时机。下面介绍 SkillHub 上的 Aholo 3DGS重建与生成（@user_a0383623/aholo-3dgs-reconstruction），它把上述流程写成 Agent 可执行的 Skill，且明确不覆盖 2D 出图场景。
这是什么¶
Aholo 3DGS重建与生成 是面向 Aholo OpenAPI v1 的 3D 任务（reconstruction / generation）编排 Skill：素材上传 → 创建任务（成功返回 WorldAsyncOperation / worldId）→ status / poll → 获取 PLY / SPZ / SOG 等结果。
- 坐标：
@user_a0383623/aholo-3dgs-reconstruction - 当前版本：1.0.12（SkillHub 页面标注 v1.0.12）
- 分类：ai-agent；来源：community；页面标注作者为 Aholo Studio
- 标签：
requires_api_key=true（调用需配置 API Key，具体字段以 Skill 包内说明为准） - 官方入口：SkillHub 技能页、API 索引
SkillHub 统计（抓取资料）：评分 100000，下载 1240 次。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面描述，仅覆盖 3D reconstruction / generation：
- 素材上传：在创建 3D 任务前完成素材上传（具体接口与参数由 Skill 内指引 Aholo OpenAPI v1）。
- 创建 3D 任务：发起创建后，成功响应包含 WorldAsyncOperation 与 worldId，用于后续查询。
- 进度查询：通过 status / poll 持续查询任务进度，直到完成或失败。
- 结果获取：任务完成后拉取 3D 产物，支持 PLY / SPZ / SOG 等格式。
任务创建策略（Skill 线索与简介一致）：
- 默认：单笔用户诉求每轮 一次
create。 - 用户明确多个视频需要 各自重建 时，可按视频数量 多次
create。
不适用范围：
- 2D 出图；
- 用户未明确需要 3D 结果的请求。
安装与启用¶
安装方式以 SkillHub 官方说明为准：先确保本机有 skillhub CLI，再将技能装到当前 Agent 实际读取的 skills 目录（装错目录 Agent 不会加载）。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
SkillHub 页面给出的安装提示为：根据 SkillHub 安装文档，安装 @user_a0383623/aholo-3dgs-reconstruction。
命令行示例（--dir 须指向当前环境的 skills 目录）：
skillhub install user_a0383623/aholo-3dgs-reconstruction --dir <skills 目录>
常见 Agent 的 skills 路径（摘自安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。因标签为 requires_api_key=true，启用前需在 Aholo / Skill 约定处配置 OpenAPI 访问密钥（以技能包内 SKILL.md 为准）。
典型用法¶
公开页面未附带完整对话示例；可复现的使用方式是与 Agent 说明 3D 重建或 3D 生成 需求，并确保已安装本 Skill 与 API Key。Agent 按 Skill 编排大致会走下面链路：
- 根据任务类型（reconstruction 或 generation）准备并 上传素材。
- 调用创建接口，拿到 worldId（及 WorldAsyncOperation 相关信息）。
- 循环 status / poll，直到任务终态。
- 下载或返回 PLY / SPZ / SOG 等指定格式产物。
若用户一次提供多个视频且要求 每个视频单独建世界，Agent 应按 Skill 约定对每个视频分别 create，而不是默认合并为单次任务。
适用场景与注意¶
适合：
- 已在用或计划用 Aholo OpenAPI v1 做 3DGS 重建/生成，希望 Cursor、Claude Code、Codex 等 Agent 自动走完上传、建任务、轮询、取文件。
- 产物需要 PLY / SPZ / SOG 等 3D 格式，而非平面图像。
注意：
- 本 Skill 不处理 2D 出图；纯文生图、修图类诉求应换其他 Skill。
- 异步任务必须 poll 到完成，避免在未终态时假定已有产物。
- 版本以 SkillHub 为准（当前 1.0.12）；升级可用
skillhub对同一坐标更新到 Agent skills 目录。 - 涉及素材版权、算力配额与 API 计费，以 Aholo 平台条款为准。
结尾¶
Aholo 3DGS重建与生成 把 Aholo 3D 任务的 OpenAPI 步骤收敛成 Agent 可执行的一站式流程，并划清与 2D 场景的边界。安装与详情见 SkillHub 技能页 与 API 索引。
