安装与更新

Awesome LinuxDo Reader 是 userscript，不是独立浏览器扩展。你需要先安装脚本管理器，再从 GreasyFork 安装正式版。

当前发布状态

本手册当前对应 1.6.4 正式版；GitHub 与 Greasy Fork 已同步，主脚本继续采用 Loader + Core + Platform + Features 四文件结构。

• Loader：脚本 588185，固定版本 1921699；Greasy Fork 文件 4,173 字节，SHA-256 7b68003bd806ec1c2b0b681aee3c2b9002045c0cdcf3f6d15b1785d35c8a6de5。移除 Greasy Fork 注入的 @downloadURL none 后为 4,152 字节，SHA-256 f9248c55c2ab1fc86c43b028063ed0cae621afc814f3dd7fd72aaa7f95233c7f，与仓库 Loader 一致。
• Core：脚本 590254，固定版本 1921693；1,739,322 字节，SHA-256 aec251cdb2502211bf4add0e8abfa6d7449ecd1abcf816f89f0165d2853a5288。
• Platform：脚本 591595，固定版本 1921695；1,491,573 字节，SHA-256 09b9ab7e8c567fb5645976254b61681c9f5eac01866bd514c0e95cdd7397992b。
• Features：脚本 590255，固定版本 1921694；2,022,100 字节，SHA-256 734fc340bf5f3d08340217f8de649b1352035f7595acca1629dd2e6949266271。
• CSS：固定到 Git 4473716d05c9151c79639d6a17e4d71e124c7aef；696,558 字节，SHA-256 7cf3e876b3536c0d2f23325fe3fe88c7152c1c632f09c2622309c0799a8bd68c。

安装成功并刷新页面后，主题列表仍保留在宿主区域，主题可直接进入右侧增强阅读工作区。

环境要求

项目	要求
站点	LINUX DO 全面适配；20 个其他社区内置支持；其他标准 HTTPS Discourse 需先由脚本管理器允许当前域名，再经本地识别或手动验证保存
登录	阅读公开内容不一定需要；消息、收藏、回复等能力需要对应账号权限
脚本管理器	Tampermonkey 或能够完整支持本脚本权限的兼容管理器
浏览器能力	现代 Chromium、Firefox 或同等级浏览器；具体边界见兼容性

安装步骤

1. 安装并启用 Tampermonkey。
2. 打开 GreasyFork 脚本页。
3. 选择“安装此脚本”，核对名称为 Awesome LinuxDo Reader。
4. 打开或刷新以下任一站点：
   • 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
5. 使用其他标准 HTTPS Discourse 时，先在脚本管理器中为本脚本添加对应 https://域名/* 用户匹配或站点访问；脚本运行后会用原生模块与 DOM 证据识别，并弹窗询问是否保存为自定义站点。也可在任一内置论坛通过“设置 → 适用站点 → 其他适用站点”手动验证保存。
6. 在主题列表顶部或主题链接附近确认阅读器入口已经出现。

站点与翻译能力

LINUX DO 保持完整功能覆盖。获得脚本管理器站点许可后，中文、英文及其他语言的标准 HTTPS Discourse 论坛会被本地识别并启用核心阅读能力，站点未安装的 Boost、Reactions、Post Voting 等插件入口会自动隐藏。站点适配不限内容语言；除内置中文站点 LINUX DO 外，其他 Discourse 社区会显示译为简体中文的正文翻译按钮。

不要同时启用两个版本

正式版、本地调试版或其他同类脚本同时接管主题链接时，可能造成重复入口、重复请求和界面状态冲突。

自动更新

正式脚本由 GreasyFork 安装后，脚本管理器会记录对应的下载与更新地址；仓库源码不写入 绕过 GreasyFork 的自定义 updateURL、installURL 或 downloadURL。更新频率由脚本管理器决定：

当前公开的 1.6.4 主脚本通过固定 @require 加载同一发布快照的 Core、Platform 与 Features 三个 Greasy Fork Library。 Library 是正式脚本的一部分，无需单独安装。固定版本 URL 与完整性哈希用于避免更新期间混用不同版本。

• 想立即检查时，在 Tampermonkey 面板中对该脚本执行“检查更新”。
• 更新后刷新当前 Discourse 页面，已打开页面不会自动替换正在运行的旧代码。
• 在脚本管理器中确认版本为 1.6.4；刚完成更新但页面仍显示旧版时，请完整刷新已打开的 Discourse 页面。

三种保留版本

版本	面向对象	更新来源
GitHub 原版	开发者与代码审查者	lite/src/、lite/styles/ 和构建脚本
本地测试版	发布前手动审查	本机单文件 main-lite.local.js 与本地四文件 Loader，不会上传；旧 mian-lite 拼写保留为兼容副本
Greasy Fork 上传版	普通用户	当前 1.6.4 薄 Loader 固定加载 Core、Platform、Features

普通用户只安装 Greasy Fork 的 Awesome LinuxDo Reader 主脚本。页面上标注“库”的 Core、Platform 和 Features 是当前公开脚本依赖，不应单独安装。

入口没有出现

按顺序检查：

1. 当前地址是否位于明确匹配的站点范围。
2. 脚本是否启用，且没有被浏览器的站点访问权限阻止。
3. 页面是否在安装或更新后完整刷新。
4. 是否同时启用了正式版和本地调试版。
5. 是否有其他脚本修改了同一主题列表入口。

仍无法解决时，记录浏览器版本、脚本管理器版本、脚本版本、页面地址的路径部分和可复现步骤；不要提交 Cookie、Authorization、完整页面内容或账号数据。

卸载

在脚本管理器中删除或停用脚本即可停止注入。浏览器本地缓存和设置可在卸载前通过“设置 → 数据管理”清理；这只影响阅读器本地数据。