vamp-mcp 0.2.0 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +142 -107
- package/THIRD_PARTY_NOTICES.md +32 -27
- package/bin/vamp-mcp.mjs +37 -37
- package/notices/mcp-virtualbox-LICENSE +21 -21
- package/notices/mcp-virtualbox-PROVENANCE.json +37 -37
- package/package.json +51 -17
- package/runtime/backends/common/Test-Environment.ps1 +7 -6
- package/runtime/backends/common/guest-install.json +58 -0
- package/runtime/backends/common/guest_install.py +57 -0
- package/runtime/backends/common/host-support.cjs +16 -0
- package/runtime/backends/common/packer.cjs +16 -0
- package/runtime/backends/hyperv/scripts/Manage-Desktop.ps1 +40 -67
- package/runtime/backends/hyperv/scripts/Send-InstallerBoot.ps1 +25 -0
- package/runtime/backends/kvm/debian-preseed.cfg +35 -35
- package/runtime/backends/library/registry.py +77 -77
- package/runtime/backends/library/replay.py +154 -154
- package/runtime/backends/packer/answer_media.py +16 -0
- package/runtime/backends/packer/deploy-hyperv.ps1 +10 -0
- package/runtime/backends/packer/drivers.py +49 -0
- package/runtime/backends/packer/hyperv-network.ps1 +10 -0
- package/runtime/backends/packer/images.py +75 -0
- package/runtime/backends/packer/osinfo.py +113 -0
- package/runtime/backends/packer/policy.json +15 -0
- package/runtime/backends/packer/runner.py +224 -0
- package/runtime/backends/packer/templates.py +118 -0
- package/runtime/backends/packer/toolchain.py +80 -0
- package/runtime/backends/remote_ssh/server.mjs +310 -93
- package/runtime/backends/virtualbox/desktop.cjs +37 -0
- package/runtime/backends/virtualbox/display.py +101 -101
- package/runtime/backends/virtualbox/history.py +139 -139
- package/runtime/backends/virtualbox/mouse_click.py +15 -15
- package/runtime/backends/virtualbox/mouse_move.py +18 -18
- package/runtime/backends/virtualbox/profiles.json +46 -46
- package/runtime/backends/virtualbox/provision.py +238 -197
- package/runtime/backends/virtualbox/recording_listener.py +29 -29
- package/runtime/backends/virtualbox/recordings.py +39 -39
- package/runtime/backends/virtualbox/requirements.txt +7 -7
- package/runtime/backends/virtualbox/rpas/debian_first_boot/manifest.json +1 -1
- package/runtime/backends/virtualbox/rpas/debian_first_boot/run.robot +13 -13
- package/runtime/backends/virtualbox/rpas/debian_first_boot/workflow.py +75 -75
- package/runtime/backends/virtualbox/rpas/observe/manifest.json +7 -7
- package/runtime/backends/virtualbox/rpas/observe/run.robot +13 -13
- package/runtime/backends/virtualbox/rpas/observe/workflow.py +14 -14
- package/runtime/backends/virtualbox/server.mjs +288 -237
- package/runtime/backends/virtualbox/setup_windows_sdk.py +58 -58
- package/runtime/backends/virtualbox/shares.py +68 -68
- package/runtime/backends/virtualbox/snapshots.py +53 -53
- package/runtime/backends/virtualbox/transfers.py +89 -89
- package/runtime/backends/virtualbox/vnc.py +61 -61
- package/runtime/guest_keys.py +13 -13
- package/runtime/guest_setup/http/debian-preseed.cfg +39 -0
- package/runtime/guest_setup/http/postdeb.sh +50 -3
- package/runtime/guest_setup/http/postwin.ps1 +53 -28
- package/runtime/guest_setup/http/setup-all.ps1 +25 -25
- package/runtime/guest_setup/http/setup-win.cmd +7 -7
- package/runtime/guest_setup/http/setup.ps1 +44 -29
- package/runtime/guest_setup/kvm/setup-windows.ps1 +52 -52
- package/runtime/guest_setup/recorder/README.txt +12 -12
- package/runtime/guest_setup/recorder/RECORDER-LICENSE +674 -674
- package/runtime/guest_setup/recorder/RECORDING-GUIDE.txt +31 -31
- package/runtime/guest_setup/recorder/apply-display.py +41 -41
- package/runtime/guest_setup/recorder/configure-debian-mirrors.py +62 -62
- package/runtime/guest_setup/recorder/configure-gdm.py +23 -0
- package/runtime/guest_setup/recorder/configure-session.ps1 +14 -0
- package/runtime/guest_setup/recorder/gnome-display.py +60 -60
- package/runtime/guest_setup/recorder/install-display-startup.py +66 -39
- package/runtime/guest_setup/recorder/install-hypervisor-drivers.ps1 +34 -0
- package/runtime/guest_setup/recorder/install-resolution-shortcut.ps1 +36 -0
- package/runtime/guest_setup/recorder/postwin.cmd +10 -10
- package/runtime/guest_setup/recorder/prepare-recording.py +30 -30
- package/runtime/guest_setup/recorder/requirements-recorder.txt +2 -2
- package/runtime/guest_setup/recorder/session-policy.py +22 -0
- package/runtime/guest_setup/recorder/setup-user.py +53 -53
- package/runtime/guest_setup/recorder/setup-win.cmd +4 -60
- package/runtime/guest_setup/recorder/setup.ps1 +108 -81
- package/runtime/guest_setup/recorder/setup.sh +1 -0
- package/runtime/guest_setup/recorder/vamp-recorder.py +148 -148
- package/runtime/guest_setup/recorder/verify-recorder.py +4 -4
- package/runtime/guest_setup/recorder/windows-display.py +76 -76
- package/runtime/guest_setup/requirements.txt +2 -2
- package/runtime/guest_setup/setup-all.ps1 +35 -35
- package/runtime/guest_setup/vault/Install-VCRuntime.ps1 +26 -26
- package/runtime/guest_setup/vault/setup-guest-vault.ps1 +148 -148
- package/runtime/recording_converter.py +230 -230
- package/runtime/requirements-mcp.txt +11 -11
- package/runtime/rpas/README.md +161 -161
- package/runtime/rpas/captcha_handoff/manifest.json +27 -27
- package/runtime/rpas/captcha_handoff/run.robot +16 -16
- package/runtime/rpas/captcha_handoff/workflow.py +11 -11
- package/runtime/rpas/common.resource +26 -26
- package/runtime/rpas/debian_update/manifest.json +27 -27
- package/runtime/rpas/debian_update/run.robot +17 -17
- package/runtime/rpas/debian_update/workflow.py +13 -13
- package/runtime/rpas/desktop_control/manifest.json +26 -26
- package/runtime/rpas/desktop_control/run.robot +27 -27
- package/runtime/rpas/desktop_control/workflow.py +51 -51
- package/runtime/rpas/firefox_launch/manifest.json +27 -27
- package/runtime/rpas/firefox_launch/run.robot +15 -15
- package/runtime/rpas/firefox_launch/workflow.py +25 -25
- package/runtime/rpas/firefox_naver/manifest.json +27 -27
- package/runtime/rpas/firefox_naver/run.robot +21 -21
- package/runtime/rpas/firefox_naver/workflow.py +28 -28
- package/runtime/rpas/kvm_validation/README.md +11 -11
- package/runtime/rpas/kvm_validation/manifest.json +28 -28
- package/runtime/rpas/kvm_validation/run.robot +30 -30
- package/runtime/rpas/kvm_validation/workflow.py +91 -91
- package/runtime/rpas/manifest.schema.json +105 -105
- package/runtime/rpas/naver_login/login.robot +25 -25
- package/runtime/rpas/naver_login/manifest.json +33 -33
- package/runtime/rpas/naver_login/run.robot +20 -20
- package/runtime/rpas/naver_login/workflow.py +32 -32
- package/runtime/rpas/windows_naver_recorded/README.md +24 -24
- package/runtime/rpas/windows_naver_recorded/conversion.json +25 -25
- package/runtime/rpas/windows_naver_recorded/manifest.json +28 -28
- package/runtime/rpas/windows_naver_recorded/run.robot +37 -37
- package/runtime/rpas/windows_naver_recorded/workflow.py +32 -32
- package/runtime/scripts/build_recorder_media.py +39 -39
- package/runtime/scripts/macos/setup-host.sh +0 -0
- package/runtime/scripts/script_server.py +571 -517
- package/runtime/skills/vamp-rpa-ui-checks/SKILL.md +26 -0
- package/runtime/skills/vamp-rpa-ui-checks/agents/openai.yaml +4 -0
- package/runtime/skills/vamp-rpa-ui-checks/references/display.md +12 -0
- package/runtime/skills/vamp-rpa-ui-checks/references/user-guide.md +49 -0
- package/runtime/skills/vamp-ui-cleanup/SKILL.md +15 -0
- package/runtime/skills/vamp-ui-cleanup/agents/openai.yaml +4 -0
- package/runtime/skills/vamp-ui-validation/SKILL.md +27 -0
- package/runtime/skills/vamp-ui-validation/agents/openai.yaml +4 -0
- package/runtime/third_party/mcp-virtualbox/scripts/mouse_click.py +65 -65
- package/runtime/third_party/pyautogui-recorder/LICENSE +674 -674
- package/runtime/third_party/pyautogui-recorder/PROVENANCE.json +16 -16
- package/runtime/third_party/pyautogui-recorder/PyAutoGuiRecorder.py +169 -169
- package/runtime/third_party/pyautogui-recorder/README.md +53 -53
package/runtime/rpas/README.md
CHANGED
|
@@ -1,161 +1,161 @@
|
|
|
1
|
-
# RPA 패키지 규격 v1
|
|
2
|
-
|
|
3
|
-
이 패키지는 AI가 같은 GUI 작업의 세부 구현을 매번 다시 읽지 않고, 작업 ID와 입력값으로 호출할 수 있도록 묶은 실행 단위입니다. 네이버 로그인 페이지를 여는 수동 기록 예시는 [워크플로 재사용](../docs/WORKFLOWS.md)에 있습니다. 결과 요약을 먼저 읽고 필요할 때 Robot 로그·OCR·스크린샷을 확인합니다.
|
|
4
|
-
|
|
5
|
-
실제 시험한 호스트는 Ubuntu + NVIDIA이며 설치는 [호스트와 가속기 프로필](../docs/INSTALL.md)을 참고하세요.
|
|
6
|
-
|
|
7
|
-
게스트 대상은 Debian(`debian13`)과 Windows 11(`windows-RPA`)로 구분하고 둘 다 1920×1080 기준을 사용합니다. 동일 해상도가 동일 좌표·UI를 보장하지는 않습니다. GNOME Firefox 기동·로그인 준비와 apt update 예시는 Debian용입니다. Windows 수동 기록의 로그인 화면 도달 예시는 별도로 검증했습니다. 패키지 선택과 호스트 GPU/NPU 프로필 선택은 별개입니다.
|
|
8
|
-
|
|
9
|
-
RPA 한 개를 폴더 하나로 관리합니다. 각 폴더에는 하나 이상의 `.robot` 실행 파일, RPA 전용 Python 라이브러리, 실행 메타데이터가 들어갑니다. Robot Framework의 표준 확장자는 `.robot`입니다.
|
|
10
|
-
|
|
11
|
-
```text
|
|
12
|
-
rpas/
|
|
13
|
-
├── common.resource # SPICE 연결·종료, 결과·사용자 인계 공통 키워드
|
|
14
|
-
├── manifest.schema.json # manifest 형식
|
|
15
|
-
├── naver_login/
|
|
16
|
-
│ ├── manifest.json
|
|
17
|
-
│ ├── run.robot # 로그인 화면 검출만
|
|
18
|
-
│ ├── login.robot # 검출 → 계정 입력 → 제출 → 결과 확인
|
|
19
|
-
│ └── workflow.py # 이 RPA의 Python 키워드
|
|
20
|
-
└── debian_update/
|
|
21
|
-
├── manifest.json
|
|
22
|
-
├── run.robot # root apt update → 결과 확인
|
|
23
|
-
└── workflow.py
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
`.robot`에는 작업 순서, 분기, 확인 조건을 적습니다. `workflow.py`는 좌표·입력·OCR·YOLO와 해당 RPA의 세부 동작을 처리합니다. 공통 엔진인 `spice_robot.py`, `vision.py`, `login_flow.py`, `vm_update.py` 등은 저장소 루트에서 공유합니다. 패키지 폴더만 복사한 독립 실행은 지원하지 않으므로 공유할 때는 공통 엔진과 의존성도 함께 제공해야 합니다.
|
|
27
|
-
|
|
28
|
-
## 제공 패키지
|
|
29
|
-
|
|
30
|
-
| ID | 기본 진입점 | 동작 |
|
|
31
|
-
| --- | --- | --- |
|
|
32
|
-
| `firefox_launch` | `run.robot` | Firefox 실행·OCR 확인 |
|
|
33
|
-
| `firefox_naver` | `run.robot` | Firefox 실행·네이버 접속·OCR 확인 |
|
|
34
|
-
| `naver_login` | `run.robot` | 로그인 폼 검출까지만 수행 |
|
|
35
|
-
| `naver_login` | `login.robot` | 자격 증명을 받아 로그인 제출 |
|
|
36
|
-
| `debian_update` | `run.robot` | root apt update·OCR 결과 판정 |
|
|
37
|
-
| `captcha_handoff` | `run.robot` | 현재 화면 인증 문구 확인·사용자 인계 |
|
|
38
|
-
| `desktop_control` | `run.robot` | 화면 캡처·OCR·YOLO·키보드·마우스 작업 한 개 |
|
|
39
|
-
|
|
40
|
-
## 실행
|
|
41
|
-
|
|
42
|
-
저장소 루트에서 `.venv` Python으로 실행합니다. `run_rpa.py`는 manifest에서 **하나의 Robot 진입점만 선택**합니다. 작업 구현은 해당 Robot 파일과 Python 라이브러리에 있습니다.
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
cd /home/ssh1032007/spice_kvm_based_rpa
|
|
46
|
-
.venv/bin/python scripts/run_rpa.py --list
|
|
47
|
-
.venv/bin/python scripts/run_rpa.py firefox_launch
|
|
48
|
-
.venv/bin/python scripts/run_rpa.py firefox_naver
|
|
49
|
-
.venv/bin/python scripts/run_rpa.py debian_update
|
|
50
|
-
|
|
51
|
-
# 로그인 폼 검출만: 자격 증명을 입력하거나 제출하지 않음
|
|
52
|
-
.venv/bin/python scripts/run_rpa.py naver_login
|
|
53
|
-
|
|
54
|
-
# 실제 제출: 호스트 비공개 입력창/getpass 사용
|
|
55
|
-
.venv/bin/python scripts/run_rpa.py naver_login --entry login --var CREDENTIAL_SOURCE:prompt
|
|
56
|
-
|
|
57
|
-
# NAVER_ID/NAVER_PASSWORD가 실행 환경에 이미 제공된 경우
|
|
58
|
-
.venv/bin/python scripts/run_rpa.py naver_login --entry login
|
|
59
|
-
|
|
60
|
-
# 현재 화면만 검사. 사용자의 CAPTCHA 진행 상태를 보존
|
|
61
|
-
.venv/bin/python scripts/run_rpa.py captcha_handoff
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
한 번에 한 명령씩 실행하세요. `robot rpas`처럼 폴더 전체를 일반 실행하면 apt update와 로그인 제출 진입점도 순서대로 실행될 수 있으므로, 전체 폴더 검사는 아래의 `--dryrun`으로 수행하세요.
|
|
65
|
-
|
|
66
|
-
표준 Robot 명령으로 직접 실행할 수도 있습니다.
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
.venv/bin/python -m robot --outputdir artifacts/rpas/debian_update rpas/debian_update/run.robot
|
|
70
|
-
.venv/bin/python -m robot --variable CREDENTIAL_SOURCE:prompt --outputdir artifacts/rpas/naver_login rpas/naver_login/login.robot
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
다른 SPICE 주소는 `--var SPICE_URI:spice://127.0.0.1:5901`로 전달합니다. Debian 업데이트는 `--var VM_CONFIG:config/my-sandbox-vm.json`도 지정해 설정 파일의 URI를 맞춰야 합니다.
|
|
74
|
-
|
|
75
|
-
## 화면·입력 RPA
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
# 기본은 화면 캡처 한 번
|
|
79
|
-
.venv/bin/python scripts/run_rpa.py desktop_control
|
|
80
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:screen-info
|
|
81
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:ocr --var LANGUAGES:ko,en,ja,zh
|
|
82
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:analyze
|
|
83
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:hotkey --var KEYS:ctrl+l
|
|
84
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:write --var TEXT:about:blank
|
|
85
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:hotkey --var KEYS:enter
|
|
86
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:click --var X:800 --var Y:500
|
|
87
|
-
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:click-text --var TEXT:확인
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
YOLO `DEVICE`는 `cpu`, `auto`, `rocm`, `mps`, `ascend-npu`, `intel-npu` 등을 받습니다. AMD·Apple·NPU 경로는 미검증입니다.
|
|
91
|
-
|
|
92
|
-
추가 ACTION: `move`, `move-relative`(`DX`, `DY`), `detect`, `find-image`, `click-image`(`TEMPLATE`). 절대 좌표는 게스트 원본 화면 기준입니다. 상대 이동은 SERVER 모드에서만 가능합니다. 일반 `write`에 개인 비밀번호를 넘기면 Robot 인자 로그에 남으므로 계정 입력에는 전용 로그인 진입점을 사용하세요.
|
|
93
|
-
|
|
94
|
-
## 공통 결과
|
|
95
|
-
|
|
96
|
-
기본 출력 폴더는 `artifacts/rpas/<id>/`입니다. `--output <폴더>`로 변경할 수 있습니다.
|
|
97
|
-
|
|
98
|
-
```json
|
|
99
|
-
{
|
|
100
|
-
"schema_version": 1,
|
|
101
|
-
"rpa_id": "debian_update",
|
|
102
|
-
"status": "succeeded",
|
|
103
|
-
"verification": "ocr_only",
|
|
104
|
-
"root_verified": true,
|
|
105
|
-
"root_shell_exited": true,
|
|
106
|
-
"details_path": ".../update/result.json"
|
|
107
|
-
}
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
- `summary.json`: AI와 호출자가 읽는 짧은 결과. `status`가 실제 작업 상태입니다.
|
|
111
|
-
- `log.html`, `report.html`, `output.xml`: Robot 실행·검증 기록.
|
|
112
|
-
- 화면·OCR 상세 자료: 해당 실행 폴더 아래 저장. Debian 업데이트는 `update/`, 로그인 폼 검출은 `login/`에 저장.
|
|
113
|
-
- 실패 시 `error_summary`는 최대 300자로 제한합니다. Robot 검증이 실패하면 `execution_status: failed`도 기록합니다.
|
|
114
|
-
|
|
115
|
-
`executed`는 입력을 전송했다는 뜻이며 목표 화면 도달을 보장하지 않습니다. `observed`, `captured`, `analyzed`, `detected`, `found`도 각 관찰 동작의 완료 상태입니다. `needs_credentials`는 계정 입력 대기, `needs_user_captcha`/`needs_user_verification`은 사용자 인계입니다. CAPTCHA 인계 시 Robot 작업은 SKIP으로 종료해 사용자 조작을 기다립니다. `no_challenge_text`만으로 인증 통과나 로그인 성공을 주장하지 않습니다.
|
|
116
|
-
|
|
117
|
-
실제 로그인은 `logged_in`을 확인해야 합니다. Debian 업데이트는 `succeeded`일 때만 Robot PASS입니다. 연결·import 문제로 실행이 시작되지 못하면 Robot 로그도 확인하세요. 같은 출력 폴더를 재사용하면 이전 결과를 덮어씁니다.
|
|
118
|
-
|
|
119
|
-
## 새 RPA 추가 규칙
|
|
120
|
-
|
|
121
|
-
1. `rpas/<영문_snake_case_ID>/`를 만듭니다.
|
|
122
|
-
2. `manifest.json`에 ID, 버전, 기본 진입점, 각 Robot 파일, Python 라이브러리, 의존성, 연결 스킬을 선언합니다. 자격 증명 제출 진입점은 별도 이름으로 분리합니다.
|
|
123
|
-
3. `run.robot`에서 `../common.resource`와 전용 `workflow.py`를 import합니다. `Start RPA`, `Stop RPA`, `Finish RPA Task`를 기존 패키지처럼 사용합니다.
|
|
124
|
-
4. Python 키워드에서 세부 동작을 수행하고, Robot 파일에서 결과를 검증합니다. `Contract.Publish Result`로 짧은 결과를 발행합니다.
|
|
125
|
-
5. 해당 스킬의 `SKILL.md`에 패키지·Robot·Python 경로와 실행 명령을 함께 명시합니다.
|
|
126
|
-
|
|
127
|
-
```bash
|
|
128
|
-
.venv/bin/python scripts/validate_rpas.py
|
|
129
|
-
.venv/bin/python scripts/run_rpa.py debian_update --dryrun
|
|
130
|
-
.venv/bin/python -m robot --dryrun --outputdir artifacts/rpa-packages-dryrun rpas
|
|
131
|
-
.venv/bin/python -m unittest discover -s tests -v
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
파일 검증 스크립트는 패키지 ID, 기본 진입점, 파일 경계·존재 여부, 자격 증명 유형과 출력 규약을 검사합니다. `manifest.schema.json`도 제공하므로 외부 도구에서 JSON Schema 검증을 추가할 수 있습니다. dry-run은 VM을 조작하지 않으며, 실제 작업 성공의 증거는 아닙니다. 표준 실행기의 dry-run 기본 출력은 `artifacts/rpas-dryrun/<id>/`로 분리해 실제 실행 기록을 덮어쓰지 않습니다.
|
|
135
|
-
|
|
136
|
-
## 녹화 확장 지점
|
|
137
|
-
|
|
138
|
-
Robot의 작업·키워드 시작/종료 경계를 녹화 시작·종료나 타임스탬프 기록에 연결할 수 있도록 실행 진입점을 통일했습니다.
|
|
139
|
-
|
|
140
|
-
```bash
|
|
141
|
-
.venv/bin/python scripts/run_rpa.py firefox_launch --listener my_recorder.py
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
`--listener`에는 사용자가 구현·설치한 Robot listener를 전달합니다. 수동 PyAutoGUI 기록의 SPICE 변환은 [변환기](../docs/RECORDING_CONVERSION.md), VirtualBox 실행 영상은 [RecordingListener](../docs/EXECUTION_HISTORY.md)를 사용합니다. 임의의 CUA 기록 자동 변환과 SPICE 자체 영상 Listener는 아직 없습니다. Python 내부의 세부 동작을 별도 타임라인으로 남기려면 해당 라이브러리에도 계측을 추가해야 합니다. SPICE 영상 녹화는 기존 세션의 화면을 재사용해야 하며, 별도 SPICE 클라이언트 연결은 제어 연결을 대체할 수 있습니다. 개인 계정 입력 구간은 녹화·자동 캡처 대상에서 제외하세요.
|
|
145
|
-
|
|
146
|
-
[Robot listener 공식 문서](https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#listener-interface)
|
|
147
|
-
|
|
148
|
-
## AI로 실패한 RPA 보정
|
|
149
|
-
|
|
150
|
-
`$spice-rpa-repair`는 대상 패키지의 Robot 진입점과 Python 라이브러리를 유지하면서 좌표·OCR 앵커·타이밍을 보정하는 개발 스킬입니다. [SKILL.md](../.agents/skills/spice-rpa-repair/SKILL.md)를 따릅니다. 먼저 `summary.json`과 실패 키워드를 확인하고, UI 변화가 확인된 경우에만 새 OCR·YOLO 근거로 수정합니다. 시스템 오류나 인증 대기를 좌표 문제로 취급하지 않습니다.
|
|
151
|
-
|
|
152
|
-
보정은 최대 2회 시도하며, 테스트·dry-run 결과와 실제 VM 재검증 여부를 별도로 기록합니다. 기존 성공 검증을 제거하거나 CAPTCHA를 풀지 않습니다. 자세한 명령은 [SPICE 실행 가이드](../docs/SPICE_GUIDE.md#실패한-rpa의-ai-보정)에 있습니다.
|
|
153
|
-
|
|
154
|
-
## 사용자가 직접 만들거나 Recorder로 가져오기
|
|
155
|
-
|
|
156
|
-
- 빈 RPA 틀: `.venv/bin/python scripts/new_rpa.py my_task --guest-os windows11`
|
|
157
|
-
- 코드 기록 변환: `.venv/bin/python scripts/convert_recording.py ~/naver_login_rpa --id my_recorded_task --guest-os windows11`
|
|
158
|
-
- [전체 설명](../docs/RECORDING_CONVERSION.md) 및 `$spice-recording-convert` 스킬을 제공합니다.
|
|
159
|
-
- 공유: 검토한 패키지는 [VAMP Script Hub](https://wayfarer6.github.io/vamp-script-hub/)에 올려 다른 사용자가 입력값만 바꿔 재사용하게 할 수 있습니다. **Export ZIP** 결과를 `scripts/<id>/`로 넣어 풀 리퀘스트를 열거나, 사이트의 제출 이슈를 사용하세요. 사본은 [`docs/hub/`](../docs/hub/)에 있습니다.
|
|
160
|
-
|
|
161
|
-
Windows는 Win+R, Debian GNOME은 Alt+F2 같은 공통 실행기를 사용하고 바탕화면 아이콘 시작은 피합니다. 생성기는 기존 폴더를 덮어쓰지 않습니다. 기본 상태는 검토/구현 대기로, VM에 입력하지 않습니다. 원시 `recording.local.json`은 Git에 포함되지 않으므로 공유받은 쪽에서는 재생성하거나 정리된 동작을 작성해야 합니다.
|
|
1
|
+
# RPA 패키지 규격 v1
|
|
2
|
+
|
|
3
|
+
이 패키지는 AI가 같은 GUI 작업의 세부 구현을 매번 다시 읽지 않고, 작업 ID와 입력값으로 호출할 수 있도록 묶은 실행 단위입니다. 네이버 로그인 페이지를 여는 수동 기록 예시는 [워크플로 재사용](../docs/WORKFLOWS.md)에 있습니다. 결과 요약을 먼저 읽고 필요할 때 Robot 로그·OCR·스크린샷을 확인합니다.
|
|
4
|
+
|
|
5
|
+
실제 시험한 호스트는 Ubuntu + NVIDIA이며 설치는 [호스트와 가속기 프로필](../docs/INSTALL.md)을 참고하세요.
|
|
6
|
+
|
|
7
|
+
게스트 대상은 Debian(`debian13`)과 Windows 11(`windows-RPA`)로 구분하고 둘 다 1920×1080 기준을 사용합니다. 동일 해상도가 동일 좌표·UI를 보장하지는 않습니다. GNOME Firefox 기동·로그인 준비와 apt update 예시는 Debian용입니다. Windows 수동 기록의 로그인 화면 도달 예시는 별도로 검증했습니다. 패키지 선택과 호스트 GPU/NPU 프로필 선택은 별개입니다.
|
|
8
|
+
|
|
9
|
+
RPA 한 개를 폴더 하나로 관리합니다. 각 폴더에는 하나 이상의 `.robot` 실행 파일, RPA 전용 Python 라이브러리, 실행 메타데이터가 들어갑니다. Robot Framework의 표준 확장자는 `.robot`입니다.
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
rpas/
|
|
13
|
+
├── common.resource # SPICE 연결·종료, 결과·사용자 인계 공통 키워드
|
|
14
|
+
├── manifest.schema.json # manifest 형식
|
|
15
|
+
├── naver_login/
|
|
16
|
+
│ ├── manifest.json
|
|
17
|
+
│ ├── run.robot # 로그인 화면 검출만
|
|
18
|
+
│ ├── login.robot # 검출 → 계정 입력 → 제출 → 결과 확인
|
|
19
|
+
│ └── workflow.py # 이 RPA의 Python 키워드
|
|
20
|
+
└── debian_update/
|
|
21
|
+
├── manifest.json
|
|
22
|
+
├── run.robot # root apt update → 결과 확인
|
|
23
|
+
└── workflow.py
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
`.robot`에는 작업 순서, 분기, 확인 조건을 적습니다. `workflow.py`는 좌표·입력·OCR·YOLO와 해당 RPA의 세부 동작을 처리합니다. 공통 엔진인 `spice_robot.py`, `vision.py`, `login_flow.py`, `vm_update.py` 등은 저장소 루트에서 공유합니다. 패키지 폴더만 복사한 독립 실행은 지원하지 않으므로 공유할 때는 공통 엔진과 의존성도 함께 제공해야 합니다.
|
|
27
|
+
|
|
28
|
+
## 제공 패키지
|
|
29
|
+
|
|
30
|
+
| ID | 기본 진입점 | 동작 |
|
|
31
|
+
| --- | --- | --- |
|
|
32
|
+
| `firefox_launch` | `run.robot` | Firefox 실행·OCR 확인 |
|
|
33
|
+
| `firefox_naver` | `run.robot` | Firefox 실행·네이버 접속·OCR 확인 |
|
|
34
|
+
| `naver_login` | `run.robot` | 로그인 폼 검출까지만 수행 |
|
|
35
|
+
| `naver_login` | `login.robot` | 자격 증명을 받아 로그인 제출 |
|
|
36
|
+
| `debian_update` | `run.robot` | root apt update·OCR 결과 판정 |
|
|
37
|
+
| `captcha_handoff` | `run.robot` | 현재 화면 인증 문구 확인·사용자 인계 |
|
|
38
|
+
| `desktop_control` | `run.robot` | 화면 캡처·OCR·YOLO·키보드·마우스 작업 한 개 |
|
|
39
|
+
|
|
40
|
+
## 실행
|
|
41
|
+
|
|
42
|
+
저장소 루트에서 `.venv` Python으로 실행합니다. `run_rpa.py`는 manifest에서 **하나의 Robot 진입점만 선택**합니다. 작업 구현은 해당 Robot 파일과 Python 라이브러리에 있습니다.
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
cd /home/ssh1032007/spice_kvm_based_rpa
|
|
46
|
+
.venv/bin/python scripts/run_rpa.py --list
|
|
47
|
+
.venv/bin/python scripts/run_rpa.py firefox_launch
|
|
48
|
+
.venv/bin/python scripts/run_rpa.py firefox_naver
|
|
49
|
+
.venv/bin/python scripts/run_rpa.py debian_update
|
|
50
|
+
|
|
51
|
+
# 로그인 폼 검출만: 자격 증명을 입력하거나 제출하지 않음
|
|
52
|
+
.venv/bin/python scripts/run_rpa.py naver_login
|
|
53
|
+
|
|
54
|
+
# 실제 제출: 호스트 비공개 입력창/getpass 사용
|
|
55
|
+
.venv/bin/python scripts/run_rpa.py naver_login --entry login --var CREDENTIAL_SOURCE:prompt
|
|
56
|
+
|
|
57
|
+
# NAVER_ID/NAVER_PASSWORD가 실행 환경에 이미 제공된 경우
|
|
58
|
+
.venv/bin/python scripts/run_rpa.py naver_login --entry login
|
|
59
|
+
|
|
60
|
+
# 현재 화면만 검사. 사용자의 CAPTCHA 진행 상태를 보존
|
|
61
|
+
.venv/bin/python scripts/run_rpa.py captcha_handoff
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
한 번에 한 명령씩 실행하세요. `robot rpas`처럼 폴더 전체를 일반 실행하면 apt update와 로그인 제출 진입점도 순서대로 실행될 수 있으므로, 전체 폴더 검사는 아래의 `--dryrun`으로 수행하세요.
|
|
65
|
+
|
|
66
|
+
표준 Robot 명령으로 직접 실행할 수도 있습니다.
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
.venv/bin/python -m robot --outputdir artifacts/rpas/debian_update rpas/debian_update/run.robot
|
|
70
|
+
.venv/bin/python -m robot --variable CREDENTIAL_SOURCE:prompt --outputdir artifacts/rpas/naver_login rpas/naver_login/login.robot
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
다른 SPICE 주소는 `--var SPICE_URI:spice://127.0.0.1:5901`로 전달합니다. Debian 업데이트는 `--var VM_CONFIG:config/my-sandbox-vm.json`도 지정해 설정 파일의 URI를 맞춰야 합니다.
|
|
74
|
+
|
|
75
|
+
## 화면·입력 RPA
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
# 기본은 화면 캡처 한 번
|
|
79
|
+
.venv/bin/python scripts/run_rpa.py desktop_control
|
|
80
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:screen-info
|
|
81
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:ocr --var LANGUAGES:ko,en,ja,zh
|
|
82
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:analyze
|
|
83
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:hotkey --var KEYS:ctrl+l
|
|
84
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:write --var TEXT:about:blank
|
|
85
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:hotkey --var KEYS:enter
|
|
86
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:click --var X:800 --var Y:500
|
|
87
|
+
.venv/bin/python scripts/run_rpa.py desktop_control --var ACTION:click-text --var TEXT:확인
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
YOLO `DEVICE`는 `cpu`, `auto`, `rocm`, `mps`, `ascend-npu`, `intel-npu` 등을 받습니다. AMD·Apple·NPU 경로는 미검증입니다.
|
|
91
|
+
|
|
92
|
+
추가 ACTION: `move`, `move-relative`(`DX`, `DY`), `detect`, `find-image`, `click-image`(`TEMPLATE`). 절대 좌표는 게스트 원본 화면 기준입니다. 상대 이동은 SERVER 모드에서만 가능합니다. 일반 `write`에 개인 비밀번호를 넘기면 Robot 인자 로그에 남으므로 계정 입력에는 전용 로그인 진입점을 사용하세요.
|
|
93
|
+
|
|
94
|
+
## 공통 결과
|
|
95
|
+
|
|
96
|
+
기본 출력 폴더는 `artifacts/rpas/<id>/`입니다. `--output <폴더>`로 변경할 수 있습니다.
|
|
97
|
+
|
|
98
|
+
```json
|
|
99
|
+
{
|
|
100
|
+
"schema_version": 1,
|
|
101
|
+
"rpa_id": "debian_update",
|
|
102
|
+
"status": "succeeded",
|
|
103
|
+
"verification": "ocr_only",
|
|
104
|
+
"root_verified": true,
|
|
105
|
+
"root_shell_exited": true,
|
|
106
|
+
"details_path": ".../update/result.json"
|
|
107
|
+
}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
- `summary.json`: AI와 호출자가 읽는 짧은 결과. `status`가 실제 작업 상태입니다.
|
|
111
|
+
- `log.html`, `report.html`, `output.xml`: Robot 실행·검증 기록.
|
|
112
|
+
- 화면·OCR 상세 자료: 해당 실행 폴더 아래 저장. Debian 업데이트는 `update/`, 로그인 폼 검출은 `login/`에 저장.
|
|
113
|
+
- 실패 시 `error_summary`는 최대 300자로 제한합니다. Robot 검증이 실패하면 `execution_status: failed`도 기록합니다.
|
|
114
|
+
|
|
115
|
+
`executed`는 입력을 전송했다는 뜻이며 목표 화면 도달을 보장하지 않습니다. `observed`, `captured`, `analyzed`, `detected`, `found`도 각 관찰 동작의 완료 상태입니다. `needs_credentials`는 계정 입력 대기, `needs_user_captcha`/`needs_user_verification`은 사용자 인계입니다. CAPTCHA 인계 시 Robot 작업은 SKIP으로 종료해 사용자 조작을 기다립니다. `no_challenge_text`만으로 인증 통과나 로그인 성공을 주장하지 않습니다.
|
|
116
|
+
|
|
117
|
+
실제 로그인은 `logged_in`을 확인해야 합니다. Debian 업데이트는 `succeeded`일 때만 Robot PASS입니다. 연결·import 문제로 실행이 시작되지 못하면 Robot 로그도 확인하세요. 같은 출력 폴더를 재사용하면 이전 결과를 덮어씁니다.
|
|
118
|
+
|
|
119
|
+
## 새 RPA 추가 규칙
|
|
120
|
+
|
|
121
|
+
1. `rpas/<영문_snake_case_ID>/`를 만듭니다.
|
|
122
|
+
2. `manifest.json`에 ID, 버전, 기본 진입점, 각 Robot 파일, Python 라이브러리, 의존성, 연결 스킬을 선언합니다. 자격 증명 제출 진입점은 별도 이름으로 분리합니다.
|
|
123
|
+
3. `run.robot`에서 `../common.resource`와 전용 `workflow.py`를 import합니다. `Start RPA`, `Stop RPA`, `Finish RPA Task`를 기존 패키지처럼 사용합니다.
|
|
124
|
+
4. Python 키워드에서 세부 동작을 수행하고, Robot 파일에서 결과를 검증합니다. `Contract.Publish Result`로 짧은 결과를 발행합니다.
|
|
125
|
+
5. 해당 스킬의 `SKILL.md`에 패키지·Robot·Python 경로와 실행 명령을 함께 명시합니다.
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
.venv/bin/python scripts/validate_rpas.py
|
|
129
|
+
.venv/bin/python scripts/run_rpa.py debian_update --dryrun
|
|
130
|
+
.venv/bin/python -m robot --dryrun --outputdir artifacts/rpa-packages-dryrun rpas
|
|
131
|
+
.venv/bin/python -m unittest discover -s tests -v
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
파일 검증 스크립트는 패키지 ID, 기본 진입점, 파일 경계·존재 여부, 자격 증명 유형과 출력 규약을 검사합니다. `manifest.schema.json`도 제공하므로 외부 도구에서 JSON Schema 검증을 추가할 수 있습니다. dry-run은 VM을 조작하지 않으며, 실제 작업 성공의 증거는 아닙니다. 표준 실행기의 dry-run 기본 출력은 `artifacts/rpas-dryrun/<id>/`로 분리해 실제 실행 기록을 덮어쓰지 않습니다.
|
|
135
|
+
|
|
136
|
+
## 녹화 확장 지점
|
|
137
|
+
|
|
138
|
+
Robot의 작업·키워드 시작/종료 경계를 녹화 시작·종료나 타임스탬프 기록에 연결할 수 있도록 실행 진입점을 통일했습니다.
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
.venv/bin/python scripts/run_rpa.py firefox_launch --listener my_recorder.py
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
`--listener`에는 사용자가 구현·설치한 Robot listener를 전달합니다. 수동 PyAutoGUI 기록의 SPICE 변환은 [변환기](../docs/RECORDING_CONVERSION.md), VirtualBox 실행 영상은 [RecordingListener](../docs/EXECUTION_HISTORY.md)를 사용합니다. 임의의 CUA 기록 자동 변환과 SPICE 자체 영상 Listener는 아직 없습니다. Python 내부의 세부 동작을 별도 타임라인으로 남기려면 해당 라이브러리에도 계측을 추가해야 합니다. SPICE 영상 녹화는 기존 세션의 화면을 재사용해야 하며, 별도 SPICE 클라이언트 연결은 제어 연결을 대체할 수 있습니다. 개인 계정 입력 구간은 녹화·자동 캡처 대상에서 제외하세요.
|
|
145
|
+
|
|
146
|
+
[Robot listener 공식 문서](https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#listener-interface)
|
|
147
|
+
|
|
148
|
+
## AI로 실패한 RPA 보정
|
|
149
|
+
|
|
150
|
+
`$spice-rpa-repair`는 대상 패키지의 Robot 진입점과 Python 라이브러리를 유지하면서 좌표·OCR 앵커·타이밍을 보정하는 개발 스킬입니다. [SKILL.md](../.agents/skills/spice-rpa-repair/SKILL.md)를 따릅니다. 먼저 `summary.json`과 실패 키워드를 확인하고, UI 변화가 확인된 경우에만 새 OCR·YOLO 근거로 수정합니다. 시스템 오류나 인증 대기를 좌표 문제로 취급하지 않습니다.
|
|
151
|
+
|
|
152
|
+
보정은 최대 2회 시도하며, 테스트·dry-run 결과와 실제 VM 재검증 여부를 별도로 기록합니다. 기존 성공 검증을 제거하거나 CAPTCHA를 풀지 않습니다. 자세한 명령은 [SPICE 실행 가이드](../docs/SPICE_GUIDE.md#실패한-rpa의-ai-보정)에 있습니다.
|
|
153
|
+
|
|
154
|
+
## 사용자가 직접 만들거나 Recorder로 가져오기
|
|
155
|
+
|
|
156
|
+
- 빈 RPA 틀: `.venv/bin/python scripts/new_rpa.py my_task --guest-os windows11`
|
|
157
|
+
- 코드 기록 변환: `.venv/bin/python scripts/convert_recording.py ~/naver_login_rpa --id my_recorded_task --guest-os windows11`
|
|
158
|
+
- [전체 설명](../docs/RECORDING_CONVERSION.md) 및 `$spice-recording-convert` 스킬을 제공합니다.
|
|
159
|
+
- 공유: 검토한 패키지는 [VAMP Script Hub](https://wayfarer6.github.io/vamp-script-hub/)에 올려 다른 사용자가 입력값만 바꿔 재사용하게 할 수 있습니다. **Export ZIP** 결과를 `scripts/<id>/`로 넣어 풀 리퀘스트를 열거나, 사이트의 제출 이슈를 사용하세요. 사본은 [`docs/hub/`](../docs/hub/)에 있습니다.
|
|
160
|
+
|
|
161
|
+
Windows는 Win+R, Debian GNOME은 Alt+F2 같은 공통 실행기를 사용하고 바탕화면 아이콘 시작은 피합니다. 생성기는 기존 폴더를 덮어쓰지 않습니다. 기본 상태는 검토/구현 대기로, VM에 입력하지 않습니다. 원시 `recording.local.json`은 Git에 포함되지 않으므로 공유받은 쪽에서는 재생성하거나 정리된 동작을 작성해야 합니다.
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
{
|
|
2
|
-
"format_version": 1,
|
|
3
|
-
"id": "captcha_handoff",
|
|
4
|
-
"name": "CAPTCHA 사용자 인계",
|
|
5
|
-
"version": "1.0.0",
|
|
6
|
-
"default_entrypoint": "run",
|
|
7
|
-
"entrypoints": [
|
|
8
|
-
{
|
|
9
|
-
"name": "run",
|
|
10
|
-
"file": "run.robot",
|
|
11
|
-
"credentials": "none"
|
|
12
|
-
}
|
|
13
|
-
],
|
|
14
|
-
"python_libraries": [
|
|
15
|
-
"workflow.py"
|
|
16
|
-
],
|
|
17
|
-
"dependencies": [
|
|
18
|
-
"spice",
|
|
19
|
-
"paddleocr"
|
|
20
|
-
],
|
|
21
|
-
"skill": "spice-captcha-handoff",
|
|
22
|
-
"outputs": {
|
|
23
|
-
"summary": "${OUTPUT DIR}/summary.json",
|
|
24
|
-
"robot_log": "${OUTPUT DIR}/log.html",
|
|
25
|
-
"robot_report": "${OUTPUT DIR}/report.html"
|
|
26
|
-
}
|
|
27
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"format_version": 1,
|
|
3
|
+
"id": "captcha_handoff",
|
|
4
|
+
"name": "CAPTCHA 사용자 인계",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"default_entrypoint": "run",
|
|
7
|
+
"entrypoints": [
|
|
8
|
+
{
|
|
9
|
+
"name": "run",
|
|
10
|
+
"file": "run.robot",
|
|
11
|
+
"credentials": "none"
|
|
12
|
+
}
|
|
13
|
+
],
|
|
14
|
+
"python_libraries": [
|
|
15
|
+
"workflow.py"
|
|
16
|
+
],
|
|
17
|
+
"dependencies": [
|
|
18
|
+
"spice",
|
|
19
|
+
"paddleocr"
|
|
20
|
+
],
|
|
21
|
+
"skill": "spice-captcha-handoff",
|
|
22
|
+
"outputs": {
|
|
23
|
+
"summary": "${OUTPUT DIR}/summary.json",
|
|
24
|
+
"robot_log": "${OUTPUT DIR}/log.html",
|
|
25
|
+
"robot_report": "${OUTPUT DIR}/report.html"
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
*** Settings ***
|
|
2
|
-
Resource ${CURDIR}/../common.resource
|
|
3
|
-
Library ${CURDIR}/workflow.py WITH NAME Workflow
|
|
4
|
-
Suite Setup Start RPA
|
|
5
|
-
Suite Teardown Stop RPA
|
|
6
|
-
Task Teardown Finish RPA Task
|
|
7
|
-
|
|
8
|
-
*** Variables ***
|
|
9
|
-
${RPA_ID} captcha_handoff
|
|
10
|
-
${LANGUAGES} ko,en,ja,zh
|
|
11
|
-
|
|
12
|
-
*** Tasks ***
|
|
13
|
-
Inspect Current Verification Screen
|
|
14
|
-
${result}= Workflow.Inspect Challenge ${LANGUAGES}
|
|
15
|
-
Contract.Publish Result ${result}
|
|
16
|
-
Pause For User Verification ${result}
|
|
1
|
+
*** Settings ***
|
|
2
|
+
Resource ${CURDIR}/../common.resource
|
|
3
|
+
Library ${CURDIR}/workflow.py WITH NAME Workflow
|
|
4
|
+
Suite Setup Start RPA
|
|
5
|
+
Suite Teardown Stop RPA
|
|
6
|
+
Task Teardown Finish RPA Task
|
|
7
|
+
|
|
8
|
+
*** Variables ***
|
|
9
|
+
${RPA_ID} captcha_handoff
|
|
10
|
+
${LANGUAGES} ko,en,ja,zh
|
|
11
|
+
|
|
12
|
+
*** Tasks ***
|
|
13
|
+
Inspect Current Verification Screen
|
|
14
|
+
${result}= Workflow.Inspect Challenge ${LANGUAGES}
|
|
15
|
+
Contract.Publish Result ${result}
|
|
16
|
+
Pause For User Verification ${result}
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
"""Read-only challenge inspection; no clicking or solving is performed."""
|
|
2
|
-
from robot.api.deco import keyword,library
|
|
3
|
-
from robot.libraries.BuiltIn import BuiltIn
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
@library(scope='SUITE',auto_keywords=False)
|
|
7
|
-
class Workflow:
|
|
8
|
-
@keyword
|
|
9
|
-
def inspect_challenge(self,languages='ko,en,ja,zh'):
|
|
10
|
-
spice=BuiltIn().get_library_instance('Spice')
|
|
11
|
-
return spice.check_guest_verification(languages)
|
|
1
|
+
"""Read-only challenge inspection; no clicking or solving is performed."""
|
|
2
|
+
from robot.api.deco import keyword,library
|
|
3
|
+
from robot.libraries.BuiltIn import BuiltIn
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@library(scope='SUITE',auto_keywords=False)
|
|
7
|
+
class Workflow:
|
|
8
|
+
@keyword
|
|
9
|
+
def inspect_challenge(self,languages='ko,en,ja,zh'):
|
|
10
|
+
spice=BuiltIn().get_library_instance('Spice')
|
|
11
|
+
return spice.check_guest_verification(languages)
|
|
@@ -1,26 +1,26 @@
|
|
|
1
|
-
*** Settings ***
|
|
2
|
-
Library ${CURDIR}/../vm_robot.py WITH NAME Spice
|
|
3
|
-
Library ${CURDIR}/../rpa_contract.py WITH NAME Contract
|
|
4
|
-
|
|
5
|
-
*** Variables ***
|
|
6
|
-
${SPICE_URI} vnc://127.0.0.1:5900
|
|
7
|
-
|
|
8
|
-
*** Keywords ***
|
|
9
|
-
Start RPA
|
|
10
|
-
Contract.Begin Result ${RPA_ID}
|
|
11
|
-
Spice.Connect Spice ${SPICE_URI}
|
|
12
|
-
|
|
13
|
-
Finish RPA Task
|
|
14
|
-
IF '${TEST STATUS}' == 'FAIL'
|
|
15
|
-
Contract.Publish Failure If Missing ${TEST MESSAGE}
|
|
16
|
-
END
|
|
17
|
-
|
|
18
|
-
Stop RPA
|
|
19
|
-
Spice.Disconnect Spice
|
|
20
|
-
|
|
21
|
-
Pause For User Verification
|
|
22
|
-
[Arguments] ${result}
|
|
23
|
-
IF $result['status'] in ['needs_user_captcha', 'needs_user_verification']
|
|
24
|
-
Log To Console ${result}[message]
|
|
25
|
-
Skip ${result}[message]
|
|
26
|
-
END
|
|
1
|
+
*** Settings ***
|
|
2
|
+
Library ${CURDIR}/../vm_robot.py WITH NAME Spice
|
|
3
|
+
Library ${CURDIR}/../rpa_contract.py WITH NAME Contract
|
|
4
|
+
|
|
5
|
+
*** Variables ***
|
|
6
|
+
${SPICE_URI} vnc://127.0.0.1:5900
|
|
7
|
+
|
|
8
|
+
*** Keywords ***
|
|
9
|
+
Start RPA
|
|
10
|
+
Contract.Begin Result ${RPA_ID}
|
|
11
|
+
Spice.Connect Spice ${SPICE_URI}
|
|
12
|
+
|
|
13
|
+
Finish RPA Task
|
|
14
|
+
IF '${TEST STATUS}' == 'FAIL'
|
|
15
|
+
Contract.Publish Failure If Missing ${TEST MESSAGE}
|
|
16
|
+
END
|
|
17
|
+
|
|
18
|
+
Stop RPA
|
|
19
|
+
Spice.Disconnect Spice
|
|
20
|
+
|
|
21
|
+
Pause For User Verification
|
|
22
|
+
[Arguments] ${result}
|
|
23
|
+
IF $result['status'] in ['needs_user_captcha', 'needs_user_verification']
|
|
24
|
+
Log To Console ${result}[message]
|
|
25
|
+
Skip ${result}[message]
|
|
26
|
+
END
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
{
|
|
2
|
-
"format_version": 1,
|
|
3
|
-
"id": "debian_update",
|
|
4
|
-
"name": "Debian VM 패키지 목록 갱신",
|
|
5
|
-
"version": "1.0.0",
|
|
6
|
-
"default_entrypoint": "run",
|
|
7
|
-
"entrypoints": [
|
|
8
|
-
{
|
|
9
|
-
"name": "run",
|
|
10
|
-
"file": "run.robot",
|
|
11
|
-
"credentials": "public_sandbox_config"
|
|
12
|
-
}
|
|
13
|
-
],
|
|
14
|
-
"python_libraries": [
|
|
15
|
-
"workflow.py"
|
|
16
|
-
],
|
|
17
|
-
"dependencies": [
|
|
18
|
-
"spice",
|
|
19
|
-
"paddleocr"
|
|
20
|
-
],
|
|
21
|
-
"skill": "spice-vm-update",
|
|
22
|
-
"outputs": {
|
|
23
|
-
"summary": "${OUTPUT DIR}/summary.json",
|
|
24
|
-
"robot_log": "${OUTPUT DIR}/log.html",
|
|
25
|
-
"robot_report": "${OUTPUT DIR}/report.html"
|
|
26
|
-
}
|
|
27
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"format_version": 1,
|
|
3
|
+
"id": "debian_update",
|
|
4
|
+
"name": "Debian VM 패키지 목록 갱신",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"default_entrypoint": "run",
|
|
7
|
+
"entrypoints": [
|
|
8
|
+
{
|
|
9
|
+
"name": "run",
|
|
10
|
+
"file": "run.robot",
|
|
11
|
+
"credentials": "public_sandbox_config"
|
|
12
|
+
}
|
|
13
|
+
],
|
|
14
|
+
"python_libraries": [
|
|
15
|
+
"workflow.py"
|
|
16
|
+
],
|
|
17
|
+
"dependencies": [
|
|
18
|
+
"spice",
|
|
19
|
+
"paddleocr"
|
|
20
|
+
],
|
|
21
|
+
"skill": "spice-vm-update",
|
|
22
|
+
"outputs": {
|
|
23
|
+
"summary": "${OUTPUT DIR}/summary.json",
|
|
24
|
+
"robot_log": "${OUTPUT DIR}/log.html",
|
|
25
|
+
"robot_report": "${OUTPUT DIR}/report.html"
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
*** Settings ***
|
|
2
|
-
Resource ${CURDIR}/../common.resource
|
|
3
|
-
Library ${CURDIR}/workflow.py WITH NAME Workflow
|
|
4
|
-
Suite Setup Start RPA
|
|
5
|
-
Suite Teardown Stop RPA
|
|
6
|
-
Task Teardown Finish RPA Task
|
|
7
|
-
|
|
8
|
-
*** Variables ***
|
|
9
|
-
${RPA_ID} debian_update
|
|
10
|
-
${VM_CONFIG} config/sandbox-vm.json
|
|
11
|
-
${APT_TIMEOUT} 300
|
|
12
|
-
|
|
13
|
-
*** Tasks ***
|
|
14
|
-
Refresh Debian Package Indexes
|
|
15
|
-
${result}= Workflow.Refresh Debian Indexes ${VM_CONFIG} ${APT_TIMEOUT}
|
|
16
|
-
Contract.Publish Result ${result}
|
|
17
|
-
Should Be Equal ${result}[status] succeeded
|
|
1
|
+
*** Settings ***
|
|
2
|
+
Resource ${CURDIR}/../common.resource
|
|
3
|
+
Library ${CURDIR}/workflow.py WITH NAME Workflow
|
|
4
|
+
Suite Setup Start RPA
|
|
5
|
+
Suite Teardown Stop RPA
|
|
6
|
+
Task Teardown Finish RPA Task
|
|
7
|
+
|
|
8
|
+
*** Variables ***
|
|
9
|
+
${RPA_ID} debian_update
|
|
10
|
+
${VM_CONFIG} config/sandbox-vm.json
|
|
11
|
+
${APT_TIMEOUT} 300
|
|
12
|
+
|
|
13
|
+
*** Tasks ***
|
|
14
|
+
Refresh Debian Package Indexes
|
|
15
|
+
${result}= Workflow.Refresh Debian Indexes ${VM_CONFIG} ${APT_TIMEOUT}
|
|
16
|
+
Contract.Publish Result ${result}
|
|
17
|
+
Should Be Equal ${result}[status] succeeded
|
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
"""Debian update package: details remain in the shared OCR-only terminal engine."""
|
|
2
|
-
from pathlib import Path
|
|
3
|
-
from robot.api.deco import keyword,library
|
|
4
|
-
from robot.libraries.BuiltIn import BuiltIn
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
@library(scope='SUITE',auto_keywords=False)
|
|
8
|
-
class Workflow:
|
|
9
|
-
@keyword
|
|
10
|
-
def refresh_debian_indexes(self,config='config/sandbox-vm.json',timeout=300):
|
|
11
|
-
spice=BuiltIn().get_library_instance('Spice')
|
|
12
|
-
output=Path(BuiltIn().get_variable_value('${OUTPUT DIR}'))/'update'
|
|
13
|
-
return spice.update_sandbox_vm(config,str(output),timeout)
|
|
1
|
+
"""Debian update package: details remain in the shared OCR-only terminal engine."""
|
|
2
|
+
from pathlib import Path
|
|
3
|
+
from robot.api.deco import keyword,library
|
|
4
|
+
from robot.libraries.BuiltIn import BuiltIn
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@library(scope='SUITE',auto_keywords=False)
|
|
8
|
+
class Workflow:
|
|
9
|
+
@keyword
|
|
10
|
+
def refresh_debian_indexes(self,config='config/sandbox-vm.json',timeout=300):
|
|
11
|
+
spice=BuiltIn().get_library_instance('Spice')
|
|
12
|
+
output=Path(BuiltIn().get_variable_value('${OUTPUT DIR}'))/'update'
|
|
13
|
+
return spice.update_sandbox_vm(config,str(output),timeout)
|