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

== 分支 ==
  - [[opencode指南|OpenCode 安装配置指南]]
  - [[openclaw_小龙虾_指南|OpenClaw模型配置教程]]
  - [[配置插件|自动配置插件]]
  - [[mcp-生图插件]]

<note tip>本指南教你在 5 分钟内，把 **Droid**（Factory 出品的 AI 编程助手）接到本站模型。完全照着抄就行，不用懂原理。</note>

===== 一、安装并登录 =====

==== 第 1 步：安装 Droid ====

**Windows**（用**管理员身份**打开 PowerShell）：

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

**macOS / Linux**：

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

==== 第 2 步：登录账号 ====

<note important>Droid 需要**谷歌老账号**登录才能启动（账号找群主购买）。</note>

在终端输入 ''droid'' 回车，会自动打开浏览器，登录 Google 账号即可。

<note warning>如果你以前设过 ''FACTORY_API_KEY'' 环境变量（旧版的假 Key），请先删掉它，否则会和登录冲突。</note>

==== 第 3 步：启动 ====

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

===== 二、配置本站模型（duojie.games）=====

==== 第 1 步：获取 API Key ====

<note important>
  - 闲鱼买的**兑换码**是用来兑换额度的，**不是** API Key
  - API Key 要去 [[https://api.duojie.games|令牌页面]] 自己生成一个
</note>

==== 第 2 步（二选一）：写入配置 ====

=== 方式一：一键配置工具（推荐，最省事） ===

本站的 ''duojie-helper'' 会自动把模型写进 Droid，**不用手动改任何文件**（需先装好 Node.js）。

<code bash>
npx duojie-helper@latest
</code>

按提示操作：粘贴 API Key → 方向键选中 ''droid''（空格勾选）→ 回车，搞定。

也可以直接只配 Droid：

<code bash>
npx duojie-helper@latest config droid
</code>

<note tip>这个工具会自动写好正确的模型地址、接口类型，还会顺手配好「压缩模型」，避免压缩报错。新手强烈推荐用它。</note>

=== 方式二：手动编辑 settings.json ===

适合想自己掌控配置、或一键工具出问题的同学。

**配置文件在哪：**

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

<note>文件不存在就自己建一个。Windows 快速打开：在资源管理器地址栏输入 ''%USERPROFILE%\.factory'' 回车。</note>

打开（或新建）''settings.json''，填入下面这段——把"你的密钥"换成你在令牌页面生成的 API Key：

<code json>
{
  "customModels": [
    {
      "model": "claude-opus-5",
      "displayName": "Opus 5 [duojie.games]",
      "baseUrl": "https://api.duojie.games",
      "apiKey": "你的密钥",
      "provider": "anthropic",
      "maxOutputTokens": 16384
    },
    {
      "model": "gpt-5.6-sol",
      "displayName": "GPT 5.6 Sol [duojie.games]",
      "baseUrl": "https://api.duojie.games/v1",
      "apiKey": "你的密钥",
      "provider": "openai",
      "maxOutputTokens": 16384
    },
    {
      "model": "glm-5.2",
      "displayName": "GLM 5.2 [duojie.games]",
      "baseUrl": "https://api.duojie.games/v1",
      "apiKey": "你的密钥",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384
    }
  ],
  "compactionModel": "same"
}
</code>

想要更多模型，照着往 ''customModels'' 数组里照葫芦画瓢加就行，本站全部模型见 [[https://api.duojie.games/pricing|定价页]]。

==== 字段说明 ====

^ 字段 ^ 说明 ^ 必填 ^
| ''model'' | 模型 ID，在[[https://api.duojie.games/pricing|定价页]]复制 | 是 |
| ''displayName'' | 在 Droid 里显示的名字，随便起 | 是 |
| ''baseUrl'' | API 地址（怎么选见下方） | 是 |
| ''apiKey'' | 你的 API Key | 是 |
| ''provider'' | 接口类型，**只有 3 种**：''anthropic'' / ''openai'' / ''generic-chat-completion-api'' | 是 |
| ''maxOutputTokens'' | 单次最大输出长度，可省略 | 否 |

<note important>**''provider'' 和 ''baseUrl'' 怎么选（选错直接报错，务必看）：**

  * **Claude 系列**（opus / sonnet / haiku）→ ''provider'' 填 ''anthropic''，''baseUrl'' 填 ''https://api.duojie.games''（**不带** /v1）
  * **GPT / Grok 系列** → ''provider'' 填 ''openai''，''baseUrl'' 填 ''https://api.duojie.games/v1''
  * **GLM 等其它模型** → ''provider'' 填 ''generic-chat-completion-api''，''baseUrl'' 填 ''https://api.duojie.games/v1''
</note>

<note warning>**和旧版的区别**：以前是写在 ''config.json''、用 ''custom_models''（下划线）的老格式；现在官方改成 ''settings.json''、''customModels''（驼峰）。老格式还能用，但推荐换成新的，''settings.json'' 的优先级更高。两个文件都配了的话，以 ''settings.json'' 为准。
</note>

===== 三、切换模型 =====

在 Droid 聊天框输入 ''/model''，在列表里选你配的模型即可。

<note tip>看不到你配的模型？八成是 JSON 语法错了（多了逗号、少了引号）。去 [[https://jsonlint.com/|JSON 校验工具]] 查一下，改完会自动生效，不用重启。</note>

===== 四、开启「思考模式」（让模型想得更深） =====

思考模式让模型在回答前先深入推理，适合复杂任务。

**最简单的方式：用 ''/settings''**

  - 输入 ''/settings''
  - 找到 **Reasoning Effort（思考深度）**，调高（比如 ''high''）
  - 想看到思考过程，把 **Show Thinking** 打开
  - 保存即可

思考深度从低到高：''off''（关）→ ''low'' → ''medium'' → ''high'' → ''xhigh'' → ''max''。具体能选哪几档取决于模型，不同模型支持的不一样。

<note>也可以直接改 ''settings.json'' 里这两个字段：
<code json>
{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}
</code>
</note>

===== 五、常用命令 =====

^ 命令 ^ 作用 ^
| ''/model'' | 切换模型 |
| ''/settings'' | 打开设置（思考、压缩、声音等都在这） |
| ''/clear'' | 清空当前对话 |
| ''/compact'' | 手动压缩上下文 |
| ''/help'' | 查看帮助 |
| ''Esc'' 按两下 | 打断当前操作 |
| ''Ctrl+C'' | 退出 Droid |
| ''droid --version'' | 查看版本 |

===== 六、常见问题 =====

**Q：提示 400 错误？**

A：通常是模型 ID 写错，或 ''provider'' 选错。去[[https://api.duojie.games/pricing|定价页]]核对模型 ID，并按上面的「provider 怎么选」对照。

----

**Q：提示 401 错误 / API Key 无效？**

A：确认已用谷歌账号登录，且 ''apiKey'' 填对了。注意：闲鱼兑换码≠API Key，API Key 要在[[https://api.duojie.games|令牌页面]]单独生成。

----

**Q：''/model'' 列表里看不到我配的模型？**

A：''settings.json'' 的 JSON 语法错了。用[[https://jsonlint.com/|JSON 校验工具]]检查，改完自动生效。

----

**Q：找不到 settings.json 文件？**

A：它默认不存在，自己在 ''.factory'' 目录下新建一个即可。

----

**Q：如何添加更多模型？**

A：在 ''customModels'' 数组里照着已有的格式加一条就行。

----

**Q：压缩失败（compaction failed）？**

A：用第三方模型时，压缩默认会去找官方模型，因没权限而失败。解决方法二选一：
  - 用 ''duojie-helper'' 一键配置（会自动帮你设好，最省心）
  - 或在 ''settings.json'' 里加上 ''"compactionModel": "same"''（压缩用当前模型），也可以在 ''/settings'' 里把压缩模型（Summarization/Compaction Model）手动选成当前在用的模型

----

**Q：创建会话失败（Failed to create session / daemon running）？**

A：旧版可能残留了 ''FACTORY_API_KEY'' 环境变量（假 Key），和新版登录冲突。解决：
  - 删掉系统环境变量里的 ''FACTORY_API_KEY''（Windows：系统属性 → 环境变量 → 删除；macOS/Linux：编辑 ''~/.bashrc'' 或 ''~/.zshrc'' 删掉对应 export 行）
  - 关掉并重新打开终端
  - 运行 ''droid''，用谷歌账号重新登录

如果还不行，把 ''%USERPROFILE%\.factory\settings.json''（macOS/Linux：''~/.factory/settings.json''）删掉，重新登录、重新配置一遍。

----

**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''）

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

  * [[https://docs.factory.ai|Factory 官方文档]]
  * [[https://api.duojie.games/pricing|本站模型与定价]]