Gallery

# 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，加一条：

{
  "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 -NoProfile -ExecutionPolicy Bypass -File .\regen-index.ps1

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

也可以手动编辑 index.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. 提交推送

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）相机驱动