# ZJMaster-Plugins

**Repository Path**: bdon4000/zjmaster-plugins

## Basic Information

- **Project Name**: ZJMaster-Plugins
- **Description**: ZJMaster插件仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-05
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZJMaster Plugins

ZJMaster 官方扩展插件仓库。仓库包含 54 个工业设备、MES 和业务插件项目，以及对应的插件行为测试、脚本和示例配置；框架依赖统一锁定为 `1.1.13`。

框架自有的 UI/脚本集成样例 `ScriptsTest` 和全局变量诊断样例 `GlobalVariableViewer` 在 [ZJMaster 主框架仓库](https://gitee.com/bdon4000/zjmaster/tree/framework-samples-baseline-1.1.12/samples)维护，不在两个仓库重复保存源码。

## 开发规范入口

- [AGENTS.md](AGENTS.md)：Agent 的强制文档路由、仓库边界、高风险规则和最小验证矩阵。
- [插件开发指南](docs/PluginWritingGuide.md)：插件规范的主维护版本，覆盖从项目、Config、Plugin、协议和生命周期到 UI 预览、测试与交付。
- [脚本开发指南](docs/ScriptWritingGuide.md)：适配 SDK `1.1.13` 的完整离线脚本规范；脚本运行时 API 语义由主框架维护，本镜像提供插件仓库路径和本地验证命令。
- [PreviewHost 说明](tools/ZJMaster.PluginPreviewHost/README.md)：Visual Studio Split View、明暗主题切换及预览器故障排查。

开发或评审插件时完整阅读插件指南；任务涉及 `.csx`、事件订阅、脚本参数/返回值、`SendAsync` 或 `#load` 时再完整阅读脚本指南。根 `AGENTS.md` 保留必须先遵守的硬约束，两份长指南分别维护插件和脚本的完整做法。

## 依赖边界

- 插件只直接引用 `ZJMaster.Plugin.Sdk` 和 `ZJMaster.UI.Controls`。
- 设备协议、数据库驱动等插件私有能力使用插件自己的第三方依赖。
- 不允许引用 ZJMaster 主框架源码、主程序包或仓库外文件。

## 构建与测试

```powershell
dotnet tool restore
dotnet restore ZJMaster.Plugins.slnx
dotnet build ZJMaster.Plugins.slnx -c Release --no-restore -v minimal
dotnet test tests/ZJMaster.PluginTests/ZJMaster.PluginTests.csproj -c Release --no-build -v minimal
```

构建后的插件部署到仓库根目录下的 `Plugins` 工作区。插件开发指南在本仓库中维护，是插件开发规范的主维护版本；框架运行时和架构边界以 `v1.1.13` 的
[架构文档](https://gitee.com/bdon4000/zjmaster/blob/v1.1.13/docs/ZJMaster-Architecture.md) 为准。所需 SDK 见
[ZJMaster.Plugin.Sdk 1.1.13](https://www.nuget.org/packages/ZJMaster.Plugin.Sdk/1.1.13)，主框架仓库保留指南的完整同步镜像。

## Avalonia UI 预览

插件 View 的运行时构造函数通常依赖 Plugin/Config，Avalonia Designer 无法自动构造这些对象。仓库提供开发专用的 `tools/ZJMaster.PluginPreviewHost`：先将它设为启动项目并构建一次，再打开 `.axaml` 使用 Split View。PreviewHost 不启动主框架、脚本或设备连接。

PreviewHost 会通过通配符自动引用 `src/ZJMaster.Plugins.*/*.csproj` 下的新插件，无需手动修改宿主项目；新增插件后重新加载解决方案或 PreviewHost 项目并构建即可。设计器的明暗主题切换会同时同步 Fluent 和 SukiUI，预览内容使用与主程序一致的 SukiUI 背景层。

```powershell
dotnet build tools/ZJMaster.PluginPreviewHost/ZJMaster.PluginPreviewHost.csproj `
  -p:ZJMasterDeployOnBuild=false
./eng/Test-PreviewContracts.ps1
```

当前仓库共有 172 个 AXAML，公开无参构造和可用设计期数据欠账均已归零。`eng/preview-missing-parameterless-constructors.txt` 与 `eng/preview-missing-design-data.txt` 保留为空基线，契约检查会阻止新债务进入仓库。当前已为全部数据绑定 View 提供强类型设计数据；其中包含 BT3562A、BT4560、DM7275、ST5520、RJ6921、RJ6921V2、RJ3501、RJ3523、RJ3563、RJ3563CalK、RJ6901A、RJ6902BG1、RJ6902R、RJ6903R、ShiftManager、AndGxWeigher、AndGxWeigherLoss、Anemometer485、ThicknessGauge、ThicknessV2、Thickness_Panasonic、BarcodeScanner、BarcodePrinter97xx、BarcodePrinter97xxDynamic、ShinkoWeigher、ShinkoLiquidLoss、SonicsWelder、SonicsWelderTcp、XDLWelder、YudianAibusSerial、YudianAiModbusTcp、PowerMeter、DeviceAlarmMonitor、DeviceRuntimeStatus、PLCConnectionMonitor、PlcPoller、PlcDataReport、InjectionAmountCalculator、TvocTransmitter485、MachineIntegrationMesConnector、MesConnector、MesHttpConnector、GwMqttClient、ConsumableBatchManager、ManualProduction、TrayCellConverter、WebApiTest、LocalConfigurationManager、ProcessParameterManager 的 Card/Page/Configuration（含喷码机序列维护、温控器控制、耗材库存结果、工艺参数分类编辑和表格维护窗口），以及 CellProcessContextManager、JiaochengWelder、MesDataRequestCollector、SchunkWelder、TrayPacker 的 Configuration。详细使用方式见 [PreviewHost 说明](tools/ZJMaster.PluginPreviewHost/README.md)。

原始迁移来源与逐文件校验值见 `SOURCE-SNAPSHOT.txt` 和 `MIGRATION-SNAPSHOT.sha256`。
框架示例归属调整及 54 插件复验结果见 [验证记录](docs/Framework-Sample-Ownership-Validation.md)。