publish

构建与部署工作流

前置条件

• 已安装 Node.js
• 已安装 Domo CLI（npm install -g @domoinc/ryuu）

本地开发

npm install          # Install dependencies
npm run dev          # Start dev server (usually Vite)

若要在本地进行 API 调用，你需要配置 ryuu-proxy 并完成 domo login 身份验证。

生产构建

npm run build        # Outputs to dist/ (Vite) or build/ (CRA)

Domo CLI 身份验证

domo login           # Authenticate with your Domo instance

系统会提示你输入 Domo 实例 URL 和凭据。

发布

cd dist              # Change to build output directory
domo publish         # Publish to Domo

如果发布包含新增/更新的 Code Engine 包，请先通过以下方式运行包生命周期步骤：

• ~/.agents/skills/code-engine-create/SKILL.md
• ~/.agents/skills/code-engine-update/SKILL.md

重要 - 首次发布：

• 首次发布时，Domo 会为你的应用生成一个新的 id
• 该 ID 会出现在 dist 文件夹中已发布的 manifest.json 里
• 你必须将此 ID 复制回源 manifest.json（例如 public/manifest.json）
• 如果不这样做，每次发布都会创建一个新应用，而不是更新现有应用

# After first publish, copy the generated ID:
# dist/manifest.json → public/manifest.json (just the "id" field)

后续发布

一旦 ID 已写入源 manifest：

npm run build && cd dist && domo publish

构建检查清单

发布前，请确保：

• manifest.json 中的数据集具有正确的 dataSetId（而不是 id）
• manifest.json 中每个数据集映射都有 fields: []
• thumbnail.png 存在且为 300x300 像素
• 所有查询都使用带特定列的 .select()（切勿获取所有列）
• 每个可视化都有自己优化的查询
• 没有 .aggregate() 调用（使用 .groupBy() 或客户端聚合）
• .groupBy() 调用包含分组列（而不仅仅是聚合）