1 产品定位

全球首个 AI Agent 分享与发现社区

用户提交自己搭建的 Agent，系统自动分析生成档案，社区浏览、评价、复用。

核心价值

2 agent.json 规范

标准化 Agent 描述文件 — 机器可解析、人可阅读。一个文件完整描述一个 Agent。

{
  "name": "smart-customer-service",
  "version": "1.2.0",
  "description": "自动处理客服工单，支持退款、查物流、FAQ",
  "author": {
    "name": "PigTech",
    "email": "hello@bytespace.sg",
    "url": "https://github.com/dongxie"
  },
  "framework": "openclaw",
  "models": ["claude-sonnet-4", "deepseek-v3"],
  "skills": [
    {
      "name": "refund-handler",
      "description": "自动审核退款申请，金额<100自动通过",
      "triggers": ["退款", "refund", "退货"]
    },
    {
      "name": "logistics-tracker",
      "description": "对接快递API查询物流状态",
      "triggers": ["物流", "快递", "tracking"]
    }
  ],
  "channels": ["telegram", "discord", "whatsapp"],
  "dependencies": {
    "services": ["postgresql", "redis"],
    "apis": ["stripe", "sf-express"]
  },
  "deploy": {
    "type": "docker",
    "resources": "1vCPU/1GB",
    "region": ["sg", "hk"]
  },
  "tags": ["customer-service", "e-commerce"],
  "license": "MIT",
  "repo": "https://github.com/dongxie/smart-cs-agent",
  "demo": "https://t.me/smart_cs_bot"
}

必填字段

可选字段

3 提交流程

三种提交方式

API 提交示例

# 一行命令发布 Agent
curl -X POST https://api.clawvsclaw.com/agents \
  -H "Authorization: Bearer cvc-xxx" \
  -H "Content-Type: application/json" \
  -d @agent.json

# 从 Git Repo 导入
curl -X POST https://api.clawvsclaw.com/agents/import \
  -H "Authorization: Bearer cvc-xxx" \
  -d '{"repo": "https://github.com/user/my-agent"}'

自动分析引擎

无论哪种方式提交，系统自动执行完整分析流程：

自动扫描的关键文件

4 版本管理

轻量版本管理，类似 App Store 更新模式，不需要 Git 那么复杂。

版本规则

每个版本记录

• 📋 档案快照（能力变化 diff）
• 📝 变更说明（自动生成 + 用户补充）
• ⭐ 独立评分（大版本重新积累口碑）
• 📊 下载 / 使用量统计

自动版本检测（Git Repo）

监听 Webhook → 新 push 自动分析变更 → 对比 agent.json diff → 建议版本级别 → 通知作者确认发布

5 社区功能

5.1 浏览与发现

5.2 Agent 详情页

每个 Agent 独立页面，包含：

• 基本信息（名称、作者、版本、标签）
• 能力概览（skills 可视化卡片）
• 技术栈（框架、模型、依赖拓扑图）
• 部署指南（一键复制配置）
• Demo 入口（在线体验链接）
• 版本历史（changelog timeline）
• 社区评价（评分 + 评论）

5.3 互动系统

5.4 用户系统

• 个人主页（提交的 Agent、收藏、贡献度）
• 成就徽章（首次提交、获赞100、精选作者…）
• 关注 / 粉丝

6 API 设计

Agent CRUD

POST   /api/agents              # 创建 Agent
POST   /api/agents/import       # 从 Git Repo 导入
GET    /api/agents               # 列表（筛选、分页、排序）
GET    /api/agents/:id           # 详情
PUT    /api/agents/:id           # 更新（自动创建新版本）
DELETE /api/agents/:id           # 下架

版本管理

GET    /api/agents/:id/versions          # 版本历史
GET    /api/agents/:id/versions/:ver     # 特定版本详情
POST   /api/agents/:id/versions          # 手动发布新版本

社区互动

POST   /api/agents/:id/rate             # 评分
GET    /api/agents/:id/reviews          # 评论列表
POST   /api/agents/:id/reviews          # 发表评论
POST   /api/agents/:id/fork             # Fork
POST   /api/agents/:id/favorite         # 收藏

发现

GET    /api/agents/trending              # 热门
GET    /api/agents/featured              # 编辑精选
GET    /api/agents/search?q=xxx          # 搜索
GET    /api/tags                         # 标签列表
GET    /api/frameworks                   # 框架列表

用户

GET    /api/users/:id                    # 用户主页
GET    /api/users/:id/agents             # 用户提交的 Agent
GET    /api/users/:id/favorites          # 收藏列表

7 技术架构

8 数据库设计

agents 表

CREATE TABLE agents (
  id UUID PRIMARY KEY,
  name VARCHAR(100) UNIQUE NOT NULL,
  display_name VARCHAR(200),
  description TEXT,
  author_id UUID REFERENCES users(id),
  framework VARCHAR(50),
  models JSONB,
  skills JSONB,
  channels JSONB,
  dependencies JSONB,
  deploy JSONB,
  tags TEXT[],
  license VARCHAR(50),
  repo_url TEXT,
  demo_url TEXT,
  current_version VARCHAR(20),
  total_stars INTEGER DEFAULT 0,
  avg_rating DECIMAL(2,1) DEFAULT 0,
  download_count INTEGER DEFAULT 0,
  status VARCHAR(20) DEFAULT 'pending',
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

agent_versions 表

CREATE TABLE agent_versions (
  id UUID PRIMARY KEY,
  agent_id UUID REFERENCES agents(id),
  version VARCHAR(20) NOT NULL,
  changelog TEXT,
  agent_json JSONB,
  file_url TEXT,
  analysis_result JSONB,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

reviews 表

CREATE TABLE reviews (
  id UUID PRIMARY KEY,
  agent_id UUID REFERENCES agents(id),
  user_id UUID REFERENCES users(id),
  rating INTEGER CHECK (rating BETWEEN 1 AND 5),
  content TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

9 开发计划

10 页面结构

公共页面

用户页面

API 文档

11 与 ByteSpace 生态关系

ClawVsClaw 是 ByteSpace 生态的流量入口和用户教育平台 — UGC 内容驱动增长，社区活跃度反哺 SEO。