원문: Sac-Y/Jev-cu · 수집일: 2026-09-20 · 기준 커밋
38fb31d(단일 커밋, 2026-09-18) · Stars 360 · Forks 35 · JS · ISC
핵심 요지
Computer Use의 “다음에 어디를 누를지”를 Jev(TypeSafe System One)에 위임하는 중국어 오픈소스다. Jev는 텍스트 후보에서 요소·액션·완료도·리스크만 고르고, Codex Computer Use가 화면 읽기·실행을 맡으며, 로컬 정책 게이트가 민감 작업을 차단한다. 스크린샷은 Jev에 보내지 않는다 — 텍스트만 전송. jev-ultrafast가 브라우저 DOM 위 판단이라면, 이쪽은 macOS 네이티브 App의 AX(접근성) 트리 위 판단이다.
주요 내용
역할 분담 (관측→결정→게이트→실행)
- Codex (Planner) — 작업 분할·입력 준비·예외 처리·결과 검증. 텍스트 입력·키·방향 같은 동작 파라미터는 Codex가 미리 준비 — Jev는 텍스트를 생성하지 않는다.
- Jev (판단) — 매 단계 표준 4문항을 병렬로 답한다: target(어떤 요소, choice)·action(9종 중 클릭·입력·스크롤·대기 등, choice)·done(이미 달성했나, noul)·risk(확인 필요한 민감 동작인가, noul).
- Policy Gate (순수 함수) — 화이트리스트 7종(Calendar·Calculator·TextEdit·NetEaseMusic·Figma·Chrome·Codex In-app Browser), 민감 라벨 7종(삭제·전송·결제·인증·공유·설치·설정, 중영 매칭), 임계값(done≥0.9 종료·risk≥0.2 확인·confidence<0.5 인계, 저위험 App은 0.4로 완화·<0.3 정지).
- Computer Use (실행) — Codex 데스크톱 App의
cua_repl런타임에서 AX 읽기·클릭·입력 수행. 매 단계 전체 AX를 재읽고(구 인덱스 재사용 금지) 실행 전후 변화를 기록한다.
배운 교훈 3가지 (코드에 박혀 있음)
- 위치 기반 블라인드 절단 금지 — 후보를 앞에서 N개 자르면 목표 버튼이 목록 항목에 밀려 탈락한다(P0 실측). 역할 가중+목표 토큰 매칭으로 정렬 후 절단.
- Jev 자가 완료 보고를 믿지 마라 —
done확률이 높아도verify상태 판정을 통과해야 종료. Jev 완료+미검증은 인계(escalate). - 통과를 위해 게이트를 낮추지 마라 — 저신뢰도는 재시도·화면 확인·인간 질문으로 해결.
skipJev확정 단계도 미리보기만 허용하고 실제 실행은 인계.
검증 체계
npm test— mock driver 단위 테스트(API·실 App 미사용): 파싱·후보 선별 회귀·정책 게이트·질문/결정 왕복·실행 경계.npm run p0— 저장 AX 스냅샷 3종(달력·계산기·왕이윈 음악) 위 12개 케이스 요소 선택 정확도 오프라인 평가(정확도·p50·토큰·비용 집계).- 달력 데모 시나리오(월뷰→다음 달→오늘→주뷰, 일정 수정 없음)와 단계별 성공 증거 정의. 대조 실험 시 동일 출발점·판정 기준 + 실패·인계 통계 필수 — “데모 성공≠우위 증명”을 문서에 못박음.
해석과 적용 메모
- 내 해석: 2026-09-20-typesafe-ai-skills의 설계 지침(코드가 흐름 소유·Jev는 좁은 판단·confidence 해석 주의)이 macOS computer-use 하네스에 완전히 구현된 사례다. 특히 “Planner는做什么(무엇을), Jev는点哪里(어디를)” 분리는 스킬 문서의 “코드가 목표·관측 유지, fresh 판단이 다음 bounded step 지도” 원칙의 직역이다.
- 적용: harness에 판단 게이트를 붙일 때 정책 게이트 임계값(done 0.9·risk 0.2·confidence 0.5/0.4/0.3)과 민감 라벨 7종을 그대로 참조할 수 있다. jev-ultrafast와 함께 읽으면 “DOM 위 판단 vs AX 트리 위 판단” 두 구현을 비교할 수 있다.
- 주의: 저장소 언어가 중국어이며 goal은 영문 권장(Jev 영문 정확도). 수집 시점에 실측 P0 수치가 저장소에 없어 성능 근거로 인용 불가.
cua_repl의존이라 Codex 데스크톱 App 없이는 실행 불가.
관련 페이지
- 2026-09-20-typesafe-ai-skills — 이 구현이 따르는 공식 스킬의 설계 지침
- jev-ultrafast — 브라우저 DOM 위 Jev 판단의 실전 사례 (구성 비교용)
- harness — 판단 게이트·임계값·폴백을 설계하는 하네스 개념
- 2026-09-19-typesafe-use-case-map — Harness Engineering 축의 공식 원칙