# 출력 프로그램 설치·연결

> Windows 출력 프로그램 설치, 계정 키 연결, 허용 사이트, 자동 업데이트.

Source: https://82label.app/docs/agent/

82label 출력 프로그램은 Windows 트레이에서 도는 작은 프로그램입니다. 켜져 있으면 `print()` 가 인쇄 창 없이 바로 라벨프린터로 보냅니다. 처음 연결한 날부터 **30일 무료**이고, 그 뒤에는 **구독자에게 무료**입니다. 계정 키로 연결해야 동작합니다.

## 설치

1. [다운로드](https://82label.app/download/)에서 `82label-Setup-버전.exe` 를 받습니다(Windows 10·11, 64비트).
2. 실행하면 관리자 권한 없이 사용자 폴더(`%LOCALAPPDATA%\Programs\82label`)에 설치되고 트레이에 아이콘이 뜹니다.
3. Windows 시작 시 자동으로 켜집니다(트레이 메뉴에서 끌 수 있음).

> "Windows 의 PC 보호" 창이 뜨면 **추가 정보 → 실행**을 누르세요. 새 프로그램은 다운로드 수가 쌓일 때까지 SmartScreen 이 경고할 수 있습니다. 설치 파일의 SHA-256 은 다운로드 페이지에 있습니다.

## 계정 연결

1. 82label.app 에 로그인해 [내 서식 › 출력 프로그램](https://82label.app/my/agent/)에서 **새 키 만들기**를 누릅니다. 키(`l82a_…`)는 이때 한 번만 보입니다.
2. 트레이 아이콘 › **계정 연결…** 에 키를 붙여 넣습니다.
3. 구독이 확인되면 트레이에 "연결됨" 이 보입니다. 연결은 12시간마다 다시 확인하고, 인터넷이 끊겨도 7일 동안은 그대로 인쇄됩니다.

## 허용 사이트

아무 웹사이트나 몰래 인쇄하지 못하도록, 출력 프로그램은 요청한 사이트(Origin)를 확인합니다. 처음 보는 사이트는 트레이 위에 "https://shop.example.com 에서 라벨 출력을 허용할까요?" 를 묻고, 허용하면 목록에 저장합니다. 82label.app 은 처음부터 허용돼 있습니다. 목록은 트레이 › 허용 사이트에서 지울 수 있습니다.

## 자동 업데이트

시작 1분 뒤와 6시간마다 새 버전을 확인합니다. 82label 의 업데이트 서명이 맞고 82label.app 에서 받은 파일의 크기·SHA-256 이 맞을 때만 조용히 설치하고 다시 켭니다. 트레이 메뉴에서 끄거나 "업데이트 확인" 을 누를 수 있습니다.

## 확인하기

```js
const s = await Label82.agentStatus();
// null → 출력 프로그램이 없거나 꺼져 있음
// { version: '0.1.0', allowed: true, licensed: true } → 바로 인쇄됨
```

| 증상 | 확인할 것 |
| --- | --- |
| 계속 브라우저 창이 뜸 | 트레이에 아이콘이 있는지, "연결됨" 인지. 보안 프로그램이 `127.0.0.1:18282` 를 막는지. |
| 아무것도 안 나옴 | `status: 'pending_permission'` 이면 트레이의 허용 창에서 허용. |
| 위치가 밀림 | 드라이버의 용지 크기, 프린터의 라벨 감지 보정. 배율은 항상 100% 로 보냅니다. |