Olares

简体中文

English

简体中文

English

Appearance

WARNING

本文档由 AI 自动翻译，可能存在表述差异。如需核对，请参考英文原文。

将 OpenCode 设置为你的 AI 编码代理 ​

OpenCode 是一个 AI 驱动的编码代理，允许你通过自然语言编写、测试和管理代码。它支持多个 AI 提供方，并可以从聊天界面运行 shell 命令、创建文件和安装开发环境。

在 Olares 上，你可以通过两种方式使用 OpenCode：

  • 浏览器：在 Olares 上将 OpenCode 安装为应用，并通过浏览器访问它。
  • 本地 CLI：在你的计算机上安装 OpenCode，并将其连接到 Olares 上的模型，以获得原生终端体验。

学习目标 ​

在本教程结束时，你将学习如何：

  • 在 Olares 上安装 OpenCode，并将其连接到本地模型或 OpenAI。
  • 通过聊天界面或基于终端的 UI（TUI）创建项目和运行编码任务。
  • 通过 LarePass VPN 从你的本地计算机使用 OpenCode，或从 VS Code 内部使用。
  • 编辑 OpenCode 配置文件以管理提供方、模型和工具。

前提条件 ​

  • 具有足够磁盘空间和内存的 Olares 设备
  • 从 Market 安装应用的管理员权限
  • 其他条件取决于 OpenCode 的使用方式：
使用方式所需条件
在浏览器中使用本地模型从 Market 安装 Qwen3.6-27B (llama.cpp)
在浏览器中使用 OpenAIChatGPT Plus/Pro 账号或 OpenAI API key
在计算机上使用 OpenCode CLI在 Olares 上安装 Ollama 并下载 qwen3.6:27b，同时在计算机上启用 LarePass VPN

在浏览器中运行 OpenCode ​

此选项在你的 Olares 设备上将 OpenCode 安装为应用。你通过浏览器访问它。

安装 OpenCode ​

  1. 打开 Market 并搜索 "OpenCode"。 Install OpenCode

  2. 点击 Get，然后点击 Install，等待安装完成。

安装后，你将在 Launchpad 上看到两个图标：

  • OpenCode：OpenCode 的主界面。
  • OpenCode Terminal：OpenCode 的命令行终端。如果你更喜欢在 TUI 中工作，请使用此选项。

获取模型连接信息 ​

计划使用 oh-my-openagent？

对于 oh-my-openagent 下的多本地模型设置，请使用单一模型应用。每个模型都有自己的端点，这允许你将其注册为单独的提供方，并调整每个模型的设置（如并发限制）。

模型连接的工作原理

Olares 上的独立模型作为与客户端应用分开的服务运行。要连接两者，客户端需要准确的 Model name，以及与其所需 API 格式相匹配的 Base URL。

你可以从模型控制台获取这两个值。有关更多信息，可参阅连接 AI 应用。

本示例中，OpenCode 通过 OpenAI-compatible API 格式连接 Qwen3.6-27B：

  1. 从启动台打开模型应用。其模型控制台会自动打开。

  2. 等待模型显示就绪，且引擎显示运行中。

    Qwen3.6-27B 模型控制台

  3. 在模型部分，按显示内容原样复制模型名称。

  4. 在引擎部分：

    a. 连接来源：选择 Olares 内应用。

    b. API 格式：选择 OpenAI-Compatible。

    c.按显示内容原样复制 Base URL 地址。

连接到自定义提供方 ​

在 OpenCode 中将 Qwen3.6-27B 添加为自定义提供方。

  1. 在 OpenCode 中，点击左下角的 settings。 Open OpenCode settings

  2. 选择 Providers，然后向下滚动并选择 Custom Provider 旁边的 Connect。 Select custom provider

  3. 输入以下详细信息：

    • Provider ID：输入唯一标识符，例如 qwen3.6-27b。
    • Display name：输入提供方列表中显示的名称，例如 Qwen3.6 27B。
    • Base URL：粘贴从 Model Console 复制的 Base URL，并按显示内容原样使用。
    • Models：
      • Model ID：输入从 Model Console 复制的准确 Model name。本示例中为 unsloth/Qwen3.6-27B-GGUF:Q4_K_M。
      • Display Name：输入该模型的显示名称，例如 Qwen3.6 27B。

  4. 点击 Submit 保存配置。你新添加的提供方将出现在提供方列表中。 Provider list

连接到 OpenAI ​

OpenCode 支持两种连接 OpenAI 的实用方式：

  • 浏览器登录：推荐用于 ChatGPT Plus 或 Pro 账户。
  • API key：简单直接。即使你也有 ChatGPT 订阅，OpenAI 也会根据 token 使用量单独计费 API 使用。

不要使用无头登录

无头登录方法容易出现 OpenAI 安全检查导致的已知故障。失败后，登录流可能会在短时间内无法恢复。请改用浏览器登录或 API key。

创建项目 ​

默认工作空间是 Files 中的 Home/Code。点击左侧导航栏中的 + 创建项目。

Create a project

要处理多个项目，首先在 Home/Code 下创建子文件夹：

  1. 打开 Files 并导航到 Home/Code/。

  2. 为每个项目创建一个子文件夹。 Create subfolders in Files

  3. 返回 OpenCode，点击 +，然后打开带有子文件夹名称的项目。 Open project from subfolder

开始编码 ​

你现在可以通过聊天界面与 OpenCode 交互。

  1. 选择一个项目以打开编码代理界面。

  2. 在聊天框下方，选择 Big Pickle 打开模型选择器，然后从列表中选择 Qwen3.6 27B。

  3. 用自然语言输入编码任务。 Code generation

  4. 点击 folder_open 打开文件浏览器并查看生成的代码。 View files

  5. 使用 @ 在聊天窗口中提及文件，并要求 OpenCode 编辑它。 Mention file in chat

使用 TUI ​

OpenCode 还提供基于终端的 UI（TUI）。你可以通过两种方式启动它：

  • 在 OpenCode UI 内部：在 OpenCode UI 底部打开终端面板，类似于 VS Code 的集成终端。代理聊天在上方保持可见，而 TUI 在面板中运行。
  • 从 OpenCode Terminal：从 Launchpad 打开 OpenCode Terminal。它直接打开到命令行，没有聊天 UI。

从你的计算机运行 OpenCode ​

此可选流程在你的计算机上安装 OpenCode CLI，并通过 LarePass VPN 将其连接到 Olares 上的 Ollama。

安装 OpenCode CLI ​

  1. 使用官方安装程序安装 CLI：

    bash
    curl -fsSL https://opencode.ai/install | bash

  2. （可选）如果你遇到 No config file found for zsh 错误，请通过运行以下命令将 export 行添加到你的 ~/.zshrc 文件：

    bash
    echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.zshrc

    错误消息示例：

    text
    No config file found for zsh. You may need to manually add to PATH:
export PATH=/Users/{username}/.opencode/bin:$PATH

  3. 重新加载你的 shell 配置：

    bash
    source ~/.zshrc

  4. 验证安装：

    bash
    opencode --version

    显示版本，例如 1.15.6。

  5. 运行以下命令初始化 OpenCode 并创建配置文件：

    bash
    opencode

    配置文件在 ~/.config/opencode/opencode.jsonc 创建。

获取 Ollama 服务 Endpoint ​

OpenCode CLI 将 Ollama 应用作为服务提供方进行连接。

应用端点（endpoint）如何工作

当客户端连接另一个 Olares 应用时，会使用该应用的端点作为网络地址。如果应用提供多个端点，请选择与客户端所需功能或协议相匹配的端点。

  1. 前往 Olares 设置 > 应用 > Ollama > 入口。
  2. 选择 Ollama API，然后复制 Endpoint URL。

配置连接 ​

  1. 在你的计算机上启用 LarePass VPN 以连接到 Olares。 Enable LarePass VPN on desktop

    在同一本地网络？

    如果你的计算机和 Olares 在同一 LAN 上，可以跳过 VPN 并使用 .local 域。有关详细信息，请参阅使用 .local 域。

  2. 在文本编辑器中打开 ~/.config/opencode/opencode.jsonc 处的 OpenCode 配置文件。添加一个自定义提供方，包含你的 Ollama 端点和模型。一般格式为：

    json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "<provider-id>": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "<display-name>",
      "options": {
        "baseURL": "<your-endpoint>/v1"
      },
      "models": {
        "<model-id>": {
          "name": "<model-display-name>"
        }
      }
    }
  }
}

    例如，要使用 Qwen3.6 27B 模型连接到 Olares 上的 Ollama：

    json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "olares-ollama": {
      "name": "olares-ollama",
      "npm": "@ai-sdk/openai-compatible",
     "models": {
        "qwen3.6:27b": {
          "name": "Qwen3.6 27B"
        }
      },
      "options": {
        "baseURL": "<Ollama-Endpoint>/v1"
      }
    }
  }
}

    Windows WSL 用户

    如果你在 WSL 中安装了 OpenCode，配置文件路径是 ~/.local/share/opencode/config.json。

  3. 保存文件。

启动 OpenCode TUI ​

  1. 在你的终端中，运行 opencode 启动 TUI： Launch OpenCode TUI in terminal

  2. 使用 /models 命令切换到 Qwen3.6 27B。 Select model in terminal TUI

  3. 开始与你的自托管模型聊天。 Chat in terminal TUI

首次连接

首次连接可能需要更长时间才能建立。

在 VS Code 中使用 OpenCode ​

要直接使用你的代码库，请在 VS Code 中打开终端并从项目目录运行 opencode。

OpenCode in VS Code

编辑配置文件 ​

OpenCode 将其配置存储在 JSON 文件中。你可以直接编辑此文件以管理提供方、模型和工具。

  1. 打开 Files 并导航到 Application/Data/opencode/.config/opencode/。

  2. 右键点击 opencode.jsonc 并选择 Rename。 Rename config file

  3. 将文件重命名为 config.json，以便你可以在 Files 中直接编辑它。OpenCode 识别这两个扩展名。

  4. 打开 config.json 并点击 edit_square 编辑它。 Edit config file

  5. 保存更改。

  6. 从 Settings > Applications 重启 OpenCode 以应用更改。

了解更多 ​