发布到市场

将场景发布到 AweeClaw 场景市场，让全球用户发现和使用你的场景。

发布流程

构建 → 校验 → 打包 → 登录 → 发布 → 审核 → 上架

第一步：构建

# 编程式场景
npx aweeclaw-scenario build

# 声明式场景
npx aweeclaw-scenario build

第二步：校验

npx aweeclaw-scenario validate

# 严格模式
npx aweeclaw-scenario validate --strict

校验项包括：

• scenario.json 格式和字段校验
• 构建产物完整性
• 文件引用正确性
• SHA-256 checksum
• 包大小不超过 50MB

第三步：打包

npx aweeclaw-scenario pack

# 指定输出目录
npx aweeclaw-scenario pack --out-dir ./releases

生成 {id}-{version}.tar.gz 文件。

第四步：登录

# 交互式登录
npx aweeclaw-scenario login

# 非交互式登录
npx aweeclaw-scenario login --email dev@example.com --password xxx

# 使用 Token
npx aweeclaw-scenario login --token eyJhbGciOi...

发布前需要完成实名认证。请访问 开发者中心 完成认证。

第五步：发布

# 标准发布
npx aweeclaw-scenario publish

# 带更新说明
npx aweeclaw-scenario publish --changelog "新增功能：支持批量处理"

# 跳过自动打包
npx aweeclaw-scenario publish --skip-pack

# 指定最低客户端版本
npx aweeclaw-scenario publish --min-app-version "1.2.0"

发布前检查清单

• [ ] scenario.json 所有必填字段完整
• [ ] 版本号已更新（如果是新版本）
• [ ] 提示词文件已优化
• [ ] 权限声明合理（最小权限原则）
• [ ] 通过了 validate 校验
• [ ] 已登录开发者账号
• [ ] 已完成实名认证
• [ ] 更新说明（changelog）已准备好
• [ ] 图标和截图已准备

审核流程

1. 提交发布 → 场景进入 pending 状态
2. 管理员审核 → 检查内容合规性和安全性
3. 审核通过 → 场景自动上架，状态变为 approved
4. 审核驳回 → 场景状态变为 rejected，附审核意见

版本管理

发布新版本

1. 更新 scenario.json 中的 version 字段
2. 重新构建和打包
3. 执行 publish 命令

版本号规范

使用语义化版本 (SemVer)：

主版本号.次版本号.修订号
  MAJOR . MINOR . PATCH

• MAJOR：不兼容的 API 修改
• MINOR：向下兼容的功能新增
• PATCH：向下兼容的问题修复

更新检查

客户端会定期检查已安装场景的更新：

• 调用后端 /api/v1/marketplace/check-updates 接口
• 比对本地版本和最新版本
• 提示用户更新

定价

场景可以设置价格：

• 免费：price: 0（默认）
• 付费：设置价格（人民币元）

{
  "price": 9.9
}

平台分成：开发者 90%，平台 10%。

发布后管理

• 在 开发者中心 查看场景状态
• 查看下载量和评分数据
• 查看收益明细
• 更新场景信息和价格
• 下架场景（需审核）