TeamPLT 扩展 Gallery 源（index.json + packages）

wangshuo 1445f0d8ba Gallery: 收录 Ext.Cameras 1.0.0（拓展层）与 Plugins.Camera.Ahua/Basler/Hikvision 1.0.0（插件层）		1 주 전
packages	1445f0d8ba Gallery: 收录 Ext.Cameras 1.0.0（拓展层）与 Plugins.Camera.Ahua/Basler/Hikvision 1.0.0（插件层）	1 주 전
README.md	d1ddde7a5f docs: update README with correct index.json schema and multi-version format	1 주 전
index.json	1445f0d8ba Gallery: 收录 Ext.Cameras 1.0.0（拓展层）与 Plugins.Camera.Ahua/Basler/Hikvision 1.0.0（插件层）	1 주 전
regen-index.ps1	8682ded93d release: Ext.AiAssistant 1.0.0 重新打包（覆盖同名版本）	1 주 전

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       # 扩展包

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 数组里加一条，字段顺序如下（与平台 GalleryPackage 类对齐）：

{
  "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>=1.0.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": "首个版本"
    }
  ]
}

字段说明：

字段	说明
`kind`	`extension` 或 `contract`
`host`	挂载位置（platform/vision/cameras/communication/base）
`downloadUrl` / `sha256` / `size`	最新版的下载信息，平台下载后强校验
`requiresHost`	字符串格式 `平台ID>=版本`，如 `TeamPLT>=1.0.0`
`versions`	所有历史版本，每条含独立的 downloadUrl/sha256/size/status
`status`	`stable` / `beta` / `deprecated`

发新版本时：更新顶层 version/downloadUrl/sha256/size 到最新版，同时在 versions 数组里追加一条。

5. 提交推送

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

当前收录

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

README.md