26.9.1 세션 — mailhub 신설: Checker Plus 해부 → IMAP 브리지 + 스코프0 MV3 확장 — 기록: [코디]
논의·대안
[페페] 지시 = 「크롬 확장 Checker Plus for Gmail 을 무료로 잘 써왔지만 pepehq.com 이메일이 늘었고 유료 기능도 쓰고 싶어 기능을 카피한 자체 크롬 확장을 만든다. 가장 핵심은 지메일 말고도 pepehq.com 으로 들어오는 메일들도 관리하기 위함이다. 로그인 필요하면 얘기하고, 나머지는 페이블·GPT 상의로 계획 짜서 바로 제작해라.」
먼저 설치본(Extensions/oeopbcg.../36.4_0, MV3, 5.2MB)을 통째로 해부해 기능 152개를 뽑았다. 유료(기부) 잠금은
4개뿐이었다 — 퀵액션 커스터마이즈·발신자별 알림음·스킨·야간모드. 즉 "유료 기능을 쓰고 싶다"는 동기는
실제로는 거의 비어 있었고, 진짜 문제는 pepehq.com 도메인메일 쪽이었다.
아키텍처 3안을 놓고 갈렸다. A 순수 MV3 + 자체 OAuth(Checker Plus 동형) / B 로컬 IMAP 브리지만 /
C 브리지(엔진) + 얇은 확장(UI). 쟁점은 gmail.modify 가 restricted scope 라는 점이었다. 조사 에이전트 하나는
"In production 으로만 바꾸면 7일 만료가 사라지고 개인용은 검증 면제"라 했고, 다른 하나는 "restricted 는 사실상
CASA 강제"라 해서 정면 충돌했다. 적대검증 3렌즈를 붙였더니 2렌즈가 낙관론을 반박했다 — 같은 조건에서
클릭 불가능한 "This app is blocked" 를 맞은 개발자 보고, 그리고 Advanced Protection 계정은 검증 여부와 무관하게
원천 차단(개인계정 우회 없음). 수명이 남의 손에 있는 설계라 A 를 버렸다.
대신 IMAP 경로를 실측했다 — imap.gmail.com 앱비밀번호 로그인 성공, IDLE(푸시)·X-GM-EXT-1(라벨 읽기/쓰기)
지원 확인. 페이블 계획과 코덱스 상의도 각각 독립적으로 C 로 수렴했다. 페페 지시가 "크롬 확장"이라 B 는 탈락.
pepehq.com 채널 분리는 헤더로 풀었다. 실제 수신메일을 뜯어 X-Forwarded-For: ghostdex@pepehq.com delix0731@gmail.com
을 확인 — Cloudflare 가 원본 수신주소를 남긴다. 이러면 캐치올로 처음 오는 주소도 채널이 저절로 생긴다.
Gmail 필터로 하는 안은 사람이 신규 주소를 따라 만들어야 해서 버렸다.
결정
- 아키텍처 = C. 브리지
bridge.py(pythonw 상주,127.0.0.1:8794)가 IMAP 엔진·채널판별·액션 실행을 전담하고, 확장은host_permissions가 localhost 뿐인 스코프 0 MV3 로 배지·팝업만 그린다. 본문 정독은 Gmail 웹 딥링크로 위임. - 감시 계정 5개(페페 승인) — 지금 도는 건
delix0731하나. pepehq.com 메일이 현재 전부 여기로 떨어져서 핵심 목적은 이미 덮인다.whymycat.pepe는 2FA OFF 로 막혔고,poin3133·poincustomer는 페페가 제작 후 직접. - 유료 4기능은 전부 안 만든다. 고정 퀵액션 3종 + 다크 CSS 로 끝난다.
- 앱비밀번호 단일 출처 =
.secrets/.env.accounts.json엔 키 이름만. - 최초 설치는 사람 손 — 크롬 152 가
--load-extension을 막았다.
산출물·커밋
C:\dev\tools\mailhub\bridge.py— IMAP 엔진 + localhost API(/status/mail/refresh/action) + 토큰 게이트.--selftest내장(네트워크 0, 채널판별 3케이스·MIME 제목·딥링크).C:\dev\tools\mailhub\accounts.json·extension/(manifest·background·popup·options·api·아이콘 3종).C:\dev\devplan\mailhub.html— 계획·구조·검증표. 허브 카드 등록 +project_state.json항목 추가.- 검증:
bridge.py --selftestPASS ·/status200 · 무토큰 401 · 실계정 최근 50건 수집 ·ghostdex@pepehq.com채널 1건 판별 · 팝업 50건 렌더 · 채널탭 필터 1건 · 딥링크authuser일치. - 검증 2차(실계정 왕복) =
bridge.py --livetest신설 — Cloudflare 헤더를 단 합성메일을 INBOX 에 APPEND → 캐치올 신규주소livetest@pepehq.com채널 자동생성 → 미읽음 판정 → 보관 → 흔적제거까지 통과. 검사 후 받은편지함은 원상(5802통·미읽음 0)으로 복귀 확인. - 함정 기록 5건:
① 포트 8792 는 talklog 서버 점유 → 8794.
②
pythonw는sys.stdout이 None 이라print한 줄에 프로세스가 죽는다 → 로그파일 리다이렉트. ③ CDP 로 확장을 찾을 때 크롬 내장 컴포넌트 확장(Google Hangouts·Google Network Speech)이 같은chrome-extension://스킴으로 뜬다 → SW 파일명으로 갈라야 한다./json/new탭은 확장 권한을 못 받는다. ④ 크롬 152 는--load-extension을 막았다 — 전용 프로필·해제 플래그를 줘도 확장 0개. ⑤ 🔑보관은-X-GM-LABELS (\Inbox)로 안 된다 — Gmail IMAP 은 선택한 메일함 자신의 라벨을X-GM-LABELS에서 빼고 준다(실배달 메일도("\Important")뿐이었다). 보관 =+FLAGS (\Deleted)+EXPUNGE. 이 계정에서 합성메일로 확인 = INBOX 0 · 전체보관함 1 · 휴지통 0 = 진짜 아카이브. 라벨 백슬래시는 하나다. - 자해 1건: 프로세스를
cmdline문자열로 매칭해 죽였더니 그 문자열을 인자로 들고 있던 자기 bash 셸이 같이 죽었다.
다음
M4 = IMAP IDLE + Windows 토스트 + 예약작업 상주. M5 = SMTP 답장 + Gmail send-as(pepehq 별칭) + SPF 보정
(현재 v=spf1 include:_spf.mx.cloudflare.net ~all 이라 Gmail 발신은 softfail). M6 = 계정추가 UX·배포형태 확정.
페페 몫 = 확장 수동 로드 1회.
관계
- 주제 그룹: mailhub
- 관련 문서: mailhub-handoff, insta-channels-handoff