上海三思中控插件发布工具

使用方式

导入框架

npm i spub -g

发布项目

发布项目会自动编译项目然后提交到云平台上，需要按照以下步骤操作

本地发布

1. 在云平台上申请发布用到 token
2. 在环境变量中添加 SANSI_CLOUD_PLUGIN_TOKEN 这个环境变量，值为申请到的 token 字符串
3. 运行 spub -f xxxx.[msvc|splug|interp] --open 以发布单个插件
4. 运行 spub -d xxxxDir --open 以发布一个文件夹内所有的插件

CI 自动发布

1. 在云平台上申请发布用到 token
2. 在 gitlab 仓库的环境变量中添加 SANSI_CLOUD_PLUGIN_TOKEN 这个环境变量，值为申请到的 token 字符串
3. 在 CI 流程中添加 spub -f xxxx.[msvc|splug|interp] --open 进行发布单个插件
4. 在 CI 流程中添加 spub -d xxxxDir --open 发布一个文件夹内所有的插件

⚠️注意： --open 表示公开发布。
取消 --open 参数 spub -f xxx，或者声明关闭 spub -f xxx --open false 均表示该版本不公开发布。
非公开发布的版本，不可以在中控在线插件中直接搜索到，需要登录云平台进行查看下载或者通过分享链接进行下载，之后通过本地进行加载。

发布 CyberHub 安装包

使用 spub -c <发布目录> --open 发布 ZIP、DEB、RPM、HarmonyOS 安装包。发布目录需包含 appinfo.json：

{
  "name": "CyberHub",
  "description": "玄道智控平台"
}

安装包沿用 name_version_platform_arch.ext 命名，例如 cyberhub_3.8.2_linux_x64.rpm、cyberhub_3.8.2_linux_arm64.deb 或 cyberhub_3.8.5_harmonyos_arm64.zip，platform 与 arch 段不区分大小写。

平台分类映射（对应云平台「插件版本」中的平台下拉项）：

| 文件名 platform | 扩展名 | 云端平台分类 | 说明 | | --- | --- | --- | --- | | linux | .rpm | 202 redhat | CentOS / RedHat 系，供 CentOS 云端更新识别 | | linux | .zip .deb | 201 linux 通用 | | | windows | 任意 | 301 windows 通用 | | | darwin / mac | 任意 | 401 macos 通用 | | | harmonyos | 任意 | 508 HarmonyOS | 鸿蒙，属「国产操作系统」分类 |

CPU 架构沿用 x64（3）、arm64（4）、mips（5）、loong64（6）等取值。平台或架构无法识别时会直接报错，避免把错误分类的安装包提交到云平台。安装包同时上传到应用仓库和服务插件仓库。

发布目录中的 appinfo.json 是元数据文件，不会当作安装包上传，日志中会显示 Skip app meta file。

运行 npm test 验证上传参数、文件内容及现有安装包格式的兼容性。