printbench 0.8.3 → 0.8.4

package/README.md

@@ -59,6 +59,7 @@ function onExported(payload: PrintBenchExportedPayload) {
   // payload.longestEdgeMm — 若导出时指定了目标边长缩放
   // payload.scaleAxis — 若按 X/Y/Z 轴缩放（最长边模式不带此字段）
   // payload.partIds / modelSize — 分件导出时带回写出的零件与缩放后整模尺寸
+  // payload.groundCenter — 若导出时置于地面中心
 }
 </script>
 
@@ -188,7 +189,7 @@ async function upload() {
 | -------------------- | ------------------------------------------------- | -------------------------------------------------- |
 | `ready`              | —                                                 | 几何内核就绪                                             |
 | `error`              | `string`                                          | 可展示错误                                              |
-| `exported`           | `{ action, format, fileName, blob, unit, size, longestEdgeMm?, scaleAxis?, scaleBasis?, partIds?, modelSize?, axis? }` | 网格导出完成。`size` 为本次 blob 内网格包围盒；分件且按整模缩放时带 `modelSize`；`partIds` 为实际写出的零件 |
+| `exported`           | `{ action, format, fileName, blob, unit, size, longestEdgeMm?, scaleAxis?, scaleBasis?, partIds?, modelSize?, groundCenter?, axis? }` | 网格导出完成。`size` 为本次 blob 内网格包围盒；分件且按整模缩放时带 `modelSize`；`groundCenter: true` 表示已贴地居中 |
 | `snapshot`           | `{ action, format, fileName, blob, mime, width, height }` | 模型快照完成。`format` 为 `'png'` \| `'jpeg'` |
 | `report`             | 审核报告对象                                            | 下载 JSON / HTML 审核报告时触发                             |
 | `parts`              | `{ id, index, name, initialSize, size, unit }[]`  | 零件列表；`size` 为当前尺寸，`initialSize` 为导入时尺寸（无则为 `null`） |
@@ -207,7 +208,7 @@ async function upload() {
 
 | 方法                     | 说明                                                                                                                                                                |
 | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `exportFile(options?)` | 不打开插件对话框。`action` / `format` / `unit` 同上；`longestEdgeMm` + `scaleAxis?` 等比缩放；`scaleBasis`: `'model'`（默认，整模比例）\| `'exportSet'`；`partIds` 只导出指定零件；`silent: true` 跳过确认。成功返回与 `exported` 相同的 payload。 |
+| `exportFile(options?)` | 不打开插件对话框。`action` / `format` / `unit` 同上；`longestEdgeMm` + `scaleAxis?` 等比缩放；`scaleBasis`: `'model'`（默认，整模比例）\| `'exportSet'`；`partIds` 只导出指定零件；`groundCenter: true` 导出时贴地且 XZ 居中于原点（不改工作台）；`silent: true` 跳过确认。成功返回与 `exported` 相同的 payload。 |
 | `exportSnapshot(options?)` | 按当前视角截取模型图（不含网格、手柄、切面）。`action`: `'download'` \| `'upload'`；`format`: `'png'`（默认）\| `'jpeg'`；`quality` 仅 JPEG。成功返回与 `snapshot` 相同的 payload。`customExport` 时不本地下载、不 POST。 |
 | `autoSplit(options?)` | 多零件接触面自动装配（≥2 件）。检测接触后一端保留凸起、一端挖槽，再加卡扣。`connector`: `'ballSnap'` \| `'sphere'` \| `'square'`（默认 `ballSnap` 爪扣）；`connectorSize` 可选；`silent: true` 时不弹修复确认，未封闭则返回 `{ ok: false, needsRepair: true, repairPartNames }`。成功 `{ ok: true }`。 |
 | `getPartBounds()` | 同步返回与 `@parts` 相同结构的零件列表（含 `initialSize` / `size`）。无模型时为 `[]`。 |
@@ -299,7 +300,7 @@ JSON 结构：
 - **STL**：二进制；无单位字段，切片软件需与导出单位一致（推荐毫米）。单零件 `.stl`，多零件 `.zip`（每件一个 STL）。不含颜色。
 - **3MF**：自带毫米单位；每零件单独 object，并写入 `displaycolor`（零件打印色）
 - **GLB**：单文件多网格；零件打印色写入材质。无打印单位字段，坐标按导出单位解释。
-- **目标边长缩放**：导出对话框可选参考轴（最长边 / X / Y / Z）、缩放基准（整模 / 仅导出零件）并填「目标边长 mm」；可勾选「仅导出选中」。宿主：`exportFile({ longestEdgeMm, scaleAxis?, scaleBasis?, partIds? })`。先按毫米等比缩放，再按所选 `unit` 写出。按件循环且需可组装时用默认 `scaleBasis: 'model'`。
+- **目标边长缩放**：导出对话框可选参考轴（最长边 / X / Y / Z）、缩放基准（整模 / 仅导出零件）并填「目标边长 mm」；可勾选「仅导出选中」「置于地面中心」。宿主：`exportFile({ longestEdgeMm, scaleAxis?, scaleBasis?, partIds?, groundCenter? })`。先按毫米等比缩放，再按 `partIds` 过滤，再可选贴地居中（相对**本次写出集合**的 AABB），再按所选 `unit` 写出。按件循环时 `groundCenter: true` 会把每件单独放到地面中心；缩放比例仍可用默认 `scaleBasis: 'model'` 保持可组装尺寸。
 - **快照**：PNG / JPEG。按当前相机截取模型，不含工作台网格、变换手柄、拆件切面与测量。下载或一键上传（同 `uploadUrl` / `customExport`）。嵌入预览用 `exportSnapshot()`。
 
 ### 快捷键

package/dist/chunks/{3mf-ECHCUgKd.js → 3mf-C2F5qOGB.js}

@@ -1,5 +1,5 @@
 import j from "jszip";
-import { h as w, r as R } from "./index-taUrTXAq.js";
+import { h as w, r as R } from "./index-Cc4caqHB.js";
 function p(s, l) {
   return s.match(new RegExp(`\\b${l}\\s*=\\s*"([^"]*)"`, "i"))?.[1];
 }

package/dist/chunks/{glb-CHKLJs5K.js → glb-BSCgbq7W.js}

@@ -1,6 +1,6 @@
 import { Group as w, Mesh as l, MeshStandardMaterial as u, DoubleSide as h, Color as c } from "three";
 import { GLTFExporter as p } from "three/examples/jsm/exporters/GLTFExporter.js";
-import { b as d } from "./index-taUrTXAq.js";
+import { b as d } from "./index-Cc4caqHB.js";
 async function G(r, e, n) {
   const t = new w();
   t.name = "PrintBench", r.forEach((f, o) => {