为什么值得关注

它为 Gemini 交互提供了趣味性的实时视觉反馈，通过不同的动画状态区分用户输入、AI 思考、AI 打字和完成阶段，并且是开源且注重隐私的设计。

适合谁使用

经常使用 Google Gemini 并希望界面更有趣的用户
对趣味交互式项目感兴趣的 Chrome 扩展爱好者
希望了解基于 DOM 事件检测和 Chrome 扩展开发模式的开发者
喜欢可爱桌面助手或虚拟宠物的人

典型使用场景

在 AI 思考或进行网络搜索时提供视觉提示，避免盯着空白屏幕
让与 Gemini 的长时间对话感觉更生动、更有响应性
演示如何构建能响应网页状态变化的 Chrome 扩展
通过非文字提示增强交互阶段的可用性

项目优势

五种不同的动画状态覆盖完整交互周期（等待、输入、思考、回复、完成）
支持拖放功能，可任意放置到屏幕任何角落
纯客户端运行，明确声明不收集任何个人数据
为非技术用户提供详细的安装指南，包括 Windows 和 macOS 路径

使用前须知

仅适用于 gemini.google.com 域名，使用范围受限
依赖于 Google Gemini 当前的 DOM 结构，如果网站更新可能失效
未提及对外观、动画速度或行为的任何自定义选项

README 快速开始

🌸 Gemielle - Gemini AI Assistant Widget

Gemielle là một Chrome Extension giúp hiển thị một "trợ lý AI" sinh động ở góc màn hình khi bạn sử dụng Google Gemini Web (gemini.google.com). Trợ lý sẽ tự động biểu cảm và chuyển đổi trạng thái theo thời gian thực tương ứng với hành vi của bạn và AI.

✨ Tính năng nổi bật

🎭 5 Trạng thái biểu cảm linh hoạt: Theo dõi chính xác từng bước tương tác giữa User và Gemini.
🖱️ Kéo thả tự do (Drag & Drop): Bạn có thể dễ dàng "túm" và di chuyển Gemielle đến bất kỳ góc nào trên màn hình.
⚡ Nhận diện chính xác & Mượt mà:
- Nhận diện khi user gõ prompt hoặc xoá trắng input.
- Phân biệt chính xác giữa lúc AI suy nghĩ/tìm kiếm web (Grounding) với lúc AI thực sự sinh chữ.
- Phản hồi trạng thái ngay lập tức khi AI kết thúc câu trả lời.

🎭 Các trạng thái trợ lý (Assistant States)

Trạng thái	Biểu tượng GIF	Mô tả
WAITING		Trợ lý đang ở trạng thái chờ người dùng nhập prompt.
USER_TYPING		Bạn đang gõ văn bản vào ô nhập liệu của Gemini.
AI_THINKING		AI đang suy nghĩ, xử lý yêu cầu hoặc tìm kiếm thông tin trên Web.
AI_TYPING		AI đang bắt đầu sinh và xuất văn bản trả lời.
AI_COMPLETE		AI đã hoàn thành xong câu trả lời.

🚀 Hướng dẫn cài đặt chi tiết (Dành cho người không biết code)

📌 Bước 1: Tải extension

Bấm nút Code (màu xanh ở trên cùng trang GitHub này) ➔ Chọn Download ZIP.
Giải nén tệp .zip vừa tải về, bạn sẽ nhận được thư mục chứa extension (ví dụ: Gemielle).

📌 Bước 2: Lưu trữ thư mục cài đặt

(Lưu ý: Lưu thư mục vào đúng vị trí dữ liệu tiện ích của Chrome để tránh vô tình xóa tệp khiến Extension ngưng hoạt động)

Dành cho Windows:
1. Nhấn tổ hợp phím Windows + R trên bàn phím để mở hộp thoại Run.
2. Nhập hoặc dán đường dẫn sau rồi nhấn Enter:
```
%LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions
```
3. Cửa sổ thư mục sẽ mở ra. Hãy chép (copy) thư mục Gemielle vào đây.
Dành cho macOS:
1. Mở Finder, nhấn tổ hợp phím Command + Shift + G (hoặc chọn menu Go ➔ Go to Folder...).
2. Nhập đường dẫn sau rồi nhấn Return (Enter):
```
~/Library/Application Support/Google/Chrome/Default/Extensions
```
3. Cửa sổ thư mục sẽ mở ra. Hãy *chép (copy) thư mục Gemielle

Gemielle