Awesome LinuxDo Reader

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

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

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

功能

• LINUX DO 全面适配，消息、历史、收藏、回应、Boost、长帖与楼层关系等能力保持完整覆盖。
• 中文、英文及其他语言的标准 Discourse 站点均可使用；插件、主题和权限差异由站点适配层与能力检测自动降级。
• 列表页直接打开完整帖子，支持浮窗、全屏与移动端布局。
• 保留楼层关系、楼中楼、跳转、浏览历史与真实已读进度。
• 集成回复、点赞、回应、收藏、通知、搜索与用户资料等社区能力。
• 为非中文内置社区提供原文、双语与全译文切换，并集成原图灯箱、媒体播放和公式渲染。
• 后台下载全部、楼主或自选楼层，生成可搜索、可跳转的独立离线 HTML；下载历史可选同步到 WebDAV。
• 设置导出、导入与恢复默认覆盖组合配置，并始终排除翻译 API Key、WebDAV 用户名和密码。
• 内置 21 个社区；其他标准 HTTPS Discourse 论坛自动识别，深度定制站点可验证添加为兜底，非 Discourse 网站不会启动。
• 内置请求调度、429 退避、DOM 窗口化与本地资源监控。

核心体验

离线 Topic	安全配置管理	WebDAV 分类同步
后台补齐、离线查看与下载历史。	秘密字段永不进入配置导出。	普通记录三方合并，离线 HTML 独立存放。

更多截图

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

阅读流转 — 工作区与楼中楼上下文

阅读器工作区	楼中楼上下文

社区互动 — 浏览历史、收藏与回应

浏览历史	收藏与回应

个性化 — 用户信息、外观与布局

用户信息	外观设置	布局设置

后台优化 — 缓存与 DOM 渲染管理

缓存管理	DOM 渲染管理

安装

发布状态： Lite 1.3.1 已发布：Loader 588185 / 1899428、Core 590254 / 1899419、Features 590255 / 1899422；CSS 继续固定到 Git 5ca40cf，完整校验值见更新记录。

1. 安装 Tampermonkey 或兼容的 userscript 管理器。
2. 在 GreasyFork 点击“安装此脚本”。
3. 打开或刷新以下任一站点：
   • LINUX DO
   • Brave Community
   • Roblox Developer Forum
   • OpenAI Developer Community
   • Home Assistant Community
   • Cfx.re Forum
   • Spiceworks Community
   • Arduino Forum
   • Unity Discussions
   • Cloudflare Community
   • Epic Developer Community
   • Obsidian Forum
   • Cursor Community
   • Godot Forum
   • n8n Community
   • MikroTik Forum
   • Discourse Meta
   • Python Discussions
   • Swift Forums
   • Julia Discourse
   • Rust Users Forum
4. 其他标准 HTTPS Discourse 论坛会自动识别；只有深度定制站点识别失败时，才需在“设置 → 适用站点 → 其他适用站点”中验证添加为兼容兜底。
5. 点击主题标题开始使用。

当前项目版本为 1.3.1。脚本对 LINUX DO 保持全面适配，同时自动识别中文、英文及其他语言的标准 HTTPS Discourse 社区；深度定制站点仍可验证添加为兼容兜底。除内置中文站点 LINUX DO 外，其他 Discourse 社区还支持原文、双语和简体中文译文切换；完整范围、翻译边界和能力降级规则见兼容性说明。

1.3.1 重点是为已有设置的用户重新投放一次“建议恢复默认值”提示，确保新版设置与默认值能够完整生效；同时修复 Boost 输入框调用宿主表情选择器时被阅读器层遮挡的问题。新用户保持静默，选择保留当前设置也不会改动任何值。1.3.0 的离线 Topic、安全配置、WebDAV 分类同步和阅读体验改进保持不变，完整列表见更新记录。

开发

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

三条保留产物

版本	保留内容	是否进入 GitHub	用途
GitHub 原版	lite/src/、lite/styles/、测试、构建脚本、文档与可审查生成物	是	唯一源码事实源和完整开发历史
本地测试版	work/main-lite.local.js、work/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.3.1 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 开源。