多杰游戏学

用户工具

站点工具

您在这里: 学习指南 » 知识库 » droid指南
知识库:droid指南

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
知识库:droid指南 [2026/01/15 15:51] – 邪让多杰知识库:droid指南 [2026/08/11 19:28] (当前版本) – 外部编辑 127.0.0.1
行 1: 行 1:
 ====== Droid 安装配置指南 ====== ====== Droid 安装配置指南 ======
  
-【进阶】可以尝试 [[opencode指南|OpenCode 安装配置指南]]+== 分支 == 
 +  - [[opencode指南|OpenCode 安装配置指南]] 
 +  - [[openclaw_小龙虾_指南|OpenClaw模型配置教程]] 
 +  - [[配置插件|自动配置插件]] 
 +  - [[mcp-生图插件]]
  
-===== 简要步骤说明：=====+<note tip>本指南教你在 5 分钟内，把 **Droid**（Factory 出品的 AI 编程助手）接到本站模型。完全照着抄就行，不用懂原理。</note>
  
-**完整配置只需 4 步：**+===== 一、安装并登录 =====
  
-  - **步骤1** - 安装 Droid：运行安装命令 +==== 第 1 步：安装 Droid ====
-  - **步骤2** - 设置环境变量：让 Droid 能启动（FACTORY_API_KEY 随便填个值） +
-  - **步骤3** - 配置 config.json： +
-    * 在中转站 <color #ed1c24>钱包</color> 里用兑换码兑换余额 +
-    * 在 <color #22b14c>令牌</color> 页面生成 API Key +
-    * 把 Key 填入 <color #ff7f27>config.json</color> +
-    * 如果以前有用过，需要更新或删除<color #ff7f27>setting.json</color> +
-  - **步骤4** - 切换模型：在 Droid 里用 <color #ed1c24>/model</color> 切换到 <color #00a2e8>custom</color> 里的模型+
  
- +**Windows**（用**管理员身份**打开 PowerShell）：
-===== 30秒快速开始 ===== +
- +
-== 第一步：安装 Droid == +
- +
-**Windows 用户（PowerShell 管理员）：**+
  
 <code powershell> <code powershell>
行 27: 行 19:
 </code> </code>
  
-**macOS / Linux 用户：**+**macOS / Linux**：
  
 <code bash> <code bash>
行 33: 行 25:
 </code> </code>
  
-== 第二步：设置环境变量（必须！） ==+==== 第 2 步：登录账号 ====
  
-<note important>Droid 不再需要登录官方账号，只需设置一个环境变量即可启动。FACTORY_API_KEY 的值可以随便填，只要不为空就行。</note>+<note important>Droid 需要**谷歌老账号**登录才能启动（账号找群主购买）。</note>
  
-**Windows 用户：**+在终端输入 ''droid'' 回车，会自动打开浏览器，登录 Google 账号即可。
  
-方法一：PowerShell 临时设置（关闭窗口后失效） +<note warning>如果你以前设过 ''FACTORY_API_KEY'' 环境变量（旧版的假 Key），请先删掉它，否则会和登录冲突。</note>
-<code powershell> +
-$env:FACTORY_API_KEY="fk-your-key-here" +
-</code>+
  
-方法二：永久设置系统环境变量（推荐） +==== 第 3 步：启动 ====
-<code powershell> +
-# 以管理员身份运行 PowerShell +
-[System.Environment]::SetEnvironmentVariable("FACTORY_API_KEY", "fk-your-key-here", "User") +
-</code> +
-或者：右键"此电脑" → 属性 → 高级系统设置 → 环境变量 → 新建用户变量 +
-  * 变量名：''FACTORY_API_KEY'' +
-  * 变量值：''fk-your-key-here'' +
- +
-**macOS 用户：**+
  
-方法一：临时设置（关闭终端后失效） 
 <code bash> <code bash>
-export FACTORY_API_KEY="fk-your-key-here"+cd 你的项目目录 
 +droid
 </code> </code>
  
-方法二：永久设置（推荐） +===== 二、配置本站模型（duojie.games）=====
-<code bash> +
-# 添加到 ~/.zshrc（macOS 默认 shell） +
-echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.zshrc +
-source ~/.zshrc +
-</code>+
  
-**Linux 用户：**+==== 第 1 步：获取 API Key ====
  
-方法一：临时设置（关闭终端后失效） +<note important> 
-<code bash> +  - 闲鱼买的**兑换码**是用来兑换额度的，**不是** API Key 
-export FACTORY_API_KEY="fk-your-key-here" +  - API Key 要去 [[https://api.duojie.games|令牌页面]] 自己生成一个 
-</code>+</note>
  
-方法二：永久设置（推荐） +==== 第 2 步（二选一）：写入配置 ====
-<code bash> +
-# Bash 用户添加到 ~/.bashrc +
-echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.bashrc +
-source ~/.bashrc+
  
-# Zsh 用户添加到 ~/.zshrc +=== 方式一：一键配置工具（推荐，最省事） ===
-echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.zshrc +
-source ~/.zshrc +
-</code>+
  
-== 第三步：启动 Droid ==+本站的 ''duojie-helper'' 会自动把模型写进 Droid，**不用手动改任何文件**（需先装好 Node.js）。
  
 <code bash> <code bash>
-cd 你的项目目录 +npx duojie-helper@latest
-droid+
 </code> </code>
  
-===== 配置文件位置 =====+按提示操作：粘贴 API Key → 方向键选中 ''droid''（空格勾选）→ 回车，搞定。
  
-^ 系统 ^ 配置文件路径 ^ +也可以直接只配 Droid：
-| Windows | ''C:\Users\<用户名>\.factory\config.json'' | +
-| macOS | ''~/.factory/config.json'' | +
-| Linux | ''~/.factory/config.json'' |+
  
-<note>如果 ''config.json'' 文件不存在，需要自己手动创建。</note>+<code bash> 
 +npx duojie-helper@latest config droid 
 +</code>
  
-**快速打开方式：** +<note tip>这个工具会自动写好正确的模型地址、接口类型，还会顺手配好「压缩模型」，避免压缩报错。新手强烈推荐用它。</note>
-  * **Windows**: 资源管理器地址栏输入 ''%USERPROFILE%\.factory'' +
-  * **macOS**: 终端输入 ''open ~/.factory'' +
-  * **Linux**: 终端输入 ''xdg-open ~/.factory''+
  
-<note>如果改完后找不到自定义模型，删除setting.json </note>+=== 方式二：手动编辑 settings.json ===
  
-===== 配置第三方渠道 (duojie.games) =====+适合想自己掌控配置、或一键工具出问题的同学。
  
-=== 获取 API Key ===+**配置文件在哪：**
  
-<note important> +^ 系统 ^ 路径 ^ 
-  - 闲鱼购买的**兑换码**是用于兑换额度的，不是 API Key +| Windows | ''C:\Users\<用户名>\.factory\settings.json'' | 
-  - API Key 需要在 [[https://api.duojie.games|令牌页面]] 自行生成创建 +| macOS / Linux | ''~/.factory/settings.json'' |
-</note>+
  
-=== 配置示例 ===+<note>文件不存在就自己建一个。Windows 快速打开：在资源管理器地址栏输入 ''%USERPROFILE%\.factory'' 回车。</note>
  
-在 ''config.json'' 中添加以下配置：+打开（或新建）''settings.json''，填入下面这段——把"你的密钥"换成你在令牌页面生成的 API Key：
  
 <code json> <code json>
 { {
-  "custom_models": [+  "customModels": [
     {     {
-      "model_display_name": "Opus 4.5 [duojie.games]", +      "model": "claude-opus-5", 
-      "model": "claude-opus-4-5-20251101", +      "displayName": "Opus 5 [duojie.games]", 
-      "base_url": "https://api.duojie.games", +      "baseUrl": "https://api.duojie.games", 
-      "api_key": "你的API密钥",+      "apiKey": "你的密钥",
       "provider": "anthropic",       "provider": "anthropic",
-      "supports_vision": true, +      "maxOutputTokens": 16384
-      "max_tokens": 8192 +
-    } +
-  ] +
-} +
-</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, +
-      "max_tokens": 8192+
     },     },
     {     {
-      "model_display_name": "Opus 4.5 Think [duojie.games]", +      "model": "gpt-5.6-sol", 
-      "model": "claude-opus-4-5-think", +      "displayName": "GPT 5.6 Sol [duojie.games]", 
-      "base_url": "https://api.duojie.games", +      "baseUrl": "https://api.duojie.games/v1", 
-      "api_key": "你的密钥", +      "apiKey": "你的密钥", 
-      "provider": "anthropic", +      "provider": "openai", 
-      "max_tokens": 8192+      "maxOutputTokens": 16384
     },     },
     {     {
-      "model_display_name": "GLM-4.7 [duojie.games]", +      "model": "glm-5.2", 
-      "model": "glm-4.7", +      "displayName": "GLM 5.2 [duojie.games]", 
-      "base_url": "https://api.duojie.games", +      "baseUrl": "https://api.duojie.games/v1", 
-      "api_key": "你的密钥", +      "apiKey": "你的密钥", 
-      "provider": "anthropic", +      "provider": "generic-chat-completion-api", 
-      "supports_vision": true +      "maxOutputTokens": 16384
-    }, +
-    { +
-      "model_display_name": "Gemini 3 Pro [duojie.games]", +
-      "model": "gemini-3-pro-preview", +
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "anthropic", +
-      "supports_vision": true +
-    }, +
-    { +
-      "model_display_name": "gpt 5.2 [duojie.games]", +
-      "model": "gpt-5.2", +
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "openai-response", +
-      "supports_vision": true +
-    }, +
-    { +
-      "model_display_name": "gpt 5.2 codex[duojie.games]", +
-      "model": "gpt-5.2-codex", +
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "openai-response", +
-      "supports_vision": true+
     }     }
-  ]+  ], 
 +  "compactionModel": "same"
 } }
 </code> </code>
  
-=== 配置字段说明 ===+想要更多模型，照着往 ''customModels'' 数组里照葫芦画瓢加就行，本站全部模型见 [[https://api.duojie.games/pricing|定价页]]。 
 + 
 +==== 字段说明 ====
  
 ^ 字段 ^ 说明 ^ 必填 ^ ^ 字段 ^ 说明 ^ 必填 ^
-| ''model_display_name'' | 在 Droid 中显示的模型名称 | 是 | +| ''model'' | 模型 ID，在[[https://api.duojie.games/pricing|定价页]]复制 | 是 | 
-| ''model'' | 实际调用的模型 ID | 是 | +| ''displayName'' | 在 Droid 里显示的名字，随便起 | 是 | 
-| ''base_url'' | API 地址 | 是 | +| ''baseUrl'' | API 地址（怎么选见下方） | 是 | 
-| ''api_key'' | 你的 API 密钥（在令牌页面生成） | 是 | +| ''apiKey'' | 你的 API Key | 是 | 
-| ''provider'' | 提供商类型: ''anthropic'', ''openai'', ''gemini'', ''openrouter'' | 是 | +| ''provider'' | 接口类型，**只有 3 种**：''anthropic'' / ''openai'' / ''generic-chat-completion-api'' | 是 | 
-| ''supports_vision'' | 是否支持图片识别 | 否 | +| ''maxOutputTokens'' | 单次最大输出长度，可省略 | 否 |
-| ''max_tokens'' | 最大输出 token 数 | 否 | +
-| ''supports_prompt_caching'' | 是否支持提示缓存 | 否 |+
  
-<note important>2025年12月25日 Factory 新增了 setting.json 里的模型缓存，如果你要改已有模型，两边都要改。</note> +<note important>**''provider'' 和 ''baseUrl'' 怎么选（选错直接报错，务必看）：**
-===== 切换模型 =====+
  
-在 Droid 聊天界面输入 ''/model'' 命令，在弹出的列表中选择你配置的模型。+  * **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 tip>如果 ''/model'' 列表中看不到你配置的模型，说明 ''config.json'' 配置格式有误，请检查 JSON 语法。</note>+<note warning>**和旧版的区别**：以前是写在 ''config.json''、用 ''custom_models''（下划线）的老格式；现在官方改成 ''settings.json''、''customModels''（驼峰）。老格式还能用，但推荐换成新的，''settings.json'' 的优先级更高。两个文件都配了的话，以 ''settings.json'' 为准。 
 +</note>
  
-===== 如何开启思考模式 =====+===== 三、切换模型 =====
  
-思考模式（Extended Thinking）可以让模型在回答前进行更深入的推理，适合复杂任务。+在 Droid 聊天框输入 ''/model''，在列表里选你配的模型即可。
  
-=== 重要提示 ===+<note tip>看不到你配的模型？八成是 JSON 语法错了（多了逗号、少了引号）。去 [[https://jsonlint.com/|JSON 校验工具]] 查一下，改完会自动生效，不用重启。</note>
  
-<note warning> +===== 四、开启「思考模式」（让模型想得更深） =====
-**每次切换模型后，''settings.json'' 会被刷新！**+
  
-如果你需要开启思考模式，必须在切换模型后**手动修改** ''settings.json'' 文件。 +思考模式让模型在回答前先深入推理，适合复杂任务。
-</note>+
  
-=== 配置文件位置 ===+**最简单的方式：用 ''/settings''**
  
-  * **Windows**: ''C:\Users\<用户名>\.factory\settings.json'' +  - 输入 ''/settings'' 
-  * **macOS/Linux**: ''~/.factory/settings.json''+  - 找到 **Reasoning Effort（思考深度）**，调高（比如 ''high''） 
 +  - 想看到思考过程，把 **Show Thinking** 打开 
 +  - 保存即可
  
-=== 关键配置字段 === +思考深度从低到高：''off''（关）→ ''low'' → ''medium'' → ''high'' → ''xhigh'' → ''max''。具体能选哪几档取决于模型，不同模型支持的不一样。
- +
-在 ''settings.json'' 中找到并修改以下字段：+
  
 +<note>也可以直接改 ''settings.json'' 里这两个字段：
 <code json> <code json>
 { {
行 241: 行 163:
 } }
 </code> </code>
 +</note>
  
-^ 字段 ^ 说明 ^ 可选值 ^ +===== 五、常用命令 =====
-| ''reasoningEffort'' | **开启思考**：设置思考深度级别 | ''low'' / ''medium'' / ''high'' | +
-| ''showThinkingInMainView'' | **显示思考过程**：是否在界面显示思考内容 | ''true'' / ''false'' | +
- +
-=== 思考深度说明 === +
- +
-使用模型：`claude-opus-4-5-think` +
- +
-=== 操作步骤 === +
- +
-  - 使用 ''/model'' 切换到你想要的模型 +
-  - 打开配置目录 `C:\Users\用户名\.factory` +
-  - 编辑 ''settings.json'' 文件 +
-  - 如果想看到思考过程，将 ''showThinkingInMainView'' 改为 ''true'' +
-  - 保存文件，配置立即生效 +
- +
-===== 常用命令速查 =====+
  
-^ 命令/快捷键 ^ 功能 ^+^ 命令 ^ 作用 ^
 | ''/model'' | 切换模型 | | ''/model'' | 切换模型 |
-| ''/settings'' | 打开设置 | +| ''/settings'' | 打开设置（思考、压缩、声音等都在这） | 
-| ''/clear'' | 清空对话 |+| ''/clear'' | 清空当前对话 | 
 +| ''/compact'' | 手动压缩上下文 |
 | ''/help'' | 查看帮助 | | ''/help'' | 查看帮助 |
-| ''/compact'' | 压缩上下文 | +| ''Esc'' 按两下 | 打断当前操作 |
-| ''Esc'' 两次 | 中断当前操作 |+
 | ''Ctrl+C'' | 退出 Droid | | ''Ctrl+C'' | 退出 Droid |
 | ''droid --version'' | 查看版本 | | ''droid --version'' | 查看版本 |
  
-===== 常见问题 =====+===== 六、常见问题 =====
  
-**Q: Windows 安装失败？**+**Q：提示 400 错误？**
  
-A: 确保以管理员身份运行 PowerShell。如仍失败，检查网络或尝试使用代理。+A：通常是模型 ID 写错，或 ''provider'' 选错。去[[https://api.duojie.games/pricing|定价页]]核对模型 ID，并按上面的「provider 怎么选」对照。
  
 ---- ----
  
-**Q: 提示 400 错误？**+**Q：提示 401 错误 / API Key 无效？**
  
-A: 模型名称错误，检查 ''config.json'' 中的 ''model'' 字段是否正确。+A：确认已用谷歌账号登录，且 ''apiKey'' 填对了。注意：闲鱼兑换码≠API Key，API Key 要在[[https://api.duojie.games|令牌页面]]单独生成。
  
 ---- ----
  
-**Q: 提示 401 错误？**+**Q：''/model'' 列表里看不到我配的模型？**
  
-A: 环境变量未设置或 API Key 无效。检查 ''FACTORY_API_KEY'' 环境变量是否已设置，以及 ''config.json'' 中的 ''api_key'' 是否正确。+A：''settings.json'' 的 JSON 语法错了。用[[https://jsonlint.com/|JSON 校验工具]]检查，改完自动生效。
  
 ---- ----
  
-**Q: 提示 API Key 无效？**+**Q：找不到 settings.json 文件？**
  
-A: 检查 ''api_key'' 是否正确填写。注意：闲鱼买的兑换码是兑换额度用的，API Key 需要在令牌页面单独生成。+A：它默认不存在，自己在 ''.factory'' 目录下新建一个即可。
  
 ---- ----
  
-**Q: 模型列表中看不到配置的模型？**+**Q：如何添加更多模型？**
  
-A: ''config.json'' 格式错误。使用[[https://jsonlint.com/|在线 JSON 校验工具]]检查语法，然后重启 Droid。+A：在 ''customModels'' 数组里照着已有的格式加一条就行。
  
 ---- ----
  
-**Q: 找不到 config.json 文件？**+**Q：压缩失败（compaction failed）？**
  
-A: 该文件默认不存在，需要自己在 ''.factory'' 目录下手动创建。+A：用第三方模型时，压缩默认会去找官方模型，因没权限而失败。解决方法二选一： 
 +  - 用 ''duojie-helper'' 一键配置（会自动帮你设好，最省心） 
 +  - 或在 ''settings.json'' 里加上 ''"compactionModel": "same"''（压缩用当前模型），也可以在 ''/settings'' 里把压缩模型（Summarization/Compaction Model）手动选成当前在用的模型
  
 ---- ----
  
-**Q: 如何添加多个模型？**+**Q：创建会话失败（Failed to create session / daemon running）？**
  
-A: 在 ''custom_models'' 数组中添加多个配置项即可，参考上方多模型配置示例。+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？**+**Q：如何更新 Droid？**
  
-A: 重新运行安装命令即可覆盖更新。+A：重新运行一遍安装命令即可覆盖更新。
  
 ---- ----
  
-**Q: 代理/VPN 环境下无法连接？**+**Q：代理 / VPN 下连不上？**
  
-A: 设置环境变量：+A：设置环境变量：
 <code bash> <code bash>
-# Linux/macOS+# Linux / macOS
 export HTTP_PROXY=http://127.0.0.1:7890 export HTTP_PROXY=http://127.0.0.1:7890
 export HTTPS_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890
行 335: 行 249:
 ---- ----
  
-**Q: 如何完全卸载？**+**Q：如何完全卸载？**
  
-A: 删除配置目录和可执行文件： +A： 
-  * Windows: 删除 ''%USERPROFILE%\.factory'' 目录 +  * 删配置目录：Windows 删 ''%USERPROFILE%\.factory''；macOS/Linux 删 ''~/.factory'' 
-  * macOS/Linux: 删除 ''~/.factory'' 目录 +  * 删可执行文件 ''droid''（通常在 ''~/.local/bin'' 或 ''/usr/local/bin''）
-  * 删除 ''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://docs.factory.ai|Factory 官方文档]] 
 +  * [[https://api.duojie.games/pricing|本站模型与定价]]
  
知识库/droid指南.1768463474.txt.gz · 最后更改: 由 邪让多杰

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： GNU Free Documentation License 1.3
粤ICP备2021175623号
GNU Free Documentation License 1.3 Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki