PLUGIN_ID

由 @international-iot-association/plugin-cli new 从 plugin-starter 生成的产测工位插件工程。

这是一个 unsigned 开发包，不是「官方 ZIP」——「官方 ZIP」专指本仓 plugins/* 经五方对账与签名后的产物；仓外产出的包不管走什么路径打包，都只能叫 unsigned 开发包，产线放行与否取决于 MES 后台是否将其标记为 released。

环境要求

• Node.js >= 20.19
• pnpm（由 package.json 的 packageManager 字段锁版本，勿用 npm/yarn 安装）

大陆网络：npm 镜像配置

clone 走 GitHub、装依赖走 npmjs 在大陆网络下容易同时卡住，先配置镜像：

npm config set registry https://registry.npmmirror.com

快速开始

pnpm install
pnpm run dev
pnpm run build && pnpm run pack

目录形态

manifest.json   插件清单：id / version / permissions / dependencies
package.json    依赖声明 + loom 字段（见下）
runtime/        产测流程主逻辑（独立 Node 子进程，禁止 import electron）
ui/             操作员界面（React，沙箱 iframe，无网络）
shared/         runtime 与 ui 共用的类型/契约
test/           单元测试（不能是空壳）

loom 字段

package.json 里的 loom 字段供外壳工作台读取启动命令，避免猜测：

{
  "loom": {
    "ui": { "dev": "...", "port": 5174 },
    "runtime": { "build": "..." }
  }
}

插件间依赖不是 npm 依赖

manifest.json 的 dependencies 字段引用的是别的插件（基座能力，如登录态、全局配置），由 Shell 底座（bundled-attested）或 MES 后台提供——不要 npm install 它们，那些包名不在任何 npm registry 上。

反馈

发现问题请开 issue，不要提 PR——本仓不接受针对模板/SDK 的外部 PR。

局限

本 README 只验证过「照着做流程能跑通」，未做真人可读性验收（没有找一个没碰过本仓的人照文档从零走一遍）；如果卡住，请在 issue 里写清卡在哪一步。