Skip to content

alai/ReadX

Repository files navigation

ReadX - X.com 阅读模式 Chrome 插件

一个专为 X.com (Twitter) 长帖子设计的阅读模式 Chrome 插件,让你的阅读体验更加舒适。

✨ 功能特色

  • 🎯 智能内容提取: 自动识别并提取 X.com 页面上的主要推文内容
  • 🎨 自定义样式: 支持字体、字号、行距、页面宽度等多项自定义设置
  • 🌙 主题切换: 支持浅色和深色两种主题模式
  • ⌨️ 快捷操作: 双击 ESC 键或点击 X 按钮快速退出阅读模式
  • 📱 响应式设计: 完美适配各种屏幕尺寸
  • 💾 设置保存: 您的个性化设置会自动保存

🚀 安装方法

开发者模式安装

  1. 打开 Chrome 浏览器
  2. 访问 chrome://extensions/
  3. 开启右上角的"开发者模式"
  4. 点击"加载已解压的扩展程序"
  5. 选择 ReadX 插件文件夹
  6. 插件安装完成!

使用方法

  1. 访问任意 X.com 推文页面
  2. 点击浏览器工具栏中的 ReadX 图标
  3. 享受清爽的阅读体验!

🎛️ 控制选项

退出阅读模式

  • 双击 ESC 键: 连续按两次 ESC 键(500ms 内)
  • 点击 X 按钮: 点击左上角的关闭按钮

样式自定义

  • 主题: 浅色/深色模式切换
  • 字号: 14px - 24px 范围调节
  • 行距: 1.2 - 2.5 倍行距调节
  • 宽度: 500px - 900px 页面宽度调节
  • 字体: 系统默认、衬线、无衬线、等宽字体

🛠️ 技术实现

核心技术

  • Manifest V3: 使用最新的 Chrome 扩展标准
  • Content Scripts: 页面内容提取和注入
  • Chrome Storage API: 用户设置的持久化存储
  • DOM 操作: 智能识别推文结构

兼容性

  • ✅ Chrome 88+
  • ✅ 支持 x.com 和 twitter.com 域名
  • ✅ 响应式设计,支持手机和平板访问

📁 文件结构

ReadX/
├── manifest.json          # 插件配置文件
├── background.js          # 后台服务脚本
├── content.js            # 内容脚本(主要逻辑)
├── content.css           # 阅读模式样式
├── tweet_extractor.js    # 内容提取器(独立版本)
├── icons/                # 插件图标目录
├── README.md            # 项目说明
└── feasibility_report.md # 技术可行性分析报告

🎯 使用场景

  • 长篇推文阅读: 特别适合阅读 X.com 上的长文、线程推文
  • 专注阅读: 移除干扰元素,专注于内容本身
  • 个性化体验: 根据个人喜好调整阅读环境
  • 护眼模式: 深色主题减少眼部疲劳

🐛 故障排除

插件无法工作

  • 确保在 x.com 或 twitter.com 页面上使用
  • 检查浏览器是否已禁用插件
  • 尝试刷新页面后重新点击插件图标

内容提取失败

  • 确保页面已完全加载
  • 检查是否在单个推文页面(而不是时间线)
  • 尝试滚动到推文可见区域

样式显示异常

  • 检查浏览器缩放比例是否为 100%
  • 尝试切换主题模式
  • 重置样式设置到默认值

🔒 隐私保护

  • ReadX 只在 X.com 页面上运行
  • 不收集任何个人数据
  • 设置仅保存在本地浏览器中
  • 不向任何服务器发送数据

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目!

📄 许可证

MIT License - 详见 LICENSE 文件


享受更好的 X.com 阅读体验! 📖✨

About

Reader mode for x.com

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published