read-aloud

环境要求

• Chrome、Edge 等 Chromium 内核浏览器或 Firefox 浏览器
• Node.js 与 npm（仅 Firefox 源码安装方式需要）
• 已获取 read-aloud 项目源码目录（源码安装时）

安装与启动步骤

1. 1商店直接安装

   普通用户推荐方式：打开 Chrome 应用商店或 Firefox Addon 页面，点击添加到浏览器即可，无需编译源码。

   https://chromewebstore.google.com/detail/read-aloud-a-text-to-spee/hdhinadidafjejdhmfkjgnolgimiaplp

   复制

2. 2获取项目源码

   Firefox 源码安装需要本地有项目代码，先从 GitHub 克隆仓库到本地目录。

   git clone https://github.com/ken107/read-aloud.git
   cd read-aloud

   复制

3. 3创建构建目录

   在项目根目录下执行 mkdir build，创建用于存放打包产物的目录。

   mkdir build

   复制

4. 4打包扩展

   运行打包脚本，生成可分发的 zip 压缩包，产物位于项目内。

   npm run-script package

   复制

5. 5解压打包产物

   解压上一步生成的 zip 文件，解压后目录中应能看到 manifest.json，后面加载会用到它。

6. 6加载到 Firefox

   先在 Firefox 中确认没有已安装的 read-aloud 扩展，地址栏输入 about:debugging 回车。

   about:debugging

   复制

7. 7选择清单文件

   点击 This Firefox → Load Unpackaged Extension，选中前面解压出来的 manifest.json 完成加载。

如何确认成功

about:debugging 的「临时扩展」列表中出现 read-aloud，且浏览器工具栏显示其图标即为加载成功。

常见问题

注意事项

• README 未明确写出获取源码的命令，第 2 步依据项目 GitHub 地址推断，仅供源码安装方式使用。
• 源码安装前请确保 Firefox 中未安装其他 read-aloud 扩展，避免冲突。
• 打包前需保证已安装 Node.js 与 npm，并已在本项目目录下执行命令。