Agentic Coding Flywheel Setup (ACFS)

🌐 agent-flywheel.com — 面向初学者的交互式设置向导

30分钟内，从零到完全配置的 AI 代理编程 VPS。 一套完整的引导系统，可将一台全新的 Ubuntu VPS 转变为专业的 AI 驱动开发环境。

核心愿景

初学者（笔记本电脑） → 设置向导 → VPS → 能够为您编写代码的 AI 代理

---

快速安装

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh?$(date +%s)" | bash -s -- --yes --mode vibe

该安装程序具有幂等性（idempotent） —— 如果安装过程中断，只需重新运行即可。它会自动从最后完成的阶段恢复，无需任何提示。

生产环境建议： 为了确保安装过程稳定且可复现，请锁定到特定的标签版本（tag）或 commit：

# 推荐：使用标签版本（例如 v0.5.0）
ACFS_REF=v0.5.0 curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/v0.5.0/install.sh" | bash -s -- --yes --mode vibe

# 备选：锁定到特定的 commit SHA
ACFS_REF=abc1234 curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/abc1234/install.sh" | bash -s -- --yes --mode vibe

已发布的标签版本经过测试且稳定。设置 ACFS_REF 可确保所有获取的脚本版本一致。

---

简要概述 (TL;DR)

ACFS 是一套用于引导 AI 代理编程环境的完整系统：

为什么选择它：

• 从零到精： 带领初学者从“我只有一台笔记本电脑”进阶到“我拥有可以在 VPS 上自动编程的 Claude/Codex/Gemini 代理”。
• 一键魔法： 单行 curl | bash 命令即可安装 30 多种工具，完成所有配置并部署三个 AI 编程代理。
• Vibe 模式： 预配置以实现最大效率——包含免密 sudo、已启用高权限代理标志、优化的 Shell 环境等。
• 实战验证的技术栈： 包含完整的 Dicklesworthstone 技术栈（10 种工具 + 实用程序），用于代理编排、协作和安全保障。

您将获得：

• 现代化的 Shell 环境 (zsh + oh-my-zsh + powerlevel10k)
• 各种语言运行时 (bun, uv/Python, Rust, Go)
• 三个 AI 编程代理 (Claude Code, Codex CLI, Gemini CLI)
• 代理协调工具 (NTM, MCP Agent Mail, SLB)
• 云服务 CLI (Vault, Wrangler, Supabase, Vercel)
• 以及 20 多种开发者工具

---

ACFS 体验流程

graph LR
    %%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#e8f5e9', 'lineColor': '#90a4ae'}}}%%

    subgraph user ["用户设备"]
        LAPTOP["笔记本电脑"]
        BROWSER["浏览器"]
    end

    subgraph wizard ["向导网站"]
        STEPS["13 步指南"]
    end

    subgraph vps ["全新 VPS"]
        UBUNTU["Ubuntu 25.10"]
        INSTALLER["install.sh"]
        CONFIGURED["已配置的 VPS"]
    end

    subgraph agents ["AI 代理"]
        CLAUDE["Claude Code"]
        CODEX["Codex CLI"]
        GEMINI["Gemini CLI"]
    end

    LAPTOP --> BROWSER
    BROWSER --> STEPS
    STEPS -->|SSH| UBUNTU
    UBUNTU --> INSTALLER
    INSTALLER --> CONFIGURED
    CONFIGURED --> CLAUDE
    CONFIGURED --> CODEX
    CONFIGURED --> GEMINI

    classDef user fill:#e3f2fd,stroke:#90caf9,stroke-width:2px
    classDef wizard fill:#fff8e1,stroke:#ffcc80,stroke-width:2px
    classDef vps fill:#f3e5f5,stroke:#ce93d8,stroke-width:2px
    classDef agent fill:#e8f5e9,stroke:#a5d6a7,stroke-width:2px

    class LAPTOP,BROWSER user
    class STEPS wizard
    class UBUNTU,INSTALLER,CONFIGURED vps
    class CLAUDE,CODEX,GEMINI agent

面向初学者

ACFS 包含一个分步向导网站 agent-flywheel.com，引导初学者完成以下流程：

1. 在本地机器安装终端
2. 生成 SSH 密钥（用于后续安全访问）
3. 从 OVH 或 Contabo 等提供商租用 VPS
4. 通过密码通过 SSH 连接（初始设置）
5. 运行安装程序（配置密钥登录）
6. 使用 SSH 密钥安全重连
7. 开始使用 AI 代理进行编程

面向开发者

ACFS 提供了一个单行命令，可将任何全新的 Ubuntu VPS 转换为配备现代工具和三个预就绪 AI 编程代理的完整开发环境。

面向团队

ACFS 提供了一种可复现且具有幂等性的设置方案，确保团队中每个成员的 VPS 环境完全一致——彻底消除代理工作流中“在我的机器上可以运行”的问题。

---

架构与设计

ACFS 构建于**单一事实来源（single source of truth）**之上：manifest 文件。其他所有内容——安装脚本、诊断检查（doctor checks）、网站内容——均源自于此。