yeahhe365/Gemini-Nexus

Gemini Nexus 是一款面向浏览器场景的 AI 助手扩展，集成 Gemini Web、Gemini API 与 OpenAI 兼容接口，支持网页上下文、图像处理、工具调用和 MCP 浏览器控制。

Gemini Nexus – AI 기반 Chrome 확장 프로그램

개요 – Gemini Nexus는 브라우저에 대화형 AI 어시스턴트를 직접 내장하는 Chrome MV3 확장 프로그램입니다. Google Gemini(웹 UI 및 공식 API 모두)뿐만 아니라 다양한 OpenAI 호환 서비스(OpenAI, Anthropic, DeepSeek, OpenRouter, Qwen/DashScope, Zhipu 등)와 통신할 수 있습니다. 확장 프로그램은 사이드 패널, 플로팅 도구 모음, 브라우저 제어 도구 세트를 추가하여 모델이 페이지 읽기, 버튼 클릭, 양식 작성, 스크린샷 캡처, 사용자 지정 JavaScript 실행까지 수행할 수 있게 합니다.

중요성 – 별도의 채팅 창을 여는 대신, 어시스턴트는 브라우저 내에 상주하며 현재 탭에서 작업할 수 있습니다. 이를 통해 페이지를 떠나지 않고도 LLM을 사용한 즉석 번역, 요약, 코드 생성, 완전 자동화된 브라우징 작업이 가능합니다.

핵심 기능

기능	설명
다중 공급자 지원	Gemini Web(API 키 불필요, 리버스 엔지니어링), Gemini 공식 API, OpenAI 호환 API, Anthropic, DeepSeek, OpenRouter, Qwen/DashScope, Zhipu 등 간에 전환할 수 있습니다. 각 공급자는 고유한 기본 URL, API 키 및 모델 ID를 가집니다.
네이티브 브라우저 제어	Chrome DevTools Protocol을 통해 모델은 `navigate_page`, `click`, `fill_form`, `take_snapshot`, `evaluate_script` 등의 명령을 실행할 수 있습니다. 제어되는 탭은 시각적 피드백을 위해 그룹화됩니다.
플로팅 선택 도구 모음	텍스트를 강조 표시하면 번역, 요약, 설명, 문법 수정, 결과를 양식에 삽입하는 옵션을 제공하는 도구 모음이 나타납니다.
이미지 및 스크린샷 입력	선택한 이미지 영역의 OCR/번역, 전체 화면 또는 창 캡처, 페이지 이미지용 플로팅 “이미지 분석” 버튼이 있습니다.
사이드 패널 UI	Chrome의 `sidePanel` API로 구축되었으며 빠른 액세스, 전체 텍스트 기록 검색, 샌드박스 iframe에서 Markdown/LaTeX/코드 렌더링을 제공합니다.
컨텍스트 관리	요약 압축 및 턴 트리밍으로 토큰 사용량을 모델 제한 내로 유지합니다.
외부 MCP 도구 통합	SSE, HTTP 스트리밍 또는 WebSocket을 통해 로컬 또는 원격 Multi-Tool-Calling(MCP) 서버에 연결하여 사용자 지정 도구를 LLM에 노출합니다.
워터마크 제거	Gemini 생성 이미지에 포함된 워터마크를 제거합니다(사용자 책임 하에 사용).
임시 Gemini Web 채팅	사용자의 공식 채팅 기록을 오염시키지 않고 Gemini Web을 사용할 수 있습니다.

설치 방법

릴리스 빌드에서 – Releases 페이지에서 ZIP을 다운로드하고 압축을 푼 다음, chrome://extensions/를 열고 개발자 모드를 활성화하고, 압축 해제된 확장 프로그램을 로드를 클릭하여 추출한 폴더를 선택합니다.
소스에서 빌드 –
```
npm install
npm run package:extension   # artifacts/chrome-extension에 로드 가능한 폴더 생성
```
해당 폴더를 위와 동일한 방법으로 로드합니다. (npm run build는 UI 번들만 생성하며 전체 확장 프로그램은 생성하지 않습니다.)
게시 – 저장소에는 로컬 .env.chrome-webstore 파일에 저장된 자격 증명을 사용하여 패키지된 ZIP을 Chrome 웹 스토어에 업로드하는 스크립트(npm run publish:chrome-webstore)가 포함되어 있습니다.

아키텍처 스냅샷

프런트엔드 – Vite + TypeScript UI가 dist/로 컴파일되어 사이드 패널과 플로팅 도구 모음에 주입됩니다.
백그라운드 – 공급자 라우팅, 토큰 저장, Chrome DevTools 기반 제어 루프(background/control/)를 처리합니다.
콘텐츠 스크립트 – 웹 페이지에 주입되어 선택 항목 캡처, 플로팅 이미지 분석 버튼 추가, Accessibility Tree를 통한 DOM 작업 수행을 담당합니다.
MCP 브리지 – 선택적 프록시(예: MCP-SuperAssistant)가 확장 프로그램 호출을 로컬 stdio 기반 도구 서버로 변환합니다.
공급자 드라이버 – services/providers 아래에 있으며, 각 드라이버는 대상 API에 대한 요청 형식을 알고 있습니다(예: Gemini Web용 web.js, Gemini API용 official.js, Claude용 anthropic.js 등).

위험 및 주의 사항

Gemini Web 리버스 엔지니어링 – 확장 프로그램은 gemini.google.com에서 내부 RPC 토큰을 추출하고 웹 클라이언트를 모방합니다. 이는 Google의 서비스 약관을 위반할 가능성이 높으며, Google이 내부 API를 변경하면 작동이 중지될 수 있습니다.
워터마크 제거 – 생성된 이미지에서 출처 표시를 제거하면 Google의 사용 정책을 위반할 수 있습니다.
API 키 – 모든 키는 확장 프로그램의 로컬 저장소에만 저장되며 선택한 공급자 이외의 제3자에게 전송되지 않습니다.
책임 – 저자는 리버스 엔지니어링된 기능 사용으로 인한 법적 또는 정책적 결과는 사용자가 부담한다는 면책 조항을 제공합니다.

사용 대상

파워 유저 – 앱을 전환하지 않고 현재 웹 페이지에서 작업할 수 있는 대화형 어시스턴트를 원하는 사용자.
개발자 – LLM 기반 브라우저 자동화 또는 도구 호출 워크플로를 실험하려는 개발자.
연구자 – 다중 공급자 LLM 통합 및 Gemini Web에 대한 리버스 엔지니어링 액세스의 한계를 테스트하는 데 관심이 있는 연구자.

라이선스 – MIT(오픈 소스).

Gemini Nexus는 Chrome에 네이티브 AI 레이어를 도입하여 많은 대규모 언어 모델 공급자를 통합하고, 간단한 텍스트 지원부터 본격적인 자율 브라우징까지 브라우저를 직접 제어할 수 있게 합니다.