A2A 砍价擂台（Bargain Arena）项目详情

1. 项目基本信息

• 项目名称：A2A 砍价擂台（Bargain Arena）
• 赛道建议：🌐 重做一遍互联网
• 项目类型：双 Agent 自主协商交易应用
• 一句话介绍： 让卖家 AI 与买家 AI 在同一个房间自动砍价 10 轮，给出成交/流拍结论、成交价与关键回合摘要。

2. 项目背景与问题

传统二手交易存在几个高频痛点：

• 人类协商成本高：反复来回沟通，耗时且情绪成本高。
• 议价效率低：双方底线不透明，往往陷入拉扯。
• 对新用户不友好：不会砍价的人常常吃亏。

本项目把“谈价过程”交给 AI 分身处理，让用户从“亲自拉扯”升级为“设置策略 + 围观结果”。

3. 核心方案

本项目是一个严格的 A2A 应用，不是单 Agent 工具。

• 卖家用户授权登录后创建房间，输入商品信息与最低可接受价（仅服务端保存）。
• 买家用户授权登录后加入房间，输入预算上限（仅服务端保存）。
• 卖家点击“开始砍价”后，系统启动 A2A 编排器。
• 卖家 AI 与买家 AI 自动交替发言与报价，最多 10 轮。
• 系统按统一规则判定成交或流拍。
• 结果页展示成交价、砍价幅度、关键回合摘要，并支持围观投票与分享。

4. A2A 交互机制（关键）

4.1 双 Agent 结构

• 卖家 Agent：代表卖家用户利益，目标是尽量高价成交。
• 买家 Agent：代表买家用户利益，目标是尽量低价成交。

4.2 会话与上下文策略

• 每个房间为卖家 Agent 和买家 Agent 分别维护独立 sessionId。
• 每个角色首次发言附带 systemPrompt，后续复用同一 sessionId。
• 通过服务端 orchestrator 统一调度回合，保证交互顺序一致。

4.3 输出结构与解析稳定性

每轮要求 Agent 输出固定格式：

PRICE: <number>
SAY: <one concise sentence>

系统服务端解析 PRICE 与 SAY，写入消息表并更新房间状态。

4.4 成交判定规则

• 最大回合：10
• 成交条件：buyerOffer >= sellerAsk
• 成交价：finalPrice = sellerAsk
• 若 10 轮仍未满足成交条件：流拍

5. 产品功能清单

5.1 已实现核心功能（MVP）

• SecondMe OAuth 登录（user.info + chat）
• 卖家创建房间
• 买家加入房间
• 卖家手动点击开始
• 双 AI 自动谈判
• 结果页展示成交/流拍 + 成交价 + 砍价幅度 + 关键回合
• 围观投票（登录后可投票）
• 分享挑战链接

5.2 已实现加分功能

• 首页榜单（砍价王、金牌销售）
• 房间状态机（WAITING -> READY -> ACTIVE -> COMPLETED/FAILED）
• 回合并发保护（防重复触发）

6. 用户流程设计

6.1 卖家流程

1. OAuth 登录
2. 进入创建页填写商品信息、标价、最低可接受价
3. 创建房间并复制邀请链接
4. 等买家加入后点击“开始砍价”
5. 进入结果页查看成交结果并分享

6.2 买家流程

1. OAuth 登录
2. 打开房间链接
3. 输入预算上限并加入
4. 围观 AI 自动砍价
5. 在结果页投票并继续挑战

6.3 围观者流程

1. 打开房间/结果页围观
2. 登录后可投票
3. 可复制链接继续传播

7. 技术架构

7.1 技术栈

• 前后端框架：Next.js 14（App Router）+ TypeScript
• 数据库：Prisma + SQLite（本地开发）
• 登录与 Agent 接口：SecondMe OAuth + chat/stream
• UI：React + Tailwind CSS

7.2 后端关键模块

• OAuth 模块：登录跳转、授权回调、token 管理、用户信息同步
• 房间模块：建房、加入、启动、查询
• 编排模块：回合调度、消息写入、成交判定、状态推进
• 结果模块：摘要生成、投票统计、榜单接口

7.3 数据模型（摘要）

• User：SecondMe 用户映射、头像昵称、token 信息
• Room：房间信息、商品信息、状态、成交价、会话与并发字段
• Message：每轮角色发言、报价、轮次
• Vote：结果页投票记录（房间 + 用户唯一）

8. 安全与约束设计

• 最低价 minPrice、最高预算 maxPrice 仅服务端保存，不在公开接口中返回。
• OAuth 使用 state 进行校验，避免回调被伪造。
• 回合执行使用数据库状态锁（isProcessing）防并发冲突。
• 统一由服务端判定成交条件，避免前端作弊。

9. 与评分维度对应关系

9.1 A2A 场景价值（40%）

• 明确是双用户双 Agent 的自主协商。
• 交互主体是 Agent-to-Agent，不是人类与单 Agent 对话。

9.2 创新度（30%）

• 将“二手砍价”做成回合制对抗可视化玩法。
• 引入围观、投票、分享机制，增强传播与参与感。

9.3 完成度（30%）

• 端到端闭环可跑通。
• 关键路径（登录、建房、加入、开始、结果）完整。
• 工程验证通过（lint、typecheck、build）。

9.4 用户数（OAuth）

• 每次挑战至少涉及卖家/买家两个 OAuth 登录。
• 围观投票也要求登录，可自然拉新。

10. 部署与运行信息

10.1 环境变量

DATABASE_URL="file:./dev.db"
SECONDME_CLIENT_ID="<your_client_id>"
SECONDME_CLIENT_SECRET="<your_client_secret>"
BASE_URL="https://<your-domain>"

10.2 回调地址

• 本地：http://localhost:3000/api/auth/callback
• 线上：https://<your-domain>/api/auth/callback

10.3 提交前检查清单

• 线上 Demo 可访问
• OAuth 登录可用
• 房间流程可完整跑一遍
• 结果页可展示并可投票
• 提交页已填写 Client ID（用于统计）

11. 1 分钟演示脚本（路演版）

1. 进入首页，展示“使用 SecondMe 登录”。
2. 卖家建房，填商品与底价，复制链接。
3. 买家登录加入，输入预算。
4. 卖家点击“开始砍价”，展示双 AI 自动回合。
5. 进入结果页，展示成交/流拍、成交价、砍价幅度、关键回合。
6. 现场点击投票并复制挑战链接。

12. 项目亮点总结

• 纯 A2A：双 Agent 自主博弈交易。
• 强可演示：回合过程可视、结果明确。
• 强传播：投票与分享带来自然拉新。
• 强可扩展：未来可扩展多方竞价、代理竞拍、策略市场等玩法。

13. 可直接复制到提交页的项目简介（长版）

A2A 砍价擂台是一个以交易谈判为核心的双 Agent 应用。两个不同用户通过 SecondMe OAuth 登录后，分别由卖家 AI 分身与买家 AI 分身在同一房间中自动进行最多 10 轮砍价。系统在服务端统一编排回合、解析报价与陈述、维护会话上下文，并按固定规则判定成交或流拍。结果页会输出成交价、砍价幅度和关键回合摘要，并支持登录投票和挑战链接分享。项目重点体现 Agent-to-Agent 的自主交互价值，而非单 Agent 辅助工具，能够在短时间内清晰展示 A2A 场景价值、创新玩法与可用完成度。

14. 可直接复制到提交页的一句话简介（短版）

卖家 AI 与买家 AI 自动砍价 10 轮，实时展示谈判过程并给出成交结果与关键回合。