插件开发概述

TGO 插件系统允许开发者通过标准化的接口扩展客服系统的功能。插件可以为访客面板添加自定义信息展示、扩展聊天工具栏、集成第三方应用等。

什么是 TGO 插件

TGO 插件是一个独立运行的进程，通过 Unix Socket 与 TGO 宿主程序进行通讯。

核心优势

• 语言无关：支持任何能处理 Socket 通讯的语言。
• 安全隔离：插件进程独立运行，不影响主系统稳定性。
• 实时双向：支持宿主推送请求给插件，插件实时返回 UI 或指令。

推荐开发方式

我们强烈推荐使用官方提供的 SDK 进行开发。SDK 封装了底层的通讯协议、重连机制和 UI 构建逻辑，让你可以专注于业务逻辑。

语言	状态	SDK 链接
Go	推荐	Go SDK 使用指南
Python	推荐	Python SDK 使用指南

文档学习路径

1. 快速入门：5 分钟通过 SDK 运行你的第一个插件。
2. SDK 开发指南：深入了解 SDK 的 API、UI 构建器和 Action 系统。
3. 插件配置 (plugin.yml)：详细了解如何配置插件的元数据、源码及构建方式。
4. 扩展点详解：详细了解各个可插点（访客面板、工具栏等）的交互逻辑。
5. 模版规范：了解 TGO 支持的所有 UI 组件模版。
6. 完整示例：通过真实的业务示例学习如何构建复杂的插件。

核心概念

TGO 插件系统的交互基于以下核心概念：

• Extension Point (扩展点)：插件挂载的位置，如 visitor_panel (访客面板) 或 chat_toolbar (工具栏)。
• Template (模版)：描述 UI 结构的 JSON 数据。SDK 提供了丰富的 Builder（如 Table, Form, Group）来生成这些数据。
• Action (动作)：指示宿主执行的具体操作，如 OpenURL (打开网页) 或 ShowToast (显示提示)。
• Capability (能力声明)：插件在注册时声明自己支持哪些扩展点及其配置信息。
• plugin.yml (配置文件)：插件的身份卡。定义了插件的 ID、版本、源码地址、构建方式及运行参数。它是 TGO 自动化管理插件的核心。