一个简单易用的用户脚本，通过在Twitter/X顶部向上滚动来快速刷新时间线，并支持快速返回页面顶部。
A simple userscript that allows you to refresh Twitter/X timeline by scrolling up at the top of the page, with quick scroll-to-top functionality.
- 🔄 智能刷新: 在页面顶部向上滚动即可刷新时间线
- ⬆️ 快速到顶: 按住Shift键向上滚动快速返回页面顶部
- 🎯 精确路径: 只在主页时间线页面生效，避免误触发
- 🌐 双语支持: 支持中文和英文界面
- ⚙️ 可自定义设置: 调整滚动阈值、冷却时间等参数
- 🔔 通知提示: 可选的刷新状态通知
- 🐛 调试模式: 开发者友好的调试选项
- 🎯 多方法兼容: 支持多种刷新方式，确保在不同情况下都能正常工作
-
首先安装用户脚本管理器:
-
点击下面的链接安装脚本: 安装脚本 / Install Script
- 打开 Twitter/X 网站 (
x.com/home) - 滚动到页面顶部
- 继续向上滚动即可触发刷新
- 在页面任意位置
- 按住 Shift 键
- 向上滚动鼠标滚轮
- 即可平滑滚动到页面顶部
就这么简单！脚本会自动检测你的操作并执行相应功能。
点击用户脚本管理器中的"设置"按钮，或使用快捷菜单来访问设置面板：
- 滚动阈值 (Scroll Threshold): 触发刷新的滚动敏感度 (默认: 30)
- 刷新冷却时间 (Refresh Cooldown): 两次刷新之间的最小间隔 (默认: 1500ms)
- 顶部偏移量 (Top Offset): 判定"顶部"的像素偏移 (默认: 10px)
- 启用滚轮到顶部 (Enable Scroll to Top): 开启Shift+向上滚轮功能 (默认: 开启)
- 滚轮到顶部冷却时间 (Scroll to Top Cooldown): 两次到顶操作的最小间隔 (默认: 2000ms)
- 显示通知 (Show Notifications): 是否显示刷新状态通知
- 调试模式 (Debug Mode): 开启控制台调试信息
- 语言设置 (Language): 选择界面语言
脚本使用多种方法来确保刷新功能的可靠性：
- 主页标签点击: 在主页时点击Home标签
- 刷新按钮检测: 查找页面上的刷新按钮
- 键盘快捷键: 模拟按下'.'键（Twitter的内置快捷键）
- 新帖子按钮: 查找并点击"显示新帖子"类型的按钮
- 精确路径检测: 只在
/home和/home/路径下启用功能 - Shift键检测: 监测Shift键按下状态
- 滚轮方向检测: 只响应向上滚轮操作
- 冷却机制: 防止频繁触发滚动到顶部
- 平滑滚动: 使用浏览器的平滑滚动API
脚本只在以下路径生效：
https://x.com/homehttps://x.com/home/
在其他页面（如帖子详情、通知、消息等）不会触发任何功能，避免误操作。
如果遇到问题，请在 GitHub Issues 中反馈。
- ✨ 新增 Shift + 向上滚轮 快速到顶部功能
- 🎯 改进路径检测，只在主页时间线页面生效
- 🛠️ 简化设置界面，移除复杂的操作方式选择
- 🐛 修复在帖子详情页面误触发的问题
- 📝 更新文档和使用说明
- 🐛 修复累积滚动阈值难以控制的问题
- 🔄 重构滚轮事件处理逻辑
- ✨ 新增滚轮到顶部功能
- 🎯 支持多种操作方式：双击滚轮、Shift+滚轮、长按滚轮
- ⚙️ 新增相关设置选项
- 🌐 完善国际化支持
- 🐛 修复刷新逻辑的兼容性问题
- 🔄 初始版本发布
- ⚙️ 基础刷新功能
- 🌐 双语界面支持
MIT License - 详见 LICENSE 文件。