功能覆盖目录

本目录由 docs/public/feature-catalog.json 驱动，是“当前功能是否已经写入手册”的事实表。每项都有唯一编号、源码锚点、首次纳入目录版本、当前版本、状态、验证日期、截图和至少一篇对应文档。

目录按分类展示当前能力，每项都可以回到对应手册页面。

111 项功能13 个分类当前版本 1.6.4最近核验 2026-09-04

开始使用

CORE-001

安装与自动更新

通过 GreasyFork 安装 userscript，并由脚本管理器读取更新地址。

状态：current源码：lite/userscript.meta.txt验证：2026-08-18

查看手册

CORE-002

列表页阅读器入口

从列表页的阅读入口直接打开当前主题或最近阅读主题。

状态：current源码：lite/src/queue/reader-open-queue-session.ts验证：2026-08-18

查看手册

CORE-003

主题直达接管

在匹配的主题路由中直接进入增强阅读工作区；按当前宿主路由去重重复页面信号，并只接管原站搜索菜单中的真实主题或楼层结果。

状态：current源码：lite/src/userscript/main-lite-entry.ts验证：2026-08-18

查看手册

CORE-004

多种阅读形态

支持浮窗、全屏、左侧嵌入、右侧嵌入和移动端布局；新配置默认右侧嵌入，嵌入态固定使用宿主 Default 站点主题。

状态：current源码：lite/src/userscript/main-lite-bootstrap.ts验证：2026-08-18

查看手册

CORE-005

返回原生页面

在需要时绕过增强阅读器，使用 LINUX DO 原生主题页面。

状态：current源码：lite/src/components/reader-icon.ts验证：2026-08-18

查看手册

CORE-006

多主题阅读队列

从列表页明确加入可跨刷新恢复的多主题队列；切换时保存完整阅读锚点并分层预加载内容，完成的宿主预热快照可一次性交给 Reader，当前阅读请求始终优先。

状态：current源码：lite/src/queue/reader-open-queue-session.ts验证：2026-08-21

查看手册

CORE-007

多站点 Discourse 适配

以 LINUX DO 为完整基线，在 20 个其他内置社区复用核心阅读能力；其他获脚本管理器许可的标准 HTTPS Discourse 会本地识别并提示保存为自定义站点，同时按站点插件和版本隐藏不可用功能。

状态：current源码：lite/src/app/reader-application.ts验证：2026-08-18

查看手册

阅读与导航

READ-001

虚拟化连续阅读流

长帖只挂载可见窗口附近的楼层，同时保持连续滚动位置。

状态：current源码：lite/src/dom/reply-tree.ts验证：2026-08-18

查看手册

READ-002

按批加载主楼层

接近数据边缘时按配置批次补充楼层，避免一次加载整帖。

状态：current源码：lite/src/topic/topic-session.ts验证：2026-08-18

查看手册

READ-003

楼中楼分页

在父楼层下按需加载直属回复，支持主信息流有界树状嵌套、无限树状完整讨论、分页与展开策略，并在回复或编辑后刷新和聚焦对应讨论树。

状态：current源码：lite/src/dom/reply-tree-repository.ts验证：2026-08-18

查看手册

READ-004

只看楼主

在长帖中筛选楼主内容，并保留目标楼层跳转能力。

状态：current源码：lite/src/topic/reader-topic-only-op-controller.ts验证：2026-08-18

查看手册

READ-005

主题时间轴

通过时间轴观察阅读位置、拖动或输入楼层号直达；相对时间入口会按需补齐 canonical 尾段、跳过楼中楼尾楼，并在不依赖末楼 DOM 持续挂载的情况下连续结算物理底部。

状态：current源码：lite/src/topic/reader-topic-timeline-controller.ts验证：2026-08-22

查看手册

READ-006

历史前进与后退

通过阅读器按钮或鼠标侧键在阅读过的主题之间前进、后退，并在有界安静窗口内恢复楼层、视口偏移、完整讨论分支和引用高亮。

状态：current源码：lite/src/history/reader-history-model.ts验证：2026-08-21

查看手册

READ-007

历史边缘触发

通过左右边缘触发区域或常显按钮切换历史主题。

状态：current源码：lite/src/history/reader-history-navigation-controller.ts验证：2026-08-18

查看手册

READ-008

引用与父回复预览

在当前阅读位置加载引用源和父回复上下文，并支持回跳。

状态：current源码：lite/src/topic/reader-topic-context-controller.ts验证：2026-08-18

查看手册

READ-009

真实已读进度

正文成功预加载后先显示乐观已读，再按显式目标、可见楼层和后台候选的优先级批量上报；服务器确认后写入权威状态，并以成功指纹、跨标签锁和原站计时抑制避免重复提交。

状态：current源码：lite/src/reading/read-state-controller.ts验证：2026-08-18

查看手册

READ-010

主题在线状态与实时同步

同步主题活动、在线状态、新回复和回应变化；接收原站帖子、通知、收藏、回应与客户端设置事件并精确失效缓存，仅在确认存在新楼层时执行近底部自动跟随。

状态：current源码：lite/src/live/topic-live-controller.ts验证：2026-08-18

查看手册

READ-011

主题分类与标签导航

在标题横向区域显示当前主题的父分类、分类和标签，安全内联图标，并在同主题楼层路由变化时直接跳转。

状态：current源码：lite/src/components/reader-icon.ts验证：2026-08-18

查看手册

READ-012

已解决答案与特殊帖子

显示已采纳答案、系统事件、投票和指定等特殊内容。

状态：current源码：lite/src/topic/reader-topic-special-content-feature.ts验证：2026-08-18

查看手册

READ-013

主题元信息

显示标题、楼主、分类、标签、楼层数和活动信息；字号随阅读器宽度缩放，标题自然换行，分类与标签溢出后可横向浏览。

状态：current源码：lite/src/topic/reader-topic-header.ts验证：2026-08-18

查看手册

READ-014

目标楼层闪烁

跳转后以可配置的颜色、圆角、边框、速率和次数标记目标。

状态：current源码：lite/src/topic/reader-topic-scroll-adapter.ts验证：2026-08-18

查看手册

READ-015

二级回复完整讨论

在可拖动、可缩放的独立窗口中按真实父子关系无限递归回复树，支持逐支收纳、窄宽度缩进封顶、阅读锚点和返回视口，并从隐藏楼层、消息、历史或队列恢复目标。

状态：current源码：lite/src/topic/reader-topic-context-controller.ts验证：2026-08-18

查看手册

READ-016

主题投票

在支持 Topic Voting 的主题标题区显示票数和当前投票状态，并支持登录用户投票或取消投票。

状态：current源码：lite/src/topic/reader-topic-header.ts验证：2026-08-18

查看手册

内容与媒体

MEDIA-001

帖子图片比例

按浮窗、全屏和移动形态独立设置正文图片比例。

状态：current源码：lite/src/media/reader-image-scale.ts验证：2026-08-18

查看手册

MEDIA-002

图片灯箱缩放与翻图

在灯箱中缩放、适应窗口、前后翻图并用键盘操作。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

MEDIA-003

查看原图

按需加载原图，也可将灯箱默认模式设为原图。

状态：current源码：lite/src/network/public-resource-request-adapter.ts验证：2026-08-18

查看手册

MEDIA-004

图片关联评论

按需补取图片所在主题楼层，在灯箱侧栏建立关联评论树，并支持查看、切换或取消评论回应。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

MEDIA-005

图片描述面板

展开、收起并调整灯箱图片描述区域高度。

状态：current源码：lite/src/media/reader-lightbox-controller.ts验证：2026-08-18

查看手册

MEDIA-006

单张与批量下载图片

单张下载复用阅读器缓存与限速取图链路，批量下载可选择多张图片并生成 ZIP。

状态：current源码：lite/src/media/reader-image-download-service.ts验证：2026-08-18

查看手册

MEDIA-007

头像与资料媒体预览

在用户卡旁锚定放大、缩放并下载用户头像或资料背景。

状态：current源码：lite/src/user/discourse-native-user-port.ts验证：2026-08-18

查看手册

MEDIA-008

视频、音频与 HLS

在阅读器中播放常见视频、音频和 HLS 媒体。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

MEDIA-009

KaTeX 公式

加载 KaTeX 并渲染帖子中的数学公式。

状态：current源码：lite/src/media/reader-katex-controller.ts验证：2026-08-18

查看手册

MEDIA-010

帖子投票

查看投票、提交或撤销选择，并切换投票结果。

状态：current源码：lite/src/media/reader-poll-model.ts验证：2026-08-18

查看手册

MEDIA-011

代码块工具

超过 10 行时折叠代码块，并支持展开、收起、复制，以及在阅读器中预览、编辑副本并保存到本地。

状态：current源码：lite/src/media/reader-cooked-content-feature.ts验证：2026-08-18

查看手册

MEDIA-012

链接、Onebox 与提示块

保留帖子链接预览、内嵌 Onebox、SVG 和 Markdown 提示内容，并把 GitHub 仓库卡片整理为紧凑结构。

状态：current源码：lite/src/media/reader-cooked-content-feature.ts验证：2026-08-18

查看手册

MEDIA-013

媒体加载失败恢复

为无法加载的正文图片提供重试和回退提示。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

MEDIA-014

非中文正文翻译

在非中文内置社区和语言未知的通用 Discourse 站点切换原文、双语和全译文，并从无装饰、弱化、分隔、强调、引用和卡片等译文样式中选择；可使用公共翻译或多个 OpenAI 兼容服务，并以有界 Section 缓存复用译文。

状态：current源码：lite/src/translation/reader-translation-controller.ts验证：2026-08-18

查看手册

社区互动

ACTION-001

回复与编辑器

在阅读器内回复主题或楼层，只在有效 Reader 会话中接管原生 Composer；顶层提升不可用时安全回退，并在提交后刷新和聚焦对应内容。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

ACTION-002

划词引用

选中文本后插入引用或复制规范引用文本。

状态：current源码：lite/src/post/reader-selection-quote-feature.ts验证：2026-08-18

查看手册

ACTION-003

点赞

在阅读器内点赞或取消点赞，并同步计数。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

ACTION-004

自定义回应

在正文、主帖操作列、二级回复和图片评论中添加、切换或取消 LINUX DO 自定义回应；原站回应及可用表情变化会刷新注册表、相关缓存和当前可见控件。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

ACTION-005

Boost

查看、发送和管理 Boost，使用显示在阅读器上方的宿主原生表情选择器，并可把指定 Boost 的正文、作者提及和目标楼层随原生 Composer 一起建立。

状态：current源码：lite/src/post/reader-post-action-feature.ts验证：2026-09-04

查看手册

ACTION-006

Boost 复制规则

为复制 Boost 设置前缀、数字递增或固定尾巴。

状态：current源码：lite/src/post/boost-copy-rule.ts验证：2026-08-18

查看手册

ACTION-007

主题与楼层收藏

添加或移除主题书签和楼层书签。

状态：current源码：lite/src/discourse/native-host-api.ts验证：2026-08-18

查看手册

ACTION-008

分享主题与复制楼层链接

调用主题分享能力或复制精确楼层链接。

状态：current源码：lite/src/discourse/native-host-api.ts验证：2026-08-18

查看手册

ACTION-009

主题通知级别

通过 Discourse 原生通知动作设置主题为正常、跟踪、关注或静音，并回读当前级别。

状态：current源码：lite/src/discourse/native-topic-notification-action.ts验证：2026-08-18

查看手册

ACTION-010

举报

按账号权限举报主题、楼层或 Boost。

状态：current源码：lite/src/app/reader-browser-runtime.ts验证：2026-08-18

查看手册

ACTION-011

编辑与删除楼层

按原站权限编辑或删除自己的楼层；编辑成功后就地刷新楼层并恢复楼中楼焦点。

状态：current源码：lite/src/discourse/native-composer.ts验证：2026-08-18

查看手册

ACTION-012

指定与管理操作

按权限指定主题或楼层负责人，并进入管理操作。

状态：current源码：lite/src/discourse/native-host-api.ts验证：2026-08-18

查看手册

ACTION-013

俺也一样

在支持的主题上同步原站共享问题状态和人数。

状态：current源码：lite/src/post/reader-topic-shared-issue-coordinator.ts验证：2026-08-18

查看手册

ACTION-014

主帖快捷操作列

集中提供回顶、点赞与回应、回复、Boost、收藏及更多主题操作，并支持拖动、锁定、位置记忆和贴边收纳。

状态：current源码：lite/src/post/reader-topic-action-rail.ts验证：2026-08-18

查看手册

消息与收藏

COLLECT-001

消息分类

在通知与私信双模式中按真实来源查看回复、赞、提及、编辑、链接、Boost、回应、其他通知和六类私信；标准 heart 回应统一归入赞，其他通知排除已覆盖类型与私信并标注实际类型。

状态：current源码：lite/src/notification/reader-notification-model.ts验证：2026-08-18

查看手册

COLLECT-002

消息检索、翻页与全部已读

检索、翻页和分类已读；点击未读数量会清除筛选并定位第一条真实未读通知，单条或全部已读同步 Discourse 普通、高优先级、分组和总计数。

状态：current源码：lite/src/notification/reader-notification-controller.ts验证：2026-08-18

查看手册

COLLECT-003

浏览历史检索与排序

检索、分页并按最近点击或首次点击排序浏览历史。

状态：current源码：lite/src/history/reader-history-model.ts验证：2026-08-18

查看手册

COLLECT-004

浏览历史批量管理

多选删除历史条目，或在确认后清空全部历史。

状态：current源码：lite/src/history/reader-history-repository.ts验证：2026-08-18

查看手册

COLLECT-005

收藏与回应中心

在回应、主题和楼层标签间切换、拖动排序、筛选和检索。

状态：current源码：lite/src/bookmark/reader-bookmark-model.ts验证：2026-08-18

查看手册

COLLECT-006

收藏批量管理

按本页或全部页多选收藏记录并执行批量移除。

状态：current源码：lite/src/bookmark/reader-bookmark-controller.ts验证：2026-08-18

查看手册

COLLECT-007

不想看与预设自动过滤

把列表页免打扰接入账号隔离的不想看集合，入口只保留可访问名称而不叠加宿主或 Reader 悬停提示；手动免打扰持久隐藏直到恢复，类别、Label、OP、字符与楼层用户规则则动态隐藏并持久归档完整命中原因，关闭或删除规则后立即恢复内容但保留历史；支持单行条目的并排标注与多标签编辑、来源与命中原因组合筛选、手动条目批量恢复，以及自动历史直接进入规则管理。

状态：current源码：lite/src/collection/reader-unwanted-topic-repository.ts验证：2026-08-18

查看手册

COLLECT-008

共享多标签工具浮窗

通知、历史、收藏、下载、用户观察、岁月史书和不想看共用可冻结的标签式浮窗；已打开工具可切换或单独关闭，标签过多时独立横向滚动。

状态：current源码：lite/src/shell/reader-floating-window-frame.ts验证：2026-08-18

查看手册

COLLECT-009

岁月史书失效留存

记录服务器明确软删除或返回 403、404、410，且本机仍有可定位内容的 Topic、楼层和 Boost；按账号隔离、搜索和去重，并在本地内容消失后自动移除。

状态：current源码：lite/src/history/reader-chronicle-repository.ts验证：2026-08-18

查看手册

用户资料

USER-001

阅读器用户卡

在阅读器内查看用户头像、简介、徽章、组和基础资料，并安全内联 Flair 图标或回退到内置盾牌。

状态：current源码：lite/src/discourse/native-request-descriptors.ts验证：2026-08-18

查看手册

USER-002

用户详情与社区统计

补充加载用户详情、目录统计、徽章和社区活动信息。

状态：current源码：lite/src/discourse/native-request-descriptors.ts验证：2026-08-18

查看手册

USER-003

关注与粉丝列表

查看、检索并分页浏览关注和粉丝列表。

状态：current源码：lite/src/discourse/native-host-api.ts验证：2026-08-18

查看手册

USER-004

用户关系操作

关注、私信、调整通知级别、静音或忽略用户，能力由原站权限决定。

状态：current源码：lite/src/user/discourse-native-user-port.ts验证：2026-08-18

查看手册

USER-005

当前账号与 Connect 信任进度

在设置中心查看当前账号资料、社区统计和 Connect 信任级别进度。

状态：current源码：lite/src/user/discourse-native-user-port.ts验证：2026-08-18

查看手册

USER-006

LINUX DO Credit 账户摘要

以紧凑指标只读展示 LDC 余额、额度、积分收支、账户状态和快捷入口，校验同账号并回退到 30 分钟内的成功缓存。

状态：current源码：lite/src/translation/translation-request-adapter.ts验证：2026-08-18

查看手册

USER-007

用户持续观察

从用户卡加入观察名单，按主题、回复、Boost、回应等来源渐进采集公开活动；当前账号额外汇总私有通知、私信和收藏投影，分离投影总数与来源分页水位，并保留断点与失败重试。

状态：current源码：lite/src/user/reader-user-observation-session.ts验证：2026-08-18

查看手册

个性化设置

SET-001

明亮、暗色与系统主题

在明亮、暗色和跟随系统三种主题之间切换。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-002

图片比例配置与共享

为浮窗、全屏、移动分别设置图片比例，也可将字段跨形态共享。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-003

灯箱默认行为

配置评论面板、描述面板和原图模式的默认展开状态。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-004

内置字体渲染与宿主扩展

启用增强字体渲染，并选择是否扩展到 LINUX DO 宿主页面。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-005

宿主嵌入态尺寸

调整宿主主题列表中的标题、头像、右下信息和 Label Card 大小，新配置默认分别为 110%、80%、120% 和 100%。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-006

分作用域字体配置

分别设置界面、正文和回复的字体、字重、颜色与字号；支持本机字体、11 种按需加载的精选 Google Fonts，以及保存在当前浏览器的 WOFF2、WOFF、TTF 或 OTF 导入字体，主题总结共享同一字体目录。

状态：current源码：lite/src/font/reader-font-catalog.ts验证：2026-08-18

查看手册

SET-007

普通与全屏五区布局

为普通（嵌入/浮窗）和全屏分别设置左留白、主帖、间距、时间轴、右留白比例并保持合计 100%。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-008

浮窗几何与拖拽缩放

设置浮窗宽高和左上角坐标，并记住拖动、缩放后的结果。

状态：current源码：lite/src/shell/reader-workspace.ts验证：2026-08-18

查看手册

SET-009

外观颜色与结构线

设置强调色、链接、斑马纹、回复线、引用线、分隔线和楼层预览；颜色字段共用预设、HEX、HSV 滑杆、二维色盘及浏览器屏幕吸色入口。

状态：current源码：lite/src/appearance/reader-appearance-style-controller.ts验证：2026-08-18

查看手册

SET-010

跳转闪烁参数

设置跳转目标的颜色、圆角、边框宽度、速率和次数。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-011

等待区域动画

从十种等待动画中选择固定或随机样式并即时预览；减少动态效果时使用低运动或静态呈现。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-020

设置分组、搜索与统一保存

按三组浏览 18 个设置面板，按名称和说明搜索，在独立面板管理键盘与鼠标快捷方式，并在底部一次保存全部实时预览草稿。

状态：current源码：lite/src/settings/reader-settings-controller.ts验证：2026-08-18

查看手册

SET-022

当地日落自动暗色

可在当地日落或自定义时间自动切换暗色，并在次日日出恢复启用前的主题；日出日落仅在本机按位置与时区计算，不发送坐标。

状态：current源码：lite/src/appearance/reader-local-sun-clock.ts验证：2026-08-18

查看手册

性能设置

SET-012

API 预取与正文批量

直接设置 post_ids 正文单批、已读 RPM/TPM、宿主 Topic 预热及楼层数，并分别设置下载、用户观察、通知、收藏与回应的最大并发、后台间隔和后台 RPM；固定 profile、缓存、重试及共享请求安全契约不能被覆盖。

状态：current源码：lite/src/settings/reader-performance-settings-form.ts验证：2026-08-21

查看手册

SET-013

主楼层 DOM 窗口

设置视口外挂载缓冲和同时挂载楼层目标上限；必要祖先结构与滚动占位继续由虚拟窗口 owner 裁决。

状态：current源码：lite/src/topic/reader-topic-navigation-preferences.ts验证：2026-08-18

查看手册

SET-014

正文与树状 API 预知距离

设置正文近窗缺口提升和父楼直属回复候选距离视口多少屏开始，不扩大 DOM 窗口。

状态：current源码：lite/src/topic/reader-topic-flow-controller.ts验证：2026-08-18

查看手册

SET-015

共享 API 安全边界

设置共享总并发、基础启动间隔和固定预防窗口目标；后台让路、请求 profile、宿主计账与 Cloudflare 硬闸门保持更高优先级。

状态：current源码：lite/src/network/browser-shared-request-permit.ts验证：2026-08-18

查看手册

SET-023

后台暂停宿主 Turnstile（实验）

默认关闭；LinuxDo 标签后台停留 30 秒、宿主验证已有响应且没有编辑或支付交互时，通过官方生命周期释放隐藏 Turnstile，回到前台或关闭设置后立即恢复。

状态：current源码：lite/src/network/reader-host-turnstile-background-controller.ts验证：2026-08-18

查看手册

其他设置

SET-016

历史导航设置

设置历史按钮常显、边缘触发宽度和历史排序规则。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-017

帖子从 #1 打开

普通帖子链接默认从第一楼开始，消息、历史和收藏仍按目标楼层；该默认可在阅读与导航设置中关闭。

状态：current源码：lite/src/state/reader-preferences-schema.ts验证：2026-08-18

查看手册

SET-018

二级回复展示策略

控制父回复下展开、无限树状完整讨论与 2–5 层主信息流嵌套切换，以及主楼层列表中的二级回复收纳。

状态：current源码：lite/src/dom/reply-tree-repository.ts验证：2026-08-18

查看手册

SET-019

Boost 复制设置

配置 Boost 复制的尾巴类型、前缀、递增步长和固定文本。

状态：current源码：lite/src/post/boost-copy-rule.ts验证：2026-08-18

查看手册

SET-021

阅读入口与退出偏好

控制空队列入口、阅读器单次或双次 Esc 退出，并独立设置原生回复窗口关闭前的二次确认。

状态：current源码：lite/src/settings/reader-reading-settings-form.ts验证：2026-08-18

查看手册

数据管理

DATA-001

导出、导入与重置设置

以可回滚事务导出、导入或重置偏好、适用站点、翻译与 WebDAV 非敏感设置；已有设置的用户在重大设置更新后获得一次可保留当前值的恢复默认提示，秘密凭据始终排除。

状态：current源码：lite/src/state/reader-settings-config-manager.ts验证：2026-08-21

查看手册

DATA-002

六类缓存统计与清理

查看并选择清理历史、主题与楼层、用户卡、消息、API 响应和头像图片。

状态：current源码：lite/src/cache/browser-asset-cache.ts验证：2026-08-18

查看手册

DATA-003

当前主题缓存清理

清理当前主题的本地快照与相关响应，随后重新获取。

状态：current源码：lite/src/cache/reader-cache-management-surface.ts验证：2026-08-18

查看手册

DATA-004

分层缓存与离线回退

使用有条目与字节上限的内存、本地存储、Cache Storage 与 IndexedDB；定向失效只取消匹配在途请求，网络异常时可回退到仍可读取的本地正文。

状态：current源码：lite/src/topic/reader-topic-local-archive-feature.ts验证：2026-08-21

查看手册

DATA-005

权限与外部依赖边界

公开脚本匹配范围、GM 权限、跨域目标和 KaTeX、pinyin-pro、hls.js 依赖。

状态：current源码：lite/src/userscript/browser-userscript-environment.ts验证：2026-08-18

查看手册

DATA-006

WebDAV 跨设备合并同步

通过标准 WebDAV 同步十二类可选数据；设置偏好按同一快照联合校验联动字段，通知与互动历史使用单调合并的独立清单，离线 Topic 使用轻量清单与独立 HTML。

状态：current源码：lite/src/sync/reader-webdav-coordinator.ts验证：2026-08-18

查看手册

DATA-007

离线 Topic 下载与阅读

后台补齐全部、楼主或自选楼层，保存可搜索、可跳转并保留讨论关系的独立 HTML；下载历史支持本地管理与可选 WebDAV 同步。

状态：current源码：lite/src/queue/reader-topic-download-manager.ts验证：2026-08-18

查看手册

监控与限流

MONITOR-001

实时资源监控

按毫秒事件和十分钟快照观察内存、长任务、DOM、楼层、媒体与网络，并可导出含主题流水线 trace 与 p50/p95 的脱敏 JSONL。

状态：current源码：lite/src/monitor/reader-resource-monitor.ts验证：2026-08-21

查看手册

MONITOR-002

请求数据面板

展示请求速率、P95、排队、异常、逻辑链、typed contract 与重试决策，并通过 traceId 关联请求、缓存和主题流水线的脱敏 JSONL。

状态：current源码：lite/src/app/reader-data-runtime.ts验证：2026-08-21

查看手册

MONITOR-003

多标签页 429 协调

共享 10 秒与 60 秒请求账本、普通 429 暂停状态与即时恢复通知；请求记录携带统一业务身份，并对已读上报执行成功指纹、跨标签锁、滚动分钟 RPM/TPM、端点冷却、退避和恢复探测。

状态：current源码：lite/src/network/browser-shared-request-permit.ts验证：2026-08-21

查看手册

MONITOR-004

Cloudflare 验证恢复

在请求被挑战时协调单个验证窗口；无人操作的自动窗口短时止损，人工验证保留完整处理时间，窗口导航后立即复核并跨标签同步成功状态。

状态：current源码：lite/src/network/browser-shared-request-permit.ts验证：2026-08-18

查看手册

MONITOR-005

请求记录脱敏

请求面板只保留查询键形状和有限安全 identity，不保留查询值、正文、Cookie、授权头或响应内容。

状态：current源码：lite/src/network/request-observer.ts验证：2026-08-18

查看手册

故障排查

TROUBLE-001

安装与加载排查

检查脚本管理器、匹配范围、启用状态和版本。

状态：current源码：lite/userscript.meta.txt验证：2026-08-18

查看手册

TROUBLE-002

帖子与楼层加载排查

区分缓存、虚拟窗口、已删除楼层、网络和 429 问题。

状态：current源码：lite/src/topic/topic-session.ts验证：2026-08-18

查看手册

TROUBLE-003

图片与媒体排查

检查原图源、缓存、跨域资源、HLS 和已删除来源楼层。

状态：current源码：lite/src/media/reader-topic-image-index.ts验证：2026-08-18

查看手册

TROUBLE-004

配置恢复

优先导出配置，再按范围重置设置或清理缓存。

状态：current源码：lite/src/state/preferences-config-codec.ts验证：2026-08-18

查看手册

TROUBLE-005

安全问题报告

在不提交 Cookie、授权信息和个人内容的前提下报告问题。

状态：current源码：lite/userscript.meta.txt验证：2026-08-18

查看手册

TROUBLE-006

主题打开自动恢复

主题打开遇到短暂网络、超时、服务器或定位异常时自动退避重试，并与 429 冷却和手动重试分流。

状态：current源码：lite/src/topic/topic-session.ts验证：2026-08-18

查看手册

参考

REF-001

运行兼容性

记录站点范围、浏览器脚本管理器、依赖和能力限制。

状态：current源码：lite/userscript.meta.txt验证：2026-08-18

查看手册

REF-002

版本与更新记录

以 userscript 元数据版本作为手册版本事实源。

状态：current源码：lite/userscript.meta.txt验证：2026-08-18

查看手册

REF-003

在线用户手册入口

从设置的“关于”面板直接打开独立网页用户手册，无需安装文档环境。

状态：current源码：lite/src/components/reader-image-fallback.ts验证：2026-08-18

查看手册

覆盖口径

• 目录面向用户可见入口、操作、设置、数据行为、监控和故障恢复；不为每个内部辅助函数建立独立条目。
• 一个复合功能可以在多篇手册出现，但必须有一个稳定 feature_id。
• source_anchor 使用当前源码中的稳定符号或唯一控件标记，不使用易漂移行号。
• since 表示首次纳入可验证目录的版本；早期实现历史未确认时不反推版本。
• 自动校验要求未文档化功能和无来源项均为 0。

机器可读版本：feature-catalog.json。