常见问题
关于 squads.sh 和 Squad 生态系统的常见问题。
什么是 Squad？
Squad 是一个独立的 AI 智能体、任务、工作流和配置文件包，用于在特定领域协同工作。Squads 遵循 Squad 框架定义的标准格式，使其可在项目间移植和复用。
如何安装小队？
首先，全局安装 CLI。然后从市场或 GitHub 仓库添加小队。请参阅 CLI 参考了解所有可用选项。
npm install -g squadssquads add user/squad-name如何发布我的小队？
通过 squads login 进行身份验证，确保您的小队有包含 name、version 和 description 的有效 squad.yaml，然后在小队目录中运行 squads publish。您的小队将经过自动安全审计。
squads loginsquads publish免费吗？
是的。squads.sh 的安装和发布功能完全免费。搜索、浏览和下载小队没有任何费用。发布者可以选择通过市场设置付费小队，但平台本身是免费的。CLI 是开源的。
游戏化系统是如何运作的？
- ▸XP —— 通过发布小队、获得安装量、收到评价和贡献更新来赚取经验值。
- ▸等级 —— 随着 XP 积累，逐步升级（新手、构建者、架构师、大师）。
- ▸徽章 —— 达成里程碑时解锁成就徽章（首次发布、100 次安装、最高评分等）。
- ▸排行榜 —— 在热门趋势和热度飙升页面上参与每周和全时间排名竞争。
安全审计是如何进行的？
发布到市场的每个小队都会经过自动安全审计，检查以下内容：
- ▸结构有效性 —— 正确的文件格式、必填字段、有效的 YAML/Markdown
- ▸交叉引用完整性 —— 任务和工作流中引用的所有智能体都存在
- ▸提示注入模式 —— 检测智能体定义中潜在的恶意指令
- ▸敏感数据暴露 —— 扫描硬编码的密钥、API 密钥或凭据
审计结果在审计页面上公开可见。小队被评级为 SAFE、WARNING 或 CRITICAL。
我可以出售我的小队吗？
可以！市场支持服务器端保护的付费小队分发。发布时使用 squads publish --price 2990（$29.90）设定价格。您需要先在 Dashboard > 设置中连接 Stripe 账户。收入分成：80% 归您，20% 归平台。买家在 squads.sh 购买后通过 CLI 安装。免费小队仍是默认选项，我们鼓励通过免费分享促进社区发展。
什么是 Squad，如何集成？
Synkra Squad 是一个 AI 编排开发框架。使用 --aiox 标志安装小队时，智能体成为 IDE 中的斜杠命令（例如 /SQUADS:ds:designer）。这实现了深度集成，您可以直接从 Claude Code、Gemini CLI 或其他支持的 IDE 调用智能体。运行 npx aiox-core init 开始使用 Squad Core。
npx aios-core init如何在 IDE 中激活小队？
使用 Squad 激活安装小队：squads add my-squad --aiox new（新项目）或 squads add my-squad --aiox existing（现有 Squad 项目）。
squads add my-squad --aios newsquads add my-squad --aios existing激活后，智能体注册为斜杠命令，遵循 /SQUADS:prefix:agent-id 模式。前缀在 squad.yaml 中定义（slashPrefix 字段）。IDE 会自动识别新命令。
支持的 IDE：Claude Code（完整支持）、Gemini CLI（高兼容性）、Codex CLI（部分支持）、Cursor（基于 rules）。