﻿==============================================================
            热榜助手 · 科技版  使用说明
            作者：大宇　｜　免费 · 无广告 · 不需要登录
==============================================================

一个页面刷遍全网热榜：百度、微博、知乎、B站、抖音、今日头条、
IT之家、雪球、财联社、GitHub 等 130 多个平台的热搜集中显示，
后台定时抓取、实时刷新，排名涨跌一眼看清。

在线介绍 / 下载页：https://rebang-dayu.pages.dev


--------------------------------------------------------------
一、第一次使用前的准备（只需一次）
--------------------------------------------------------------

1. 安装 Python 3.8 或更新版本
   下载地址：https://www.python.org/downloads/
   ★ 安装时务必勾选最下面的「Add Python to PATH」，
     否则双击启动会提示"没有找到 Python"。

2.（可选）让网页解析更准：
   按 Win+R，输入 cmd 回车，在黑色窗口里输入：
       pip install lxml
   回车等待安装完成即可。不装也能正常使用。

3. 把整个「热榜助手」文件夹放在任意位置（不要只拷贝其中几个文件）。


--------------------------------------------------------------
二、打开与关闭
--------------------------------------------------------------

【打开】双击「热榜助手（后台启动）.vbs」
   · 不会出现黑色窗口，浏览器自动打开热榜页面
   · 网址是 http://127.0.0.1:8930/ ，建议加入浏览器收藏夹
   · 关掉浏览器后软件仍在后台运行，下次直接打开收藏的网址即可
   · 已经在运行时再双击，只会打开网页，不会重复启动

【关闭】双击「关闭热榜助手.vbs」，会弹出"热榜助手已关闭"的提示。
   不关也没关系，占用资源很少；重启电脑后会自动停止。

【想要桌面图标】右键「热榜助手（后台启动）.vbs」→ 发送到 → 桌面快捷方式。

【带窗口启动（排查问题用）】双击「启动热榜助手.bat」
   会出现一个黑色窗口显示运行信息。注意：关掉这个黑窗口，软件就停止了。


--------------------------------------------------------------
三、界面与功能
--------------------------------------------------------------

■ 顶部分类栏
   综合 / 财经 / 娱乐 / 科技 / 社区 / 国际新闻 / 小说 / 资源 / Agent，
   点一下只看该分类。
   · 🏆 总排行：全部源按热度合并成一张大榜
   · 📍 地区新闻：先在 设置 → 常规 里填写省 / 市

■ 左侧栏
   · 聚合热榜：回到总览
   · 收藏媒体：只看你收藏的媒体（见下方 ☆）
   · 我的收藏 / 浏览记录：收藏的新闻、看过的新闻
   · 新闻源列表：鼠标移到某个源上会出现三个按钮
       ☆ 收藏此媒体　　📌 置顶　　✕ 删除此源
     还可以按住拖动调整顺序。
     源名前的小圆点：绿 = 抓取正常，红 = 抓取失败，灰 = 还没有数据

■ 两种视图
   看板（每个源一个卡片）/ 列表（紧凑排列），右上角切换。
   卡片底部「浏览更多」可查看该源的全部条目，并可跳转站内搜索。

■ 实时刷新
   右上角倒计时圆环，到点自动刷新；点圆环立即刷新全部。
   刷新间隔可在 设置 → 常规 里选 30 秒 ~ 10 分钟。
   排名旁的标记：▲ 上升　▼ 下降　NEW 新上榜

■ 其他
   · 搜索：输入关键词，所有视图实时过滤
   · 语音朗读：逐源连读，每源 10 条，语速可调
   · 收藏新闻：点条目旁的 ★
   · 顶部快讯滚动条：各源头条横向滚动

■ 快捷键
   /  搜索　　R  刷新　　B  看板/列表切换　　T  深色/浅色主题　　Esc  关闭弹窗


--------------------------------------------------------------
四、设置（右上角 ⚙ 或左下角「设置」）
--------------------------------------------------------------

· 常规：刷新间隔、地区、每个卡片显示条数等
· 外观：深色 / 浅色、7 种配色、字号、背景图片与浓度
· 新闻源：
    - 每个源都可以开关、改名、改分类、改条数、改地址、测速
    - 分类管理：点某个分类标签，下方会列出该分类的全部媒体，
      点媒体名可直接开 / 关；也可以新建、改名、删除分类
    - 一键全开 / 全部关闭、导出 / 导入、勾选后批量删除
    - 「＋ 新增源」：填网址即可添加自己的热榜（先点「测试」看能否抓到）
    - 「载入默认源」：恢复成默认的新闻源列表
      （注意：会覆盖你对源列表做的所有修改，包括自己添加的源）
· 关于：版本信息、安全说明、支持作者


--------------------------------------------------------------
五、用手机看
--------------------------------------------------------------

1. 先关闭已经在运行的热榜助手（双击「关闭热榜助手.vbs」）
2. 双击「局域网模式-手机访问.bat」，黑色窗口里会显示一个「手机打开」地址
3. 手机连接和电脑同一个 WiFi，浏览器打开那个地址
4. 可以用浏览器菜单「添加到主屏幕」，像 App 一样使用
   （使用期间不要关闭电脑上的黑色窗口）


--------------------------------------------------------------
六、常见问题
--------------------------------------------------------------

问：双击后提示"没有找到 Python"？
答：没装 Python，或安装时没勾选「Add Python to PATH」。
    重新运行 Python 安装程序 → Modify / 修改 → 勾选该项，或卸载后重装。

问：双击后浏览器没有打开 / 打不开页面？
答：手动在浏览器打开 http://127.0.0.1:8930/ 。
    还不行就双击「启动热榜助手.bat」，看黑色窗口里的报错；
    后台模式的运行记录在「后台日志.txt」。

问：提示"端口 8930 已被占用"？
答：说明热榜助手已经在运行，直接打开 http://127.0.0.1:8930/ 即可。

问：有些源显示红点、没有内容？
答：个别网站临时故障或调整了页面，可在 设置 → 新闻源 里点「测速」重试，
    长期失败的可以关掉。国际新闻和部分海外小说站在国内网络下可能打不开，
    默认是关闭的，需要的话开代理后再打开。

问：删掉的新闻源怎么找回？
答：设置 → 新闻源 →「载入默认源」（会覆盖你对源列表的其他修改）。

问：换电脑 / 换浏览器后收藏和设置不见了？
答：收藏、记录、设置都保存在浏览器里，不在文件夹中。
    可在 设置 → 新闻源 → 导出，到新电脑上再导入新闻源设置。

问：苹果电脑 / Linux 能用吗？
答：能。打开「终端」，进入本文件夹，运行：python3 server.py
    然后浏览器打开 http://127.0.0.1:8930/ 。（.bat / .vbs 文件只适用于 Windows）


--------------------------------------------------------------
七、安全说明
--------------------------------------------------------------

· 只在你自己的电脑上运行，抓取各网站公开的榜单页面，缓存在本机
· 没有账号系统、没有数据上报、没有埋点统计
· 收藏、记录、设置都只保存在你本机的浏览器里
· 默认只允许本机访问，其它网页无法借用它访问你的内网
· 源代码完全公开，可随时查看


--------------------------------------------------------------
八、文件说明
--------------------------------------------------------------

热榜助手（后台启动）.vbs   ← 平时双击这个打开
关闭热榜助手.vbs           关闭后台
启动热榜助手.bat           带黑窗口启动（排查问题用）
局域网模式-手机访问.bat     让同一 WiFi 下的手机也能访问
launcher.pyw               后台启动器（上面两个 .vbs 会调用它）
server.py                  后台程序：抓取、缓存、定时刷新
sources.json               默认新闻源列表
oscar.json                 奥斯卡最佳影片离线数据
static\                    网页界面
后台日志.txt               后台模式的运行记录（运行后自动生成）
使用说明.txt               本文件


--------------------------------------------------------------
觉得好用，可以在 设置 → 关于 里扫码支持作者，金额随意，完全自愿。
愿你的信息流清爽一点，别再被推荐算法牵着走。　—— 大宇
