star-chart-search-enhancer/docs/【给同事】从Git下载使用说明.md

135 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📥 从 Git 下载使用插件
> 适合:第一次从 Git 仓库下载的同事
---
## 第一步:安装 Git如果还没装
**Mac 用户**
打开终端,输入:
```bash
git --version
```
如果没安装,系统会提示你安装。
**Windows 用户**
1. 访问 https://git-scm.com/download/win
2. 下载并安装(一直点"下一步"即可)
---
## 第二步:下载插件代码
打开终端Mac或命令提示符/PowerShellWindows输入
```bash
cd Desktop
git clone https://git.internal.intelligrow.cn/wangshaoqing/star-chart-search-enhancer.git
```
等待下载完成,桌面上会出现一个文件夹 `star-chart-search-enhancer`
---
## 第三步:安装插件到 Chrome
1. 打开 Chrome 浏览器
2. 地址栏输入 `chrome://extensions` 并回车
3. 右上角打开 **"开发者模式"**
4. 点击 **"加载已解压的扩展程序"**
5. 选择桌面上的这个路径:
```
star-chart-search-enhancer/dist-release/
```
⚠️ **重要**:必须选择 `dist-release` 这个子文件夹,不要选外层文件夹
✅ 安装成功!你会看到插件卡片。
---
## 第四步:确认扩展 ID
点击插件卡片的 **"详情"**,确认 ID 是:
**`pkjopdibdnomhogjheclhnknmejccffg`**
如果这个 ID 不对,说明下载有问题,请联系我。
---
## 第五步:登录并开始使用
1. 点击 Chrome 右上角的拼图图标 🧩
2. 找到 **Star Chart Search Enhancer**,点击图钉 📌 固定
3. 点击插件图标 → **登录**
4. 完成公司账号登录
5. 打开星图页面开始使用
---
## 🆕 最近修复
当前版本已修复:
- 在星图搜索关键词后,左侧插件勾选框和右侧达人行可能逐行错位的问题
如果你之前已经装过旧版本,请务必按下面的“后续更新”步骤执行一次更新和重新加载。
---
## 🔄 后续更新
当我发布新版本时,你只需要:
```bash
cd Desktop/star-chart-search-enhancer
git pull
npm run build:release
```
然后到 `chrome://extensions` 页面点击插件卡片的 **"重新加载"** 🔄
推荐完整更新顺序:
1. 先关闭星图页面标签页
2. 执行 `git pull`
3. 执行 `npm run build:release`
4. 到 `chrome://extensions` 点击插件卡片的 **"重新加载"**
5. 重新打开星图页面
如果你主要使用的是“达人市场”页面,更新后可以这样快速确认修复是否生效:
1. 打开 `https://xingtu.cn/ad/creator/market`
2. 在搜索框输入关键词,例如 `孕晚期`
3. 向下滚动到达人列表区域
4. 确认左侧勾选框和右侧达人行保持对齐
⚠️ **如果重新加载后还是旧版本**
- 先点击插件卡片的 **"移除"** 删除旧版本
- 然后重新点击 **"加载已解压的扩展程序"**
- 再次选择 `dist-release` 文件夹
---
## ❓ 常见问题
**Q: 提示 "git 不是内部或外部命令"**
A: Git 没装好,请先安装 Git。
**Q: 下载后找不到 dist-release 文件夹?**
A: 请确认下载的是最新版本,可以重新执行 `git pull`。
**Q: 加载后扩展 ID 不对?**
A: 请检查是否选择了 `dist-release` 文件夹,而不是外层文件夹。
---
## 📞 需要帮助?
如果以上步骤遇到问题,请截图发给我:
1. 你在哪一步卡住了
2. 完整的错误提示
3. Chrome 扩展页面的截图