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                                    # 包索引（平台只认这个文件）
packages\<host>\<id>\<id>-<version>.zip       # 扩展包

每个 zip 的根目录必须包含 manifest.json，包内 manifest.id 与索引里的 id 一致。

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

在 index.json 的 packages 数组里加一条：

{
  "id": "Ext.YourExt",
  "name": "扩展显示名",
  "version": "1.0.0",
  "publisher": "你的名字",
  "description": "一句话说明扩展做什么",
  "downloadUrl": "packages/platform/Ext.YourExt/Ext.YourExt-1.0.0.zip",
  "sha256": "zip 文件的 sha256",
  "size": 123456,
  "notes": "• 功能点一\n• 功能点二",
  "references": ["TeamPLT.SDK", "TeamPLT.Contracts"]
}

sha256 和 size 必须和 zip 文件实际值一致，否则平台校验会拒绝安装。

5. 提交推送

推到 master 分支即可，平台下次刷新包列表就能看到。

当前收录

Id	名称	版本	host	说明
Ext.AiAssistant	AI 助手	1.0.0	platform	嵌入主控进程的 AI 副驾驶，支持电脑控制与平台命令桥