Skip to content

长文沉浸式阅读与段评#209

Merged
adlered merged 30 commits into
FishPiOffical:masterfrom
HereIsYui:master
Jul 20, 2026
Merged

长文沉浸式阅读与段评#209
adlered merged 30 commits into
FishPiOffical:masterfrom
HereIsYui:master

Conversation

@HereIsYui

Copy link
Copy Markdown
Member

概要

articleType=6 长文新增沉浸式阅读体验与起点式段评能力。

普通文章、问答、思绪、机要的阅读与评论行为保持不变。

阅读体验

  • 长文隐藏顶部、底部导航的视觉内容,保留公共脚本。
  • 阅读页采用独立背景、阅读面与夜间配色。
  • 标题左对齐,补充作者、时间、专栏与章节信息。
  • 正文优化字号、行高、首行缩进、代码块、引用、表格与图片间距。
  • 新增阅读宽度设置:自动、600、800、1000、1200,默认 800px,并保存至 localStorage.longArticleSettings
  • 新增返回首页入口。
  • 阅读工具栏改为靠近阅读面的悬浮工具栏,保留顶部、评论、字号与版式设置。
  • 评论面板从阅读面右侧展开,正文与工具栏同步让位;评论编辑器保留在阅读舞台下方。
  • 修复窄宽度溢出、评论面板定位、滚动条偏移及回到顶部动画。

段评能力

  • 长文正文按段落、标题、列表项、引用、媒体、代码块、表格生成服务端段落锚点。
  • 支持正文点击打开、再次点击关闭对应段评。
  • 段落末尾展示已有段评数量;无评论段落不显示红色数量标记。
  • 段评与章评共存:
    • 工具栏评论进入章评。
    • 正文段落进入对应段评线程。
  • 段评支持新增、回复、分页、排序、匿名、仅楼主可见、Markdown、图片与表情。
  • 评论编辑、删除、感谢、投票、reaction 与实时推送继续复用原有链路。
  • 文章编辑时尝试迁移段评锚点;无法匹配的评论归入“原段落已修改”,保留原文摘要。
  • 段评通知、评论列表与评论跳转展示关联段落摘要。

段评交互优化

  • 段落选中或悬停时,仅正文文字显示高亮与虚线下划线,不覆盖整行空白。
  • 段评图标保持在段落末尾,不额外占用一行。
  • 段评回复视觉层级最多两层。
  • 段评隐藏 reaction 汇总区域。
  • 评论操作默认显示点赞;悬停显示反对、回复与更多。
  • 举报、感谢、编辑、删除等低频操作收进更多菜单。
  • 修复父评论悬停时内部回复操作同时显示的问题,并移除厚重阴影。

数据库迁移

执行:

sql/20260719_long_article_paragraph_comment.sql

symphony_comment 增加段评类型、段落标识、段落类型、顺序、快照与状态字段,并创建段评查询索引。

旧评论默认保留为章评,不影响历史数据。

新增接口

  • POST /comment/paragraph
  • POST /comment/paragraph/summary
  • POST /comment/paragraph/thread/parents

接口说明已更新至 API.md,需要同步到鱼排 API 文档文章。

@adlered
adlered merged commit 3f148da into FishPiOffical:master Jul 20, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants