寰宇智联用户指南

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== Droid 安装配置指南 ======

===== 简要步骤说明：=====

**完整配置只需 4 步：**

  - **步骤1** - 安装 Droid：运行安装命令
  - **步骤2** - 登录账号：用谷歌老账号登录
  - **步骤3** - 配置第三方模型：手动编辑 config.json，填入 API Key
  - **步骤4** - 用 /model 切换到本站模型；用 /settings 配置压缩选项（200k，当前模型）

===== 30秒快速开始 =====

== 第一步：安装 Droid ==

**Windows 用户（PowerShell 管理员）：**

<code>
irm https://app.factory.ai/cli/windows | iex
</code>

**macOS / Linux 用户：**

<code>
curl -fsSL https://app.factory.ai/cli | sh
</code>

== 第二步：登录账号 ==

Droid 现在需要使用**谷歌老账号**登录才能启动。账号可联系管理员获取。

运行 ''droid'' 命令后，会自动跳转浏览器完成 Google 账号登录，登录成功后即可使用。

如果你之前设置过 ''FACTORY_API_KEY'' 环境变量（旧版假Key方式），请删除它，否则可能引起冲突。

== 第三步：启动 Droid ==

<code>
cd 你的项目目录
droid
</code>

===== 配置文件位置 =====

^ 系统 ^ 配置文件路径 ^
| 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''

===== 配置第三方渠道 =====

=== 获取 API Key ===

  - API Key 需要在 [[https://huanyuf.top/|本站控制台]] 的令牌页面自行生成创建

=== 手动配置 config.json ===

在 ''config.json'' 中添加以下配置：

<code json>
{
  "custom_models": [
    {
      "model_display_name": "Claude Opus 4.6 [huanyu]",
      "model": "claude-opus-4-6",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Claude Opus 4.6 Thinking [huanyu]",
      "model": "claude-opus-4-6-thinking",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Claude Sonnet 4.6 [huanyu]",
      "model": "claude-sonnet-4-6",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Claude Sonnet 4.6 Thinking [huanyu]",
      "model": "claude-sonnet-4-6-thinking",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Gemini 3.1 Pro [huanyu]",
      "model": "gemini-3.1-pro",
      "base_url": "https://api.huanyuf.top/v1",
      "api_key": "your-api-key",
      "provider": "openai",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Gemini 3 Flash [huanyu]",
      "model": "gemini-3-flash",
      "base_url": "https://api.huanyuf.top/v1",
      "api_key": "your-api-key",
      "provider": "openai",
      "supports_vision": true,
      "max_tokens": 8192
    }
  ]
}
</code>

=== 配置字段说明 ===

^ 字段 ^ 说明 ^ 必填 ^
| ''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日后，如果你改了 ''config.json'' 里的已有模型，需要同时删除 ''settings.json'' 让配置重新生效。

===== 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**
    * 压缩模型：选 **当前使用的主模型**

===== 切换模型 =====

在 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'' 中找到并修改以下字段：

<code json>
{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}
</code>

^ 字段 ^ 说明 ^ 可选值 ^
| ''reasoningEffort'' | **开启思考**：设置思考深度级别 | ''low'' / ''medium'' / ''high'' |
| ''showThinkingInMainView'' | **显示思考过程**：是否在界面显示思考内容 | ''true'' / ''false'' |

=== 操作步骤 ===

  - 使用 ''/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 无效或未登录。确认已用谷歌老账号登录，并检查 ''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: 压缩失败（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+ 升级后出现错误？」章节，按步骤重置即可。

----

**Q: 如何更新 Droid？**

A: 重新运行安装命令即可覆盖更新。

----

**Q: 代理/VPN 环境下无法连接？**

A: 设置环境变量：

<code>
# 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''）

===== 官方资源 =====

  * [[https://docs.factory.ai/|Droid 官方文档]]
  * [[https://app.factory.ai/|Droid 官网]]
  * [[https://app.factory.ai/cli/windows|Windows 下载地址]]
  * [[https://github.com/anthropics/droid|Droid GitHub]]
  * [[https://huanyuf.top/|本站 API 控制台（令牌页面）]]
寰宇智联 用户指南

用户工具

站点工具

页面工具

寰宇智联用户指南
