pacxio 0.0.1__tar.gz

pacxio-0.0.1/.gitignore

@@ -0,0 +1,29 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+out/
+jobs/
+fonts/
+*.icc
+*.icm
+
+# 客户需求文档与素材（和 jobs/ 一样，不进仓库）
+briefs/
+# agent 的临时脚本和本地笔记
+tmp/
+.learnings/
+# 系统与打包产物
+.DS_Store
+*.egg-info/
+dist/
+build/
+
+# 本机浏览器验证截图与会话
+.playwright-cli/
+output/playwright/
+
+# 本机 MCP 登记（pacxio mcp install 写的，里面是本机 Python 路径）
+.mcp.json

pacxio-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The pacxio authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pacxio-0.0.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.5
+Name: pacxio
+Version: 0.0.1
+Summary: Packaging prepress for coding agents: dielines, 3D, print-ready factory files
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: ezdxf>=1.3
+Requires-Dist: fonttools>=4.50
+Requires-Dist: numpy>=1.26
+Requires-Dist: pikepdf>=9.0
+Requires-Dist: pillow>=10.0
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: reportlab>=4.0
+Requires-Dist: shapely>=2.1
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# pacxio
+
+Packaging prepress for coding agents. Describe a box, and pacxio turns box dimensions and brand artwork into the files a packaging factory accepts:
+
+- the dieline: DXF, CF2 and PDF;
+- a CMYK print PDF;
+- named spot-color plates for foil, spot UV and embossing;
+- a spec sheet;
+- a preflight report.
+
+pacxio runs inside Claude Code or Codex as a plugin (a workflow Skill plus MCP tools), and as a plain command-line tool.
+
+## What runs where
+
+| On your machine (this repository, MIT) | On the pacxio server (sign-in required) |
+|---|---|
+| Structure library: FEFCO and public ECMA codes, plus hand-built carton, mailer, label and pouch entries | Composing artwork onto the dieline (`render`, `art`, `restore`, `visual trace`) |
+| Dieline geometry, editable parameters, DXF / CF2 / dieline PDF | Print PDF, spot-color separations, preflight |
+| Folding 3D preview and the local workbench (127.0.0.1 only) | The factory delivery pack (`export`) |
+| Jobs, content lists, concept-image records, notes | |
+
+The open client sends server-side commands to the pacxio server automatically. Every command prints the same JSON either way. The first such command starts a browser sign-in (`pacxio login`). Your vector artwork stays on the server; previews, reports and the delivery pack come back to your job folder.
+
+## Install
+
+You need [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv tool install pacxio
+```
+
+```bash
+pacxio setup --agent claude-code --yes
+```
+
+Use `--agent codex` for Codex. Leave out `--agent` to install into every agent found on the machine. Setup also downloads the open-source Source Han Sans fonts if they are missing. Restart the agent afterwards, open a project folder, and describe the box you want.
+
+## Command line
+
+```bash
+pacxio structures suggest --use ecommerce --no-tape --material corrugated --json
+pacxio structures preview 0427 --L 233 --W 161 --H 66.5 --out preview/
+pacxio job init jobs/demo --fefco 0427 --L 233 --W 161 --H 66.5 --material flute_e
+pacxio studio start jobs/demo --open
+pacxio next jobs/demo
+```
+
+- `structures suggest` picks candidate structures from the library for what the box has to do.
+- `structures preview` draws a dieline and a 3D view without making a job.
+- `studio start` opens the local workbench in your browser.
+- `next` tells you which step comes next and which command runs it.
+
+Every command takes `--json` and prints `{ok, command, job, artifacts, data, errors, warnings}`. Each error carries a `fix`. Exit codes: `0` success, `1` an error was found, `2` bad arguments, `3` something is missing from the environment.
+
+Messages are in English. Set `PACXIO_LANG=zh` for Chinese.
+
+## Rules the engine enforces
+
+- **Text in print files is typeset by the engine and outlined.** AI-generated images in print files must not contain text.
+- **Concept images are for direction only.** The engine refuses to place a concept image in a print file. The final artwork is rebuilt from the confirmed flat.
+- **The user confirms; the agent does not.** `approve` on the dieline confirmation image is the only gate before export.
+- **A preflight error means no factory files.** `export` refuses until every error is fixed.
+- **Dielines use lines and arcs only.** No Béziers, so DXF R12 and CF2 stay exact.
+- **Cut and crease lines are named spot colors set to overprint.** They are never drawn in Registration.
+- **Values marked as initial are not verified.** Structures that are not calibrated against a factory dieline say so. Make a physical proof before a production run.
+
+## Development
+
+```bash
+uv sync
+```
+
+```bash
+uv run pytest
+```
+
+```bash
+uv run ruff check . && uv run mypy
+```
+
+```bash
+uv run pacxio env check
+```
+
+Separation tests are skipped when Ghostscript is not installed. Fonts and ICC profiles are not part of this repository.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

pacxio-0.0.1/README.md

@@ -0,0 +1,89 @@
+# pacxio
+
+Packaging prepress for coding agents. Describe a box, and pacxio turns box dimensions and brand artwork into the files a packaging factory accepts:
+
+- the dieline: DXF, CF2 and PDF;
+- a CMYK print PDF;
+- named spot-color plates for foil, spot UV and embossing;
+- a spec sheet;
+- a preflight report.
+
+pacxio runs inside Claude Code or Codex as a plugin (a workflow Skill plus MCP tools), and as a plain command-line tool.
+
+## What runs where
+
+| On your machine (this repository, MIT) | On the pacxio server (sign-in required) |
+|---|---|
+| Structure library: FEFCO and public ECMA codes, plus hand-built carton, mailer, label and pouch entries | Composing artwork onto the dieline (`render`, `art`, `restore`, `visual trace`) |
+| Dieline geometry, editable parameters, DXF / CF2 / dieline PDF | Print PDF, spot-color separations, preflight |
+| Folding 3D preview and the local workbench (127.0.0.1 only) | The factory delivery pack (`export`) |
+| Jobs, content lists, concept-image records, notes | |
+
+The open client sends server-side commands to the pacxio server automatically. Every command prints the same JSON either way. The first such command starts a browser sign-in (`pacxio login`). Your vector artwork stays on the server; previews, reports and the delivery pack come back to your job folder.
+
+## Install
+
+You need [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv tool install pacxio
+```
+
+```bash
+pacxio setup --agent claude-code --yes
+```
+
+Use `--agent codex` for Codex. Leave out `--agent` to install into every agent found on the machine. Setup also downloads the open-source Source Han Sans fonts if they are missing. Restart the agent afterwards, open a project folder, and describe the box you want.
+
+## Command line
+
+```bash
+pacxio structures suggest --use ecommerce --no-tape --material corrugated --json
+pacxio structures preview 0427 --L 233 --W 161 --H 66.5 --out preview/
+pacxio job init jobs/demo --fefco 0427 --L 233 --W 161 --H 66.5 --material flute_e
+pacxio studio start jobs/demo --open
+pacxio next jobs/demo
+```
+
+- `structures suggest` picks candidate structures from the library for what the box has to do.
+- `structures preview` draws a dieline and a 3D view without making a job.
+- `studio start` opens the local workbench in your browser.
+- `next` tells you which step comes next and which command runs it.
+
+Every command takes `--json` and prints `{ok, command, job, artifacts, data, errors, warnings}`. Each error carries a `fix`. Exit codes: `0` success, `1` an error was found, `2` bad arguments, `3` something is missing from the environment.
+
+Messages are in English. Set `PACXIO_LANG=zh` for Chinese.
+
+## Rules the engine enforces
+
+- **Text in print files is typeset by the engine and outlined.** AI-generated images in print files must not contain text.
+- **Concept images are for direction only.** The engine refuses to place a concept image in a print file. The final artwork is rebuilt from the confirmed flat.
+- **The user confirms; the agent does not.** `approve` on the dieline confirmation image is the only gate before export.
+- **A preflight error means no factory files.** `export` refuses until every error is fixed.
+- **Dielines use lines and arcs only.** No Béziers, so DXF R12 and CF2 stay exact.
+- **Cut and crease lines are named spot colors set to overprint.** They are never drawn in Registration.
+- **Values marked as initial are not verified.** Structures that are not calibrated against a factory dieline say so. Make a physical proof before a production run.
+
+## Development
+
+```bash
+uv sync
+```
+
+```bash
+uv run pytest
+```
+
+```bash
+uv run ruff check . && uv run mypy
+```
+
+```bash
+uv run pacxio env check
+```
+
+Separation tests are skipped when Ghostscript is not installed. Fonts and ICC profiles are not part of this repository.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

pacxio-0.0.1/conventions/paint.yaml

@@ -0,0 +1,58 @@
+# 常规参考表："Home improvement · Paint"（docs/FLOW_V2.md 2.2）
+#
+# 用途：出概念图时写进提示词，告诉 AI "这类包装一般这么排"——只是提示，AI 可以按设计需要变通；
+# 看图后 agent 用它核对：哪些信息放得不寻常、有没有漏掉通常必有的东西。
+# 全部是【初值】：来自通常做法，未经品牌方、印厂或法规顾问确认。法规相关的只做提醒，由用户确认。
+
+id: paint
+name_zh: "Home improvement · Paint"
+description: "Folding cartons and shipping cases for wall paint, wood finishes and primers"
+verified: false
+
+# 各类信息通常放在哪些面（front 正面 / back 背面 / side 侧面 / top 顶面 / bottom 底面），排在前面的更常见
+faces:
+  brand: [front, back, top, side]
+  logo: [front, back, top, side]
+  product_name: [front, back]
+  variant: [front]            # 内墙 / 外墙、木器、底漆面漆；颜色、光泽
+  spec: [front, side]         # 容量（1L、5L）
+  net_content: [front]
+  slogan: [front, side]
+  selling_point: [front, back, side]
+  icon: [front, side]
+  description: [back, side]
+  usage: [back, side]         # 施工步骤
+  technical: [back, side]     # 涂布率、表干 / 实干、重涂间隔、VOC
+  ingredients: [side]
+  caution: [side, back]       # 安全警示、急救
+  storage: [side]
+  standard: [side]
+  manufacturer: [side]
+  contact: [side]
+  origin: [side]
+  barcode: [side]
+  certification: [side, front]
+  batch: [bottom, side]
+
+# 常见版式（提示词里给 AI 参考；也用于看图后说明这个方向属于哪一种）
+layouts:
+  - id: same_front_back
+    name_zh: "Matching front and back"
+    front: "Key visual, brand, product name, category / colour and sheen, volume, main selling points"
+    back: "Same as the front"
+    sides: "Use one side for application instructions and technical data. Use the other for precautions, applicable standards, manufacturer, barcode and country of origin. Vertical branding is also common."
+    common_for: "Shipping cases, cartons for large paint containers, and products displayed with either face outward"
+  - id: split
+    name_zh: "Different roles for front and back"
+    front: "Key visual, brand, product name, category / colour and sheen, volume, main selling points"
+    back: "Brand story or product introduction, application steps and technical data"
+    sides: "Precautions, applicable standards, manufacturer, barcode and country of origin. Use the other side for the brand or tagline."
+    common_for: "Small retail cartons and gift boxes"
+
+# 提醒（不是规定）：看图核对时逐条提示用户，由用户按现行标准与法规确认
+reminders:
+  - "For paint packaging, check the applicable marking standard in the target market (for example, GB/T 9750 in China). Verify requirements for product name and model, applicable standards, net contents, production date or batch, manufacturer name and address, storage and safety information."
+  - "Check whether the target market requires packaging disclosures about hazardous substance limits for architectural coatings and wood finishes."
+  - "Net contents usually appear on the principal display panel. Check the target market’s requirements for placement and character height."
+  - "Leave sufficient quiet zones around the barcode, use a white or light background, and keep it clear of folds."
+  - "Batch codes and production dates are usually added after printing. Reserve blank space for them in the artwork."

pacxio-0.0.1/profiles/default.yaml

@@ -0,0 +1,157 @@
+id: default
+name: Default
+verified: true                 # 2026-10-24 用户：实物打样验证通过，配置档数值经工厂确认（规格补 21）
+units: mm
+
+bleed_mm: 3                    # 出血
+safe_margin_mm: 3              # 文字/Logo 距切线与折线
+glue_flap:
+  ink: bleed_only              # none | bleed_only | full
+  bleed_into_mm: 2             # 图文可伸入糊口的距离
+tac_limit_pct: 300             # 总墨量上限，铜版纸胶印常见 300–320%
+flexo:                         # 柔印（开槽箱水印）：job 的 print.method = flexo 时代替上面的数值
+  tac_limit_pct: 240           # 水印直接印在瓦楞纸板上，吃墨多、干得慢，总墨量比胶印低
+  min_text_pt: 8               # 水印网线粗、易糊版，小字要大一些
+  min_print_line_mm: 0.3       # 图形里最细的线（开槽箱测试 R-09，补 47，要工厂确认，不在 2026-10-24 确认的范围里）
+  min_print_reverse_mm: 0.5    # 最窄的反白（没墨的细缝、小白点），比正线更容易糊
+min_text_pt: 6                 # 最小字号（pt），小于它给 T05 提醒；法规对净含量等另有字高要求
+icc:
+  path: null                   # 工厂给了自己的 ICC 时填：嵌入生产文件、声明 PDF/X-4
+  name: null
+  auto:                        # 没填 path 时按纸张自动选本机已有的标准 ICC（docs/COLOR_V1.md）：
+    coated:   [JapanColor2001Coated.icc, CoatedFOGRA39.icc]       # 只用来把照片转成印刷色，
+    uncoated: [JapanColor2001Uncoated.icc, UncoatedFOGRA29.icc]   # 不嵌入、不声明 PDF/X-4
+  search_dirs:                 # 装了 Adobe 软件就有；ICC 文件不进代码仓库（CLAUDE.md）
+    - /Library/Application Support/Adobe/Color/Profiles/Recommended
+    - /Library/Application Support/Adobe/Color/Profiles
+    - /Library/ColorSync/Profiles
+    - ~/Library/ColorSync/Profiles
+    - C:/Program Files (x86)/Common Files/Adobe/Color/Profiles/Recommended
+    - C:/Windows/System32/spool/drivers/color
+finish_rules:
+  foil:     { min_line_mm: 0.2, min_gap_mm: 0.3 }
+  spot_uv:  { min_line_mm: 0.3, min_gap_mm: 0.5 }
+  spot_uv_digital: { min_line_mm: 0.1, min_gap_mm: 0.2 }   # 数码 UV（喷墨）：用户确认工厂能做时，工艺加 --process digital 才用（2026-10-30 用户定，补 41；不在工厂确认的范围里）
+  emboss:   { min_line_mm: 0.5, min_gap_mm: 1.0 }   # 击凸、压凹共用
+  white:    { min_line_mm: 0.3, min_gap_mm: 0.5 }   # 白墨
+  crease_clearance_mm: 2
+  registration_tolerance_mm: 0.1   # 工艺超出对应的印刷图形多少就提醒没对齐（F04，补 20 新加，不在工厂确认的范围里）【初值】
+attachment:                    # 配件（金属标，docs/ATTACHMENTS.md；补 40 新加，不在工厂确认的范围里）
+  fold_clearance_mm: 3          # 标的外形离折线 / 刀线至少多远（A01）【初值】
+labels:                        # 不干胶标签（C4，docs/C4_CARRIER_FRAMEWORK.md；不在工厂确认的范围里，全部【初值】）
+  bleed_mm: 2                  # 标签出血
+  safe_margin_mm: 2            # 文字、条码离模切外形至少多远
+  wrap_overlap_mm: 6           # 环标默认搭接
+  wrap_tolerance_mm: 1         # 环标长度和瓶周长 + 搭接差多少就报（L02）
+  panel_max_arc: 0.45          # 前 / 背标最宽占瓶周长的比例
+  min_corner_r_mm: 1           # 模切外形最小圆弧半径（L05）
+  min_concave_r_mm: 2          # 内凹圆弧最小半径（太小模切会撕，L05）
+  arc_fit_tol_mm: 0.05         # 椭圆 / 异形外形用双圆弧逼近的最大误差（守 D4）
+  barcode_max_arc_deg: 30      # 条码横跨的圆心角超过这个就提醒（L04；GS1 资料待查）
+  roll:                        # 卷标交付参数：规格书里写"请标签厂确认"
+    unwind: 1                  # 出标方向（标准 8 个方位）
+    core_mm: 76                # 卷芯内径
+    max_roll_od_mm: 300        # 卷外径上限
+    gap_mm: 3                  # 标签间距
+    across: 1                  # 排数
+    liner_margin_mm: 1.5       # 底纸两边留边
+pouches:                       # 软包装（C5，docs/C5_POUCHES.md；参照 Pacdora 参数化模板，不在工厂确认的范围里，全部【初值】）
+  bleed_mm: 3
+  safe_margin_mm: 3            # 文字离封边内沿至少多远
+  seal_small_mm: 5             # 封边宽：袋宽 ≤ seal_break_w 时 5，否则 7
+  seal_large_mm: 7
+  seal_break_w: 90
+  gusset_k: 0.3                # 自立袋底褶深 G = 0.3·W − 10
+  gusset_b: -10
+  zipper_top_mm: 13            # 拉链带离顶 13–25
+  zipper_w_mm: 12
+  tear_from_top_mm: 9          # 撕口离顶
+  tear_size_mm: 3
+  fin_seal_mm: 9               # 背封袋中缝封
+  end_seal_mm: 12              # 背封袋上下封
+  tolerance_mm: 1.5            # 制袋尺寸公差（规格书写"请制袋厂确认"）
+  flat_depth_k: 0.4            # 平底袋不给底深时 = 0.4 × 正面宽
+  flat_top_seal_mm: 10         # 平底袋顶封
+  flat_bottom_seal_mm: 6       # 平底袋底片四边封、袋身下沿
+  flat_fin_mm: 10              # 平底袋背中缝每边（Pacdora 10）
+  flat_bottom_gap_mm: 10       # 平底袋的底单独一片，排在右边、和袋身之间空 10
+  corner_seal_mm: 3            # 平底袋四条竖角封（跨折线）
+  valve_d_mm: 22               # 单向排气阀直径
+  valve_gap_mm: 10             # 排气阀离拉链带 / 顶封
+  spout_d_mm: 10               # 吸嘴口径（常见 8.6 / 10 / 16 / 22）
+  spout_base_k: 2.6            # 吸嘴船形底座宽 = 2.6 × 口径
+  spout_base_h_mm: 12
+  spout_corner_mm: 28          # 斜角吸嘴的切角直角边
+  handle_w_k: 0.4              # 手提孔宽 = 0.4 × 袋宽，最多 90
+  handle_max_w_mm: 90
+  handle_h_mm: 20
+  handle_top_mm: 15            # 手提孔上沿离顶
+  handle_margin_mm: 8          # 孔四周的手提封
+  window_min_mm: 15            # 透明窗最小边
+  shape_tol_mm: 0.05           # 异形外形转圆弧误差
+  roll:                        # 卷膜交付（自动包装机制袋；请印刷厂、包装机厂确认）
+    unwind: 1                  # 出卷方向（标准 8 个方位）
+    core_mm: 76
+    max_roll_od_mm: 400
+    max_splices: 2             # 每卷接头上限，接头处做标记
+    eye_w_mm: 10               # 光标（电眼色标）横向宽
+    eye_h_mm: 5                # 光标沿走膜方向长
+    eye_edge_mm: 2             # 光标离膜边 / 中缝封
+    eye_lane_mm: 3             # 光标两边留空的电眼通道
+    eye_cmyk: [0, 0, 0, 100]
+    lane_min_lum: 0.6          # 通道里亮度低于 0.6（0 黑 – 1 白）算深，电眼会误读（PO07）
+  fill_default: 0.7            # 装满效果图的鼓起量（job.json 的 pouch.fill 可改）
+  puff_k: 0.25                 # 每面最大鼓起 = 鼓起量 × 0.25 × 内容区短边
+  base_k: 0.9                  # 自立袋底 / 侧风琴撑开的半深 = 鼓起量 × 0.9 × 褶深
+  stretch_warn: 0.08           # PO05：装满后膜要变形超过 8% 的地方
+  small_text_pt: 8             # PO05：小于 8 pt 算小字
+window:                        # 开窗（docs/M4_WINDOW.md）
+  min_size_mm: 10              # 窗口最小边长
+  min_corner_r_mm: 1           # 最小圆角（尖角容易撕裂）
+  default_corner_r_mm: 3       # 圆角矩形窗不给 --r 时的圆角
+  edge_clearance_mm: 6         # 窗口离压线 / 外轮廓 / 糊口落胶位置至少多远（贴窗是工厂的后续工序，不在这里管）
+  min_web_mm: 8                # 两个窗口之间至少留多宽的纸
+  max_area_ratio: 0.6          # 窗口占面积的比例超过这个就提醒（盒子变软）
+
+spot_names:                    # PDF 专色名
+  cut: Dieline_Cut
+  crease: Dieline_Crease
+  perf: Dieline_Perf
+  partial_cut: Dieline_Score
+  reverse_crease: Dieline_ReverseCrease
+  foil_gold: Foil_Gold
+  foil_silver: Foil_Silver
+  foil_copper: Foil_Copper     # 铜金 / 玫瑰金一类的箔（2026-10-29 天地盖测试 F-01）
+  spot_uv: Spot_UV
+  emboss: Emboss
+  deboss: Deboss
+  white: White_Ink
+  glue_area: Glue_Area         # 糊胶区标注（信息层，不印；补 17 起生产文件里也有这一层）
+  keep_clear: Keep_Clear       # 封口 / 拉链 / 撕口 / 搭接区标注（软袋、标签；信息层，不印；C5）
+  annotation: Info_Annotation  # 生产文件的"标注"层（各面尺寸、图例、文件信息；只在出血外，不印）
+  attachment: Attach_Position  # 配件（金属标）的贴标位置：外形线 + 中心十字，信息层，不印（补 40 新加，不在工厂确认的范围里）
+
+dxf:
+  version: R12
+  layers:                      # ACI 颜色号：1 红 3 绿 5 蓝 6 洋红 2 黄
+    cut:            { name: CUT,      aci: 1 }
+    crease:         { name: CREASE,   aci: 3 }
+    perf:           { name: PERF,     aci: 5 }
+    partial_cut:    { name: SCORE,    aci: 6 }
+    reverse_crease: { name: RCREASE,  aci: 2 }
+    glue_area:      { name: GLUE,     aci: 4 }   # 糊胶区标注图层（不是刀线；常规标法）
+    keep_clear:     { name: SEAL,     aci: 6 }   # 封口 / 拉链 / 撕口区标注图层（软袋、标签；不是刀线）
+    attachment:     { name: ATTACH,   aci: 30 }  # 配件贴标位置（不是刀线；补 40）
+
+cf2:
+  units: mm
+  linetypes: { cut: 1, crease: 2, perf: 3, partial_cut: 4, reverse_crease: 5 }   # 参照 CFF2 线型表；反压线按常规单独编号，刀模厂按需映射【初值】
+
+compensation:                  # 见规格 8.5
+  folding_carton: { k_panel: 1.0, k_height: 1.0, k_lid: 1.0 }
+  corrugated:     { k_panel: 1.0, k_height: 1.0, k_lid: 1.0, k_flap: 0.5 }   # k_lid：飞机盒的盖（v0.2）
+
+deliverables: [production_pdf, spec_sheet, dxf]   # 交付包（发给工厂）：分层的生产文件、规格书、刀模 DXF（补 17）
+archive: [confirm_png, preflight_report, preview_png, dieline_pdf, cf2, finish_pdfs]   # 存档（<交付包>_archive/，工厂另要时再给）
+file_preferences:
+  editable_source: layered_pdf   # 有工厂要求 ai / cdr 时在这里标注

pacxio-0.0.1/profiles/materials.yaml

@@ -0,0 +1,28 @@
+# 材料预设。厚度【初值】，以工厂实测为准（规格第 7 节）。
+sbs_300:   { name: SBS 300 g/m²,     type: folding_carton, caliper_mm: 0.42, flute: null, surface: coated }
+sbs_350:   { name: SBS 350 g/m²,     type: folding_carton, caliper_mm: 0.48, flute: null, surface: coated }
+sbs_400:   { name: SBS 400 g/m²,     type: folding_carton, caliper_mm: 0.55, flute: null, surface: coated }
+gd_350:    { name: White-lined greyback 350 g/m², type: folding_carton, caliper_mm: 0.48, flute: null, surface: coated }
+kraft_350: { name: Kraft board 350 g/m²,   type: folding_carton, caliper_mm: 0.50, flute: null, surface: uncoated }
+flute_e:   { name: E-flute corrugated,     type: corrugated,     caliper_mm: 1.5,  flute: E }
+flute_b:   { name: B-flute corrugated,     type: corrugated,     caliper_mm: 3.0,  flute: B }
+flute_c:   { name: C-flute corrugated,     type: corrugated,     caliper_mm: 4.0,  flute: C }
+flute_bc:  { name: BC double-wall corrugated,  type: corrugated,     caliper_mm: 6.5,  flute: BC }
+# 不干胶标签（C4）：厚度是面材（不含底纸），只用于 3D 离瓶面的距离；film 是膜材种类（透明 / 镀铝要白墨打底）
+label_coated:   { name: Coated paper label stock,   type: label_stock, caliper_mm: 0.08, flute: null, surface: coated }
+label_kraft:    { name: Kraft paper label stock,   type: label_stock, caliper_mm: 0.09, flute: null, surface: uncoated }
+label_textured: { name: Textured paper label stock (wine label), type: label_stock, caliper_mm: 0.12, flute: null, surface: uncoated }
+label_pp_white: { name: White PP label stock,   type: label_stock, caliper_mm: 0.06, flute: null, surface: coated, film: white }
+label_pp_clear: { name: Clear PP label stock, type: label_stock, caliper_mm: 0.05, flute: null, surface: coated, film: clear }
+label_pe_white: { name: White PE label stock (squeeze bottles), type: label_stock, caliper_mm: 0.08, flute: null, surface: coated, film: white }
+label_metallized: { name: Silver metallized label stock, type: label_stock, caliper_mm: 0.06, flute: null, surface: coated, film: metallized }
+# 软包装复合膜（C5）：厚度是总厚（只用于 3D），film 决定要不要白墨（透明 / 镀铝）；复合结构以制袋厂为准【初值】
+pouch_pet_pe_clear:  { name: Clear PET/PE laminate,      type: film_laminate, caliper_mm: 0.10, flute: null, surface: coated, film: clear }
+pouch_pet_vmpet_pe:  { name: Metallized PET/VMPET/PE laminate, type: film_laminate, caliper_mm: 0.11, flute: null, surface: coated, film: metallized }
+pouch_pet_al_pe:     { name: PET/AL/PE foil laminate,    type: film_laminate, caliper_mm: 0.12, flute: null, surface: coated, film: metallized }
+pouch_matte_white:   { name: Matte BOPP/white PE laminate,   type: film_laminate, caliper_mm: 0.10, flute: null, surface: coated, film: white }
+pouch_kraft_pe:      { name: Kraft/PE laminate,          type: film_laminate, caliper_mm: 0.13, flute: null, surface: uncoated, film: kraft }
+pouch_pet_al_rcpp:   { name: PET/AL/RCPP retort laminate (121 °C; ready meals and meat), type: film_laminate, caliper_mm: 0.12, flute: null, surface: coated, film: metallized }
+pouch_ny_pe_clear:   { name: Clear NY/PE laminate (freezer and vacuum), type: film_laminate, caliper_mm: 0.09, flute: null, surface: coated, film: clear }
+pouch_mono_pe_white: { name: White mono-material PE/PE (recyclable), type: film_laminate, caliper_mm: 0.11, flute: null, surface: coated, film: white }
+pouch_kraft_pla:     { name: Kraft/PLA laminate (biodegradable),   type: film_laminate, caliper_mm: 0.13, flute: null, surface: uncoated, film: kraft }

pacxio-0.0.1/profiles/render-materials.json

@@ -0,0 +1,121 @@
+{
+  "version": "5",
+  "note": "仅供视觉示意的材质预设；不是工厂实测或制造公差。roughness/metallic/clearcoat 为 0–255。relief_* 是击凸 / 压凹在屏幕上的显示参数，不是模具深度：relief_edge_mm 是沿轮廓一圈斜坡的宽度（里外各一半），relief_height_mm 是平顶高出纸面多少，relief_cavity 是凹处压暗的强度（0–1）。 attachment 是配件（金属标）：field 是底面（喷砂哑光，粗糙度高）、relief 是凸起图案（抛光），height 是标面在高度图里的值（128 平、255 最高），edge_mm 是外缘斜坡宽。 static_reflection 是静态效果图的影棚（只看，不随视角换灯）：左前方一块竖长柔光灯板（方向 strip_az_deg / strip_el_deg，0 正前、负值往左；距盒子中心 strip_distance、宽 strip_width、高 strip_height，都是盒子对角线的倍数）加浅色地面（往下看 floor_fade_deg 度提亮到最大）；灯板软边 edge + edge_per_rough × 粗糙度（对角线倍数）；粗糙度 ≥ rough_none 不反光、≤ rough_full 最强；strip_strength / floor_strength 是灯板、地面反光往白色混的最大比例。",
+  "fold": {
+    "crease_radius_caliper": 1.0
+  },
+  "paper": [
+    173,
+    0,
+    0
+  ],
+  "matte_lamination": [
+    150,
+    0,
+    90
+  ],
+  "gloss_lamination": [
+    48,
+    0,
+    240
+  ],
+  "matte_varnish": [
+    140,
+    0,
+    60
+  ],
+  "gloss_varnish": [
+    65,
+    0,
+    210
+  ],
+  "foil_gold": {
+    "base": [
+      217,
+      174,
+      73
+    ],
+    "material": [
+      59,
+      255,
+      0
+    ]
+  },
+  "foil_silver": {
+    "base": [
+      218,
+      222,
+      230
+    ],
+    "material": [
+      51,
+      255,
+      0
+    ]
+  },
+  "foil_copper": {
+    "base": [
+      196,
+      122,
+      84
+    ],
+    "material": [
+      59,
+      255,
+      0
+    ]
+  },
+  "foil_holo": {
+    "base": [
+      200,
+      206,
+      215
+    ],
+    "material": [
+      64,
+      255,
+      0
+    ]
+  },
+  "spot_uv": [
+    30,
+    0,
+    255
+  ],
+  "white": [
+    250,
+    250,
+    250
+  ],
+  "relief_height_mm": 0.3,
+  "relief_edge_mm": 0.5,
+  "relief_cavity": 0.2,
+  "attachment": {
+    "field": [
+      110,
+      255,
+      0
+    ],
+    "relief": [
+      50,
+      255,
+      0
+    ],
+    "height": 200,
+    "edge_mm": 1.0
+  },
+  "static_reflection": {
+    "strip_az_deg": -33,
+    "strip_el_deg": -8,
+    "strip_distance": 1.2,
+    "strip_width": 0.18,
+    "strip_height": 2.6,
+    "edge": 0.05,
+    "edge_per_rough": 0.5,
+    "floor_fade_deg": 30,
+    "strip_strength": 0.24,
+    "floor_strength": 0.04,
+    "rough_none": 160,
+    "rough_full": 30
+  }
+}