# 插件助手正式打包规范（助手合同 v1 / 打包器 v6）

产品、插件和账号键统一为 `webdz_plugin_assistant`，源码入口固定 `webdz_plugin_assistant.rb`。配套合同为 `webdz-plugin-assistant-runtime-v1`，固定 Windows x64、协议 1 和 `WebDZ-Plugin-Assistant.exe`。这些身份由平台登记，不能通过改名冒用其他引擎合同。

## 源码开发者交付

1. 提供原始源码 RBZ：`webdz_plugin_assistant_<版本>_source.rbz`。根目录直接是入口 RB，业务文件在 `webdz_plugin_assistant/` 中，不能再套一层项目目录。根入口 `VERSION` 必须与提交版本一致；`webdz_plugin_assistant/helper_digest.rb` 中的 `HELPER_SHA256` 必须是配套 EXE 的 SHA-256。源码 RBZ 不含 EXE、DLL、私钥、连接码、缓存或历史交付包。
2. 提供独立程序 ZIP：`webdz_plugin_assistant_<版本>_engine.zip`。保留 `webdz_plugin_assistant/bin/WebDZ-Plugin-Assistant.exe` 和 `licenses/<依赖>/LICENSE...` 的现有交接布局即可，许可证须为非空 UTF-8 文本。不要改名为 `juzheng_geometry.exe`，不要加入源码、测试、安装器、额外 DLL 或调试文件。
3. 使用新打包器 v6，默认打开 `http://127.0.0.1:8877/v3/`。选择源码 RBZ，并在独立引擎栏选择原 engine.zip，包类型选“客户运行 ZIP”。点击“检查 V3 源码”；打包器应识别“插件助手”并显示专用合同。助手必须双包提交。
4. 本地检查通过后，使用既有平台连接码，填写配套代次并点击“提交联动审核”。首次代次为 1，后续严格递增；失败沿原任务和代次恢复。两个输入各不得超过本地 64 MiB，公网提交的源码与标准运行包各不得超过 52 MiB。只有精确候选通过正式资格检查和独立审批后才能执行“联动正式发布”。

现有 1.0.4 双包可直接交给 v6，无需重新编译或修改源包。只有业务内容实际改变时才递增补丁版本并同步版本信息；不要原位覆盖已交付版本。

## 平台负责的转换与运行

v6 核对源码版本、固定 EXE 名称及 HELPER_SHA256，再生成独立标准运行 ZIP：根目录 `engine.json`、`WebDZ-Plugin-Assistant.exe` 和平铺的 `licenses/*.txt`。转换记录输入、输出和 EXE 摘要，原双包保持不变；已经标准化的运行 ZIP 保持原字节。服务端再次绑定已审核源码，不只相信客户端报告。

正式密封包使用平台签名的助手启动适配及专用双 Ruby ABI 加载器。程序位置由经过验证的配套记录提供，在原生文件锁内启动；源码开发者不必把 EXE 塞回源码 RBZ，也不必自行绕过密封后的资源路径。

产品登记不等于向客户授予权益。结构审核通过不等于已签名发布；实际 SketchUp 2022–2026 的启动、安装/清理、退出后外部执行、取消与失败恢复仍须按具体候选验收。