包装刀模生成器

一个可离线运行的包装刀模生成器：输入箱体尺寸和纸厚，在浏览器本地计算刀模，导出 1:1 mm SVG 或带信息栏的 PDF。发布文件是单个 HTML，双击即可使用，不需要安装运行环境，也不会上传尺寸数据。

在线试用：https://nealzhoupanda.github.io/packaging-dieline-generator/

这是一个面向实际打样和生产前核对的辅助工具，不替代纸箱厂的结构确认、试样和工艺审核。

当前发布能力

index.html 与 src/ 是唯一源码入口；app/包装刀模生成器.html、release/包装刀模生成器.html 和 docs/index.html 均由构建脚本生成，不再手工修改。当前包含五种箱型：

• 0201：标准纸箱
• 0421：翻盖展示盒
• K016A：提手盒
• E005C：翻盖飞机盒（0427）
• C001GX：翻盖锁扣纸盒

输入项包括长、宽、高和材料类型。瓦楞纸板显示楞型；白卡纸显示独立的白卡厚度。界面支持开口方向切换、展开尺寸提示、抛重估算、装柜估算，以及 SVG / PDF 下载。开口方向下方的面积和每张数量按刀模展开包络估算；“每张”表示单位原纸张可切出的包装盒数量，可用于用纸和成本估算；不同箱型的独立用纸校准仍需继续补充。装柜估算支持 20GP、40GP、40HQ、45HQ，按箱体外尺寸进行六向排列取最大理论满载数，再乘 0.88 装载率系数显示实际估算数。

切换箱型时会加载适合展示的默认尺寸和材料：0201 为 350×190×230 mm / 瓦楞纸板 A 楞 5.0，E005C 为 350×190×230 mm / 瓦楞纸板 B 楞 3.0，0421 翻盖展示盒与 C001GX 翻盖锁扣纸盒支持白卡纸 0.4、0.5、0.6、0.8 mm。白卡厚度是展示默认值，实际生产应按供应商纸张实测值调整。

页面右上角可用 EN / 中文 切换主要界面文字；语言层不参与尺寸和刀模计算。

型号命名

项目模型编号优先采用对应的行业标准编号。当前 0201 按 FEFCO 0201 盒型编号使用，表示普通开槽箱（RSC）。如果某种结构暂时没有确认的公开行业标准编号，则保留项目当前型号标识，不把厂商内部编号宣称为行业标准。

重要说明

• 尺寸计算只适用于对应箱型，不能把一种箱型的补偿规则套到另一种箱型。
• 首次投产前必须打样，核对内尺寸、刀模尺寸、纸厚、压痕和成箱效果。
• 0201、E005C 和 C001GX 的几何逻辑来自当前单文件应用；新增箱型前必须补充独立的坐标校准和回归测试。
• 新增箱型仍需继续补充独立的结构样本和生产验证；开口方向上的面积按刀模展开包络估算并随每张数量一并显示，完成逐箱型净面积校准前不作为精确用纸依据。
• 每张数量按纸型区分纸张幅面估算：瓦楞纸板 1200×2400 mm，白卡纸按大度平板纸 889×1194 mm；供应商实际用纸不同则结果不同。
• 材料幅面警示只是生产前提示，不代表所有供应商设备的统一限制。

开发

需要 Node.js 和 npm：

npm ci
npm test
npm run build:offline

构建结果：

release/包装刀模生成器.html

打开开发页面：

npm run dev

许可证

本项目代码采用 MIT License，见仓库根目录 LICENSE。内嵌的 Noto Sans SC 字体子集按 SIL Open Font License 1.1 发布，见 LICENSES/OFL-1.1.txt。

目录

• index.html：开发页面与界面结构的唯一入口
• app/：由模块源码生成的单文件离线应用，不手工修改
• src/：模块化几何计算、SVG / PDF 导出和回归测试所用代码
• tests/：几何、尺寸、导出和安全门测试
• reference/：本地回归和校准资料
• tools/：单文件构建和 PDF 字体子集构建脚本
• release/：与 app/ 同步生成、可直接转发的离线 HTML
• CONTRIBUTING.md：协作和验证要求

贡献前提

任何几何规则变更都要同时更新测试，并完成 npm test 与 npm run build:offline。没有经过打样或独立坐标验证的箱型，不要宣称适用于批量生产。

字体子集使用 Noto Sans SC；其字体许可证见 LICENSES/OFL-1.1.txt。