Skip to content

INSTALL_GUIDE.md

Latest commit

 

History

History
323 lines (228 loc) · 8.37 KB

INSTALL_GUIDE.md

File metadata and controls

323 lines (228 loc) · 8.37 KB

Chrome插件安装完整教程

📋 安装前准备

系统要求

  • ✅ Chrome浏览器 88版本及以上
  • ✅ Edge浏览器 88版本及以上（基于Chromium）
  • ⚠️ 不支持Firefox、Safari等非Chromium内核浏览器

文件准备

确保你已经下载了完整的 chrome-extension 文件夹，包含以下文件：

chrome-extension/
├── manifest.json          ← 插件配置文件（必需）
├── background/
│   └── background.js     ← 后台脚本（必需）
├── content/
│   ├── content.js        ← 内容脚本（必需）
│   └── content.css       ← 样式文件（必需）
├── popup/
│   ├── popup.html        ← 弹窗页面（必需）
│   ├── popup.css         ← 弹窗样式（必需）
│   └── popup.js          ← 弹窗脚本（必需）
├── icons/
│   ├── icon-16.png       ← 插件图标（必需）
│   ├── icon-48.png       ← 插件图标（必需）
│   └── icon-128.png      ← 插件图标（必需）
└── README.md             ← 说明文档（可选）

🚀 详细安装步骤

步骤1：打开Chrome扩展程序页面

方法A：通过地址栏

  1. 复制以下地址：chrome://extensions/
  2. 粘贴到Chrome地址栏
  3. 按回车键

方法B：通过菜单

  1. 点击Chrome右上角的 ⋮ (三个点)
  2. 选择 扩展程序
  3. 点击 管理扩展程序

方法C：快捷方式

  • Windows/Linux: 按 Ctrl + Shift + E
  • Mac: 按 Cmd + Shift + E

打开扩展页面

步骤2：启用开发者模式

  1. 在扩展程序页面的右上角
  2. 找到 开发者模式 开关
  3. 点击开关，确保变为 蓝色/打开状态

启用开发者模式

💡 为什么要开启开发者模式？

开发者模式允许你安装未发布到Chrome应用商店的本地扩展程序。

步骤3：加载插件文件夹

  1. 点击左上角的 加载已解压的扩展程序 按钮
  2. 在弹出的文件选择窗口中，找到 chrome-extension 文件夹
  3. 重要： 选择整个 chrome-extension 文件夹（不是里面的某个文件）
  4. 点击 选择文件夹 或 打开

加载插件

步骤4：验证安装成功

安装成功后，你会看到：

✅ 扩展程序列表中出现了新卡片：

┌─────────────────────────────────────┐
│ 📝 Star Seeker      v2.0.0  │
│                                     │
│ 自动抓取小红书帖子评论并导出CSV... │
│                                     │
│ ID: abcdef123456...                │
│ [详细信息] [移除] [错误]           │
└─────────────────────────────────────┘

✅ Chrome右上角出现插件图标（如果没有，参考步骤5）

✅ 状态显示："已启用"

步骤5：固定插件图标到工具栏（可选但推荐）

  1. 点击Chrome右上角的 拼图图标 🧩
  2. 在下拉列表中找到 Star Seeker
  3. 点击右侧的 📌 图标 固定到工具栏
  4. 现在插件图标会一直显示在工具栏上

固定图标

✅ 安装完成 - 开始使用

快速测试

  1. 打开小红书网站

    https://www.xiaohongshu.com

  2. 点击任意帖子进入详情页

  3. 检查插件是否工作：

    • 页面右侧应该出现悬浮工具栏
    • 点击工具栏的插件图标，弹窗应该显示"✅ 小红书页面"

  4. 尝试抓取评论：

    • 点击悬浮工具栏的 ▶️ 开始抓取
    • 观察评论数是否开始增加
    • 抓取完成后点击 📥 导出CSV

🔧 常见安装问题

❌ 问题1：点击"加载已解压的扩展程序"后没反应

原因： 可能是文件夹路径包含特殊字符或中文

解决方案：

  1. 将 chrome-extension 文件夹移动到简单路径
    • ✅ 推荐：C:\Extensions\xhs-scraper\ (Windows)
    • ✅ 推荐：/Users/你的用户名/Extensions/xhs-scraper/ (Mac)
  2. 重新加载插件

❌ 问题2：提示"清单文件缺失或不可读"

原因： 选择的文件夹不正确，或manifest.json文件损坏

解决方案：

  1. 确认选择的是包含 manifest.json 的文件夹
  2. 检查 manifest.json 文件是否完整
  3. 用文本编辑器打开 manifest.json，检查JSON格式是否正确

❌ 问题3：提示"程序包无效: 'XXX'"

原因： manifest.json文件格式错误

常见错误及修复：

// ❌ 错误示例（最后一行多了逗号）
{
  "name": "Star Seeker",
  "version": "2.0.0",
}

// ✅ 正确格式（去掉最后的逗号）
{
  "name": "Star Seeker",
  "version": "2.0.0"
}

解决方案：

  1. 用VSCode等编辑器打开 manifest.json
  2. 使用JSON格式化工具检查语法
  3. 修复错误后重新加载

❌ 问题4：加载成功但图标灰色

原因： 当前页面不是小红书网站

解决方案：

  1. 打开 https://www.xiaohongshu.com
  2. 点击任意帖子进入详情页
  3. 图标应该变为彩色（可用状态）

❌ 问题5：插件安装后没有悬浮工具栏

原因： Content Script可能未正确注入

解决方案：

  1. 刷新小红书页面（F5）
  2. 打开开发者工具（F12）查看Console是否有错误
  3. 检查是否有其他插件冲突
  4. 尝试删除并重新安装插件

❌ 问题6：提示"未打包的扩展程序"警告

现象：

⚠️ 未打包的扩展程序
此扩展程序不是从Chrome网上应用店安装的

说明： 这是正常现象，不影响使用

解释：

  • 通过开发者模式安装的本地插件会有此提示
  • 这不是错误，只是Chrome的安全提醒
  • 如果想去掉警告，需要将插件发布到Chrome应用商店

如果警告很烦人，可以：

  • 忽略它，不影响功能
  • 或者等我们发布到Chrome应用商店后再安装

🔄 更新插件

方法A：手动更新

  1. 下载新版本的 chrome-extension 文件夹
  2. 覆盖旧文件夹
  3. 在 chrome://extensions/ 页面点击插件卡片的 刷新图标 🔄

方法B：自动更新（应用商店版本）

  • 如果从Chrome应用商店安装，会自动更新
  • 无需手动操作

🗑️ 卸载插件

完全卸载步骤

  1. 打开 chrome://extensions/
  2. 找到"Star Seeker"
  3. 点击 移除 按钮
  4. 确认删除

清理数据

卸载后，如需清理残留数据：

  1. 打开 chrome://settings/clearBrowserData
  2. 选择 高级 选项卡
  3. 勾选 托管应用数据
  4. 点击 清除数据

📚 Edge浏览器安装

Edge浏览器安装步骤与Chrome基本相同：

  1. 打开 edge://extensions/
  2. 开启 开发人员模式
  3. 点击 加载解压缩的扩展
  4. 选择 chrome-extension 文件夹
  5. 完成安装

💡 Edge基于Chromium内核，完全兼容Chrome插件

🆘 仍然无法安装？

获取帮助

  1. 查看详细错误信息

    • 打开开发者工具（F12）
    • 切换到 Console 标签
    • 截图错误信息

  2. 提交Issue

  3. 加入社区

    • QQ群：123456789
    • 微信群：扫描二维码

✅ 安装检查清单

完成安装前，请确认：

  • Chrome版本 ≥ 88
  • 已开启开发者模式
  • 选择了正确的文件夹（包含manifest.json）
  • 插件在扩展程序列表中显示"已启用"
  • 工具栏显示插件图标（或已固定）
  • 打开小红书后页面出现悬浮工具栏
  • 点击插件图标弹窗正常显示

全部打✅？恭喜你安装成功！🎉

📞 技术支持

祝你使用愉快！ 🚀