多杰游戏学

用户工具

站点工具

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

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
知识库:droid指南 [2026/01/23 09:30] – 邪让多杰知识库:droid指南 [2026/04/17 17:37] (当前版本) – [v100+ 升级后出现错误？] 邪让多杰
行 1: 行 1:
 ====== Droid 安装配置指南 ====== ====== Droid 安装配置指南 ======
  
-【进阶】对于已经熟练掌握Droid的玩家，可以尝试 [[opencode指南|OpenCode 安装配置指南]]+== 分支 == 
 +  - [[opencode指南|OpenCode 安装配置指南]] 
 +  - [[openclaw_小龙虾_指南|OpenClaw模型配置教程]] 
 +  - [[配置插件|自动配置插件]] 
 +  - [[mcp-生图插件]]
  
 ===== 简要步骤说明：===== ===== 简要步骤说明：=====
行 8: 行 12:
  
   - **步骤1** - 安装 Droid：运行安装命令   - **步骤1** - 安装 Droid：运行安装命令
-  - **步骤2** - 设置环境变量：让 Droid 能启动（FACTORY_API_KEY 随便填个值） +  - **步骤2** - 登录账号：用<color #ed1c24>谷歌老账号</color>登录（找群主购买） 
-  - **步骤3** - 配置 config.json： +  - **步骤3** - 配置第三方模型（二选一）： 
-    * 在中转站 <color #ed1c24>钱包</color> 里用兑换码兑换余额 +    * 推荐：运行 <color #22b14c>duojie-helper</color> 一键自动配置 
-    * 在 <color #22b14c>令牌</color> 页面生成 API Key +    * 备选：手动编辑 <color #ff7f27>config.json</color>，填入 API Key 
-    * 把 Key 填入 <color #ff7f27>config.json</color> +  - **步骤4** - 用 <color #ed1c24>/model</color> 切换到本站模型；用 <color #ed1c24>/settings</color> 配置压缩选项（200k，当前模型）
-    * 如果以前有用过，需要更新或删除<color #ff7f27>setting.json</color> +
-  - **步骤4** - 切换模型：在 Droid 里用 <color #ed1c24>/model</color> 切换到 <color #00a2e8>custom</color> 里的模型+
  
  
行 33: 行 35:
 </code> </code>
  
-== 第二步：设置环境变量（必须！） ==+== 第二步：登录账号 ==
  
-<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> +
- +
-方法二：永久设置系统环境变量（推荐） +
-<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> +
-export FACTORY_API_KEY="fk-your-key-here" +
-</code> +
- +
-方法二：永久设置（推荐） +
-<code bash> +
-# 添加到 ~/.zshrc（macOS 默认 shell） +
-echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.zshrc +
-source ~/.zshrc +
-</code> +
- +
-**Linux 用户：** +
- +
-方法一：临时设置（关闭终端后失效） +
-<code bash> +
-export FACTORY_API_KEY="fk-your-key-here" +
-</code> +
- +
-方法二：永久设置（推荐） +
-<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 == == 第三步：启动 Droid ==
行 105: 行 63:
   * **macOS**: 终端输入 ''open ~/.factory''   * **macOS**: 终端输入 ''open ~/.factory''
   * **Linux**: 终端输入 ''xdg-open ~/.factory''   * **Linux**: 终端输入 ''xdg-open ~/.factory''
- 
-<note>如果改完后找不到自定义模型，删除setting.json </note> 
  
 ===== 配置第三方渠道 (duojie.games) ===== ===== 配置第三方渠道 (duojie.games) =====
行 117: 行 73:
 </note> </note>
  
-=== 配置示例 ===+=== 方式一：一键配置工具（推荐） === 
 + 
 +''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> 
 + 
 +=== 方式二：手动配置 config.json ===
  
 在 ''config.json'' 中添加以下配置： 在 ''config.json'' 中添加以下配置：
行 125: 行 97:
   "custom_models": [   "custom_models": [
     {     {
-      "model_display_name": "GPT 5.2 [duojie.games]", +      "model_display_name": "Opus 4.6 [duojie.games]", 
-      "model": "gpt-5.2", +      "model": "claude-opus-4-6-gemini",
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "openai-response", +
-      "supports_vision": true, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "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, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "Claude Haiku 4.5 [duojie.games]", +
-      "model": "claude-haiku-4-5",+
       "base_url": "https://api.duojie.games",       "base_url": "https://api.duojie.games",
       "api_key": "你的密钥",       "api_key": "你的密钥",
行 152: 行 106:
     },     },
     {     {
-      "model_display_name": "Opus 4.5 [duojie.games]", +      "model_display_name": "Sonnet 4.6 [duojie.games]", 
-      "model": "claude-opus-4-5-20251101",+      "model": "claude-sonnet-4-6",
       "base_url": "https://api.duojie.games",       "base_url": "https://api.duojie.games",
       "api_key": "你的密钥",       "api_key": "你的密钥",
行 161: 行 115:
     },     },
     {     {
-      "model_display_name": "Opus 4.5 AWS [duojie.games]", +      "model_display_name": "GLM-5 [duojie.games]", 
-      "model": "claude-opus-4-5-aws", +      "model": "glm-5",
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "anthropic", +
-      "supports_vision": true, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "Opus 4.5 Fast [duojie.games]", +
-      "model": "claude-opus-4-5-fast", +
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "anthropic", +
-      "supports_vision": true, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "Opus 4.5 Max [duojie.games]", +
-      "model": "claude-opus-4-5-max",+
       "base_url": "https://api.duojie.games",       "base_url": "https://api.duojie.games",
       "api_key": "你的密钥",       "api_key": "你的密钥",
行 197: 行 133:
     },     },
     {     {
-      "model_display_name": "Gemini 3 Flash [duojie.games]", +      "model_display_name": "GPT 5.4 [duojie.games]", 
-      "model": "gemini-3-flash-preview", +      "model": "gpt-5.4", 
-      "base_url": "https://api.duojie.games",+      "base_url": "https://api.duojie.games/v1",
       "api_key": "你的密钥",       "api_key": "你的密钥",
-      "provider": "anthropic",+      "provider": "openai-responses",
       "supports_vision": true,       "supports_vision": true,
       "max_tokens": 8192       "max_tokens": 8192
     },     },
     {     {
-      "model_display_name": "Gemini 3 Pro Image [duojie.games]", +      "model_display_name": "Gemini 3.1 Pro [duojie.games]", 
-      "model": "gemini-3-pro-image-preview", +      "model": "gemini-3.1-pro", 
-      "base_url": "https://api.duojie.games",+      "base_url": "https://api.duojie.games/v1",
       "api_key": "你的密钥",       "api_key": "你的密钥",
-      "provider": "anthropic", +      "provider": "openai",
-      "supports_vision": true, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "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, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "GLM-4.7 [duojie.games]", +
-      "model": "glm-4.7", +
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "anthropic",+
       "supports_vision": true,       "supports_vision": true,
       "max_tokens": 8192       "max_tokens": 8192
行 248: 行 166:
 | ''supports_prompt_caching'' | 是否支持提示缓存 | 否 | | ''supports_prompt_caching'' | 是否支持提示缓存 | 否 |
  
-<note important>2025年12月25日 Factory 新增了 setting.json 里的模型缓存，如果你要改已有模型，两边都要改。</note>+<note important>2025年12月25日后，如果你改了 ''config.json'' 里的已有模型，需要同时删除 ''settings.json'' 让配置重新生效。</note> 
 + 
 +===== v100+ 升级后出现错误？(Failed to create session.Is the daemon running?) ===== 
 + 
 +升级到 v100 版本之后如果出现各种报错，按以下步骤重置： 
 + 
 +  - 删除 ''settings.json''： 
 +    * Windows: ''%USERPROFILE%\.factory\settings.json'' 
 +    * macOS/Linux: ''~/.factory/settings.json'' 
 +  - 删除系统环境变量中的 ''FACTORY_API_KEY''（旧版假Key残留） 
 +  - 重新打开终端，运行 ''droid''，用谷歌老账号重新登录 
 +  - 用 ''/model'' 重新切换到本站模型 
 +  - 用 ''/settings'' 重新配置压缩选项： 
 +    * 压缩上下文大小：**200k** 
 +    * 压缩模型：选**当前使用的主模型** 
 ===== 切换模型 ===== ===== 切换模型 =====
  
行 327: 行 260:
 **Q: 提示 401 错误？** **Q: 提示 401 错误？**
  
-A: 环境变量未设置或 API Key 无效。检查 ''FACTORY_API_KEY'' 环境变量是否已设置，以及 ''config.json'' 中的 ''api_key'' 是否正确。+A: API Key 无效或未登录。确认已用谷歌老账号登录，并检查 ''config.json'' 中的 ''api_key'' 是否正确。
  
 ---- ----
行 352: 行 285:
  
 A: 在 ''custom_models'' 数组中添加多个配置项即可，参考上方多模型配置示例。 A: 在 ''custom_models'' 数组中添加多个配置项即可，参考上方多模型配置示例。
 +
 +----
 +
 +**Q: 压缩失败（compaction failed）？**
 +
 +A: 使用第三方模型时，压缩功能的默认模型指向官方模型，会因无权限而失败。解决方法：
 +  - 在 Droid 中输入 ''/settings''
 +  - 找到**压缩模型（Summarization Model）**选项，从官方模型切换为**当前正在使用的第三方模型**
 +  - 找到**压缩上下文大小**，设置为 ''200k''
 +  - 保存即可
 +
 +----
 +
 +**Q: 创建会话失败（session creation failed）？**
 +
 +A: 旧版安装时可能设置了 ''FACTORY_API_KEY'' 环境变量（假Key），导致与新版登录机制冲突。解决方法：
 +  - **删除系统环境变量**中的 ''FACTORY_API_KEY''（Windows: 系统属性 → 环境变量 → 删除；macOS/Linux: 编辑 ''~/.bashrc'' 或 ''~/.zshrc'' 删除对应 export 行）
 +  - **关闭并重新打开终端**（确保环境变量生效）
 +  - 运行 ''droid''，使用谷歌老账号重新登录
 +
 +----
 +
 +**Q: 升级后登录失败或模型全部消失？**
 +
 +A: 参考上方「v100+ 升级后出现错误？」章节，按步骤重置即可。
  
 ---- ----
行 382: 行 340:
   * 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> 
  
 ===== 官方资源 ===== ===== 官方资源 =====
知识库/droid指南.1769131856.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