差别

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

--- 知识库:droid指南 [2025/12/19 18:53] – [Droid 安装配置指南] 邪让多杰
+++ 知识库:droid指南 [2025/12/20 22:09] (当前版本) – 邪让多杰
@@ 行 1: / 行 1: @@
 ====== Droid 安装配置指南 ======
-<note important>
-**不要将中转站的 API Key 设置到 Factory 的环境变量中！**
-</note>
-===== 1. 安装 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>
@@ 行 11: / 行 19: @@
 </code>
-===== 2. 登录账号 =====
+== 安装后 ==
-**重要**: 必须使用账号登录 Droid，推荐使用 **Google 账号登录**，可以免电话号验证。
+<code bash>
+cd 你的项目目录
+droid
+</code>
-===== 3. 配置第三方渠道 (duojie.games) =====
+===== 配置文件位置 =====
-==== 3.1 打开配置文件 ====
+^ 系统 ^ 配置文件路径 ^
+| Windows | ''C:\Users\<用户名>\.factory\config.json'' |
+| macOS | ''~/.factory/config.json'' |
+| Linux | ''~/.factory/config.json'' |
-配置文件位置: ''C:\Users\<用户名>\.factory\config.json''
+<note>如果 ''config.json'' 文件不存在，需要自己手动创建。</note>
-快捷方式: 在 VS Code 中按 ''Ctrl+Shift+P''，输入 ''Preferences: Open User Settings (JSON)''，然后手动导航到 ''.factory'' 目录。
+**快速打开方式：**
+  * **Windows**: 资源管理器地址栏输入 ''%USERPROFILE%\.factory''
+  * **macOS**: 终端输入 ''open ~/.factory''
+  * **Linux**: 终端输入 ''xdg-open ~/.factory''
+  * **通用**: 在 Droid 中输入 ''/settings''
-==== 3.2 添加渠道配置 ====
+===== 配置第三方渠道 (duojie.games) =====
-在 ''config.json'' 的 ''custom_models'' 数组中添加以下配置:
+=== 获取 API Key ===
+<note important>
+  - 闲鱼购买的**兑换码**是用于兑换额度的，不是 API Key
+  - API Key 需要在 [[https://api.duojie.games|令牌页面]] 自行生成创建
+</note>
+=== 配置示例 ===
+在 ''config.json'' 中添加以下配置：
 <code json>
@@ 行 42: / 行 69: @@
 </code>
-==== 3.3 配置说明 ====
+=== 多模型配置示例 ===
-^ 字段 ^ 说明 ^
+<code json>
-| ''model_display_name'' | 在 Droid 中显示的模型名称，可自定义 |
+{
-| ''model'' | 实际调用的模型 ID，根据渠道支持的模型填写 |
+  "custom_models": [
-| ''base_url'' | API 地址，默认 ''https://api.duojie.games'' |
+    {
-| ''api_key'' | 你的 API 密钥 |
+      "model_display_name": "Opus 4.5 [duojie.games]",
-| ''provider'' | 提供商类型: ''anthropic'', ''openai'', ''gemini'' 等 |
+      "model": "claude-opus-4-5-20251101",
-| ''supports_vision'' | 是否支持图片识别（可选） |
+      "base_url": "https://api.duojie.games",
-| ''max_tokens'' | 最大输出 token 数（可选） |
+      "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>
-===== 4. 切换模型 =====
+=== 配置字段说明 ===
-在 Droid 聊天界面输入 ''/model'' 命令，在弹出的列表中选择你配置的模型（如 ''Opus 4.5 [duojie.games]''）。
+^ 字段 ^ 说明 ^ 必填 ^
+| ''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'' | 是否支持提示缓存 | 否 |
-<note tip>
+===== 切换模型 =====
-如果 ''/model'' 列表中看不到你配置的模型，说明 ''config.json'' 配置格式有误，请检查 JSON 语法。
-</note>
-===== 5. 正确使用流程 =====
+在 Droid 聊天界面输入 ''/model'' 命令，在弹出的列表中选择你配置的模型。
-<note important>
+<note tip>如果 ''/model'' 列表中看不到你配置的模型，说明 ''config.json'' 配置格式有误，请检查 JSON 语法。</note>
-**请严格按照以下顺序操作：**
-</note>
+===== 常用命令速查 =====
+^ 命令/快捷键 ^ 功能 ^
+| ''/model'' | 切换模型 |
+| ''/settings'' | 打开设置 |
+| ''/clear'' | 清空对话 |
+| ''/help'' | 查看帮助 |
+| ''/compact'' | 压缩上下文 |
+| ''Esc'' 两次 | 中断当前操作 |
+| ''Ctrl+C'' | 退出 Droid |
+| ''droid --version'' | 查看版本 |
+===== 常见问题 =====
+**Q: Windows 安装失败？**
+A: 确保以管理员身份运行 PowerShell。如仍失败，检查网络或尝试使用代理。
+----
+**Q: 提示 400 错误或 401 错误？**
+A: 未登录或登录过期。运行 ''droid'' 重新登录，推荐使用 Google 账号。
-  - **登录 Droid** - 使用 Google 账号登录（免电话验证）
+<note tip>如果Droid成功登录，你的本地会话在Factory.ai官方里能看到的。</note>
-  - **配置 config.json** - 添加自定义模型配置
-  - **切换模型** - 输入 ''/model'' 命令，选择你配置的模型
-  - **验证配置** - 如果 ''/model'' 列表中没有你的模型，说明配置格式错误
-===== 6. 常见问题 =====
+----
 **Q: 提示 API Key 无效？**
-A: 检查 ''apiKey'' 是否正确填写，注意不要有多余空格。
+A: 检查 ''api_key'' 是否正确填写。注意：闲鱼买的兑换码是兑换额度用的，API Key 需要在令牌页面单独生成。
+----
 **Q: 模型列表中看不到配置的模型？**
-A: 重启 VS Code 后重试。
+A: ''config.json'' 格式错误。使用[[https://jsonlint.com/|在线 JSON 校验工具]]检查语法，然后重启 Droid。
+----
+**Q: 找不到 config.json 文件？**
+A: 该文件默认不存在，需要自己在 ''.factory'' 目录下手动创建。
+----
 **Q: 如何添加多个模型？**
-A: 在 ''models'' 数组中添加多个配置项即可。
+A: 在 ''custom_models'' 数组中添加多个配置项即可，参考上方多模型配置示例。
-**Q: 出现 400 错误或 401 错误？**
+----
-A: 这通常是因为没有登录 Droid。请确保已使用账号（推荐 Google）登录 Droid 后再使用。
+**Q: 如何更新 Droid？**
-===== 6. 重要警告 =====
+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 的环境变量中！**
-</note>
   * 中转站的 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 社区]]

多杰游戏学

用户工具

站点工具

差别

页面工具