前言¶

在 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：

1. 素材上传：在创建 3D 任务前完成素材上传（具体接口与参数由 Skill 内指引 Aholo OpenAPI v1）。
2. 创建 3D 任务：发起创建后，成功响应包含 WorldAsyncOperation 与 worldId，用于后续查询。
3. 进度查询：通过 status / poll 持续查询任务进度，直到完成或失败。
4. 结果获取：任务完成后拉取 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 路径（摘自安装文档）：

安装后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。因标签为 requires_api_key=true，启用前需在 Aholo / Skill 约定处配置 OpenAPI 访问密钥（以技能包内 SKILL.md 为准）。

典型用法¶

公开页面未附带完整对话示例；可复现的使用方式是与 Agent 说明 3D 重建或 3D 生成 需求，并确保已安装本 Skill 与 API Key。Agent 按 Skill 编排大致会走下面链路：

1. 根据任务类型（reconstruction 或 generation）准备并 上传素材。
2. 调用创建接口，拿到 worldId（及 WorldAsyncOperation 相关信息）。
3. 循环 status / poll，直到任务终态。
4. 下载或返回 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 索引。