메뉴
선택 번역 팝업 룰 (단어/문장 모드, UI, 캐시). selection-popup.ts, llm-helpers.ts 수정 시 참조.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | selection-popup-rules |
| description | 선택 번역 팝업 룰 (단어/문장 모드, UI, 캐시). selection-popup.ts, llm-helpers.ts 수정 시 참조. |
mouseup 이벤트 캐치isLikelyEnglish, ASCII 비율 > 60%)Range.getClientRects() 마지막 rect)TRANSLATE_BATCH 메시지 전송| 모드 | 조건 | mode 값 | 프롬프트 | UI |
|---|---|---|---|---|
| 단어 | isSingleWord() — 공백 없음 | 'word' | buildWordTranslationPrompt (번역 + 예문 2개) | 컴팩트 팝업 |
| 문장 | 공백 포함 | 'page' | buildTranslationPrompt (일반 번역) | 넓은 팝업 |
parseWordResponse)LLM 응답 형식:
[1] 한국어 번역
= brief English definition
~ similar word 1, similar word 2
• English example sentence 1
→ Korean translation 1
• English example sentence 2
→ Korean translation 2
= 시작 줄 = 영영 해석 (작은 회색 글씨)~ 시작 줄 = 유사 단어 (초록색, ≈ 라벨)• 시작 줄 = 영어 예문 (선택 단어 초록색 하이라이트)→ 시작 줄 = 한국어 예문word — 한국어번역 🔊
brief English definition (작은 회색)
≈ similar1, similar2 (초록색)
──────────────────────────────────
• Example sentence (word 하이라이트)
→ 한국어 예문
speechSynthesis), Google US English 보이스 우선position: absolute — 페이지 스크롤 시 함께 이동 (viewport 좌표 → document 좌표 변환)mousedown): 전부 닫힘__word__ 프리픽스로 분리 (같은 단어라도 page/word 결과가 다름)floatingButtonVisible === false → destroySelectionPopup() (선택 번역도 비활성화)floatingButtonVisible === true → initSelectionPopup() (재활성화)선택 팝업 UI 변경:
| # | 파일 | 위치 | 할 일 |
|---|---|---|---|
| 1 | content/selection-popup.ts | 해당 함수 | 로직 수정 |
| 2 | content/selection-popup.css | 스타일 클래스 | 스타일 추가/수정 |
| 3 | 이 스킬 파일 | 해당 섹션 | 규칙 업데이트 |
번역 모드 추가:
| # | 파일 | 위치 | 할 일 |
|---|---|---|---|
| 1 | utils/messaging.ts | TranslateBatchRequest.mode | 모드 타입 추가 |
| 2 | utils/engines/types.ts | TranslationEngine.translate() | mode 타입 추가 |
| 3 | utils/engines/llm-helpers.ts | 프롬프트 빌더 | 새 프롬프트 함수 추가 |
| 4 | utils/engines/gemini.ts, openai.ts, anthropic.ts | prompt 선택 분기 | 모드 분기 추가 |
| 5 | entrypoints/background.ts | handleTranslateBatch | mode 전달, 캐시 키 분리 |
| 6 | 이 스킬 파일 | 모드 판별 테이블 | 행 추가 |
YouTube 자막 번역 룰 (파이프라인, cue 병합, rolling 번역, 캐시). youtube/ 디렉토리 수정 시 참조.
페이지 번역 룰 (text detection, injection, batch, cache). text-detector.ts, translator.ts, constants.ts 수정 시 참조.
상태 머신·보호 장치·Observer 룰. content.ts, observer.ts, background.ts 수정 시 참조.
b3rys translate 크롬 확장을 GitHub에서 설치하고 API 키 설정·사용법까지 끝까지 안내한다. 사용자가 `/b3translate`을 실행하거나, repo URL을 붙여넣거나, "b3rys 번역 확장 설치/사용법"을 요청하면 사용.