YouTube AI 扩展

🚀 重大更新将于 2025 年 6 月 10 日发布！ 🚀
新版本即将上线，带来强大的新功能、更简洁的安装流程，并将在 Chrome 网上应用店正式发布。

YouTube 聊天扩展允许您直接与 YouTube 视频进行对话，提供独特的互动体验。

演示视频 · 功能 · 路线图 · 安装 · 致谢

功能

• 与 YouTube 视频无缝实时聊天。
• 获取视频摘要、提问并获得详细解答。
• 用户友好的界面直接集成到 YouTube 中。
• 支持多种语言和上下文感知的回答。

路线图

• 2025 年 6 月 10 日：重大更新，新增功能并正式在 Chrome 网上应用店发布。

安装

要本地安装并运行 YouTube 聊天扩展，请按照以下步骤操作：

1. 克隆仓库：

   git clone https://github.com/PaoloJN/youtube-ai-extension.git
   
   cd youtube-chat-extension
   

2. 添加您的 OpenAI API 密钥。将 chat.ts 和 completion.ts 文件中的 YOUR_API_KEY 替换为您实际的密钥：

   const openai = new OpenAI({
     apiKey: "YOUR_API_KEY"
   })
   

3. 安装依赖并构建项目：

   pnpm install
   pnpm run build
   

4. 将扩展加载到 Chrome 中：

   1. 打开 Chrome 浏览器，访问 chrome://extensions/。
   2. 启用右上角的“开发者模式”开关。
   3. 点击“加载已解压的扩展程序”，然后选择刚刚构建的项目中的 build/chrome-mv3-dev 目录。

5. 打开 YouTube，开始与视频聊天吧！ :)

此扩展目前不支持新版 YouTube 布局。如需切换回旧版布局，请使用 uBlock Origin 扩展程序，这样扩展即可正常工作。

许可证

本项目采用 AGPL-3.0 许可证，仅限非商业用途。

商业用途

如需用于商业用途或部署时需要支付设置费用，请通过电子邮件 paolo.j.nessim@gmail.com 联系我们以获取商业许可。

使用本软件即表示您同意该许可证的条款。

致谢

没有以下资源的支持，本项目将无法实现：

• OpenAI API
• React
• Tailwind CSS
• Plasmo Extension
• Chrome 扩展文档

YouTube AI Extension 快速上手指南

YouTube AI Extension 是一款浏览器插件，允许用户直接在 YouTube 视频页面与视频内容进行实时对话、获取摘要及详细解释。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• 浏览器：Google Chrome (推荐最新版本)
• 运行时依赖：
  • Node.js (建议 v18+)
  • pnpm (包管理工具)
  • Git
• API 密钥：有效的 OpenAI API Key

国内开发者提示：如果 pnpm install 下载依赖较慢，可配置国内镜像源：

pnpm config set registry https://registry.npmmirror.com

安装步骤

1. 克隆项目

将源代码克隆到本地并进入项目目录：

git clone https://github.com/PaoloJN/youtube-ai-extension.git
cd youtube-chat-extension

2. 配置 API 密钥

打开项目中的 chat.ts 和 completion.ts 文件，将 YOUR_API_KEY 替换为您实际的 OpenAI API 密钥：

const openai = new OpenAI({
  apiKey: "YOUR_API_KEY" // 替换为您的真实密钥
})

3. 安装依赖并构建

使用 pnpm 安装依赖并构建生产版本：

pnpm install
pnpm run build

4. 加载扩展程序到 Chrome

1. 打开 Chrome 浏览器，访问 chrome://extensions/。
2. 点击右上角开启 “开发者模式” (Developer mode)。
3. 点击 “加载已解压的扩展程序” (Load unpacked)。
4. 选择项目构建生成的目录：build/chrome-mv3-dev。

基本使用

1. 调整布局（重要）： 当前版本暂不支持 YouTube 新版界面布局。若插件无法正常工作，请安装 uBlock Origin 扩展并启用旧版布局规则，或手动回退至旧版 YouTube 界面。

2. 开始交互：

   • 打开任意 YouTube 视频页面。
   • 插件界面将自动集成在视频播放器旁。
   • 在输入框中输入问题（支持中文），即可获取视频摘要、细节解释或进行实时对话。

3. 示例场景：

   • 输入：“总结这个视频的核心观点。”
   • 输入：“视频里提到的第三个步骤是什么？”