SuperAPI AI 工具集

publish-artifact-to-sites

数据与分析

查看项目

更新于 11-04 02:41

技能介绍

用途 该技能在报告或仪表盘工作流产出完整的规范清单(canonical manifest)和有界快照(bounded snapshot),且 validate_artifact 校验成功后,将 Data Analytics 阅读器运行时发布为 Sites 托管的快照。它不会为站点添加实时源连接。

路由规则 在明确识别的工作模式(Work Mode)中,若完整的 Sites 构建与托管生命周期可调用,持久化报告或仪表盘请求会自动选择 Sites,无需再询问交付方式或发布确认。在 ChatGPT Desktop 的非工作模式下,只有在用户明确要求使用 Sites,或明确接受在最终 MCP 产物交接后提供的可选共享提议时,才使用本技能;仅凭报告或仪表盘请求不足以授权在此环境发布。若工作模式中完整的 Sites 生命周期不可调用,则改用由所属报告或仪表盘工作流选定的自包含 HTML 回退方案。

工作流程

  1. 确认 $sites-building 与 $sites-hosting 均可调用,覆盖完整的 Sites 创建、检查点与部署生命周期。
  2. 调用 $sites-building,为每个逻辑报告或仪表盘创建或重新打开一个 worker-starter 检出;新建站点时选择 worker starter(--starter worker),后续版本复用同一站点。
  3. 通过 Sites 连接器读取站点当前访问策略。仅当站点为自定义、恰好有一个 allowed_account_user_id、其唯一 allowed_users 条目具有相同账号用户 id 且邮箱非空、且无允许的组时,才可视为可验证的仅所有者(owner-only)。若用户要求扩大读者访问范围,应推迟该访问变更至包导出之后,以免丢失已验证的创建者种子;不要从已共享的读者允许列表推断创建者。
  4. 调用 export_artifact_package,传入已校验负载、在兼容字段 site_creator_project_id 中传入 Sites 项目 id、并将返回的检出路径作为 output_dir。当当前工作区策略可验证为仅所有者时,将其唯一解析出的邮箱作为 site_editor_email 传入;导出器会在写入源之前对其哈希。否则省略该字段,以保留现有编辑器种子或显式禁用状态。仅在用户明确要求禁用展示编辑时传入 site_editor_email: null。导出成功后,应用用户明确要求的读者访问变更,然后在相同审批边界下执行检查点与部署。
  5. 验证返回的所有 source/schema/hosting 路径均位于检出目录内,并单独验证托管元数据包含解析出的项目 id。展示编辑需要逻辑 D1 绑定 DB,不得替换其他绑定名称。只读导出可省略 database_schema_path。
  6. 通过 $sites-building 对检出执行检查点,然后调用 $sites-hosting 轮询部署至终态。
  7. 返回 Sites URL 与产物快照时间戳,并说明已发布数据是快照而非实时连接。若启用了展示编辑,说明只有被播种的创建者可编辑标题/文本/布局、删除区块或启动刷新与导出交接;已保存的展示覆盖保留在 Sites 中,不会同步回 ChatGPT Desktop。

回退与失败 若完整 Sites 生命周期不可用,或工作模式中一次针对性重试后发布仍失败,则自动切换到所属工作流的自包含 HTML 模式,简要说明失败阶段,且不得声称站点已发布。若用户明确只要求 Sites,则应报告阻塞原因,而非未经同意切换交付面。