====== Droid 安装配置指南 ======

<note important>**不要将中转站的 API Key 设置到 Factory 的环境变量中！**</note>

===== 30秒快速开始 =====

<note tip>首次运行会自动打开浏览器登录，推荐使用 **Google 账号**（免手机验证）</note>

== Windows 用户（PowerShell 管理员） ==

<code powershell>
irm https://app.factory.ai/cli | iex
</code>

== macOS / Linux 用户 ==

<code bash>
curl -fsSL https://app.factory.ai/cli | sh
</code>

== 安装后 ==

<code bash>
cd 你的项目目录
droid
</code>

===== 配置文件位置 =====

^ 系统 ^ 配置文件路径 ^
| Windows | ''C:\Users\<用户名>\.factory\config.json'' |
| macOS | ''~/.factory/config.json'' |
| Linux | ''~/.factory/config.json'' |

<note>如果 ''config.json'' 文件不存在，需要自己手动创建。</note>

**快速打开方式：**
  * **Windows**: 资源管理器地址栏输入 ''%USERPROFILE%\.factory''
  * **macOS**: 终端输入 ''open ~/.factory''
  * **Linux**: 终端输入 ''xdg-open ~/.factory''
  * **通用**: 在 Droid 中输入 ''/settings''

===== 配置第三方渠道 (duojie.games) =====

=== 获取 API Key ===

<note important>
  - 闲鱼购买的**兑换码**是用于兑换额度的，不是 API Key
  - API Key 需要在 [[https://api.duojie.games|令牌页面]] 自行生成创建
</note>

=== 配置示例 ===

在 ''config.json'' 中添加以下配置：

<code json>
{
  "custom_models": [
    {
      "model_display_name": "Opus 4.5 [duojie.games]",
      "model": "claude-opus-4-5-20251101",
      "base_url": "https://api.duojie.games",
      "api_key": "你的API密钥",
      "provider": "anthropic",
      "supports_vision": true
    }
  ]
}
</code>

=== 多模型配置示例 ===

<code json>
{
  "custom_models": [
    {
      "model_display_name": "Opus 4.5 [duojie.games]",
      "model": "claude-opus-4-5-20251101",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true
    },
    {
      "model_display_name": "Sonnet 4 [duojie.games]",
      "model": "claude-sonnet-4-20250514",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic"
    }
  ]
}
</code>

=== 配置字段说明 ===

^ 字段 ^ 说明 ^ 必填 ^
| ''model_display_name'' | 在 Droid 中显示的模型名称 | 是 |
| ''model'' | 实际调用的模型 ID | 是 |
| ''base_url'' | API 地址 | 是 |
| ''api_key'' | 你的 API 密钥（在令牌页面生成） | 是 |
| ''provider'' | 提供商类型: ''anthropic'', ''openai'', ''gemini'', ''openrouter'' | 是 |
| ''supports_vision'' | 是否支持图片识别 | 否 |
| ''max_tokens'' | 最大输出 token 数 | 否 |
| ''supports_prompt_caching'' | 是否支持提示缓存 | 否 |

===== 切换模型 =====

在 Droid 聊天界面输入 ''/model'' 命令，在弹出的列表中选择你配置的模型。

<note tip>如果 ''/model'' 列表中看不到你配置的模型，说明 ''config.json'' 配置格式有误，请检查 JSON 语法。</note>

===== 常用命令速查 =====

^ 命令/快捷键 ^ 功能 ^
| ''/model'' | 切换模型 |
| ''/settings'' | 打开设置 |
| ''/clear'' | 清空对话 |
| ''/help'' | 查看帮助 |
| ''/compact'' | 压缩上下文 |
| ''Esc'' 两次 | 中断当前操作 |
| ''Ctrl+C'' | 退出 Droid |
| ''droid --version'' | 查看版本 |

===== 常见问题 =====

**Q: Windows 安装失败？**

A: 确保以管理员身份运行 PowerShell。如仍失败，检查网络或尝试使用代理。

----

**Q: 提示 400 错误或 401 错误？**

A: 未登录或登录过期。运行 ''droid'' 重新登录，推荐使用 Google 账号。

<note tip>如果Droid成功登录，你的本地会话在Factory.ai官方里能看到的。</note>

----

**Q: 提示 API Key 无效？**

A: 检查 ''api_key'' 是否正确填写。注意：闲鱼买的兑换码是兑换额度用的，API Key 需要在令牌页面单独生成。

----

**Q: 模型列表中看不到配置的模型？**

A: ''config.json'' 格式错误。使用[[https://jsonlint.com/|在线 JSON 校验工具]]检查语法，然后重启 Droid。

----

**Q: 找不到 config.json 文件？**

A: 该文件默认不存在，需要自己在 ''.factory'' 目录下手动创建。

----

**Q: 如何添加多个模型？**

A: 在 ''custom_models'' 数组中添加多个配置项即可，参考上方多模型配置示例。

----

**Q: 如何更新 Droid？**

A: 重新运行安装命令即可覆盖更新。

----

**Q: 代理/VPN 环境下无法连接？**

A: 设置环境变量：
<code bash>
# Linux/macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
</code>

----

**Q: 如何完全卸载？**

A: 删除配置目录和可执行文件：
  * Windows: 删除 ''%USERPROFILE%\.factory'' 目录
  * macOS/Linux: 删除 ''~/.factory'' 目录
  * 删除 ''droid'' 可执行文件（通常在 ''~/.local/bin'' 或 ''/usr/local/bin''）

===== 重要警告 =====

<note important>
**不要将中转站的 API Key 设置到 Factory 的环境变量中！**

  * 中转站的 Key 只能用于 ''config.json'' 中的 BYOK 配置
  * Factory 自身的环境变量（如 ''ANTHROPIC_API_KEY''）应使用官方 Key
  * 混用会导致认证失败
</note>

===== 官方资源 =====

  * [[https://docs.factory.ai|官方文档]]
  * [[https://github.com/factory-ai/factory|GitHub]]
  * [[https://discord.gg/zuudFXxg69|Discord 社区]]