agentic_coding_flywheel_setup

30分钟把空VPS变成多智能体开发环境

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1665

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类自动化工作流

开发团队Dicklesworthstone

所属国家

官网地址https://agent-flywheel.com

GitHubhttps://github.com/Dicklesworthstone/agentic_coding_flywheel_setup

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Shell

技术栈/模型agentic-ai,agentic-workflow,agentmail,beads,bv

GitHub 星标★ 1665

30天Star增速

HF 下载量

上线时间2025-12-20 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-10

浏览次数0

项目介绍

这是一个面向多智能体 AI 开发场景的一键式环境搭建脚本，用 Shell 写成，目标是把一台全新的 Ubuntu VPS 在约 30 分钟内变成可直接开工的多智能体开发工作站。它解决的核心问题是：自己从零配环境太碎太慢——要装编码代理、会话管理、安全护栏、代理间协调工具，还要处理依赖冲突和配置细节。项目把这些步骤打包成可重复执行的引导流程，自动完成代理运行时、会话持久化、权限与安全限制、以及多代理协作所需的基础设施部署。适合想快速验证多代理工作流、或需要可复制开发环境的个人与团队，省去手工踩坑时间，把精力放在代理逻辑与任务编排上。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 30 分钟部署方式：命令行工具 7 步

环境要求

一台全新（或可重装）的 Ubuntu 或 Arch 系 Linux 机器 / VPS，具备 root 或 sudo 权限
网络可访问 raw.githubusercontent.com（官方脚本主源），浏览器可打开 agent-flywheel.com 查看交互式向导
建议预留约 30 分钟的安装时间；普通笔记本用户可先用官网在线向导生成配置

安装与启动步骤

1准备干净机器

准备一台全新的 Ubuntu 或 Arch 系 VPS / 机器，确认有 sudo 权限并已能联网。README 强调这是把「全新机器」变成开发工作站，已有复杂环境的机器不在保障范围。

2一键安装（vibe 模式）

官方推荐的快速安装命令，适合一次性 VPS：先尝试 raw.githubusercontent.com，失败再回退 jsDelivr，然后以 --yes --mode vibe 执行。请勿调换两个源的顺序。

{ acfs_installer="$(curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh")" || acfs_installer="$(curl -fsSL "https://cdn.jsdelivr.net/gh/Dicklesworthstone/agentic_coding_flywheel_setup@main/install.sh")"; } && printf '%s
' "$acfs_installer" | bash -s -- --yes --mode vibe

3交互式安装

不放心全自动时使用：脚本会逐项询问确认后再执行。适合想看清楚每一步在做什么的用户，也需要停留在终端前应答。
```
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh" | bash
```
4安全模式安装

面向类生产环境：不启用免密 sudo，代理保留标准确认提示。与 vibe 模式相比牺牲速度换安全边界。
```
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh" | bash -s -- --mode safe
```
5锁版本安装

生产环境推荐做法：固定 tag 或 commit，并用 --ref 保证后续拉取的脚本同版本，做到可复现安装。示例为 v0.9.0。
```
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/v0.9.0/install.sh" | bash -s -- --yes --mode vibe --ref v0.9.0
```

6中断后重跑

安装器是幂等的：如果中途断网或被打断，直接重新执行同一条安装命令即可，它会自动从上一个完成的阶段继续，不再重复提问。

{ acfs_installer="$(curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh")" || acfs_installer="$(curl -fsSL "https://cdn.jsdelivr.net/gh/Dicklesworthstone/agentic_coding_flywheel_setup@main/install.sh")"; } && printf '%s
' "$acfs_installer" | bash -s -- --yes --mode vibe

7更新工具链

装好后用 acfs-update 统一更新 apt、运行时、shell、编码代理、云 CLI 与 flywheel 工具栈；支持只更新代理、只更新运行时或先预览。
```
acfs-update --dry-run
```

关键配置

配置项	必填	说明	示例
`cleanupPeriodDays`	否	写入 ~/.claude/settings.json，防止 Claude Code 默认 30 天后删除会话记录，安装器设为 99999。	`99999`
`skipDangerousModePermissionPrompt`	否	仅 vibe 模式写入，跳过编码代理的工作区信任交互提示。	`true`
`--mode`	否	安装器模式开关：vibe 为免密 sudo + 跳过权限提示；safe 为无免密 sudo + 标准确认。	`--mode vibe`
`--ref`	否	配合 tagged release 或 commit SHA 使用，保证本次拉取的所有脚本版本一致。	`--ref v0.9.0`

如何确认成功

安装末尾会执行 post-install smoke test，之后运行 acfs doctor，若关键项通过且没有出现 INTEGRITY 报错即视为成功。

常见问题

Q：安装报 INTEGRITY: missing 是什么原因？

A：通常是用了 jsDelivr 缓存的旧版 install.sh，其文件清单与当前校验账本不匹配。请改用官方命令（raw.githubusercontent.com 在前）重新执行。

Q：安装中途断线了要重来吗？

A：不用。安装器是幂等的，重新执行同一条命令即可，它会自动从最后完成的阶段继续，无需重新回答提示。

Q：vibe 模式和 safe 模式怎么选？

A：vibe 开启免密 sudo 并给代理加 --dangerously-skip-permissions，适合一次性 VPS 追求速度；safe 不给免密 sudo 且保留确认，适合类生产环境。

Q：怎么做到生产环境可复现安装？

A：使用 tagged release 或具体 commit 的 install.sh，并同时传对应 --ref，确保后续拉取的脚本与主脚本同版本。

Q：自动更新会覆盖我本地的 ACFS 仓库吗？

A：默认的 --no-self-update 只更新工具栈、不动 ACFS 自身；只有显式加 --bootstrap-self-update 才会用 origin/main 覆盖仓库文件。

注意事项

官方刻意把 raw.githubusercontent.com 放在第一位、jsDelivr 作为 fallback，请勿调换顺序，否则可能拿到过期安装器导致校验失败。
vibe 模式会启用免密 sudo 与跳过代理权限提示，仅建议用在可随时丢弃的 VPS 上。
安装约需 30 分钟，会依次完成用户、文件系统、shell、CLI 工具、语言运行时、AI 代理、云与数据库、flywheel 工具栈等九个阶段及收尾。
使用 --bootstrap-self-update 前请把本地改动复制出去或提交，它会用 origin/main 覆盖 ACFS 仓库文件。

核心亮点

一条命令完成从裸机到多代理环境的全流程，省去逐项安装配置
覆盖编码代理、会话管理、安全工具和协调设施，开箱即用
基于 Shell 脚本，透明可审计，便于按需裁剪或二次修改

不足之处

仅面向 Ubuntu VPS，其他系统或本地环境适配有限
依赖大量外部工具与网络下载，离线或受限网络下体验受影响

适用场景

快速搭建多代理 AI 开发沙箱做原型验证
团队统一可复制的代理开发环境基线
在云主机上部署长期运行的代理协作工作区

替代项目

Devbox、Nix、Ansible

上一篇：gome-assistant

下一篇：iPhone-use