图片、媒体与富内容
帖子图片
正文图片比例可以按浮窗、全屏、移动分别保存,范围为 50%–200%。比例只影响帖子内显示尺寸,不修改远端图片。

打开“设置 → 图片设置”,分别调整浮窗、全屏和移动布局的图片比例,并决定灯箱是否默认加载原图。
点击图片进入灯箱。常用操作:
| 操作 | 控件或快捷键 |
|---|---|
| 放大 / 缩小 | + / - 或顶部按钮 |
| 适应窗口 | 0 或重置按钮 |
| 前后翻图 | ← / → 或两侧按钮 |
| 查看原图 | “查看原图”按钮 |
| 回到楼层 | “跳到楼层”按钮 |
| 关闭 | Esc |

点击正文图片后,使用顶部工具栏缩放、重置、下载或返回楼层;底部缩略图用于前后翻图,右侧面板显示描述和关联评论。
原图、描述与评论
- 原图:默认先用预览图;可在设置中改成每次灯箱都优先取原图。
- 描述:可以展开、收起并拖动底边调整高度,状态会保存。
- 关联评论:评论面板按图片所在楼层查找直接关系;数据缺失时按需搜索主题。
- 评论宽度:拖动分隔线调整,允许范围为灯箱宽度的 18%–50%。
原图或来源楼层加载失败时,灯箱会保留现有预览并给出重试/不可用状态。来源楼层 404 不一定意味着 CDN 图片已经失效。
下载
- 单张下载优先复用阅读器缓存;需要原图时,按阅读器限速获取后再保存。
- 批量下载进入多选状态,再处理选中的图片。
- 浏览器可能根据安全设置询问保存位置或拦截连续下载。
下载只在用户明确操作后发生。大量原图会占用带宽和浏览器资源缓存。
头像与资料媒体
点击用户头像可以打开独立预览器,支持缩放、前后翻看和下载。头像缓存与帖子原图缓存分开管理。

先点击作者用户名打开用户卡,再点击卡片中的头像进入原图预览;右上角按钮用于下载或关闭。
视频、音频与 HLS
阅读器保留原生音视频控件,并用 hls.js 处理浏览器不能直接播放的 HLS 流。播放能力仍受以下因素影响:
- 媒体服务器是否允许当前来源;
- 浏览器编码器支持;
- 自动播放和音频权限;
- 源地址是否过期或需要登录。
关闭阅读器时会释放已绑定媒体和 Object URL。
公式、投票和代码块
- KaTeX
0.16.22用于数学公式。 - 投票支持选择、提交、更新、撤销和结果切换;权限与截止状态以原站为准。
- 代码块支持复制和阅读器内预览;预览副本可以编辑并下载,本地编辑不会修改原帖。
Onebox 与特殊内容
主题链接卡片、内联 Onebox、SVG、Markdown 提示块、已解决答案和部分系统事件沿用阅读器统一内容样式。第三方 iframe 或嵌入内容仍受浏览器 CSP、跨域和原站策略约束。
GitHub 仓库 Onebox 会整理为更紧凑的阅读结构:仓库缩略图移动到来源行,标题和说明保持单行节奏,并移除重复缩略图。点击卡片中的链接仍会打开原始 GitHub 页面,阅读器不会复制或改写仓库内容。
跨语正文翻译
站点适配支持中文、英文及其他语言的标准 Discourse 社区,不受内容语言限制。当前翻译功能会将已标记为非中文的内置社区正文译为简体中文,并在阅读器标题栏显示翻译按钮,无需离开帖子或复制正文。每次点击按以下顺序切换:
- 原文;
- 原文与中文译文并排的双语模式;
- 只显示简体中文译文;
- 回到原文。
翻译只处理普通正文段落、列表、标题、引用和表格文字,会跳过代码、公式、投票、Onebox、表单以及过短或类似标识符的文本。请求按批次发送,优先使用 Google,较大批次或失败时回退 Microsoft;译文最多缓存 240 条到当前站点的 localStorage。关闭阅读器会取消尚未完成的请求。
翻译是第三方机器翻译,可能存在遗漏或语义错误;涉及命令、金额、权限和安全操作时应切回原文核对。自定义站点未预设内容语言,因此暂不显示翻译按钮。
