跳转至

Marketplace 用户指南

本文档描述 AI Agent Marketplace 的用户故事和使用流程。

用户角色

角色 说明
买家 (Buyer) 浏览和购买 AI 资产的用户
卖家 (Seller) 上架和销售 AI 资产的用户
管理员 (Admin) 管理平台配置和审核商品的用户

US-001: 商品上架

作为卖家，我希望能将我的 AI 资产（Prompt/Agent/知识库等）上架到市场，设置价格和定价模式。

上架流程

sequenceDiagram
    participant S as Seller
    participant API as Marketplace API
    participant DB as Database

    S->>API: 选择资产类型和已有资产
    S->>API: 填写商品信息（标题、描述、封面）
    S->>API: 设置定价模式和价格
    S->>API: POST /marketplace/listings
    API->>DB: 创建商品记录
    API-->>S: 返回上架成功

验收标准

  • [ ] 支持选择资产类型和关联已有资产
  • [ ] 支持设置一次性/月付/阶梯定价
  • [ ] 上架后商品状态为 published，可被搜索

操作步骤

  1. 进入「我的资产」页面，选择要上架的资产
  2. 点击「上架到市场」按钮
  3. 填写商品信息：
  4. 标题：简洁明了地描述商品
  5. 描述：详细介绍商品的功能和使用场景
  6. 封面：上传吸引人的封面图片
  7. 设置定价：
  8. 选择定价模式（一次性/月付/阶梯）
  9. 设置积分价格
  10. 添加标签，便于用户搜索
  11. 点击「确认上架」

US-002: 商品购买

作为买家，我希望能浏览市场、搜索商品并使用积分购买。

购买流程

sequenceDiagram
    participant B as Buyer
    participant API as Marketplace API
    participant W as Wallet Service

    B->>API: 浏览/搜索商品
    B->>API: 查看商品详情
    B->>API: POST /marketplace/orders
    API->>W: 检查余额并扣款
    API->>W: 计算佣金并转账给卖家
    API-->>B: 返回订单完成 + 资产访问权限

验收标准

  • [ ] 商品列表支持分页、分类筛选、关键词搜索
  • [ ] 购买时自动扣除积分，卖家自动入账
  • [ ] 购买成功后获得资产访问权限

操作步骤

  1. 进入「市场」页面浏览商品
  2. 使用筛选条件缩小搜索范围：
  3. 资产类型：Prompt、Agent、知识库等
  4. 定价模式：一次性、订阅
  5. 价格区间
  6. 点击商品查看详情，包括：
  7. 详细描述和使用说明
  8. 其他用户的评价
  9. 卖家信息
  10. 点击「立即购买」
  11. 确认订单信息并支付积分
  12. 购买成功后，在「我的订单」中查看并使用资产

US-003: 积分钱包

作为用户，我希望能查看积分余额、充值、提现和转账。

积分获取途径

途径 积分数 说明
每日登录 10 每日首次登录奖励
分享 Agent 50 首次上架 Agent 奖励
商品被购买 售价 × 80% 卖家收入（扣除 20% 佣金）
充值购买 1 元 = 100 积分 直接充值
用户转账 自定义 P2P 转账

验收标准

  • [ ] 钱包页面显示当前余额和流水记录
  • [ ] 支持积分充值（模拟支付）
  • [ ] 支持用户间积分转账
  • [ ] 所有操作记录不可变流水

操作步骤

查看钱包

  1. 点击头像进入「个人中心」
  2. 选择「我的钱包」
  3. 查看：
  4. 当前可用余额
  5. 冻结金额（交易中的积分）
  6. 累计赚取和消费统计
  7. 完整的交易流水

充值积分

  1. 在钱包页面点击「充值」
  2. 输入充值金额（1 元 = 100 积分）
  3. 选择支付方式（MVP 阶段为模拟支付）
  4. 确认支付，积分立即到账

转账给他人

  1. 在钱包页面点击「转账」
  2. 输入对方用户名或用户 ID
  3. 输入转账金额和备注
  4. 确认转账

US-004: 平台佣金配置

作为管理员，我希望能动态调整平台佣金比例。

佣金计算示例

商品售价 佣金比例 平台佣金 卖家实收
100 积分 20% 20 积分 80 积分
500 积分 20% 100 积分 400 积分
1000 积分 25% 250 积分 750 积分

验收标准

  • [ ] 后台可查看和修改 commission_rate
  • [ ] 修改后新订单立即生效
  • [ ] 历史订单佣金不受影响

操作步骤

  1. 进入「管理后台」
  2. 选择「平台配置」
  3. 找到「佣金比例」配置项
  4. 修改数值（范围 0-100%，默认 20%）
  5. 保存配置，新订单将使用新的佣金比例

US-005: 商品评价

作为买家，我希望能对购买的商品进行评分和评价。

验收标准

  • [ ] 购买后可提交 1-5 星评分和文字评价
  • [ ] 商品详情页显示平均评分和评价列表
  • [ ] 每个用户对同一商品只能评价一次

操作步骤

  1. 进入「我的订单」页面
  2. 找到已完成的订单
  3. 点击「评价」按钮
  4. 选择评分（1-5 星）
  5. 填写评价内容
  6. 提交评价

功能需求汇总

编号 需求 优先级
FR-1 支持 5 种资产类型上架：Prompt、RAG 文件、Knowledge Base、Agent、MCP 高
FR-2 支持 3 种定价模式：一次性购买、按月订阅、阶梯定价 高
FR-3 积分系统支持：活跃奖励、充值购买、用户转账、提现兑换 高
FR-4 平台佣金可配置，默认 20%，支持后台动态调整 高
FR-5 所有积分变动记录不可变流水，支持审计 高
FR-6 复用现有 Chameleon 用户体系，无需独立注册 高
FR-7 商品支持搜索、分类筛选、评分排序 中

非目标

以下功能不在 MVP 范围内：

  • 不实现真实支付网关集成（MVP 阶段使用模拟充值）
  • 不实现复杂的推荐算法（仅基础排序）
  • 不实现商品版本管理和更新推送
  • 不实现卖家店铺页面和粉丝系统
  • 不实现积分兑换实物礼品的物流系统
  • 不实现多币种或汇率转换