# 🌟 星图增强插件 - 超简单使用指南

> 适合：完全没用过插件的新手 | 阅读时间：3分钟

---

## 📦 第一步：拿到压缩包

你会从同事那里收到一个文件：

**`star-chart-search-enhancer-internal.zip`**

把它保存在桌面上，不要删掉。

---

## 📂 第二步：解压（右键就行）

1. 在桌面上找到这个压缩包
2. **右键** → 选择"解压到当前文件夹"（或"Extract Here"）
3. 会多出一个文件夹，名字是 `dist`

⚠️ **重要**：这个 `dist` 文件夹要一直放在桌面，不要删、不要改名

---

## 🔧 第三步：安装到 Chrome（只需做一次）

1. 打开 **Chrome 浏览器**
2. 在地址栏输入：
   ```
   chrome://extensions
   ```
   然后按回车

3. 右上角找到 **"开发者模式"** → 打开开关（点一下变蓝色）

4. 点击左上角出现的 **"加载已解压的扩展程序"**

5. 选择刚才解压出来的 `dist` 文件夹

   ⚠️ **重要**：如果 `dist` 文件夹里能看到 `manifest.json`、`content`、`background`、`popup` 这些文件和文件夹，说明选对了。

6. 看到绿色的插件卡片出现，就装好了！

✅ **检查**：点击"详情"，确认 ID 是 `pkjopdibdnomhogjheclhnknmejccffg`

---

## 🔑 第四步：登录（只用登录一次）

1. 点击 Chrome 右上角的 **拼图图标** 🧩
2. 找到 **Star Chart Search Enhancer**
3. 点击 **图钉** 📌 把它固定到工具栏
4. 点击插件图标，然后点 **"登录"**
5. 按提示完成公司账号登录

---

## 🚀 第五步：开始使用

### 打开星图页面

访问：
```
https://xingtu.cn/ad/creator/market
```

等待页面加载，你会看到页面上多了一排新按钮。

---

## 📝 主要功能

### 1️⃣ 导出达人数据（CSV）

当你需要导出达人的内容数据、效果预估、画像时使用：

- 先勾选你想导出数据的达人
- 点击 **"导出选中达人数据"**
- 等待下载完成
- 文件自动下载到电脑的"下载"文件夹

⚠️ **重要**：导出达人数据必须先勾选达人，因为它会额外请求达人详情页数据，不能默认导出全部。

- 内容数据：个人视频/星图视频的播放量中位数、完播率、互动率、发布作品、平均时长、平均点赞、平均评论、平均转发
- 效果预估：不同视频时长的预期CPM、预期CPE、预期播放量、爆文率
- 观众画像、粉丝画像、铁粉画像
- 秒思api数据：看后搜率、看后搜数、新增A3数、新增A3率、CPA3、cp_search

**只导出部分字段**：
- 点击 **"选择字段"**
- 勾选你需要的字段，取消不需要的字段
- 点击 **"保存"**
- 再点击 **"导出选中达人数据"** 或 **"按星图ID导出"**

说明：达人ID、达人名称、导出状态、失败原因等基础字段会固定保留；你保存过一次后，下次导出会自动沿用这次勾选结果，不需要重新勾选。

### 2️⃣ 按ID导出达人数据

当你想批量查询特定达人ID的数据时使用：

- 点击 **"按星图ID导出"**
- 在弹出的对话框中输入达人ID（每行一个）
- 点击确认
- 等待下载完成

**适用场景**：已知一批达人星图ID，需要批量导出这些达人的CSV。

### 3️⃣ 提交批次

- 勾选你想提交的达人
- 点击 **"提交批次"**
- 输入批次名称（例如：`5月母婴达人第一批`）
- 点击确认

### 4️⃣ 更新插件

- 点击浏览器右上角的插件图标
- 在 **"版本更新"** 区域查看是否有新版本
- 如果提示发现新版本，点击 **"下载更新包"** 和 **"下载使用说明"**
- 解压下载到的新版本 zip
- 打开 `chrome://extensions`
- 找到 `Star Chart Search Enhancer`
- 点击 **"重新加载"**，或重新选择解压后的 `dist` 文件夹

---

## 🔄 如何更新插件

收到新版本压缩包时：

1. 删掉桌面上的旧文件夹
2. 解压新的压缩包
3. 打开 `chrome://extensions`
4. 找到插件卡片，点击 **"重新加载"** 🔄

⚠️ **如果重新加载后还是旧版本**：
- 先点击插件卡片的 **"移除"** 删除旧版本
- 然后重新点击 **"加载已解压的扩展程序"**
- 再次选择新解压出来的 `dist` 文件夹

## ♻️ 老用户一次性升级说明

如果你之前安装的是较早的旧版本，并且插件弹窗里一直显示：

- `暂时无法检查更新`

那通常说明你本地还在使用“旧更新机制”的插件包。

这种情况下，需要**手动用一次最新压缩包升级**：

1. 下载最新的 `star-chart-search-enhancer-internal.zip`
2. 解压后得到新的 `dist` 文件夹
3. 打开 `chrome://extensions`
4. 删除旧插件，或重新点击 **"加载已解压的扩展程序"**
5. 重新选择新的 `dist` 文件夹

完成这一次“过桥升级”后，后面再看到新版本时，就可以继续按统一的 `dist` 更新方式操作。

---

## ❓ 常见问题

### Q: 页面没有多出按钮？
A: 先点击插件图标确认已登录，然后刷新页面（按 F5）

### Q: 提示登录失败？
A: 关闭弹窗再试一次，或检查网络连接

### Q: 导出没反应？
A: 检查浏览器的下载列表，文件可能已经下好了

### Q: 不小心把文件夹删了？
A: 重新解压压缩包，然后到 `chrome://extensions` 点"重新加载"

### Q: 我已经在用插件了，还需要再用一次压缩包更新吗？
A: 如果你当前弹窗能正常显示 `发现新版本`，就不需要额外做特殊处理，按普通更新步骤走即可。如果弹窗一直只显示 `暂时无法检查更新`，建议手动用最新压缩包重新安装一次 `dist`，完成一次性升级。

---

## ✅ 每日使用 checklist

- [ ] 打开 Chrome，确认插件图标在
- [ ] 点击图标，确认显示"已登录"
- [ ] 打开星图页面
- [ ] 正常使用导出/提交功能

---

## 🆘 还是不行？

把下面信息发给同事：
1. 你在哪一步卡住了
2. 页面截图
3. 扩展 ID（从 chrome://extensions 里看）

**记住正确的 ID：`pkjopdibdnomhogjheclhnknmejccffg`**