MouseTooltipTranslator

环境要求

• Node.js 18（README 指定的构建环境）
• git（用于克隆仓库）
• Chrome 或 Edge 浏览器（Manifest V3，支持开发者模式加载扩展）
• 终端/命令行工具

安装与启动步骤

1. 1安装 Node.js 18

   前往 nodejs.org 下载并安装 Node 18 版本，安装完成后可在终端执行 node -v 检查版本。

2. 2克隆项目仓库

   把 MouseTooltipTranslator 源码下载到本地，并进入项目目录。

   git clone https://github.com/ttop32/MouseTooltipTranslator.git
   cd MouseTooltipTranslator

   复制

3. 3安装依赖

   在项目根目录执行 npm install，安装构建扩展所需的全部依赖包。

   npm install

   复制

4. 4构建扩展

   执行 npm run build 生成扩展产物；开发调试可改用 npm run watch 自动重建。

   npm run build

   复制

5. 5确认构建输出

   构建成功后项目根目录下会出现 MouseTooltipTranslator/build 路径，这就是要加载的扩展文件夹。

6. 6打开扩展管理页

   在 Chrome 地址栏输入 chrome://extensions/ 进入扩展管理页面。

7. 7开启开发者模式

   打开扩展页面右上角的“开发者模式”开关，才会出现加载未打包扩展的入口。

8. 8加载已解压的扩展

   点击“加载已解压的扩展程序”，选择 MouseTooltipTranslator/build 文件夹完成安装。

如何确认成功

在 chrome://extensions/ 列表中看到 MouseTooltipTranslator 已启用，打开任意网页用鼠标悬停或划词，能弹出翻译提示框即成功。

常见问题

注意事项

• 加载扩展时选择的是构建产物 build 目录，不是项目根目录。
• 必须先在扩展页右上角开启开发者模式，否则看不到“加载已解压的扩展程序”选项。
• 按 README 要求使用 Node 18，避免依赖安装或构建异常。
• 仅支持 Manifest V3 的浏览器环境，README 明确兼容 Chrome 与 Edge。