| name | kakao-automation |
| description | Use when changing anything under src/main/kakao/ (login/launch automation, PageHandler selectors, SecurityCenter, visibility policy, page dumps, maintenance detection) or the KakaoGames starter/UAC path (src/main/utils/uac/kakao-game-starter.ts, uac-migration.ts). Third-party-DOM selector policy and real-user blast radius rules. |
Skill: Kakao Automation
์นด์นด์ค ๋ก๊ทธ์ธยท๊ฒ์ ์คํ ์๋ํ๋ ์๋ํํฐ DOM์ ์์กดํ๋ฉฐ, ์
๋ ํฐ ๋ณ๊ฒฝ์
auto-update๋ก ์ ์ฒด ์ฌ์ฉ์์๊ฒ ์ฆ์ ๋ฐฐํฌ๋๋ค.
๊ตฌ์กฐ ์ง๋
src/main/kakao/preload.ts (~1.4k lines): PageHandler ๋ ์ง์คํธ๋ฆฌ โ
URL/DOM ๋งค์นญ ๊ธฐ๋ฐ ์๋ํ ๋ณธ์ฒด (SecurityCenterHandler ํฌํจ).
src/main/kakao/visibility-policy.ts: ์๋ํ ์ฐฝ ํ์/์จ๊น ์ ์ฑ
.
src/main/kakao/automation-page-dump.ts: ์คํจยท๋
ธ์ถ ์ ํ์ด์ง ๋คํ ์ ์ฅ.
src/main/kakao/session.ts: ์ธ์
ํํฐ์
. maintenance-info.ts: ์ ๊ฒ ๊ฐ์ง.
src/main/utils/uac/kakao-game-starter.ts: KakaoGames Starter(KGS) ์คํ
๊ฒฝ๋ก โ 2026-06 DGSโKGS ์ ํยท๋ง์ด๊ทธ๋ ์ด์
ํ๋จ. (๊ฒ์ exe
PathOfExile_KG.exe ๊ฐ์ง ์์ฒด๋ src/main/config/GameServiceProfiles.tsยท
src/main/utils/registry.ts.)
๊ท์น
- ์
๋ ํฐ๋ ๋คํ์์๋ง. ์ค์ ํ์ด์ง ๋คํ(HTML) ๊ทผ๊ฑฐ ์์ด ์
๋ ํฐ๋ฅผ
์ถ๊ฐยท์์ ํ์ง ์๋๋ค. ๋คํ ์์งยท๋
ํด ๋ฐฉ๋ฒ์
windows-electron-debugging.
- ์ถ๊ฐ ์ฐ์ , ์ ๊ฑฐ ์ ์ค. ๊ธฐ์กด ๋งค์นญ ์ ๊ฑฐ/๊ต์ฒด๋ ๊ตฌ ํ์ด์ง๋ฅผ ๋ณด๋ ์ฌ์ฉ์๋ฅผ
๊นจ๋จ๋ฆฐ๋ค. ํธ๋ค๋ฌยท์
๋ ํฐ๋ ์ถ๊ฐ๋ก ํ์ฅํ๊ณ , ์ ๊ฑฐ๋ ํ์ด์ง ์๋ฉธ ๊ทผ๊ฑฐ์ ํจ๊ป.
- SecurityCenter ๋
ธ์ถ ํ์ ์ URL์ด ์๋ DOM ์ํ๋ก.
- ์จ๊น ์ ์ง(์๋ ์งํ): PC์ ๋ณด์์ง์๋ด ํ์ธ ๋ฒํผ,
.section--device-save,
.modal--device-loading, ๋ณธ๋ฌธ "PC ์ธ์ฆ ์ ๋ณด ์์ง ์ค".
- ์ฆ์ ๋
ธ์ถ(์ฌ์ฉ์ ์
๋ ฅ): MOTP, ARS, ์นด์นด์คํ์ด, ๊ธฐ๊ธฐ๋ช
์
๋ ฅ, ๊ฐ์์
์ฝ๋/์
๋ ฅ ์
๋ ํฐ.
- ๋ฏธ์ง์ ํ๋ฉด: ๋
ธ์ถ์ ์ง์ฐํ๊ณ ๋คํ๋ฅผ ๋ณด์กดํด ๋ค์ ๋ฆด๋ฆฌ์ค์์ ์
๋ ํฐ ๋ณด๊ฐ.
- ๊ฒ์ฆ์ ์ค์ ํ๋ก์ฐ๋ก๋ง. ์ด ์์ญ DoD๋ ํญ์
[์ฌ์ฉ์] Windows ์ค๋์
๊ฒ์ฆ โ ๋น๋/์ ๋ ํ
์คํธ ํต๊ณผ๋ก ์๋ฃ ์ ์ธ ๊ธ์ง.
- ์คํํฐ/UAC ๊ฒฝ๋ก ๋ณ๊ฒฝ์ ๊ธฐ์กด ์ค์น ์ฌ์ฉ์์ ๋ง์ด๊ทธ๋ ์ด์
blast radius๋ฅผ
๋จผ์ ์์ ํ๋ค (
uac-migration.ts).