Appearance
AgentScope 示例项目对比指南
本文档对比了 AgentScope 生态中四个核心示例项目的定位、架构差异和适用场景， 帮助你选择最适合自己需求的项目方案。
一、项目全景
| 项目 | 一句话定位 | 目标用户 | 复杂度 |
|---|---|---|---|
| Paw | 个人本地助手——装在你电脑上，越用越聪明 | 个人开发者 | ⭐ 最简 |
| Builder | 多租户 Agent 托管平台——UI 点几下即可创建智能体 | 团队 / 公司 | ⭐⭐⭐ |
| DataAgent | 数据分析 Agent 产品——SQL、图表、报告，私有进化+共享市场 | 数据团队 | ⭐⭐⭐⭐ |
| CodingAgent | 自治代码机器人——Issue→PR、PR Review、Docker 沙箱隔离 | 代码团队 / 组织 | ⭐⭐⭐⭐⭐ |
二、核心架构对比
2.1 部署与隔离模型
| 特性 | Paw | Builder | DataAgent | CodingAgent |
|---|---|---|---|---|
| 用户模型 | 单用户（无登录） | 多租户（JWT 认证） | 多租户（JWT 认证） | 组织内共享（Webhook 触发） |
| 隔离机制 | 无隔离——全权访问宿主 OS | 按 (userId, agentId) 命名空间 | 按 (userId, agentId) 命名空间 | 按 Session 级 Docker 容器 |
| 文件系统 | LocalFilesystemWithShell | CompositeFilesystem（local/Docker/Redis-OSS） | OverlayFilesystem（私有+共享） + RemoteFilesystem | SandboxFilesystem（per-session Docker） |
| 沙箱策略 | ❌ 无——直接宿主 Shell | ✅ Docker sandbox 可选 | ✅ 运维方自管沙箱 | ✅ 运行时自管（自动创建/销毁） |
| 分布式 | ❌ 单进程 | ✅ Redis 共享状态 | ✅ Redis 共享状态 | ✅ SQLite + 消息队列 |
| 数据库 | ❌ 纯文件（JSON） | H2 → MySQL/PG | H2 → MySQL/PG | SQLite |
2.2 Agent 构建与管理
| 特性 | Paw | Builder | DataAgent | CodingAgent |
|---|---|---|---|---|
| Agent 创建方式 | JSON 文件 / UI / AI 草稿 | UI 选择 skills/tools/MCP → 保存即得 | 自动 fork 内置 data-agent | 内置 CodingAgent + ReviewerAgent |
| 自演化 | ✅ Skills/子Agent/Memory 文件自行维护 | ✅ 同 claw 自演化机制 | ✅ 私有进化 + Marketplace 共享 | ❌ 无自演化（固定系统提示） |
| Agent 分享 | ❌ 无 | ✅ 三级权限：RUN / EDIT / CLONE | ✅ 三级权限：RUN / EDIT / CLONE | ❌ 无（组织内统一部署） |
| 子 Agent | ✅ 可创建子 Agent | ✅ 可配置子 Agent | ✅ 内置 data-explorer / report-writer | ✅ ReviewerAgent（仅审查） |
| 技能市场 | ✅ Git / Nacos 注册中心 | ✅ Git / Nacos 注册中心 | ✅ Marketplace（贡献→审批→共享） | ❌ 无 |
2.3 通道与交互
| 特性 | Paw | Builder | DataAgent | CodingAgent |
|---|---|---|---|---|
| Web UI | ✅ React SPA（SSE 流式） | ✅ React SPA（SSE 流式） | ✅ React SPA（SSE 流式） | ❌ 无 Web UI |
| 钉钉 | ✅ Stream WebSocket | ✅ Stream WebSocket | ✅ Stream WebSocket | ✅ Stream WebSocket |
| 企微 | ✅ HTTP callback | ✅ HTTP callback | ✅ HTTP callback | ❌ |
| 飞书 | ✅ HTTP event | ✅ HTTP event | ✅ HTTP event | ❌ |
| GitHub | ✅ Webhook + REST | ❌ | ❌ | ✅ Webhook + REST（核心通道） |
| GitLab | ✅ Webhook + REST | ❌ | ❌ | ❌（可扩展） |
| CLI REPL | ❌ | ❌ | ❌ | ✅ 本地开发测试 |
| Outbound 主动推送 | ✅ Agent 可主动发消息到 IM | ✅ | ✅ | ✅ 回写 GitHub PR/Issue |
2.4 安全与认证
| 特性 | Paw | Builder | DataAgent | CodingAgent |
|---|---|---|---|---|
| 登录认证 | ❌ 无——打开就用 | ✅ JWT + Spring Security | ✅ JWT + Spring Security | ❌ 无登录（HMAC Webhook 验证） |
| Webhook 签名 | SHA1/HMAC/AES | HMAC | HMAC | HMAC-SHA256 |
| API Key 加密 | ❌ 明文配置 | ❌ 明文配置 | ❌ 明文配置 | ✅ Google Tink AEAD（AES-256-GCM） |
| Bot 循环保护 | ✅ 20事件/60s + 自评论过滤 | ✅ 自评论过滤 | ✅ 自评论过滤 | ✅ 自评论过滤 + 去重 |
| Token 自动刷新 | ✅ 80% TTL 主动刷新 | ✅ | ✅ | ❌ |
2.5 前端架构
| 特性 | Paw | Builder | DataAgent | CodingAgent |
|---|---|---|---|---|
| 技术栈 | React 18 + TS + Vite | React 18 + TS + Vite | React 18 + TS + Vite | 无前端 |
| 页面数 | 13 | ~25 | 25 | 0 |
| API 模块数 | 10 | 15 | 15 | 0 |
| 认证组件 | ❌ 无 PrivateRoute | ✅ PrivateRoute + JWT | ✅ PrivateRoute + JWT | N/A |
| 权限守卫 | ❌ | ✅ | ✅ EditTierGate + AdminRoute | N/A |
| SPA 集成 | frontend-maven-plugin → Spring Boot 静态 serving | 同 | 同 | N/A |
三、适用场景详解
3.1 Paw —— 个人本地助手
最适合：
- 🧑💻 个人开发者想在自己的电脑上有一个 AI 助手
- 🏠 本地开发/实验——想快速体验 AgentScope 的自演化能力
- 📱 IM 串联——日常工作在钉钉/企微/飞书上，想让 Agent 也出现在那里
- 🔧 无运维负担——不想管数据库、Docker、Redis，只想
java -jar一键启动
典型用法：
安装 Paw → 配置 LLM API Key → 打开浏览器对话
→ Agent 在你的电脑上执行命令、读写文件
→ 配置钉钉/企微通道 → 在 IM 里也能和 Agent 聊天
→ Agent 自演化：学习新技能、创建子 Agent、积累记忆不适合：
- 需要多用户共享的场景（选 Builder）
- 需要安全沙箱隔离的场景（选 CodingAgent 或 DataAgent）
- 需要分布式部署/高可用的场景（选 Builder/DataAgent）
- 需要数据分析专精能力的场景（选 DataAgent）
3.2 Builder —— 多租户 Agent 托管平台
最适合：
- 🏢 团队/公司想让多人共享使用 Agent
- 🎨 UI 创建 Agent——不想写代码，通过浏览器选择 skills/tools/MCP 组合即可
- 🔐 权限管控——需要 RUN/EDIT/CLONE 三级分享权限
- 📊 管理多种类型的 Agent——不只是数据 Agent 或代码 Agent，而是任意 Agent
典型用法：
部署 Builder（Spring Boot + DB） → 用户登录 → 创建 Agent（选 skills/tools/MCP）
→ 聊天对话（SSE 流式） → Agent 自演化
→ 分享给同事（RUN 权限：只能用 / EDIT：可改 / CLONE：可 fork）
→ 通过钉钉/企微/飞书通道让 Agent 在 IM 中也能响应不适合：
- 只想自己用的场景（选 Paw，更简单）
- 需要自治代码工程的场景（选 CodingAgent，更安全）
- 需要数据分析专精能力的场景（选 DataAgent，更专业）
- 不想管数据库/基础设施的场景（选 Paw）
3.3 DataAgent —— 数据分析 Agent 产品
最适合：
- 📈 数据团队——分析师需要 AI 帮忙写 SQL、画图表、出报告
- 🏭 企业数据中台——需要 SQL 查询 + 图表渲染 + 报告撰写的闭环
- 🔄 私有进化 + 团队共享——好技能贡献到市场，审批后全团队自动获得
- ☁️ 分布式部署——多副本、Redis 共享、无 sticky session
典型用法：
部署 DataAgent → 配置 JDBC 数据源 → 用户登录 → 自动 fork data-agent
→ 对话："昨天有多少用户注册？" → Agent 执行 SQL → 返回结果
→ 对话："画一个月度趋势图" → Agent render_chart → 前端展示
→ 对话："写一份运营周报" → Agent 撰写报告
→ 学到好技能 → 提交贡献 → 管理员审批 → 全团队共享DataAgent 独有的 OverlayFilesystem 机制：
skills/ 目录视图（每个用户看到的）:
├── upper: 用户自己的技能（可写） ← 私有进化
└── lower: 团队共享的技能（只读） ← Marketplace 审批后自动更新不适合：
- 只想自己用的场景（选 Paw）
- 需要通用 Agent 托管的场景（选 Builder，更灵活）
- 需要自治代码工程的场景（选 CodingAgent）
- 没有数据源/不需要数据分析的场景（选 Builder 或 Paw）
3.4 CodingAgent —— 自治代码机器人
最适合：
- 🤖 代码工程自动化——Issue → PR 全流程自动化
- 🔍 PR 审查自动化——Reviewer Agent 只读 diff + 发布结构化 Findings
- 🏗️ 组织内部署——通过 GitHub Webhook 触发，无需人工干预
- 🛡️ 安全沙箱——每个 Session 在独立 Docker 容器中执行，不碰宿主机
典型用法：
部署 CodingAgent → 配置 GitHub Webhook → 在 Issue 下评论需求
→ CodingAgent 克隆仓库 → 创建分支 → 实现功能 → 推送代码 → 开 PR
→ PR 上的后续评论 → Agent 继续迭代同一分支
→ 把 CodingAgent 加为 PR Reviewer → ReviewerAgent 读 diff → 发布 FindingsCodingAgent 独有的安全设计：
| 角色 | 可用工具 | 设计意图 |
|---|---|---|
| CodingAgent | execute, edit_file, git_*, github_api, fetch_url, web_search | 全能力——写代码、改文件、推 PR |
| ReviewerAgent | 仅 add_finding + publish_review | 只读审查——不能执行任何代码 |
不适合：
- 需要通用 Agent 对话的场景（选 Builder 或 Paw）
- 需要数据分析的场景（选 DataAgent）
- 个人日常助手场景（选 Paw）
- 需要 UI 创建/管理 Agent 的场景（选 Builder）
四、选型决策树
你的需求是什么？
│
├─ "我自己用，装在我电脑上"
│ └─ ✅ Paw
│
├─ "团队多人共享使用 Agent"
│ ├─ "主要是数据分析（SQL/图表/报告）"
│ │ └─ ✅ DataAgent
│ ├─ "主要是代码工程自动化（Issue→PR/PR Review）"
│ │ └─ ✅ CodingAgent
│ └─ "通用 Agent 托管，UI 创建各种 Agent"
│ └─ ✅ Builder
│
├─ "需要安全沙箱隔离"
│ ├─ "代码执行必须隔离"
│ │ └─ ✅ CodingAgent（per-session Docker，运行时自管）
│ ├─ "数据分析脚本需要隔离"
│ │ └─ ✅ DataAgent（运维方自管沙箱）
│ └─ "通用 Agent 执行需要隔离"
│ └─ ✅ Builder（Docker sandbox 可选）
│
├─ "需要分布式部署/高可用"
│ ├─ "数据分析场景"
│ │ └─ ✅ DataAgent（Redis 共享状态 + OverlayFilesystem）
│ ├─ "通用 Agent 托管"
│ │ └─ ✅ Builder（Redis 共享状态）
│ └─ "代码工程自动化"
│ └─ ✅ CodingAgent（消息队列 + ThreadBudget）
│
└─ "只想快速体验/实验"
└─ ✅ Paw（一键启动，无依赖）五、技术栈对比速查
| 维度 | Paw | Builder | DataAgent | CodingAgent |
|---|---|---|---|---|
| 后端框架 | Spring Boot MVC | Spring Boot MVC | Spring Boot WebFlux | Spring Boot MVC |
| 前端框架 | React + Vite | React + Vite | React + Vite | 无 |
| 数据库 | 无（纯文件） | H2 / MySQL / PG | H2 / MySQL / PG | SQLite |
| 分布式存储 | 无 | Redis（可选） | Redis（可选） | 无 |
| 沙箱 | 无 | Docker（可选） | 运维方自管 | Docker（运行时自管） |
| 认证 | 无 | JWT + Spring Security | JWT + Spring Security | HMAC Webhook |
| 包名 | io.agentscope.claw2 | io.agentscope.builder | io.agentscope.dataagent | io.agentscope.codingagent |
| API 前缀 | /api/agents/* | /api/agents/*, /api/auth/* | /api/chat/*, /api/auth/* | /webhooks/github, CLI REPL |
| 默认端口 | 8080 | 8080 | 8080 | 8080 |
| 默认账户 | 无 | admin/admin, bob/bob, alice/alice | bob/bob, alice/alice + ADMIN | 无 |
六、演进关系
QwenPaw (Python)
│
▼ Java 移植
AgentScope Paw (claw) —— 个人版
│
├─ 剥离多租户/JWT/Docker ──▶ AgentScope Builder —— 多租户版
│
├─ 专精数据分析 ──▶ AgentScope DataAgent —— 数据分析版
│
└─ 专精代码工程 ──▶ AgentScope CodingAgent —— 自治编码版Paw 是"原点"——最简设计，所有复杂能力（多租户、沙箱、分布式、数据库、Marketplace）都在其他三个项目中按场景需要叠加。
七、快速启动对比
| 项目 | 启动步骤 | 最少依赖 |
|---|---|---|
| Paw | export DASHSCOPE_API_KEY=sk-xxx → java -jar paw.jar | JDK + LLM API Key |
| Builder | export DASHSCOPE_API_KEY=sk-xxx → java -jar builder.jar | JDK + LLM API Key |
| DataAgent | 配置 application.yml（数据源+LLM） → java -jar dataagent.jar | JDK + LLM API Key + 数据源配置 |
| CodingAgent | 配置 application.yml（GitHub Token+Webhook Secret+LLM） → java -jar codingagent.jar + Docker | JDK + LLM API Key + GitHub Token + Docker |
文档生成时间：2026-06-30基于 AgentScope Java 项目源码分析