AweeClaw 开发者文档

深色模式

发布到市场 ​

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

发布流程 ​

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

第一步：构建 ​

bash
# 编程式场景
npx aweeclaw-scenario build

# 声明式场景
npx aweeclaw-scenario build

第二步：校验 ​

bash
npx aweeclaw-scenario validate

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

校验项包括：

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

第三步：打包 ​

bash
npx aweeclaw-scenario pack

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

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

第四步：登录 ​

bash
# 交互式登录
npx aweeclaw-scenario login

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

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

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

第五步：发布 ​

bash
# 标准发布
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（默认）
  • 付费：设置价格（人民币元）
json
{
  "price": 9.9
}

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

收益与结算 ​

每一笔付费订单都会为开发者生成一条收益记录，状态流转如下：

状态说明
冻结中购买后 3 个自然日的冻结期，防止恶意退款带来的资金风险
已解冻冻结期满自动解冻，进入可用余额，可申请提现
已退款订单退款时对应收益被扣回；若已纳入结算单，结算单金额同步冲减

平台每月 1 日 02:00 自动汇总上一个自然月已解冻的收益，按开发者生成结算单：

  • 结算单包含：结算周期、订单笔数、销售额、平台分成（10%）、开发者应得（90%）
  • 状态流转：待核对 → 已核对 → 已打款，打款流水号可在结算单中查看
  • 在开发者中心的结算单页面查看明细与逐笔来源
  • 免费商品不产生收益记录，不参与结算
  • 一条收益记录只会计入一张结算单：月结任务重复执行不会重复结算
  • 结算按解冻时间归入周期：即使 3 天冻结期跨月，该笔收益也会落在解冻当月的结算单里，不会被漏掉

有效期 ​

付费场景可选设置有效期（单位：天），决定用户购买后的权益时长：

validityDays语义
不设置 / 0 / null永久买断：一次付费，永久可用
> 0按天计费：到期后权益失效，用户需续费后继续使用
json
{
  "price": 9.9,
  "validityDays": 365
}

设置价格与有效期（开发者中心 / 开放接口）：

PUT /api/v1/developer/marketplace/scenarios/:scenarioId/price
Body: { "price": 9.9, "validityDays": 365 }

有效期相关的平台行为：

  • 到期提醒：到期前 7 / 3 / 1 天自动向用户发送站内提醒，显示在客户端右上角消息中心， 并在「工作场景」「插件与技能」「费用中心」入口显示未读角标
  • 到期处理：到期后权益失效，客户端提示续费；用户续费后有效期从原到期时间顺延 （未到期时提前续费不损失剩余时长）
  • 续费收入：与首次购买一致，开发者同样按 90% 分成
  • 不自动续费：平台不提供自动扣费，用户需主动续费

付费插件（Plugin.validityDays）遵循完全相同的语义与行为。

发布后管理 ​

  • 在 开发者中心 查看场景状态
  • 查看下载量和评分数据
  • 查看收益明细
  • 查看结算单：按月对账，含平台分成与应打款金额
  • 更新场景信息和价格
  • 下架场景（需审核）

AweeClaw AI 应用构建平台

Copyright © 2026 AweeClaw.com