知识星球阅读模式增强器

为知识星球提供纯净的阅读模式,隐藏侧边栏和导航栏,自动展开内容,专注阅读体验

作者
东哥说AI
日安装量
0
总安装量
2
评分
0 0 0
版本
1.0.0
创建于
2025-07-03
更新于
2025-07-03
大小
10.3 KB
许可证
MIT
适用于

知识星球阅读模式增强器

一个专为知识星球设计的油猴脚本,提供纯净的阅读体验,让你专注于内容本身。

✨ 功能特性

🎯 核心功能

  • 一键切换阅读模式:点击右下角浮动按钮即可进入/退出阅读模式
  • 智能隐藏干扰元素:自动隐藏左右侧边栏和顶部导航栏
  • 自动展开内容:进入阅读模式时自动点击所有"展开全部"按钮
  • 滚动智能展开:滚动过程中自动展开新出现的内容
  • 位置记忆功能:切换模式时保持当前阅读位置不变

🎨 界面优化

  • 宽屏居中布局:内容区域居中显示,最大宽度1000px,提供更舒适的阅读体验
  • 时间轴优化:时间轴贴合内容右侧,不重叠遮挡内容
  • 卡片式设计:每个话题采用卡片式布局,视觉层次清晰
  • 现代化UI:右下角渐变按钮、柔和阴影,不干扰阅读
  • 状态提示:操作时在右下角显示友好的通知消息

🔧 智能特性

  • 状态持久化:记住用户的阅读模式偏好
  • SPA路由支持:支持知识星球的单页应用路由切换
  • 性能优化:智能检测页面加载状态,避免重复初始化

🚀 安装使用

前置要求

  • 安装 Tampermonkey 浏览器扩展
  • 支持的浏览器:Chrome、Firefox、Safari、Edge

安装步骤

  1. 复制 ZsxqReadingMode.user.js 文件内容
  2. 打开 Tampermonkey 管理面板
  3. 点击「添加新脚本」
  4. 粘贴脚本内容并保存
  5. 访问任意知识星球页面即可使用

使用方法

  1. 进入阅读模式:点击页面右上角的「📖 阅读模式」按钮
  2. 退出阅读模式:点击「🔙 退出阅读」按钮
  3. 自动展开:进入阅读模式后会自动展开所有内容
  4. 滚动阅读:向下滚动时会自动展开新出现的内容

🎯 适用页面

脚本会在以下页面自动激活:

🔧 技术实现

核心技术

  • CSS选择器定位:基于实际HTML结构精确定位元素
  • MutationObserver:监听DOM变化,支持SPA路由
  • LocalStorage:持久化用户偏好设置
  • 定时器管理:智能的内容展开和滚动监听

关键元素定位

根据提供的HTML文件分析,脚本定位以下关键元素:

// 左侧边栏:星球列表
.group-list-container, app-group-list

// 右侧边栏:星球信息
.group-preview-wrapper, app-group-info

// 主内容区域
.topic-flow-container

// 展开按钮
.showAll

// 内容容器
.talk-content-container .content

样式优化

  • 响应式布局:内容区域自适应屏幕宽度
  • 视觉层次:通过阴影和圆角提升视觉体验
  • 动画效果:平滑的过渡动画和悬停效果

⚙️ 配置选项

脚本内置以下可配置参数:

const CONFIG = {
    buttonText: '📖 阅读模式',           // 按钮文本
    exitButtonText: '🔙 退出阅读',       // 退出按钮文本
    autoExpandDelay: 500,              // 自动展开延迟(ms)
    scrollCheckInterval: 1000,         // 滚动检查间隔(ms)
    storageKey: 'zsxq_reading_mode'    // 本地存储键名
};

🐛 故障排除

常见问题

Q: 脚本没有生效? A: 请检查:

Q: 阅读模式按钮没有出现? A: 请等待页面完全加载,脚本会在检测到主要内容后自动创建按钮

Q: 自动展开功能不工作? A: 脚本会持续监听页面变化,如果某些内容没有展开,可能是因为:

  • 内容还在加载中
  • 元素结构发生了变化

调试信息

脚本会在浏览器控制台输出调试信息:

[知识星球阅读模式] 脚本已初始化
[知识星球阅读模式] 已启用阅读模式
[知识星球阅读模式] 自动展开了 X 个内容

📝 更新日志

v1.0.0 (2025-07-02)

  • 🎉 首次发布,实现基础阅读模式功能
  • ✨ 支持自动展开内容和位置记忆
  • 🎨 优化界面设计和用户体验:
    • 阅读模式按钮移至右下角
    • 隐藏顶部导航栏
    • 内容区域宽度优化至1000px
    • 优化时间轴位置布局

📞 联系开发者

个人微信:donggeai02
个人微信
扫码添加开发者微信
与开发者面对面交流
微信交流群:实用工具分享
AI工具微信交流群
加入用户交流群
分享使用经验和建议
微信公众号:东哥说AI
微信公众号
关注获取最新动态
第一时间了解新功能

❗ 注意事项

⚠️ 重要提醒:

  • 请在使用前仔细阅读脚本说明文档
  • 建议在测试环境中先试用脚本
  • 如遇到问题,请先查看上方FAQ部分
  • 不要在重要会议中首次使用未测试的脚本

📋 使用建议:

  • 定期更新脚本到最新版本
  • 关注项目动态,及时了解重要更新
  • 遇到问题时提供详细的环境信息和错误描述
  • 尊重知识星球的使用条款和服务协议

🌟 支持项目

如果这个脚本对你有帮助,请考虑:

  • 给项目点星: 在GitHub上给项目点个星,让更多人发现
  • 🔄 分享推荐: 向朋友和同事推荐这个实用工具
  • 💬 反馈建议: 提供使用反馈和改进建议
  • 🤝 参与贡献: 贡献代码、文档或测试

⭐ 如果这个脚本对你有帮助,请给项目点个星!

🐛 遇到问题? 提交Issue

💡 有建议? 参与讨论

📧 商务合作: 请通过上方微信联系