🧠 个人知识库

Factory AI Droid 部署、实战与运维全景指南

Properties1
tagsai, devops, droid, factoryai, toolchain, multiagent

8 min read

Factory AI Droid 部署、实战与运维全景指南

本知识卡全面沉淀了硅谷自主软件工程平台 Factory.ai (Droid CLI) 的系统架构、本地安装配置、多模型调度、限额防护策略、自动化执行规程以及与三位一体研发团队协同的最佳实践。

一、 系统架构与核心定位

Factory Droid 是下一代自主 AI 软件工程师（AI SDLC Agent），与传统的代码补全工具（如 Copilot）不同，Droid 具备：

  1. 全局代码仓理解 (AST)：自动扫描项目依赖、符号定义与文件拓扑，理解大型代码库上下文。
  2. 全流程工程闭环：独立完成“代码分析 ➔ 方案设计 ➔ 跨文件多点补丁 ➔ 自动化测试套件编写 ➔ 终端回归运行”。
  3. 多模型独立与无缝切换：原生支持 Anthropic Claude（Opus 5 / Sonnet 4.6）、OpenAI、Google 等旗舰模型与 Factory 自研 GPT-5.6 Sol 引擎。

二、 本地安装与环境激活 (Linux ARM64 / Debian 13)

1. 安装方式

在宿主机终端直接执行官方安装脚本：

curl -fsSL https://app.factory.ai/cli | sh
  • 安装路径：/root/.local/bin/droid
  • 全局软链接（确保免环境变量直接调用）： 
    ln -sf /root/.local/bin/droid /usr/local/bin/droid

2. Pro 账户授权与激活

在项目目录首次启动交互式授权：

droid
  1. 终端输出登录链接与验证代码；
  2. 在浏览器打开链接，登录已开通 Pro 权限的 Factory.ai 账户；
  3. 终端显示 Successfully logged in，凭据将自动加密保存至 ~/.factory/auth.v2.file。

3. 全链路环境体检 (Doctor)

droid doctor
  • 检查配置合规、TLS 1.3 握手、DNS 解析与 API 连通性。

三、 配置体系与模型策略 (~/.factory/settings.json)

1. 核心配置文件路径

  • 全局用户级配置：~/.factory/settings.json
  • 项目级配置：<project>/.factory/settings.local.json

2. 生产级配置推荐基线

{
  "logoAnimation": "off",
  "trustedFolders": {
    "/root": {
      "trustedAt": "2026-09-05T01:56:59.349Z"
    }
  },
  "model": "claude-sonnet-4-6",
  "reasoningEffort": "medium",
  "modelFallbacks": {
    "claude-opus-5": "claude-sonnet-4-6",
    "claude-sonnet-4-6": "gpt-5-6-sol"
  }
}

3. 模型选型与消耗权衡

模型名称模型 ID (model)算力倍率深度推理 (reasoningEffort)适用场景
Claude Opus 5claude-opus-52×high / max复杂多模块重构、P0/P1 致命架构漏洞静态审计
Claude Sonnet 4.6claude-sonnet-4-61.2×medium / high生产主力推荐：速度极快，工程实现精准，额度消耗平衡
GPT-5.6 Solgpt-5-6-sol1×dynamic兜底引擎，大量文件快速脚手架生成

4. 滚动 5 小时限额熔断与优雅降级 (modelFallbacks)

  • 限额机制：Factory Pro 账户实行 5 小时滚动滑动窗口（Rolling 5-Hour Limit）；
  • 降级链路：配置 modelFallbacks 后，当 claude-opus-5 额度达到 100% 阈值时，系统零等待、自动平滑切换至 claude-sonnet-4-6；若再触顶则降级为 gpt-5-6-sol，待 5 小时额度恢复后自动恢复高阶模型，彻底杜绝任务挂死。

四、 核心使用指南

1. 交互式 TUI 沉浸工作模式

在需要重构的代码目录下直接运行：

cd /root/HermesAgent/clbot
droid
  • 快捷指令：
    • /settings：交互式调整模型、推理深度、Diff 显示样式；
    • /help：查看内置能力与快捷键；
    • Shift + Tab：呼出配置与状态菜单。

2. 自动化/非交互式批处理执行 (droid exec)

用于自动化脚本、CI/CD 流水线以及与其他 AI Agent 编排协同：

# 1. 快速提问与代码解释
droid exec "分析当前目录的核心入口与数据流向"
 
# 2. 指定高自主权审查（免交互确认）
droid exec --auto high "全面走查当前模块的异常捕获与资源释放逻辑，列出隐患"
 
# 3. 指定非破坏性自动改写
droid exec --auto medium "为 database.py 编写完整的 pytest 单元测试用例"

参数避坑要点：

  • 在自动化运行涉及跨文件扫描或修改代码时，必须显式附加 --auto medium 或 --auto high，否则 Droid 会因权限不足退出（insufficient permission to proceed）。

五、 与三位一体研发团队 (Multi-Bot) 的协同实战

在以 Hermes (决策总管) + A Bot (首席架构) + B Bot (核心程序员) 为主轴的敏捷协作流中，Factory Droid 扮演 “A Bot 与 B Bot 的双核 AI 引擎”：

     [用户需求 / 生产告警]
              │
              ▼
   🤖 Hermes (项目总管) ─── 拆解任务、确定边界
              │
              ▼
    📐 A Bot (首席架构)  ─── 调度【droid exec -m gpt-5.5】出具架构蓝图、接口契约与反向证伪用例
              │
              ▼
    💻 B Bot (核心研发)  ─── 强制调度【droid exec --auto high -m claude-opus-5】实施工程落地
              │                ├─ 全局代码扫描与改写 (Opus 5)
              │                └─ 生成高覆盖率自动化测试套件
              ▼
    📐 A Bot (独立审查)  ─── 严格执行“审核三问”，运行极端攻击用例证伪 (GPT-5.5 辅助红队攻击)
              │
              ▼
   🤖 Hermes (终审发布) ─── 终端执行回归、Push 仓库、热更生产 VPS

六、 运维排错与常见陷阱 (Pitfalls)

  1. command not found: droid：
    • 宿主机新开终端可能未读取 ~/.bashrc 中的 PATH。解决方案：建立全局软链接 ln -sf /root/.local/bin/droid /usr/local/bin/droid。
  2. 命令执行长时间卡死（超过 180s/420s 超时）：
    • 根因：开启了 Opus 5 + reasoningEffort: high 且 prompt 过于宽泛（如“全局审查两个项目”），导致 Droid 全量建立沙盒与庞大思维链。
    • 应对：在 settings.json 中使用 claude-sonnet-4-6 搭配 medium 推理，并在 prompt 中精确限定目标文件（如 reporting.py, database.py），严禁无边界泛化任务。
  3. 凭据过期与重登：
    • 凭据缓存位于 ~/.factory/auth.v2.file，可通过 droid doctor 实时探测 Access token expiry。过期时重新在终端运行 droid 唤醒浏览器授权即可。

相关链接

Graph View

Backlinks