# 安装与登录

> Index of the TerraLab docs for agents: [llms.txt](https://terra-lab.ai/docs/llms.txt). Every docs page is also served as markdown: add .md to its URL.

从 QGIS 插件管理器安装 TerraLab 插件，然后在浏览器中登录一次。大约需要一分钟，不需要银行卡。

## 系统要求

| 插件 | QGIS | 系统 |
| --- | --- | --- |
| AI Agent | 3.28 或更高版本 | Windows、macOS 或 Linux，需要联网 |
| AI Segmentation | 3.22 或更高版本 | Windows、macOS 或 Linux，需要联网 |
| AI Edit | 3.22 或更高版本 | Windows、macOS 或 Linux，需要联网 |

不需要 GPU，也不需要安装任何 Python 包：模型运行在 TerraLab 服务器上。

## 安装

1. 在 QGIS 中打开 **Plugins**，选择 **Manage and Install Plugins**。
2. 搜索 **AI Agent by TerraLab**、**AI Segmentation** 或 **AI Edit**。
3. 点击 **Install**。

同样的插件也可以从 plugins.qgis.org 下载 zip 文件：[AI Agent](https://plugins.qgis.org/plugins/AI_Agent/)、[AI Segmentation](https://plugins.qgis.org/plugins/AI_Segmentation/)、[AI Edit](https://plugins.qgis.org/plugins/AI_Edit/)。在 QGIS 中，用 **Install from ZIP** 安装该文件。

## 登录

1. 打开插件面板。AI Agent 用 `Ctrl+Alt+A` 打开。
2. 点击 **Sign in**。你的浏览器会打开 terra-lab.ai。
3. 登录或创建免费账户，确认后回到 QGIS。

账户会自动关联，免费额度会显示在面板中。一个账户同时适用于三个插件、[MCP 服务器](https://terra-lab.ai/zh-CN/docs/mcp)和 API。用量和套餐见你的[控制台](https://terra-lab.ai/zh-CN/dashboard)。

## 更新

QGIS 会在 **Plugins**、**Manage and Install Plugins**、**Upgradeable** 下列出可用更新。请在那里安装更新；你的登录状态会保留。

## 出问题时

- Windows 上出现 `DLL load failed` 错误：参见 [DLL load failed while importing _C](https://terra-lab.ai/zh-CN/blog/dll-load-failed-while-importing-c-qgis)。
- 在 Linux 上用 Flatpak 安装的 QGIS：参见 [No module named pip](https://terra-lab.ai/zh-CN/blog/qgis-flatpak-no-module-named-pip)。
- 其他问题：请联系[支持](https://terra-lab.ai/zh-CN/docs/support)。

Source: https://terra-lab.ai/zh-CN/docs/plugins/install · Updated 2026-10-27