@cogita/plugin-reading-progress 为文章页提供阅读体验能力:
插件不引入第三方分析,也不把阅读进度逻辑写入 Markdown 页面文件。阅读位置记忆默认关闭,开启后只写入当前浏览器的 localStorage。
enabled:关闭后插件仍提供空运行时模块,主题会跳过阅读增强 UI,确保关闭配置不会造成构建失败。showBar:控制文章顶部的固定进度条。showReadingTime:控制右下角预计阅读时长和实时百分比。showTocProgress:控制目录当前章节高亮,并同步设置 aria-current="location"。rememberPosition:按文章 route 记忆滚动位置,再次打开文章时恢复;默认关闭。wordsPerMinute:每分钟阅读单位数,中文按字符、英文按单词估算。includeCode:是否把 fenced code block 纳入估算。核心层提供默认配置,保证默认主题可以安全消费虚拟模块;自定义主题仍可通过配置关闭插件。显式关闭时,插件不扫描文章,只生成空统计数据和关闭状态,兼顾按需关闭与主题静态导入的稳定性。
插件扫描 posts.dir 下的 Markdown/MDX 文件,生成:
正文处理会移除 frontmatter、链接地址、HTML 标签、标题标记和代码块(除非显式开启 includeCode)。统计结果至少为 1 分钟,避免短文显示为 0 分钟。
virtual-reading-progress-data 提供:
readingProgressConfigreadingStatsByRoutegetReadingStats(route)虚拟模块只暴露运行时需要的数据,不泄露文章的本地绝对路径和正文内容。
Lucid 通过全局 UI 组件读取当前 URL 对应的文章统计:
aria-current="location"。