基于 Chrome Manifest V3 的英语学习扩展：在中文阅读场景中进行词汇/语句替换，配合 AI 分析、词库与备份能力。

• 关闭：仅保留右键工具
• 单词模式：按密度将中文词替换为英文
• 语句模式：整句替换为英文并提供解释弹窗（需 API Key）

• AI 模式：由 AI 选择学习词汇
• 词库模式：仅使用已激活词库
• 混合模式：AI + 词库

• 可编辑区域：翻译为英文并替换、检查英文语法
• 选中文本：翻译为中文

• 学习记录、已学会词库、自定义词库
• 导入纯英文或中英对照词库
• 批量翻译未翻译词条

• 本地 JSON 导入/导出
• WebDAV 远程备份
• S3(兼容) 远程备份

bun install
bun run dev
bun run build
bun run preview

1. 运行 bun run build
2. 打开 chrome://extensions
3. 开启「开发者模式」
4. 点击「加载已解压的扩展程序」
5. 选择项目下的 dist/ 目录

在 Options 页「AI 服务」中配置：

• API 提供商（OpenAI / Claude / 自定义兼容接口）
• API Key
• 自定义 Base URL 与模型（可选）

语句模式与部分 AI 工具依赖 API Key。

在「站点规则」中配置白名单与黑名单：

• 白名单非空时：仅对白名单命中站点启用
• 黑名单优先级高于白名单
• 规则类型：contains / prefix / suffix / exact / regex

在「词库」页可：

• 管理学习记录、已学会词和自定义词
• 导入词库并批量翻译
• 激活词库供「词库模式 / 混合模式」使用

• 本地：导出/导入 JSON
• 远程：WebDAV 或 S3(兼容)
• 导入/恢复会覆盖当前本地数据（设置、统计、缓存、词库）

• storage：保存设置、词库、统计、缓存、备份配置
• contextMenus：提供右键菜单工具
• activeTab：向当前标签页发送设置更新与操作消息
• host_permissions: <all_urls>：注入 content script 实现页面替换能力

• AI 请求由后台脚本发出，目标地址取决于你的 API 提供商配置
• WebDAV / S3 凭据保存在浏览器本地存储，不会写入仓库代码
• 远程配置（WebDAV / S3）不包含在本地备份文件中

未配置 API Key 时语句模式会被禁用。请先在「AI 服务」中保存 API Key。

请依次检查：

1. 扩展开关是否开启
2. 当前 URL 是否命中白名单/黑名单（黑名单优先）
3. 规则类型是否与预期匹配

导入会覆盖当前数据，扩展会自动刷新页面以确保新数据生效。

Weave 的灵感来源于以下优秀项目，感谢它们在沉浸式英语学习方向上的探索：

• illa-helper
• VocabMeld
• Lingrove

• 提交风格建议：Conventional Commits（feat:、fix:、refactor:）
• 每次提交聚焦一个变更点
• PR 建议包含：目标、关键改动、手动验证步骤、必要截图

MIT