基础问题

AgileBuilder 是什么？

AgileBuilder 是 AI 时代的脚手架工具，提供了基于项目模板生成项目的能力，以及可以将团队文档映射为 MCP 资源，从而让 AI 遵循团队规范。

AgileBuilder 免费吗？

本地版完全免费使用。在线版提供专业版和团队版订阅，提供更多高级功能。

AgileBuilder 支持哪些平台？

AgileBuilder 支持 Windows、macOS 和 Linux。CLI 工具可在任何安装了 Node.js 的环境中运行。

本地版相关

本地版和在线版有什么区别？

主要区别：

数据存储：本地版数据存储在本地，在线版同步到云端
团队协作：本地版不支持团队协作，在线版支持
多设备同步：本地版不支持，在线版支持

本地数据存储在哪里？

本地版数据存储在 ~/.agilebuilder 目录下。

模板相关

如何创建模板？

请查看模板制作入门文档。

可以将现有项目转换为模板吗？

可以！使用 agilebuilder template create 命令可以从现有项目快速创建模板。

模板支持哪些变量类型？

支持四种变量类型：

string - 字符串
boolean - 布尔值
select - 单选
multiselect - 多选

详见变量参考。

AI 集成相关

什么是 MCP？

MCP（Model Context Protocol）是一种标准协议，允许 AI 工具与 AgileBuilder 交互。

支持哪些 AI 工具？

目前支持 Cursor、Claude Code、Windsurf 等。详见 AI 工具兼容性。

如何配置 MCP？

请查看 MCP 服务配置文档。

团队协作相关

如何创建团队？

登录控制台后，点击「创建团队」即可。

如何邀请成员？

在团队设置中，点击「邀请成员」，输入邮箱地址即可。

团队版有多少成员限制？

团队版最多支持 50 名成员。

订阅相关

如何开通订阅？

请查看开通订阅文档。

可以退款吗？

自订阅生效之日起 7 天内，如对服务不满意，可申请无理由全额退款。详见退款政策。

如何获取发票？

在「账号设置」→「订阅」页面可以申请发票。

故障排除

安装失败

确保 Node.js 版本 >= 18.0，可以运行以下命令检查：

node --version

模板生成失败

常见原因：

模板文件中的变量语法无效
缺少必需的变量
输出目录已存在且不为空

使用 --verbose 查看详细错误信息：

agilebuilder generate <template> <output> --verbose

MCP 连接失败

确保 MCP 服务已启动：agilebuilder mcp status
检查端口配置是否正确
检查防火墙设置

其他问题

如何联系客服？

邮箱：support@agilebuilder.dev
微信：AgileBuilder 客服

提交功能建议？

欢迎在 GitHub Issues 提交功能建议。