用户工具

站点工具


知识库:droid指南

这是本文档旧的修订版!


Droid 安装配置指南

1. 安装 Droid

在终端运行以下命令安装:

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

2. 登录账号

重要: 必须使用账号登录 Droid,推荐使用 Google 账号登录,可以免电话号验证。

3. 配置第三方渠道 (duojie.games)

3.1 打开配置文件

配置文件位置: C:\Users\<用户名>\.factory\config.json

快捷方式: 在 VS Code 中按 Ctrl+Shift+P,输入 Preferences: Open User Settings (JSON),然后手动导航到 .factory 目录。

3.2 添加渠道配置

config.jsoncustom_models 数组中添加以下配置:

{
  "custom_models": [
    {
      "model_display_name": "Opus 4.5 [duojie.games]",
      "model": "claude-opus-4-5-20251101",
      "base_url": "https://api.duojie.games",
      "api_key": "你的API密钥",
      "provider": "anthropic",
      "supports_vision": true
    }
  ]
}

3.3 配置说明

字段 说明
model_display_name 在 Droid 中显示的模型名称,可自定义
model 实际调用的模型 ID,根据渠道支持的模型填写
base_url API 地址,默认 https://api.duojie.games
api_key 你的 API 密钥
provider 提供商类型: anthropic, openai, gemini
supports_vision 是否支持图片识别(可选)
max_tokens 最大输出 token 数(可选)

4. 切换模型

在 Droid 聊天界面输入 /model 命令,在弹出的列表中选择你配置的模型(如 Opus 4.5 [duojie.games])。

如果 /model 列表中看不到你配置的模型,说明 config.json 配置格式有误,请检查 JSON 语法。

5. 正确使用流程

请严格按照以下顺序操作:
  1. 登录 Droid - 使用 Google 账号登录(免电话验证)
  2. 配置 config.json - 添加自定义模型配置
  3. 切换模型 - 输入 /model 命令,选择你配置的模型
  4. 验证配置 - 如果 /model 列表中没有你的模型,说明配置格式错误

6. 常见问题

Q: 提示 API Key 无效?

A: 检查 apiKey 是否正确填写,注意不要有多余空格。

Q: 模型列表中看不到配置的模型?

A: 重启 VS Code 后重试。

Q: 如何添加多个模型?

A: 在 models 数组中添加多个配置项即可。

Q: 出现 400 错误或 401 错误?

A: 这通常是因为没有登录 Droid。请确保已使用账号(推荐 Google)登录 Droid 后再使用。

6. 重要警告

不要将中转站的 API Key 设置到 Factory 的环境变量中!
  • 中转站的 Key 只能用于 config.json 中的 BYOK 配置
  • Factory 自身的环境变量(如 ANTHROPIC_API_KEY)应使用官方 Key
  • 混用会导致认证失败或计费混乱
知识库/droid指南.1766140021.txt.gz · 最后更改: 邪让多杰