AgileBuilder logoAgileBuilder
返回文档

常见问题

AgileBuilder 常见问题：收费模式、账号要求、AI 工具支持、模板来源、离线使用、数据存储与退款

产品与收费

AgileBuilder 是免费的吗？

分两层：

  • 开源 CLI：完全免费，MIT 协议开源。本地空间的所有功能——模板管理、项目生成、变量渲染、Hooks、MCP server——永久免费，不需要账号。
  • 云端服务：注册即可免费使用免费版（云端空间只读）；云端空间的写入能力（创建/编辑资源）、团队协作属于订阅功能。中国区 ¥199/年（个人）、¥199/席位/年（团队）；全球区 $49/年、$49/用户/年。

需要注册账号吗？

不需要也能用。只使用本地功能（ag create --git-url、ag res 管理本地资源、agilebuilder-mcp）时无需注册、无需联网登录。需要使用云端空间、多设备同步或团队协作时才需要注册 SSO 账号。

AgileBuilder 会调用大模型吗？

不会。AgileBuilder 本身不集成、不调用任何 LLM。它负责管理模板和规范文档，并通过 MCP 协议把这些资产提供给 AI 工具；实际的模型调用发生在你的 AI 工具（如 Cursor、Claude Code）一侧。

使用

支持哪些 AI 工具？

任何支持 MCP（Model Context Protocol）协议的客户端都可以接入，包括 Cursor、Claude Code、Codex 等。配置方式是把 agilebuilder-mcp 作为 stdio server 加入客户端的 MCP 配置，详见 MCP 集成、Cursor 配置与 Claude Code 配置。

模板从哪里来？

三个来源：

  1. 自己的 Git 仓库：任何 Git 仓库加上一个 .agilebuilder.config.yaml 就是模板，ag create --git-url <url> 即可使用，见创建模板
  2. 团队共享模板库：团队空间中集中维护的模板，成员登录后直接使用
  3. 资源广场：官网资源广场收录的公开模板

离线能用吗？

本地空间的功能完全离线可用：不登录账号，create、res 等命令照常工作。两点例外：克隆模板需要能访问模板所在的 Git 服务；访问云端空间需要网络连接。

我的数据存在哪里？

  • CLI 本地数据（配置、当前空间、本地资源、加密凭据）统一存放在 ~/.agilebuilder/v2，可用环境变量 AGILEBUILDER_CORE1_DATA_DIR 改位置
  • 云端资源存放在 AgileBuilder Cloud 服务器上，按空间隔离；隐私相关说明见隐私政策

账号与订阅

支持哪些登录方式？

纯 SSO 认证，没有独立密码：邮箱验证码、微信扫码、GitHub、Google。首次登录自动创建账号并生成一个个人空间。CLI 端用 ag login 走浏览器 OAuth 授权，也可以用 ag login --api-key <key>。

Trial 试用是什么？

每个账号（空间）可激活一次 14 天 Trial，期间拥有云端空间的完整写入能力；团队空间试用期间最多 10 个席位。试用到期后空间回到免费版只读状态，已有资源仍可查看和使用。

如何退款？

所有已支付订单在支付后 14 天内可申请退款，覆盖新购、续费、加席位和升级等订单类型。具体流程见退款政策。

支持哪些支付方式？

中国区支持微信支付和支付宝；全球区支持 PayPal 和 Paddle。

下一步