코파일럿 여는 법 — 웹 · 홈 화면 앱 · Windows 앱
코파일럿 화면은 설치 현장의 코파일럿 서버가 내어 줍니다. 여는 길은 셋이고, 어느 것으로 열어도 같은 화면 · 같은 계정 · 같은 권한입니다.
| 여는 길 | 이럴 때 | 따로 깔 것 |
|---|---|---|
| 웹 브라우저 | 사무실 PC · 노트북에서 그냥 열 때 | 없음 |
| 홈 화면 앱(PWA) | 현장 폰 · 태블릿에서 앱처럼 열고 푸시 알림을 받을 때 | 브라우저의 «홈 화면에 추가» |
| Windows 데스크톱 앱(준비 중) | 브라우저 탭이 아니라 작업 표시줄의 창 하나로 둘 때 | 설치 파일 하나 |
주소는 관리자에게 받습니다 — 예: https://copilot.<회사>.local. HTTPS 주소여야 마이크(음성 질문)와 푸시 알림이 열립니다.
웹 브라우저
최신 Chrome · Edge · Safari · Firefox 에서 주소를 엽니다. 로그인하면 첫 화면은 묻기입니다 → 코파일럿 화면 지도.
- 처음 열 때 화면 언어는 브라우저의 언어 설정을 따릅니다(한국어 · 영어). 로그인 화면 아래의 한국어 · English 로 바꿀 수 있습니다.
- 메일 · 알림의 링크를 로그인하지 않은 채 열면 로그인 화면이 먼저 뜨고, 로그인하면 그 링크의 화면으로 갑니다.
- 탭을 오래 열어 둔 사이 서버가 새 판으로 올라가면 화면 아래에 「새 버전이 있습니다」 알림이 뜹니다 — 아래 «홈 화면 앱» 과 같습니다.
홈 화면 앱(PWA)
브라우저로 연 코파일럿을 폰 · 태블릿의 홈 화면에 앱처럼 올려 둡니다. 주소창 없이 열리고, 푸시 알림을 받습니다.
| 기기 | 올리는 법 |
|---|---|
| Android(Chrome) | 주소를 열고 메뉴 ⋮ → 홈 화면에 추가(또는 앱 설치) |
| iPhone · iPad(Safari) | 주소를 열고 공유 → 홈 화면에 추가 |
| PC(Chrome · Edge) | 주소창 오른쪽의 설치 아이콘 |
코파일럿 화면 안에는 설치 단추가 따로 없습니다 — 위처럼 브라우저의 메뉴로 올립니다.
- 앱 이름과 아이콘은 설치의 브랜드 설정(제품 이름 · 파비콘 또는 로고)을 따릅니다. 올린 앱을 열면 묻기 첫 화면에서 시작합니다.
- 올린 뒤 설정 › 알림에서 «휴대폰·브라우저 알림» 을 켭니다. iPhone · iPad 는 홈 화면에 올린 앱에서만 푸시가 됩니다.
- HTTPS 주소에서만 올릴 수 있습니다. 기기가 서버의 인증서를 신뢰해야 합니다 — 사내 인증 기관(CA)이 발급한 인증서라면 그 CA 를 기기에 먼저 등록합니다. 신뢰되지 않는 인증서로 열면 화면은 뜨지만 푸시 알림과 아래의 «끊겼을 때» 동작이 되지 않습니다.
새 버전 알림 — 서버가 새 판으로 올라가면 화면 아래에 「새 버전이 있습니다」 와 새로고침 단추가 뜹니다. 누르면 새 화면으로 바뀝니다 — 다시 설치하지 않습니다.
- 쓰던 글을 지키려고 스스로 새로 고치지 않습니다. 알림도 누를 때까지 사라지지 않습니다 — 하던 입력을 마친 뒤 누릅니다.
- 새 판이 있는지는 앱(탭)으로 돌아올 때와 열어 둔 동안 30분마다 확인합니다.
끊겼을 때 — 쓰는 중에 네트워크가 끊기면 화면 위에 「인터넷 연결이 끊겼습니다. 연결되면 다시 보낼 수 있습니다」 띠가 뜹니다. 끊긴 채로 앱을 열면 내용 대신 「인터넷 연결이 끊겼습니다. …」 나 「서버에 연결하지 못했습니다. 네트워크를 확인하고 다시 시도하세요」, 또는 「연결할 수 없습니다」 와 다시 시도가 보입니다. 공장 데이터 · 답 · 목록은 기기에 저장해 두지 않으므로, 연결돼야 내용이 보입니다.
Windows 데스크톱 앱
Windows 데스크톱 앱은 아직 공개 전입니다. 아래는 공개될 판 기준의 안내이고, 내려받기 주소는 공개와 함께 열립니다. 그때까지는 웹 브라우저나 홈 화면 앱으로 여십시오.
설치 현장의 코파일럿 서버 주소를 여는 얇은 창입니다. 화면은 앱에 들어 있지 않고 서버가 주는 화면을 그대로 띄웁니다 — 그래서 서버를 새 판으로 올려도 앱은 다시 깔 필요가 없습니다. 앱이 직접 가진 화면은 서버 주소와 연결할 수 없습니다 둘뿐입니다.
| 항목 | 값 |
|---|---|
| 지원 | Windows 10 · 11, x64 |
| 설치 | 사용자 단위 설치 — 관리자 권한이 필요 없습니다. 설치 위치를 고를 수 있습니다 |
| 크기 | 약 106 MB |
| 자동 업데이트 | 없습니다(폐쇄망 설치를 고려). 새 판은 설치 파일을 다시 실행해 덮어 깝니다 |
| 코드 서명 | 없습니다 — 설치 때 Windows 경고가 뜹니다(아래 2단계) |
내려받기
| 판 | 주소 |
|---|---|
| 최신 | https://product.kopens.io/plantpulse-ai/desktop/latest/PlantPulse-Copilot-Setup-x64.exe |
| 판별 | https://product.kopens.io/plantpulse-ai/desktop/<YYYY.MM>/PlantPulse-Copilot-Setup-<버전>-x64.exe |
두 주소 모두 설치 파일 옆에 같은 이름의 .sha256 파일이 있습니다(판별 폴더에는 그 서명 .sha256.sig 도 있습니다). 받은 파일이 맞는지 PowerShell 로 대조합니다.
Get-FileHash .\PlantPulse-Copilot-Setup-2026.10.0-x64.exe -Algorithm SHA256
# 출력의 Hash 값이 .sha256 파일의 값과 같아야 합니다
인터넷이 막힌 현장이면 인터넷이 되는 PC 에서 받아 사내로 옮깁니다. 앱 자체는 설치 뒤 코파일럿 서버에만 연결합니다.
«최신» 주소가 옛 파일을 주는 것 같으면 주소 뒤에 ?v=1 처럼 아무 숫자를 붙여 다시 받습니다.
코드 서명 — 사내에 경고 없이 배포하기
지금 판의 설치 파일에는 코드 서명이 없습니다. 서명 방식은 아직 정해지지 않았습니다 — 그때까지는 아래 «설치» 2단계처럼 경고를 넘기거나, IT 가 파일 해시를 허용 목록에 넣습니다. 서명된 판이 나오면 그 서명의 루트 인증서를 PC 에 등록해 두어 «PC 보호» 경고 없이 깔 수 있습니다.
| 등록하는 곳 | 넣는 저장소 |
|---|---|
| 그룹 정책(GPO) — 컴퓨터 구성 › 정책 › Windows 설정 › 보안 설정 › 공개 키 정책 | 신뢰할 수 있는 루트 인증 기관 + 신뢰할 수 있는 게시자 |
| Intune — 기기 구성 프로필 «신뢰할 수 있는 인증서» | 같은 두 저장소 |
인증서 파일 주소와 지문은 서명이 적용되는 판의 릴리즈 노트에 싣습니다.
설치
PlantPulse-Copilot-Setup-<버전>-x64.exe를 실행합니다.- 「Windows의 PC 보호」 창이 뜨면 추가 정보 → 실행을 누릅니다. 설치 파일에 코드 서명이 없어서 뜨는 경고입니다. 사내에 일괄 배포한다면 IT 가 그룹 정책 · Intune 으로 이 파일의 해시를 허용 목록에 넣으면 경고 없이 깔립니다.
- 설치 범위는 현재 사용자만(기본)을 고릅니다. 바탕 화면과 시작 메뉴에 PlantPulse Copilot 바로가기가 생깁니다.
제거는 Windows 설정 › 앱 › PlantPulse Copilot › 제거입니다. 서버 주소 같은 사용자 설정은 남습니다(아래 «사용자 데이터»).
서버 주소 넣기
처음 실행하면 서버 주소 화면이 뜹니다. 관리자에게 받은 주소를 넣고 연결을 누릅니다. 다음부터는 바로 그 서버의 로그인 화면이 열립니다.
https://주소만 받습니다.http://주소는 «보안 연결(https) 주소만 쓸 수 있습니다» 로 거절합니다 — 인증서가 맞지 않아 안 열릴 때는http로 내리지 말고 아래 «사내 CA 인증서 가져오기» 로 풉니다.https://를 빼고 적으면https://를 붙입니다.- 경로가 붙은 주소도 됩니다 — 예:
https://host/copilot. 주소 뒤의?…·#…은 버립니다. - 주소에
계정:비밀번호@를 넣을 수 없습니다(설정 파일에 그대로 남기 때문입니다). 로그인은 화면에서 합니다.
서버를 바꾸려면 메뉴 파일 › 서버 바꾸기… 를 누르거나, «연결할 수 없습니다» 화면에서 서버 바꾸기를 누릅니다.
연결할 수 없습니다
서버가 꺼져 있거나 네트워크가 끊겨 있으면 연결할 수 없습니다 화면이 뜹니다. 다시 시도로 다시 붙거나, 서버 바꾸기로 주소를 고칩니다.
사내 CA 인증서 가져오기
서버가 사내 인증 기관(CA)이 발급한 인증서를 쓰면, 처음엔 «연결할 수 없습니다 — 인증서 오류» 가 뜹니다.
- 서버 바꾸기 → CA 인증서 가져오기를 누르고 CA 인증서 파일(
.pem·.crt·.cer, PEM 형식)을 고릅니다. 서버 인증서가 아니라 그것을 발급한 CA 의 인증서입니다 — 예: 설치 호스트의/etc/kopens/ca/root.crt. - 화면에 CA 이름 · 만료일 · SHA-256 지문이 보입니다. 관리자에게 받은 지문과 같은지 대조합니다.
- CA 를 가져오면 앱이 스스로 다시 시작합니다 — 방금 거절한 서버를 새 CA 로 다시 판정하려면 재시작이 필요하기 때문입니다. 서버 주소를 먼저 넣어 두었으면 재시작 뒤 바로 그 서버가 열립니다. 가져온 CA 를 지울 때도 앱이 다시 시작합니다.
가져온 CA 는 설정한 서버에만 쓰입니다. 다른 사이트의 인증서 판정에는 영향이 없고, 인증서 검증을 끄지도 않습니다 — 호스트 이름 · 유효기간 · 서명은 그대로 봅니다. DER(이진) 형식 파일은 받지 않으니 PEM 으로 바꿔 옵니다.
certutil -encode root.der root.pem
단축키
| 키 | 동작 |
|---|---|
Ctrl + +(또는 =) | 확대 |
Ctrl + - | 축소 |
Ctrl + 0 | 원래 크기 |
F5 | 새로 고침 |
F11 | 전체 화면 |
앱은 한 번에 하나만 뜹니다 — 이미 떠 있을 때 다시 실행하면 그 창이 앞으로 옵니다.
사용자 데이터
%APPDATA%\PlantPulse Copilot\ 에 서버 주소 · 창 크기와 위치(settings.json), 가져온 CA(ca.pem), 로그인 쿠키가 남습니다.
이 폴더를 지우면 첫 실행 상태로 돌아갑니다.
IT 담당자를 위한 동작 범위
| 항목 | 동작 |
|---|---|
| 창 안 이동 | 설정한 서버 주소(origin) 안에서만. 다른 웹 주소는 기본 브라우저로 열고, file: 같은 그 밖의 주소는 열지 않습니다 |
| 브라우저 권한 | 서버 화면에 마이크(채팅 음성 질문, 오디오만) · 클립보드 쓰기(복사 단추) · 전체 화면만 허용합니다. 카메라 · 위치 · 알림 · USB · 시리얼 등은 거절합니다 — 그래서 푸시 알림은 Windows 앱이 아니라 웹 브라우저 · 홈 화면 앱에서 받습니다 |
| TLS | 인증서 검증을 끄지 않습니다. 사내 CA 는 위 «CA 인증서 가져오기» 로만 더합니다 |
| 실행 격리 | Chromium 샌드박스 · 컨텍스트 격리를 켜고, 화면에서 Node.js 를 쓸 수 없습니다. 개발자 도구 메뉴는 없습니다 |
| 네트워크 | 앱이 스스로 바깥에 연결하지 않습니다 — 업데이트 확인 · 사용 통계 전송이 없고, 맞춤법 검사(사전을 바깥에서 받습니다)도 꺼 두었습니다 |