kaikai_test/团队操作指引（从打开到手机同步，先看这个）.md

节目热度采集工具团队操作指引

这份文档给团队日常使用人员看。按步骤操作即可，不需要懂代码。

1. 先确认打开的是这个项目包

项目文件夹名称是：

video-hotness-desktop-app

所在位置一般是：

X:\！！！！媒资小工具\抓取视频网站数据-桌面App开发-20260513\video-hotness-desktop-app

进入这个文件夹后，日常只需要关注下面几个文件：

• 节目热度采集工具-独立窗口版.exe
• 安装桌面App到桌面（只需一次）.vbs
• 开启节目热度采集工具开机自启动.exe
• 取消节目热度采集工具开机自启动.exe
• 团队操作指引（从打开到手机同步，先看这个）.md

不要手动删除或移动这些文件夹：

• data
• public
• runtime
• src
• test

其中 data 里保存历史数据和同步数据，最重要。

2. 第一次使用：安装桌面快捷方式

如果你希望以后直接从桌面打开：

1. 打开项目文件夹。
2. 双击 安装桌面App到桌面（只需一次）.vbs。
3. 桌面上会出现一个快捷方式。
4. 以后可以直接双击桌面快捷方式打开。

如果不想安装桌面快捷方式，也可以每次直接双击项目包里的 节目热度采集工具-独立窗口版.exe。

3. 每天打开电脑端

1. 打开项目文件夹。
2. 双击 节目热度采集工具-独立窗口版.exe。
3. 等待独立 App 窗口自动打开。
4. 页面标题是 节目热度采集。
5. 页面里会看到 桌面开发版 标识。

正常情况下会打开类似这个地址：

http://127.0.0.1:3001/

端口不一定永远是 3001。如果电脑上有旧版本占用了端口，工具会自动换一个可用端口，例如 3000、3001、3002。

4. 每天关闭电脑端

不要只点窗口右上角关闭。点右上角关闭后，工具会隐藏到后台继续运行。

正确关闭方式：

1. 在 App 顶部菜单点击 工具。
2. 点击 退出后台。
3. 等几秒即可。

如果只是临时隐藏独立 App 窗口，可以从右下角托盘重新打开。

5. 电脑端采集单个节目

适合只查一个节目。

1. 打开电脑端页面。
2. 在顶部输入框输入节目名。
3. 确认平台勾选：
   • 腾讯视频
   • 优酷
   • 爱奇艺
   • 芒果TV
4. 如果你已经有某个平台的节目页链接，可以填到对应 URL 输入框。
5. 如果没有链接，可以不填，工具会自动搜索。
6. 点击 采集一次。
7. 等待结果出现。

结果说明：

• 有数字：说明抓到了该平台指标。
• 未找到：说明这次没有匹配到节目页。
• 无指标：说明找到了页面，但页面里没有抓到可用指标。
• 风控/错误：说明平台限制、网络、页面变化或程序请求失败。

6. 保存节目链接库

如果某个节目自动搜索不稳定，建议手动保存链接。

操作方法：

1. 输入节目名。
2. 填入对应平台 URL。
3. 如果节目还有别名，填在 别名 输入框。
4. 点击 保存链接库。

保存后，下次采集这个节目时，工具会优先使用已保存的链接。

7. 采集全部历史节目

适合每天统一更新一遍已有节目。

1. 打开电脑端页面。
2. 确认顶部平台勾选是否正确。
3. 点击左上方 采集全部历史节目。
4. 弹出确认窗口后，确认数量没问题。
5. 点击确认。
6. 等任务队列跑完。

注意：

• 这个操作会给每个历史节目新增一次采集记录。
• 如果节目很多，会比较久。
• 中途不要反复刷新页面。

历史时间列太多时怎么看

当某个节目已经采集了很多次，表格会默认只显示最近 12 次采集结果。

这样最新数据会靠前显示，不需要一直横向拖动找最新日期。

如果需要查看更早的数据：

1. 打开某个历史节目。
2. 看表格右上角提示，例如 默认显示最近 12 次，隐藏 31 个旧列。
3. 点击 展开旧列。
4. 表格会恢复显示全部历史时间列。
5. 看完后点击 收起旧列，会重新回到只看最近 12 次的状态。

注意：

• 旧列只是临时隐藏，没有删除数据。
• 导出 CSV 仍然会包含历史数据。
• 进入 批量删除列 时会显示全部列，方便确认要删除哪一次采集。

8. 复查无数据

适合处理之前没有搜到、没有指标、风控或错误的节目。

这个功能可以减少“节目后来上线了，但是我们不再抓”的风险。

操作方法：

1. 打开电脑端页面。
2. 确认顶部平台勾选。
3. 点击 复查无数据。
4. 弹出确认窗口后点击确认。
5. 等待任务完成。

它只会重点重试历史里失败的平台，不会把已经正常的数据全部重复采一遍。

9. 临时查询：只查一次，不写入历史

适合临时拿一批节目查数据，但不想加入历史库。

位置：

电脑端页面下方的 临时查询 区域。

操作方法：

1. 找到 临时查询。
2. 把节目列表粘贴进去。
3. 每行一个节目名。
4. 确认平台勾选。
5. 点击 一键查询。
6. 查询结果会在临时查询区域显示。
7. 如需导出，点击 导出临时 CSV。

注意：

• 临时查询不会写入历史数据。
• 临时查询结果可以单独导出。
• 如果勾选 保存成功链接，成功找到的链接可以写入链接库，方便以后正式采集。

10. 临时查询导入 Excel、CSV、TXT 或截图

在 临时查询 区域可以导入列表。

方法一：点按钮导入

1. 点击 导入列表。
2. 选择 Excel、CSV、TXT 或图片文件。
3. 导入后检查文本框里的节目名是否正确。
4. 再点击 一键查询。

方法二：直接拖进去

1. 把 Excel、CSV、TXT 或截图文件拖到临时查询文本框。
2. 松开鼠标。
3. 检查识别出来的节目名。
4. 再点击 一键查询。

截图识别注意：

• 截图里的节目名尽量清晰。
• 不要把太多无关文字截进去。
• 识别后一定人工检查一遍，避免错字。

11. 导出数据

导出当前节目：

1. 先在历史节目中打开一个节目。
2. 点击顶部 导出 CSV。

导出全部节目：

1. 点击顶部 导出全部。
2. 浏览器会下载全部历史数据 CSV。

临时查询导出：

1. 在 临时查询 区域完成查询。
2. 点击 导出临时 CSV。

12. 手机版入口

手机版用于手机快速录入和简单采集。

电脑端必须先打开。然后在电脑端或手机端找到手机访问地址。

常见地址格式：

http://电脑局域网IP:端口/mobile.html

例如：

http://192.168.1.23:3001/mobile.html

手机打开方法：

1. 确认电脑端已经打开。
2. 手机和电脑连接同一个 WiFi。
3. 在手机浏览器输入手机访问地址。
4. 打开后看到 节目热度采集 手机页面。

安装到手机桌面：

1. 如果页面出现 安装 按钮，直接点击 安装。
2. 如果没有出现安装按钮，打开手机浏览器菜单。
3. 选择 添加到主屏幕 或类似选项。
4. 以后可以从手机桌面图标打开。

第一次打开后，建议先绑定电脑地址：

1. 找到 手机 App 设置。
2. 在 电脑 / NAS 地址 里填电脑端地址，例如 http://192.168.1.23:3001。
3. 点击 保存地址。
4. 点击 测试连接。
5. 如果提示连接正常，之后手机会优先用这个地址同步。

如果以后改成 NAS 或另一台值班电脑，只需要在这里重新保存新地址。

如果手机访问不了：

• 先确认手机和电脑是不是同一个 WiFi。
• 电脑不要连公司访客 WiFi，访客 WiFi 有时会隔离设备。
• 可以让手机连接电脑开的热点。
• 也可以电脑和手机都使用同一个组网工具，例如 Tailscale。

13. 手机版在线采集一次

手机和电脑在同一网络时，可以直接用手机触发采集。

1. 手机打开 /mobile.html。
2. 先在 这台手机/录入人 里填写来源名称，例如 张三手机、商务部手机。
3. 点击 保存名称。
4. 输入节目名。
5. 可选：填写平台 URL。
6. 可选：填写备注。
7. 勾选平台。
8. 点击 采集一次。
9. 等待结果。

这个操作会通过电脑端服务采集数据。

14. 手机离线录入：没连电脑时先保存

适合外出、手机用流量、暂时连不上电脑时使用。

前提：

手机至少曾经在局域网里打开过一次手机版页面。这样浏览器才会缓存手机版页面。

操作方法：

1. 手机打开之前保存过的手机版页面。
2. 确认 这台手机/录入人 已经填好。
3. 输入节目名。
4. 可选：填写 URL。
5. 可选：填写备注。
6. 点击 保存待同步。
7. 记录会出现在 手机待同步 列表里。

注意：

• 这一步只保存在手机本机浏览器里。
• 不会马上进入电脑。
• 不会马上写入历史数据。
• 不要随便清理手机浏览器数据，否则待同步记录可能丢失。

15. 手机批量离线录入

适合开会时一次拿到很多节目名。

1. 打开手机版页面。
2. 找到 批量离线录入。
3. 把节目名单粘贴进去。
4. 每行一个节目名。
5. 点击 批量保存待同步。
6. 保存后，记录会进入 手机待同步 列表。

注意：

• 批量保存只存到手机本机。
• 回到能访问电脑端的网络后，还需要点击 同步到电脑。

16. 编辑或删除手机待同步记录

在 手机待同步 列表里，每条记录下面有操作按钮。

编辑：

1. 点击某条记录的 编辑。
2. 按提示修改节目名。
3. 按提示修改备注。
4. 保存后，该条记录会重新变成待同步状态。

删除：

1. 点击某条记录的 删除。
2. 确认删除。
3. 删除后不会同步到电脑。

17. 手机同步到电脑

当手机回到可以访问电脑端的网络后：

1. 确认电脑端已经打开。
2. 手机重新打开手机版页面。
3. 确认手机能访问电脑端地址。
4. 在 手机待同步 区域点击 同步到电脑。
5. 成功后，手机会提示 电脑已收到。
6. 手机记录会显示 已同步。

同步后的数据不会直接写入历史采集表。

它会进入电脑端的 手机同步待处理 区域。

18. 电脑端处理手机同步记录

手机同步成功后，回到电脑端。

1. 打开电脑端页面。
2. 找到 手机同步待处理 区域。
3. 查看手机同步来的节目。
4. 如果要正式采集，点击该记录里的 填入采集栏。
5. 节目名和已有 URL 会填到顶部采集栏。
6. 检查节目名、平台、URL。
7. 点击 采集一次。

这样做的好处：

• 手机同步来的内容先进入待处理队列。
• 团队成员可以人工确认。
• 不会把误录入的节目直接写进历史数据。

19. 半自动值班工具

电脑端有 半自动值班 区域，用来减少每天重复操作。

可以设置：

• 每天复查无数据
• 每天采集历史节目
• 完成后导出 CSV 并备份
• 执行时间

保存设置：

1. 打开电脑端。
2. 找到 半自动值班。
3. 勾选需要的任务。
4. 设置执行时间。
5. 点击 保存值班设置。

立即执行一次：

1. 找到 半自动值班。
2. 确认勾选项。
3. 点击 立即执行一次。
4. 等待状态显示完成。

自动执行说明：

• 电脑端服务必须开着，定时值班才会执行。
• 如果电脑关机、工具没打开、后台服务没运行，到点不会自动执行。
• 每天同一设置只会自动跑一次。
• 导出的 CSV 会保存到 data/exports。
• 备份会保存到 data/backups。

建议：

• 第一次不要直接勾选所有项目。
• 可以先只勾选 完成后导出 CSV 并备份，点 立即执行一次 测试。
• 确认没问题后，再开启每天复查或每天采集。

20. 什么情况会导致数据不准

常见原因：

• 节目刚上线，平台搜索还没同步。
• 平台页面能打开，但指标还没有展示。
• 平台改版，页面结构变化。
• 搜索结果匹配到了同名或相似节目。
• 平台限制访问，出现风控。
• 手动填的 URL 不是节目主页，而是搜索页或短链中转页。

建议处理方式：

• 新节目第一次没数据，不要马上判定没有上线。
• 过一两天用 复查无数据 再查。
• 如果自动搜索不稳定，手动找到节目页 URL 后保存链接库。
• 临时名单先用 临时查询，确认有价值后再加入历史。

21. 不要做的事情

不要删除：

• data
• runtime
• src
• public

不要直接修改：

• data/history.json
• data/link-library.json
• data/mobile-sync.json

不要把项目文件夹只复制一半给别人。要复制就复制完整 video-hotness-desktop-app 文件夹。

不要同时开多个不同版本反复采集同一批节目，容易导致团队不知道哪份数据是准的。

22. 常见问题

双击打开没反应

先等 10 秒。如果还是没反应：

1. 再双击 节目热度采集工具-独立窗口版.exe。
2. 如果还是不行，双击 节目热度采集工具-独立窗口版.exe。
3. 看黑色窗口里有没有报错。
4. 把报错截图发给维护人员。

手机打不开

按顺序检查：

1. 电脑端是否已经打开。
2. 手机和电脑是否同一个 WiFi。
3. 手机访问地址里的 IP 和端口是否正确。
4. 电脑是否连了 VPN 或访客网络。
5. Windows 防火墙是否拦截。

手机离线记录不见了

可能原因：

• 清理了手机浏览器缓存。
• 换了浏览器。
• 换了手机。
• 使用了无痕模式。

建议固定使用同一个手机浏览器，不要用无痕模式。

同步到电脑后历史里没看到

这是正常的。

手机同步后先进入电脑端 手机同步待处理，需要人工点击 填入采集栏，再点击 采集一次，才会写入历史。

值班工具到点没有自动执行

按顺序检查：

1. 电脑端是否打开。
2. 是否保存了值班设置。
3. 是否勾选了至少一个值班任务。
4. 电脑是否睡眠或关机。
5. 后台服务是否被关闭。

临时查询结果为什么历史里没有

这是正常的。

临时查询的设计就是只查一次，不写入历史。需要保留到历史时，请用正式采集。

23. 推荐日常流程

每天统一采集：

1. 打开电脑端。
2. 如果已设置 半自动值班，先看值班状态。
3. 如需手动，点击 复查无数据。
4. 点击 采集全部历史节目。
5. 导出需要的 CSV。
6. 关闭电脑端。

临时节目名单：

1. 用 临时查询 导入名单。
2. 先看哪些节目有数据。
3. 有价值的节目再正式录入历史。

手机外出录入：

1. 手机上输入节目。
2. 点 保存待同步。
3. 多节目时使用 批量离线录入。
4. 回到电脑网络后点 同步到电脑。
5. 电脑端在 手机同步待处理 人工确认。
6. 需要正式采集的再点 填入采集栏 和 采集一次。