浸入式学语言助手（illa-helper）

## 项目地址
– https://github.com/xiao-zaiyi/illa-helper

## 项目描述

语言学习的最佳途径是大量接触”可理解的”输入材料，即著名的 “i+1” 理论（俗称混个眼熟）。本浏览器扩展旨在把正在浏览的网页通过大语言模型智能的将网页上的部分词语替换为你正在学习的目标语言词汇，让你在沉浸式的阅读中，不知不觉地提升词汇量和语感。

🎯 项目亮点: 集成了完整的发音学习生态系统和智能多语言翻译功能，包括自动语言检测、音标显示、AI词义解释、双TTS语音合成和交互式悬浮框，为用户提供从智能翻译到发音学习的一站式沉浸式体验。**所有有关设置均保持在本地，无需担心密钥泄露！**

## 项目演示



## 🚀 功能特性

### 🎯 核心翻译引擎
– **智能语言检测**: AI自动识别网页源语言，无需用户手动指定语言类型
– **智能文本处理**: 使用大语言模型分析网页内容，智能选择适合用户水平的词汇进行翻译
– **精确替换控制**: 可精确控制翻译比例（1%-100%），支持字符级精确计算
– **上下文感知**: 考虑语境和用户水平，选择最合适的翻译词汇
– **多语言支持**: 支持20+种语言的智能翻译（英语、日语、韩语、法语、德语、西班牙语、俄语、意大利语、葡萄牙语、荷兰语、瑞典语、挪威语、丹麦语、芬兰语、波兰语、捷克语、土耳其语、希腊语等）**理论上依赖大模型能力**。

### 🔊 发音学习生态系统 ⭐
– **交互式悬浮框**: 鼠标悬停翻译词汇即可查看音标、AI词义和朗读功能，智能定位避免边界溢出
– **双层学习体验**: 短语显示可交互的单词列表，点击单个单词查看详细信息，支持嵌套悬浮框
– **多TTS服务支持**: 集成有道TTS（高质量）和Web Speech API（备用），支持英式/美式发音切换
– **智能音标获取**: 自动获取Dictionary API音标数据，24小时TTL缓存优化性能
– **AI词义解释**: 实时调用AI生成中文词义解释，理解更准确，支持上下文语境分析
– **渐进式加载**: 先显示基础信息，再异步加载详细内容，优化用户体验
– **音频缓存**: 内存级TTS音频缓存，同一单词无需重复生成语音

### 🎨 丰富的视觉体验
– **7种翻译样式**: 默认、微妙、粗体、斜体、下划线、高亮、学习模式（模糊效果）
– **学习模式**: 翻译词汇初始模糊显示，鼠标悬停时清晰化，增强记忆效果
– **辉光动画**: 新翻译词汇出现时的柔和提示效果，不干扰阅读体验
– **响应式设计**: 自适应深色/浅色主题，智能悬浮框定位

### ⚙️ 高度可配置性
– **智能翻译模式**: 用户只需选择目标语言，AI自动检测源语言并进行翻译
– **用户水平适配**: 从初级到精通5个级别，AI智能调整词汇难度和选择策略
– **触发模式**: 支持自动触发（页面加载时处理）和手动触发两种工作方式
– **原文显示控制**: 可选择显示、隐藏或学习模式（模糊效果）显示被翻译的原文
– **音标、发音功能开关**: 可独立控制发音悬浮框功能的启用状态

### 🔌 开放式API集成
– **兼容OpenAI API**: 支持任何兼容 OpenAI 格式的AI服务（ChatGPT、Claude、豆包等国产大模型）
– **灵活配置**: 自定义API Key、Endpoint、模型名称、Temperature参数
– **智能提示词**: 根据翻译方向和用户水平动态生成最优提示词
– **错误处理**: 完善的API错误处理和重试机制

### 💻 现代技术架构
– **技术栈**: Vue 3 + TypeScript + WXT 框架
– **模块化设计**: 高内聚低耦合的模块架构，易于维护和扩展
– **跨浏览器兼容**: 支持Chrome、Edge、Firefox，部分支持Safari

## 🌐 浏览器兼容性

本扩展基于 [Web Extension API](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions) 和 [WXT](https://wxt.dev/) 构建，支持以下浏览器：

| 浏览器 | 支持状态 | 特殊说明 |
|——-|——–|———-|
| Chrome | ✅ 完全支持 | 推荐环境，所有功能可用 |
| Edge | ✅ 完全支持 | 基于Chromium，完整兼容 |
| Firefox | ✅ 支持 | 详见[Firefox安装指南](#firefox-安装指南) |
| Safari | ⚠️ 部分支持 | 需要额外配置，自行查询 |

## ⚡ 性能特性

### 🚀 智能缓存系统
– **翻译结果**: 基于内容和设置的智能缓存，避免重复API调用
– **音标数据**: 24小时TTL本地缓存，提升响应速度
– **TTS音频**: 内存级缓存，同一单词无需重复生成语音