多杰游戏学

用户工具

站点工具

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

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
知识库:droid指南 [2026/04/17 17:37] – [v100+ 升级后出现错误？] 邪让多杰知识库:droid指南 [2026/08/11 19:28] (当前版本) – 外部编辑 127.0.0.1
行 7: 行 7:
   - [[mcp-生图插件]]   - [[mcp-生图插件]]
  
-===== 简要步骤说明：=====+<note tip>本指南教你在 5 分钟内，把 **Droid**（Factory 出品的 AI 编程助手）接到本站模型。完全照着抄就行，不用懂原理。</note>
  
-**完整配置只需 4 步：**+===== 一、安装并登录 =====
  
-  - **步骤1** - 安装 Droid：运行安装命令 +==== 第 1 步：安装 Droid ====
-  - **步骤2** - 登录账号：用<color #ed1c24>谷歌老账号</color>登录（找群主购买） +
-  - **步骤3** - 配置第三方模型（二选一）： +
-    * 推荐：运行 <color #22b14c>duojie-helper</color> 一键自动配置 +
-    * 备选：手动编辑 <color #ff7f27>config.json</color>，填入 API Key +
-  - **步骤4** - 用 <color #ed1c24>/model</color> 切换到本站模型；用 <color #ed1c24>/settings</color> 配置压缩选项（200k，当前模型）+
  
- +**Windows**（用**管理员身份**打开 PowerShell）：
-===== 30秒快速开始 ===== +
- +
-== 第一步：安装 Droid == +
- +
-**Windows 用户（PowerShell 管理员）：**+
  
 <code powershell> <code powershell>
行 29: 行 19:
 </code> </code>
  
-**macOS / Linux 用户：**+**macOS / Linux**：
  
 <code bash> <code bash>
行 35: 行 25:
 </code> </code>
  
-== 第二步：登录账号 ==+==== 第 2 步：登录账号 ====
  
-<note important>Droid 现在需要使用**谷歌老账号**登录才能启动。账号可联系群主购买。</note>+<note important>Droid 需要**谷歌老账号**登录才能启动（账号找群主购买）。</note>
  
-运行 ''droid'' 命令后，会自动跳转浏览器完成 Google 账号登录，登录成功后即可使用。+在终端输入 ''droid'' 回车，会自动打开浏览器，登录 Google 账号即可。
  
-<note warning>如果你之前设置过 ''FACTORY_API_KEY'' 环境变量（旧版假Key方式），请删除它，否则可能引起冲突。</note>+<note warning>如果你以前设过 ''FACTORY_API_KEY'' 环境变量（旧版的假 Key），请先删掉它，否则会和登录冲突。</note>
  
-== 第三步：启动 Droid ==+==== 第 3 步：启动 ====
  
 <code bash> <code bash>
行 50: 行 40:
 </code> </code>
  
-===== 配置文件位置 =====+===== 二、配置本站模型（duojie.games）=====
  
-^ 系统 ^ 配置文件路径 ^ +==== 第 1 步：获取 API Key ====
-| 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'' +
- +
-===== 配置第三方渠道 (duojie.games) ===== +
- +
-=== 获取 API Key ===+
  
 <note important> <note important>
-  - 闲鱼购买的**兑换码**是用于兑换额度的，不是 API Key +  - 闲鱼买的**兑换码**是用来兑换额度的，**不是** API Key 
-  - API Key 需要在 [[https://api.duojie.games|令牌页面]] 自行生成创建+  - API Key 要去 [[https://api.duojie.games|令牌页面]] 自己生成一个
 </note> </note>
  
-=== 方式一：一键配置工具（推荐） ===+==== 第 2 步（二选一）：写入配置 ==== 
 + 
 +=== 方式一：一键配置工具（推荐，最省事） ===
  
-''duojie-helper'' 可以自动将配置写入 Droid，无需手动编辑文件。需要先安装 Node.js。+本站的 ''duojie-helper'' 会自动把模型写进 Droid，**不用手动改任何文件**（需先装好 Node.js）。
  
 <code bash> <code bash>
行 81: 行 59:
 </code> </code>
  
-运行后按提示操作：输入 API Key → 勾选 ''droid'' → 自动写入完成。+按提示操作：粘贴 API Key → 方向键选中 ''droid''（空格勾选）→ 回车，搞定。
  
-也可直接指定只配置 droid：+也可以直接只配 Droid：
  
 <code bash> <code bash>
行 89: 行 67:
 </code> </code>
  
-=== 方式二：手动配置 config.json ===+<note tip>这个工具会自动写好正确的模型地址、接口类型，还会顺手配好「压缩模型」，避免压缩报错。新手强烈推荐用它。</note>
  
-在 ''config.json'' 中添加以下配置：+=== 方式二：手动编辑 settings.json === 
 + 
 +适合想自己掌控配置、或一键工具出问题的同学。 
 + 
 +**配置文件在哪：** 
 + 
 +^ 系统 ^ 路径 ^ 
 +| Windows | ''C:\Users\<用户名>\.factory\settings.json'' | 
 +| macOS / Linux | ''~/.factory/settings.json'' | 
 + 
 +<note>文件不存在就自己建一个。Windows 快速打开：在资源管理器地址栏输入 ''%USERPROFILE%\.factory'' 回车。</note> 
 + 
 +打开（或新建）''settings.json''，填入下面这段——把"你的密钥"换成你在令牌页面生成的 API Key：
  
 <code json> <code json>
 { {
-  "custom_models": [+  "customModels": [
     {     {
-      "model_display_name": "Opus 4.6 [duojie.games]", +      "model": "claude-opus-5", 
-      "model": "claude-opus-4-6-gemini", +      "displayName": "Opus 5 [duojie.games]", 
-      "base_url": "https://api.duojie.games", +      "baseUrl": "https://api.duojie.games", 
-      "api_key": "你的密钥",+      "apiKey": "你的密钥",
       "provider": "anthropic",       "provider": "anthropic",
-      "supports_vision": true, +      "maxOutputTokens": 16384
-      "max_tokens": 8192+
     },     },
     {     {
-      "model_display_name": "Sonnet 4.6 [duojie.games]", +      "model": "gpt-5.6-sol", 
-      "model": "claude-sonnet-4-6", +      "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", 
-      "supports_vision": true, +      "maxOutputTokens": 16384
-      "max_tokens": 8192+
     },     },
     {     {
-      "model_display_name": "GLM-5 [duojie.games]", +      "model": "glm-5.2", 
-      "model": "glm-5", +      "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
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "Sonnet 4.5 [duojie.games]", +
-      "model": "claude-sonnet-4-5", +
-      "base_url": "https://api.duojie.games", +
-      "api_key": "你的密钥", +
-      "provider": "anthropic", +
-      "supports_vision": true, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "GPT 5.4 [duojie.games]", +
-      "model": "gpt-5.4", +
-      "base_url": "https://api.duojie.games/v1", +
-      "api_key": "你的密钥", +
-      "provider": "openai-responses", +
-      "supports_vision": true, +
-      "max_tokens": 8192 +
-    }, +
-    { +
-      "model_display_name": "Gemini 3.1 Pro [duojie.games]", +
-      "model": "gemini-3.1-pro", +
-      "base_url": "https://api.duojie.games/v1", +
-      "api_key": "你的密钥", +
-      "provider": "openai", +
-      "supports_vision": true, +
-      "max_tokens": 8192+
     }     }
-  ]+  ], 
 +  "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日后，如果你改了 ''config.json'' 里的已有模型，需要同时删除 ''settings.json'' 让配置重新生效。</note>+<note important>**''provider'' 和 ''baseUrl'' 怎么选（选错直接报错，务必看）：**
  
-===== v100+ 升级后出现错误？(Failed to create session.Is the daemon running?) =====+  * **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>
  
-升级到 v100 版本之后如果出现各种报错，按以下步骤重置：+<note warning>**和旧版的区别**：以前是写在 ''config.json''、用 ''custom_models''（下划线）的老格式；现在官方改成 ''settings.json''、''customModels''（驼峰）。老格式还能用，但推荐换成新的，''settings.json'' 的优先级更高。两个文件都配了的话，以 ''settings.json'' 为准。 
 +</note>
  
-  - 删除 ''settings.json''： +===== 三、切换模型 =====
-    * Windows: ''%USERPROFILE%\.factory\settings.json'' +
-    * macOS/Linux: ''~/.factory/settings.json'' +
-  - 删除系统环境变量中的 ''FACTORY_API_KEY''（旧版假Key残留） +
-  - 重新打开终端，运行 ''droid''，用谷歌老账号重新登录 +
-  - 用 ''/model'' 重新切换到本站模型 +
-  - 用 ''/settings'' 重新配置压缩选项： +
-    * 压缩上下文大小：**200k** +
-    * 压缩模型：选**当前使用的主模型**+
  
-===== 切换模型 =====+在 Droid 聊天框输入 ''/model''，在列表里选你配的模型即可。
  
-在 Droid 聊天界面输入 ''/model'' 命令，在弹出的列表中选择你配置的模型。+<note tip>看不到你配的模型？八成是 JSON 语法错了（多了逗号、少了引号）。去 [[https://jsonlint.com/|JSON 校验工具]] 查一下，改完会自动生效，不用重启。</note>
  
-<note tip>如果 ''/model'' 列表中看不到你配置的模型，说明 ''config.json'' 配置格式有误，请检查 JSON 语法。</note>+===== 四、开启「思考模式」（让模型想得更深） =====
  
-===== 如何开启思考模式 =====+思考模式让模型在回答前先深入推理，适合复杂任务。
  
-思考模式（Extended Thinking）可以让模型在回答前进行更深入的推理，适合复杂任务。+**最简单的方式：用 ''/settings''**
  
-=== 重要提示 ===+  - 输入 ''/settings'' 
 +  - 找到 **Reasoning Effort（思考深度）**，调高（比如 ''high''） 
 +  - 想看到思考过程，把 **Show Thinking** 打开 
 +  - 保存即可
  
-<note warning> +思考深度从低到高：''off''（关）→ ''low'' → ''medium'' → ''high'' → ''xhigh'' → ''max''。具体能选哪几档取决于模型，不同模型支持的不一样。
-**每次切换模型后，''settings.json'' 会被刷新！** +
- +
-如果你需要开启思考模式，必须在切换模型后**手动修改** ''settings.json'' 文件。 +
-</note> +
- +
-=== 配置文件位置 === +
- +
-  * **Windows**: ''C:\Users\<用户名>\.factory\settings.json'' +
-  * **macOS/Linux**: ''~/.factory/settings.json'' +
- +
-=== 关键配置字段 === +
- +
-在 ''settings.json'' 中找到并修改以下字段：+
  
 +<note>也可以直接改 ''settings.json'' 里这两个字段：
 <code json> <code json>
 { {
行 215: 行 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 无效或未登录。确认已用谷歌老账号登录，并检查 ''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'' 数组中添加多个配置项即可，参考上方多模型配置示例。 +
- +
----- +
- +
-**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：旧版可能残留了 ''FACTORY_API_KEY'' 环境变量（假 Key），和新版登录冲突。解决： 
 +  - 删掉系统环境变量里的 ''FACTORY_API_KEY''（Windows：系统属性 → 环境变量 → 删除；macOS/Linux：编辑 ''~/.bashrc'' 或 ''~/.zshrc'' 删掉对应 export 行） 
 +  - 关掉并重新打开终端 
 +  - 运行 ''droid''，用谷歌账号重新登录
  
-A: 参考上方「v100+ 升级后出现错误？」章节，按步骤重置即可。+如果还不行，把 ''%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
行 334: 行 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''）+
  
 ===== 官方资源 ===== ===== 官方资源 =====
  
-  * [[https://docs.factory.ai|官方文档]]+  * [[https://docs.factory.ai|Factory 官方文档]] 
 +  * [[https://api.duojie.games/pricing|本站模型与定价]]
  
知识库/droid指南.txt · 最后更改: 由 127.0.0.1

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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