feat(gym): SVG→PNG GPU 래스터화 경로(vello/wgpu)와 정직한 벤치마크

Cargo.toml

@@ -74,6 +74,11 @@ subsecond = { version = "=0.7.10", optional = true }
 default = ["console_error_panic_hook"]
 native-skia = ["dep:resvg", "dep:skia-safe"]
 subsecond-dev = ["dep:subsecond"]
+# [gym_gpu_raster] GPU 가속 SVG 래스터화 경로 (네이티브 전용). native-skia 와 같은 방식으로
+# 선택 게이팅한다 — CI 는 GPU 없이도 컴파일되고, 실제 GPU 실행은 로컬에서만 일어난다.
+# vello(+vello_svg)로 SVG 를 GPU 래스터화하고, resvg(CPU)를 같은 usvg 트리로 돌려 정직한
+# 벤치마크 기준선으로 삼는다.
+gpu = ["dep:vello", "dep:vello_svg", "dep:pollster", "dep:resvg-gpu"]
 
 # PDF 내보내기 (네이티브 전용, Task #21)
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
@@ -84,6 +89,17 @@ pdf-writer = "0.12"
 subsetter = "0.2"
 skia-safe = { version = "0.99.0", optional = true, default-features = false, features = ["binary-cache", "embed-icudtl", "pdf", "textlayout"] }
 
+# [gym_gpu_raster] GPU 래스터화 스택 (feature = "gpu", 네이티브 전용).
+# vello: Linebender 의 GPU 2D 렌더러(컴퓨트 파이프라인). vello_svg: usvg 트리 → vello Scene.
+# pollster: 헤드리스라 이벤트 루프가 없으므로 wgpu 의 async(adapter/device/버퍼매핑)를 블로킹.
+# resvg-gpu: CPU 기준선. vello_svg 0.7 과 usvg 0.45 를 공유하도록 0.45 로 핀했다(같은 트리를
+# 두 래스터라이저에 동일 입력으로 넣어 벤치마크·픽셀비교를 성립). native-skia 의 resvg 0.47 과
+# 별개 버전으로 공존한다.
+vello = { version = "0.5", optional = true }
+vello_svg = { version = "0.7", optional = true }
+pollster = { version = "0.4", optional = true }
+resvg-gpu = { package = "resvg", version = "0.45", optional = true }
+
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 web-sys = { version = "0.3", features = [
     "CanvasRenderingContext2d",

mydocs/manual/agent_codex/10_조회.md

@@ -2,7 +2,7 @@
 kind: guide
 status: active
 canonical: mydocs/manual/agent_codex/10_조회.md
-last_verified: 2026-08-11
+last_verified: 2026-08-15
 generated: tools/gen_agent_codex.py — 수기 수정 금지, 재생성으로 갱신
 ---
 
@@ -31,7 +31,7 @@ rhwp info samples/basic/issue2007_nested_cell_pagination_42065.hwp --json
   "fonts": [
     "굴림",
     "굴림체",
-    "… (12개 중 2개 표시)"
+    "… (82개 중 2개 표시)"
   ],
   "format": "hwp5",
   "pageCount": 17,

mydocs/manual/agent_codex/40_변환과_렌더.md

@@ -2,7 +2,7 @@
 kind: guide
 status: active
 canonical: mydocs/manual/agent_codex/40_변환과_렌더.md
-last_verified: 2026-08-11
+last_verified: 2026-08-15
 generated: tools/gen_agent_codex.py — 수기 수정 금지, 재생성으로 갱신
 ---
 
@@ -112,9 +112,9 @@ rhwp export-svg samples/field-01.hwp -o {tmp}/svg
 ```json
 (비 JSON 출력 — 앞 160자)
 문서 로드 완료: samples/field-01.hwp (3페이지)
-  → <tmp>/svg/field-01_001.svg
-  → <tmp>/svg/field-01_002.svg
-  → <tmp>/svg/field-01_003.svg
+  → <tmp>/svg\field-01_001.svg
+  → <tmp>/svg\field-01_002.svg
+  → <tmp>/svg\field-01_003.svg
 내보내기 완료: 3개 SVG 파일 → <tmp>/sv
 ```
 
@@ -147,3 +147,17 @@ rhwp export-svg samples/field-01.hwp -o {tmp}/svg
 - **출처 표지**: 문서 파생 필드 없음 (엔진·에코 값뿐)
 
 > **계약만** — 입력 합성 비용 또는 산출 부피 때문에 표본 실행을 싣지 않는다 — 계약(플래그·봉투 필드·출처)은 아래가 전부이며 자기서술에서 생성됐다.
+
+### `export-png-gpu` — SVG를 GPU(vello/wgpu)로 래스터화해 페이지별 PNG로 렌더 (--benchmark 로 CPU 대비 실측)
+
+- 종류: `export` · exit 규약: 0 성공 / 1 IO / 2 사용법
+- 사용법: `export-png-gpu <파일.hwp|파일.hwpx> [옵션]   (gpu feature 필요)`
+
+> **계약만** — 입력 합성 비용 또는 산출 부피 때문에 표본 실행을 싣지 않는다 — 계약(플래그·봉투 필드·출처)은 아래가 전부이며 자기서술에서 생성됐다.
+
+### `gpu-info` — 사용 가능한 GPU 어댑터 열거 (export-png-gpu 가 쓸 백엔드 확인)
+
+- 종류: `export` · exit 규약: 0 성공 / 1 IO / 2 사용법
+- 사용법: `gpu-info                        (gpu feature 필요)`
+
+> **계약만** — 입력 합성 비용 또는 산출 부피 때문에 표본 실행을 싣지 않는다 — 계약(플래그·봉투 필드·출처)은 아래가 전부이며 자기서술에서 생성됐다.

mydocs/manual/agent_codex/70_자기서술.md

@@ -2,7 +2,7 @@
 kind: guide
 status: active
 canonical: mydocs/manual/agent_codex/70_자기서술.md
-last_verified: 2026-08-12
+last_verified: 2026-08-15
 generated: tools/gen_agent_codex.py — 수기 수정 금지, 재생성으로 갱신
 ---
 
@@ -931,7 +931,7 @@ rhwp export-agent-manifest --json
         ],
         "summary": "페이지별 텍스트 추출 (TXT 파일 또는 --json stdout)"
       },
-      "… (85개 중 2개 표시)"
+      "… (87개 중 2개 표시)"
     ],
     "exitCodes": {
       "0": "성공",