> For the complete documentation index, see [llms.txt](https://clunk.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://clunk.gitbook.io/docs/undefined/inspect.md).

# 에셋 검사와 안전한 수정

GLB·glTF를 실제 바이트에서 검사하고 안전한 새 파일과 검사 증명서를 받는 방법

[에셋 검사](https://clunk.games/app)는 GLB·glTF 파일을 브라우저에서 열어 파일 규격을 측정합니다. PNG, JPG 같은 그림 파일은 이 화면의 입력 형식이 아닙니다.

{% hint style="info" %}
파일 자체는 브라우저에서 처리합니다. Clunk가 작업공간에 저장하는 것은 파일 이름·형식·크기·파일 지문과 검사 결과 같은 기록이며, 검사하려고 고른 원본 바이트는 저장하지 않습니다.
{% endhint %}

## 검사 순서

{% stepper %}
{% step %}

## 1. 파일을 고르기

파일 선택 칸에 `.glb` 또는 `.gltf`를 넣거나 파일을 끌어 놓습니다. 여러 파일을 한 번에 넣으면 일괄 검사 큐가 만들어집니다. 처음이라면 화면의 샘플을 선택해 흐름을 볼 수 있고, 샘플 결과는 작업공간 기록과 실행 횟수에 반영되지 않습니다.
{% endstep %}

{% step %}

## 2. 검사 기준을 고르기

기본 기준은 `clunk-game-ready-v1`입니다. 화면에서 고를 수 있는 프로파일은 다음 세 가지입니다.

| 프로파일       | 기준                                               |
| ---------- | ------------------------------------------------ |
| **PC**     | 데스크톱·콘솔 게임, 폴리곤 250,000개·재질 24개·텍스처 메모리 512 MB까지 |
| **Web**    | 웹 뷰어·커머스, 폴리곤 100,000개·재질 12개·텍스처 메모리 128 MB까지   |
| **Mobile** | 모바일 게임, 폴리곤 25,000개·재질 6개·텍스처 메모리 64 MB까지        |

같은 파일도 프로파일에 따라 판정이 달라질 수 있습니다. 프로젝트가 요구하는 기준을 선택하세요.
{% endstep %}

{% step %}

## 3. 측정값과 finding 읽기

Clunk는 씬·오브젝트, 메시·조각, 정점·폴리곤, 재질, 텍스처와 메모리 등을 실제 파일에서 읽습니다. 각 finding에는 규칙 ID, 심각도, 관측값과 기준값이 있습니다.

점수는 0\~100이며 90점 이상이어야 합니다. `CRITICAL`·`ERROR`는 막는 문제, `WARNING`은 경고, `INFO`는 확인한 항목입니다. 점수가 높아도 막는 문제나 경고가 남을 수 있으니 finding을 함께 읽으세요.
{% endstep %}

{% step %}

## 4. 안전하게 수정하고 다시 검사하기

검사 결과에서 버튼이 열리면 **안전하게 최적화**를 누릅니다. Clunk가 자동으로 적용하는 작업은 빈 노드 제거, 똑같은 재질 합치기, 허용된 메타데이터 정리, 새 파일로 다시 묶기뿐입니다. 모양·텍스처·애니메이션·스킨을 바꾸는 손실 작업은 하지 않습니다.

원본은 그대로 두고 별도 출력 파일을 만든 다음, 그 출력 파일을 처음부터 다시 검사합니다. 이 재검사 결과가 원본과 다른 파일 지문에 연결되어야 다음 단계로 갑니다.
{% endstep %}

{% step %}

## 5. 결과 파일과 검사 증명서 받기

재검사 뒤 **최적화 GLB 다운로드**로 새 파일을 받고, **증명서 내려받기**로 JSON 검사 증명서를 받습니다. 증명서에는 원본·출력 파일 지문, 두 검사 결과 지문, 적용한 작업과 전후 측정값이 들어갑니다.

다운로드한 출력 파일을 다시 열어 증명서의 `outputHash`와 일치하는지 확인하면 파일이 바뀌지 않았는지 직접 확인할 수 있습니다.
{% endstep %}
{% endstepper %}

## 판정 세 가지

| 화면에 보이는 상태 | 뜻                                       |
| ---------- | --------------------------------------- |
| **통과**     | 기준 점수 이상이고 막는 문제·경고가 없어 `ready`입니다.     |
| **조건부**    | 막는 문제는 없지만 안전한 수정으로 없애지 못한 경고가 남아 있습니다. |
| **막힘**     | `ERROR` 또는 `CRITICAL` 문제가 남아 있습니다.      |

이 판정은 파일 규격에 대한 것입니다. 게임 안에서 어떻게 보이는지, 엔진에 실제로 잘 들어가는지, 사람이 최종적으로 사용할지에 대한 승인을 자동으로 만들지 않습니다. 그 증거가 없으면 `엔진 렌더`, `게임 시점`, `판정` 상태는 각각 확인 전으로 남습니다.

## 커스텀 프로파일

프로젝트 프로파일 JSON을 화면에 불러오면 선택한 기준으로 로컬 검사할 수 있습니다. 커스텀 프로파일 결과는 브라우저에만 남고 작업공간 저장이나 실행 횟수 차감이 없습니다. 저장 가능한 실행 기록이 필요하면 PC·Web·Mobile 기본 프로파일을 사용하세요.

## 관련 문서

* [에셋 제작](/docs/undefined/create.md)
* [계약과 상태](/docs/undefined-2/contracts.md)
* [CLI와 CI](/docs/undefined-2/cli-ci.md)
* [문제 해결](/docs/undefined-1/troubleshooting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://clunk.gitbook.io/docs/undefined/inspect.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.