|
|
@@ -21,6 +21,7 @@ Gallery 是 TeamPLT 的扩展包源（package source）。平台内置"扩展管
|
|
|
|
|
|
```
|
|
|
index.json # 包索引（平台只认这个文件）
|
|
|
+regen-index.ps1 # 自动生成 index.json 的脚本
|
|
|
packages\<host>\<id>\<id>-<version>.zip # 扩展包
|
|
|
```
|
|
|
|
|
|
@@ -30,8 +31,8 @@ packages\<host>\<id>\<id>-<version>.zip # 扩展包
|
|
|
|------|------|
|
|
|
| `platform` | 平台级扩展（扩展主界面、工具条、AI 等） |
|
|
|
| `vision` | 视觉算法插件 |
|
|
|
-| `cameras` | 相机驱动 |
|
|
|
-| `communication` | 通讯协议/PLC 驱动 |
|
|
|
+| `cameras` | 相机驱动子插件 |
|
|
|
+| `communication` | 通讯/PLC 驱动子插件 |
|
|
|
| `base` | 基础库/共享组件 |
|
|
|
|
|
|
## 配置为平台包源
|
|
|
@@ -71,9 +72,17 @@ Localization\zh-CN.json
|
|
|
|
|
|
例如：`packages/platform/Ext.AiAssistant/Ext.AiAssistant-1.0.0.zip`
|
|
|
|
|
|
-### 4. 更新 index.json
|
|
|
+### 4. 更新 index.json（推荐用脚本）
|
|
|
|
|
|
-在 `index.json` 的 `packages` 数组里加一条，字段顺序如下（与平台 `GalleryPackage` 类对齐）：
|
|
|
+把 zip 放进 `packages/` 对应目录后，在仓库根目录跑：
|
|
|
+
|
|
|
+```powershell
|
|
|
+powershell -NoProfile -ExecutionPolicy Bypass -File .\regen-index.ps1
|
|
|
+```
|
|
|
+
|
|
|
+脚本会自动扫描所有 zip、读包内 manifest.json、算 sha256/size，生成与平台 `GalleryPackage` 类对齐的 index.json（含多版本 `versions[]`）。旧 index 里的版本历史会自动继承。
|
|
|
+
|
|
|
+也可以手动编辑 index.json，字段格式如下：
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
@@ -90,7 +99,7 @@ Localization\zh-CN.json
|
|
|
"size": 123456,
|
|
|
"references": [ "TeamPLT.SDK", "TeamPLT.Contracts" ],
|
|
|
"targetFramework": "net48",
|
|
|
- "requiresHost": "TeamPLT>=1.0.0",
|
|
|
+ "requiresHost": "TeamPLT>=2.1.0",
|
|
|
"arch": [ "x64" ],
|
|
|
"dependencies": [],
|
|
|
"versions": [
|
|
|
@@ -107,25 +116,22 @@ Localization\zh-CN.json
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-字段说明：
|
|
|
-
|
|
|
-| 字段 | 说明 |
|
|
|
-|------|------|
|
|
|
-| `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` 数组里追加一条。
|
|
|
+发新版本时：顶层 `version`/`downloadUrl`/`sha256`/`size` 更新到最新版，`versions` 数组追加一条。`status` 可选 `stable` / `beta` / `deprecated`。
|
|
|
|
|
|
### 5. 提交推送
|
|
|
|
|
|
-推到 `master` 分支即可，平台下次刷新包列表就能看到。
|
|
|
+```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 | 嵌入主控进程的 AI 副驾驶，支持电脑控制与平台命令桥 |
|
|
|
+| Ext.AiAssistant | AI 助手 | 1.0.0 | platform | 流式对话 + Function Calling，支持电脑控制与平台命令桥 |
|
|
|
+| Ext.Cameras | 相机 | 1.0.0 | platform | 相机设备管理、实时预览、曝光增益调节（内置 UVC/仿真） |
|
|
|
+| 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）相机驱动 |
|
