# TeamPLT Gallery

TeamPLT / TeamAAS 2.1 平台的扩展包仓库。

## TeamAAS 2.1 是什么

TeamAAS 2.1 是一套面向 3C 电子制造、精密组装、检测分拣场景的工业自动化控制与机器视觉软件。它把相机、机械手、运动控制卡、光源控制器、震动盘、PLC 通讯等硬件整合到一个主控进程里，通过流程图（Flow）编排生产工序：

- **硬件层**：统一管理相机（海康/巴斯勒等）、机械手（Epson/雅马哈/国产）、运动控制卡、光源、震动盘、PLC（Modbus/TCP/Serial）
- **视觉层**：集成多种视觉算法引擎（定位、缺陷、测量、OCR）
- **流程层**：拖拽式流程图编排工序，节点连线即逻辑，支持单步调试、监控运行
- **生产层**：产品配方管理、生产计数、OK/NG 统计、良率报表

TeamPLT 是它的微内核外壳，负责插件加载、界面框架、扩展管理。本仓库（Gallery）就是给这个微内核喂扩展包的源。

## Gallery 是什么

Gallery 是 TeamPLT 的扩展包源（package source）。平台内置"扩展管理"页，配置本地址后可以浏览、下载、安装扩展，下载后按 sha256 强校验。

仓库结构：

```
index.json                                    # 包索引（平台只认这个文件）
regen-index.ps1                               # 自动生成 index.json 的脚本
packages\<host>\<id>\<id>-<version>.zip       # 扩展包
```

`host` 是扩展挂载位置：

| host | 说明 |
|------|------|
| `platform` | 平台级扩展（扩展主界面、工具条、AI 等） |
| `vision` | 视觉算法插件 |
| `cameras` | 相机驱动子插件 |
| `communication` | 通讯/PLC 驱动子插件 |
| `base` | 基础库/共享组件 |

## 配置为平台包源

编辑平台 `Config\gallery-sources.json`，加一条：

```json
{
  "id": "teamplt",
  "name": "TeamPLT Gallery",
  "location": "http://49.235.130.76/TeamPLT/Gallery/raw/master/index.json",
  "enabled": true
}
```

重启平台 → 扩展管理页即可看到包列表，点安装自动下载、校验、加载。

## 如何提交自己的扩展

### 1. 编译扩展

扩展工程引用 `TeamPLT.SDK.dll` 和 `TeamPLT.Contracts.dll`，编译产出目录（含 `manifest.json`、dll、本地化文件）整体就是一个扩展。

### 2. 打 zip

把产出目录的内容**直接压成 zip**（不要多套一层文件夹）。zip 根目录应该长这样：

```
manifest.json
Ext.XXX.dll
Localization\zh-CN.json
```

### 3. 放到仓库

路径规则：`packages\<host>\<id>\<id>-<version>.zip`

例如：`packages/platform/Ext.AiAssistant/Ext.AiAssistant-1.0.0.zip`

### 4. 更新 index.json（推荐用脚本）

把 zip 放进 `packages/` 对应目录后，在仓库根目录跑：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\regen-index.ps1
```

脚本会自动扫描所有 zip、读包内 manifest.json、算 sha256/size，生成与平台 `GalleryPackage` 类对齐的 index.json（含多版本 `versions[]`）。旧 index 里的版本历史会自动继承。

也可以手动编辑 index.json，字段格式如下：

```json
{
  "id": "Ext.YourExt",
  "name": "扩展显示名",
  "version": "1.0.0",
  "publisher": "TeamAAS",
  "kind": "extension",
  "host": "platform",
  "description": "一句话说明扩展做什么",
  "notes": "• 功能点一\n• 功能点二",
  "downloadUrl": "packages/platform/Ext.YourExt/Ext.YourExt-1.0.0.zip",
  "sha256": "zip 文件的 sha256",
  "size": 123456,
  "references": [ "TeamPLT.SDK", "TeamPLT.Contracts" ],
  "targetFramework": "net48",
  "requiresHost": "TeamPLT>=2.1.0",
  "arch": [ "x64" ],
  "dependencies": [],
  "versions": [
    {
      "version": "1.0.0",
      "downloadUrl": "packages/platform/Ext.YourExt/Ext.YourExt-1.0.0.zip",
      "sha256": "zip 文件的 sha256",
      "size": 123456,
      "releasedAt": "2026-09-24",
      "status": "stable",
      "notes": "首个版本"
    }
  ]
}
```

发新版本时：顶层 `version`/`downloadUrl`/`sha256`/`size` 更新到最新版，`versions` 数组追加一条。`status` 可选 `stable` / `beta` / `deprecated`。

### 5. 提交推送

```bash
git add -A
git commit -m "Gallery: 收录 Ext.YourExt 1.0.0"
git push origin master
```

## 当前收录

| Id | 名称 | 版本 | host | 说明 |
|---|---|---|---|---|
| Ext.AiAssistant | AI 助手 | 1.0.0 | platform | 流式对话 + Function Calling，支持电脑控制与平台命令桥 |
| Ext.Cameras | 相机 | 1.0.0 | platform | 相机设备管理、实时预览、曝光增益调节（内置 UVC/仿真） |
| Ext.ColorSchemes | 配色 | 1.0.0 | platform | 七套种子色配色主题，外观→配色切换 |
| Ext.Light | 光源 | 1.0.0 | platform | 多通道亮度控制、全开全关，内置仿真和 KCS 串口驱动 |
| Plugins.Camera.Hikvision | 海康相机驱动 | 1.0.0 | cameras | 海康机器人（Hikrobot MVS）相机驱动 |
| Plugins.Camera.Basler | Basler 相机驱动 | 1.0.0 | cameras | Basler Pylon 相机驱动 |
| Plugins.Camera.Ahua | 华睿相机驱动 | 1.0.0 | cameras | 华睿（iRayple MVSDK）相机驱动 |