====== Droid 安装配置指南 ====== 【进阶】对于已经熟练掌握Droid的玩家，可以尝试 [[opencode指南|OpenCode 安装配置指南]] 新增智能配置工具【测试】,可以尝试使用： npx duojie-helper@latest ===== 简要步骤说明：===== **完整配置只需 4 步：** - **步骤1** - 安装 Droid：运行安装命令 - **步骤2** - 设置环境变量：让 Droid 能启动（FACTORY_API_KEY 随便填个值） - **步骤3** - 配置 config.json： * 在中转站 钱包 里用兑换码兑换余额 * 在 令牌 页面生成 API Key * 把 Key 填入 config.json * 如果以前有用过，需要更新或删除setting.json - **步骤4** - 切换模型：在 Droid 里用 /model 切换到 custom 里的模型 ===== 30秒快速开始 ===== == 第一步：安装 Droid == **Windows 用户（PowerShell 管理员）：** irm https://app.factory.ai/cli/windows | iex **macOS / Linux 用户：** curl -fsSL https://app.factory.ai/cli | sh == 第二步：设置环境变量（必须！） == Droid 不再需要登录官方账号，只需设置一个环境变量即可启动。FACTORY_API_KEY 的值可以随便填，只要不为空就行。 **Windows 用户：** 方法一：PowerShell 临时设置（关闭窗口后失效） $env:FACTORY_API_KEY="fk-your-key-here" 方法二：永久设置系统环境变量（推荐） # 以管理员身份运行 PowerShell [System.Environment]::SetEnvironmentVariable("FACTORY_API_KEY", "fk-your-key-here", "User") 或者：右键"此电脑" → 属性 → 高级系统设置 → 环境变量 → 新建用户变量 * 变量名：''FACTORY_API_KEY'' * 变量值：''fk-your-key-here'' **macOS 用户：** 方法一：临时设置（关闭终端后失效） export FACTORY_API_KEY="fk-your-key-here" 方法二：永久设置（推荐） # 添加到 ~/.zshrc（macOS 默认 shell） echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.zshrc source ~/.zshrc **Linux 用户：** 方法一：临时设置（关闭终端后失效） export FACTORY_API_KEY="fk-your-key-here" 方法二：永久设置（推荐） # 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 == 第三步：启动 Droid == cd 你的项目目录 droid ===== 配置文件位置 ===== ^ 系统 ^ 配置文件路径 ^ | Windows | ''C:\Users\<用户名>\.factory\config.json'' | | macOS | ''~/.factory/config.json'' | | Linux | ''~/.factory/config.json'' | 如果 ''config.json'' 文件不存在，需要自己手动创建。 **快速打开方式：** * **Windows**: 资源管理器地址栏输入 ''%USERPROFILE%\.factory'' * **macOS**: 终端输入 ''open ~/.factory'' * **Linux**: 终端输入 ''xdg-open ~/.factory'' 如果改完后找不到自定义模型，删除setting.json ===== 配置第三方渠道 (duojie.games) ===== === 获取 API Key === - 闲鱼购买的**兑换码**是用于兑换额度的，不是 API Key - API Key 需要在 [[https://api.duojie.games|令牌页面]] 自行生成创建 === 配置示例 === 在 ''config.json'' 中添加以下配置： { "custom_models": [ { "model_display_name": "Opus 4.5 Kiro [duojie.games]", "model": "claude-opus-4-5-kiro", "base_url": "https://api.duojie.games", "api_key": "你的密钥", "provider": "anthropic", "supports_vision": true, "max_tokens": 8192 }, { "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 Max [duojie.games]", "model": "claude-opus-4-5-max", "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, "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", "api_key": "你的密钥", "provider": "anthropic", "supports_vision": true, "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": "Gemini 3 Flash [duojie.games]", "model": "gemini-3-flash-preview", "base_url": "https://api.duojie.games", "api_key": "你的密钥", "provider": "anthropic", "supports_vision": true, "max_tokens": 8192 }, { "model_display_name": "Gemini 3 Pro Image [duojie.games]", "model": "gemini-3-pro-image-preview", "base_url": "https://api.duojie.games", "api_key": "你的密钥", "provider": "anthropic", "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'' | 在 Droid 中显示的模型名称 | 是 | | ''model'' | 实际调用的模型 ID | 是 | | ''base_url'' | API 地址 | 是 | | ''api_key'' | 你的 API 密钥（在令牌页面生成） | 是 | | ''provider'' | 提供商类型: ''anthropic'', ''openai'', ''gemini'', ''openrouter'' | 是 | | ''supports_vision'' | 是否支持图片识别 | 否 | | ''max_tokens'' | 最大输出 token 数 | 否 | | ''supports_prompt_caching'' | 是否支持提示缓存 | 否 | 2025年12月25日 Factory 新增了 setting.json 里的模型缓存，如果你要改已有模型，两边都要改。 ===== 切换模型 ===== 在 Droid 聊天界面输入 ''/model'' 命令，在弹出的列表中选择你配置的模型。 如果 ''/model'' 列表中看不到你配置的模型，说明 ''config.json'' 配置格式有误，请检查 JSON 语法。 ===== 如何开启思考模式 ===== 思考模式（Extended Thinking）可以让模型在回答前进行更深入的推理，适合复杂任务。 === 重要提示 === **每次切换模型后，''settings.json'' 会被刷新！** 如果你需要开启思考模式，必须在切换模型后**手动修改** ''settings.json'' 文件。 === 配置文件位置 === * **Windows**: ''C:\Users\<用户名>\.factory\settings.json'' * **macOS/Linux**: ''~/.factory/settings.json'' === 关键配置字段 === 在 ''settings.json'' 中找到并修改以下字段： { "reasoningEffort": "high", "showThinkingInMainView": true } ^ 字段 ^ 说明 ^ 可选值 ^ | ''reasoningEffort'' | **开启思考**：设置思考深度级别 | ''low'' / ''medium'' / ''high'' | | ''showThinkingInMainView'' | **显示思考过程**：是否在界面显示思考内容 | ''true'' / ''false'' | === 思考深度说明 === 使用模型：`claude-opus-4-5-think` === 操作步骤 === - 使用 ''/model'' 切换到你想要的模型 - 打开配置目录 `C:\Users\用户名\.factory` - 编辑 ''settings.json'' 文件 - 如果想看到思考过程，将 ''showThinkingInMainView'' 改为 ''true'' - 保存文件，配置立即生效 ===== 常用命令速查 ===== ^ 命令/快捷键 ^ 功能 ^ | ''/model'' | 切换模型 | | ''/settings'' | 打开设置 | | ''/clear'' | 清空对话 | | ''/help'' | 查看帮助 | | ''/compact'' | 压缩上下文 | | ''Esc'' 两次 | 中断当前操作 | | ''Ctrl+C'' | 退出 Droid | | ''droid --version'' | 查看版本 | ===== 常见问题 ===== **Q: Windows 安装失败？** A: 确保以管理员身份运行 PowerShell。如仍失败，检查网络或尝试使用代理。 ---- **Q: 提示 400 错误？** A: 模型名称错误，检查 ''config.json'' 中的 ''model'' 字段是否正确。 ---- **Q: 提示 401 错误？** A: 环境变量未设置或 API Key 无效。检查 ''FACTORY_API_KEY'' 环境变量是否已设置，以及 ''config.json'' 中的 ''api_key'' 是否正确。 ---- **Q: 提示 API Key 无效？** A: 检查 ''api_key'' 是否正确填写。注意：闲鱼买的兑换码是兑换额度用的，API Key 需要在令牌页面单独生成。 ---- **Q: 模型列表中看不到配置的模型？** A: ''config.json'' 格式错误。使用[[https://jsonlint.com/|在线 JSON 校验工具]]检查语法，然后重启 Droid。 ---- **Q: 找不到 config.json 文件？** A: 该文件默认不存在，需要自己在 ''.factory'' 目录下手动创建。 ---- **Q: 如何添加多个模型？** A: 在 ''custom_models'' 数组中添加多个配置项即可，参考上方多模型配置示例。 ---- **Q: 如何更新 Droid？** A: 重新运行安装命令即可覆盖更新。 ---- **Q: 代理/VPN 环境下无法连接？** A: 设置环境变量： # 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" ---- **Q: 如何完全卸载？** A: 删除配置目录和可执行文件： * Windows: 删除 ''%USERPROFILE%\.factory'' 目录 * macOS/Linux: 删除 ''~/.factory'' 目录 * 删除 ''droid'' 可执行文件（通常在 ''~/.local/bin'' 或 ''/usr/local/bin''） ===== 重要警告 ===== **不要将中转站的 API Key 设置到 Factory 的环境变量中！** * 中转站的 Key 只能用于 ''config.json'' 中的 BYOK 配置 * Factory 自身的环境变量（如 ''ANTHROPIC_API_KEY''）应使用官方 Key * 混用会导致认证失败 ===== 官方资源 ===== * [[https://docs.factory.ai|官方文档]]