Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Awesome LinuxDo Reader

Awesome LinuxDo Reader

为 LINUX DO 深度定制并保持完整功能覆盖,同时通过站点识别与能力检测兼容中文、英文及其他语言的标准 Discourse 社区,在列表页内完成阅读、翻译、回复与原站互动。

安装脚本 · GreasyFork · Lite 源码 · 在线用户手册 · 项目介绍 · 参与开发 · MIT License

在 LINUX DO 列表页右侧打开完整增强阅读工作区

在列表页内完成阅读、追踪上下文与社区互动

功能

  • LINUX DO 全面适配,消息、历史、收藏、回应、Boost、长帖与楼层关系等能力保持完整覆盖。
  • 中文、英文及其他语言的标准 Discourse 站点均可使用;插件、主题和权限差异由站点适配层与能力检测自动降级。
  • 列表页直接打开完整帖子,支持浮窗、全屏与移动端布局。
  • 保留楼层关系、楼中楼、跳转、浏览历史与真实已读进度。
  • 集成回复、点赞、回应、收藏、通知、搜索与用户资料等社区能力。
  • 为非中文内置社区提供原文、双语与全译文切换,并集成原图灯箱、媒体播放和公式渲染。
  • 内置 21 个社区;其他 HTTPS Discourse 论坛可验证后添加,非 Discourse 网站不会启动。
  • 内置请求调度、429 退避、DOM 窗口化与本地资源监控。

核心体验

看图灯箱 消息中心 请求流与 429 控制
在阅读器内查看帖子原图、图片序列和关联评论 查看消息中心的回复分类和真实通知 查看请求调度、限流边界和异常恢复状态
原图、图片序列与关联评论。 回复、点赞、私信与内容回跳。 共享账本、排队放行与退避恢复。

更多截图

以下图片由 Chrome DevTools 在真实 LINUX DO 页面重新采集,保留当时的公开界面、账号和状态信息,未额外打码。点击分组展开,点击图片查看原图。

阅读流转 — 工作区与楼中楼上下文
阅读器工作区 楼中楼上下文
列表页右侧嵌入阅读器工作区 父楼层下展开楼中楼并保留关系线
社区互动 — 浏览历史、收藏与回应
浏览历史 收藏与回应
查看浏览历史和目标阅读位置 查看收藏、书签与社区回应
个性化 — 用户信息、外观与布局
用户信息 外观设置 布局设置
查看当前账号信息、社区统计和 Connect 进度 配置主题、颜色、背景和回复关系样式 配置浮窗、全屏和移动模式布局
后台优化 — 缓存与 DOM 渲染管理
缓存管理 DOM 渲染管理
按资源类型查看和管理本地缓存 配置 DOM 挂载窗口、缓冲区与渲染上限

安装

发布状态: Lite 1.1.0 源码与用户手册正在准备发布;当前 Greasy Fork 公开稳定版仍为 1.0.1。1.0.1 主脚本固定版本为 1895932,加载 Core 1895921 与 Features 1895924。完成 1.1.0 的 Library 同步、浏览器矩阵和性能验收前,不把新版本标记为已发布。

  1. 安装 Tampermonkey 或兼容的 userscript 管理器。
  2. GreasyFork 点击“安装此脚本”。
  3. 打开或刷新以下任一站点:
  4. 其他 HTTPS Discourse 论坛可在阅读器“设置 → 适用站点 → 其他适用站点”中验证并添加。
  5. 点击主题标题开始使用。

当前项目版本为 1.1.0。脚本对 LINUX DO 保持全面适配,同时兼容中文、英文及其他语言的标准 Discourse 社区;其他 HTTPS Discourse 论坛可验证后添加。除内置中文站点 LINUX DO 外,其他内置社区和语言未知的自定义 Discourse 站点还支持原文、双语和简体中文译文切换;完整范围、翻译边界和能力降级规则见兼容性说明

1.1.0 重点新增 WebDAV 跨设备合并同步:历史、收藏、设置、阅读队列、阅读位置、自定义站点和 Connect 本机观察历史均可独立选择,支持手动与定时同步;正文、图片、附件和页面缓存不会上传。同步使用 ETag、三方合并和删除标记,不以任一设备整份覆盖另一端。完整列表见更新记录

开发

v1.0.0 起,lite/src/ 是唯一业务源码,lite/styles/ 是样式事实源;v1.0.1 起 canonical 生成物统一为 work/main-lite.csswork/greasyfork-lite/libraries/main-lite-*.jswork/main-lite.js。这些文件均由确定性构建生成,禁止直接编辑。Greasy Fork 只接收可读、未压缩的薄 Loader 和两个 Library;正式 Loader 通过固定版本 URL 与 SHA-256 引用 Library。旧 mian-lite 路径在迁移期保留逐字节一致的兼容副本,切换前的旧版 working copy 保存在 archive/legacy-main-2026-08-07/,原 work/main.jswork/main.css 仅作旧版兼容参考。

三条保留产物

版本 保留内容 是否进入 GitHub 用途
GitHub 原版 lite/src/lite/styles/、测试、构建脚本、文档与可审查生成物 唯一源码事实源和完整开发历史
本地测试版 work/main-lite.local.jswork/local-debug.user.js 与验收脚本 否,受 .gitignore 保护 Tampermonkey 真实页面调试;旧 mian-lite.local.js 保留兼容
Greasy Fork 上传版 work/main-lite.js 薄 Loader、两个 main-lite-* Library 和 work/main-lite.css 通过发布门禁后由主脚本加载固定版本 Library;迁移期同时生成旧路径副本

三条产物不会互相覆盖:本地测试版只从当前工作区加载;Greasy Fork Library 从 GitHub Raw main 通过 Webhook 同步;用户只安装主脚本,不需要单独安装 Library。 正式 Loader 必须在静态检查、真实浏览器、性能和回滚门禁都完成后生成和发布。

.
├── .github/          GitHub 协作模板
├── assets/           品牌与文档资源
├── docs/             项目介绍和资料索引
├── dist/             仓库直装的压缩 userscript 与来源清单
├── lite/             v1.1.0 TypeScript 业务源码、样式、契约与测试
├── scripts/          跨平台开发工具入口
├── tools/            Rust 开发辅助工具源码
├── work/greasyfork-lite/  Lite Greasy Fork Library 发布产物
├── archive/legacy-main-2026-08-07/  旧版 main.js/main.css 只读归档
├── CONTRIBUTING.md   开发与验证规范
├── LICENSE           MIT 许可证
└── README.md         项目入口

本地开发与验证流程见 CONTRIBUTING.md

用户手册

直接打开 在线用户手册 即可浏览,无需安装本项目、下载文档或运行本地服务。手册覆盖安装、阅读导航、社区互动、图片与媒体、全部设置、缓存、请求治理、隐私和故障排查。

功能覆盖目录位于 docs/public/feature-catalog.json。每项用户可见能力都有稳定 feature_id、源码锚点、版本、验证日期、截图和对应文档;修改用户功能时必须同步更新。

许可

本项目基于 MIT License 开源。

About

LINUX DO 全面适配、兼容中文/英文及其他语言 Discourse 站点的沉浸式 userscript 阅读器,支持长帖上下文、简中翻译、自定义站点与原站互动。

Topics

Resources

Contributing

Security policy

Stars

23 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages