来自 JTech Forums 的 62 项 Discourse 修复和自选功能

我们在 Discourse 上运营 JTech 论坛。这些改动源于我们作为论坛管理员或用户时遇到的问题。新选项会保留当前的默认设置。

打开群组并发起一个拉取请求(Pull Request),以查看具体变更、适用场景以及我们提出这些建议的原因。

PR 类型 · 20 个 Bug 修复 · 1 个隐私修复 · 26 项现有行为增强 · 15 个新功能

游戏化、点赞与徽章 (11)
PR #46543 · Bug 修复 · 仅计算有效点赞的得分

内容 — 在 DiscourseGamification::LikeReceived 和 DiscourseGamification::LikeGiven 中添加了 pa.deleted_at IS NULL 条件。

位置 — 游戏化排行榜。

原因 — 取消点赞可能导致排行榜得分残留。

查看 PR #46543

PR #46566 · 增强 · 限制回复得分

内容 — 添加了一个站点范围的每日上限,限制每个用户通过符合条件的回复获得“欢呼”(Cheers)的次数。

位置 — 内置的游戏化插件。

原因 — 可选的每日上限可限制通过快速回复获取的分数。

查看 PR #46566

PR #46567 · 增强 · 限制同一点赞者的得分

内容 — 添加了一个每日上限,分别应用于每对点赞者和帖子作者。

位置 — 内置的游戏化插件。

原因 — 每日上限可防止同一对用户之间的得分膨胀。

查看 PR #46567

PR #46568 · 增强 · 限制点赞行为的得分

内容 — 添加了一个每日上限,限制个人通过点赞获得“欢呼”的符合条件次数。

位置 — 内置的游戏化插件。

原因 — 每日上限可限制因大量点赞而获得的得分增长。

查看 PR #46568

PR #46576 · 增强 · 按分类禁用点赞

内容 — 添加一个站点设置,阻止在选定分类中进行新的点赞和反应,同时保留现有的计数和常规的撤销窗口。

位置 — 选定分类中的点赞和反应控件。

原因 — 站点可以关闭选定分类中的新点赞功能。

查看 PR #46576

PR #46577 · 增强 · 按群组限制点赞

内容 — 为新的点赞和反应添加群组白名单。失去访问权限的成员仍可在常规撤销窗口内移除其现有的反应。

位置 — 站点设置和帖子点赞权限。

原因 — 站点可以将新点赞限制给受信任或已验证的群组。

查看 PR #46577

PR #46578 · 增强 · 按分类静默点赞

内容 — 添加一个分类列表,抑制新的点赞和反应通知,并从个人资料活动中隐藏相应的点赞。帖子上的反应和计数仍然可用。

位置 — 选定分类的点赞提醒和个人资料活动。

原因 — 成员可以在繁忙的分类中进行反应而不发送提醒。

查看 PR #46578

PR #46579 · 增强 · 从总计中排除点赞

内容 — 允许管理员将选定分类从用户和目录的点赞总计及相关信任等级计算中排除。现有总计会在设置或分类变更后在后台更新。

位置 — 用户总计、目录和信任等级计算。

原因 — 与主题无关的点赞可以保留在帖子中而不影响成员的总计。

查看 PR #46579

PR #46580 · 增强 · 自动信任等级标识

内容 — 添加一个设置,为未选择标识的成员显示已配置的最高信任等级标识,使用当前的信任等级和群组可见性。

位置 — 配置了信任等级标识的站点上的头像。

原因 — 当成员未选择任何标识时显示已配置的标识。

查看 PR #46580

PR #46581 · 增强 · 可配置的徽章阈值

内容 — 为选定的种子徽章阶梯添加计数覆盖列表。有效的授予查询和徽章描述将使用选定的计数。

位置 — 内置徽章的管理员徽章设置。

原因 — 通过设置调整内置徽章的目标。

查看 PR #46581

PR #46582 · 增强 · 可配置的“已解决”阈值

内容 — 为“指导顾问”(Guidance Counsellor)、“万事通”(Know-it-All)和“解决方案机构”(Solution Institution)添加计数设置。授予和徽章描述将使用选定的计数。

位置 — 内置“已解决”(Solved)插件中的徽章设置。

原因 — 站点可以为高级“已解决”徽章选择目标。

查看 PR #46582

通知与管理员工具 (11)
PR #46544 · Bug 修复 · 过滤分页通知

内容 — 在分页分支中也应用解析后的 notification_types 过滤器,并在 load_more_notifications 中保留 filter_by_types。

位置 — 分页通知历史 API。

原因 — 在加载较早的通知时应用类型过滤器。

查看 PR #46544

PR #46598 · 增强 · 用户备注创建事件

内容 — 在 DiscourseUserNotes.add_note 中触发 DiscourseEvent.trigger(:user_note_created, record, user, created_by, opts)。

位置 — 内置的用户备注(User Notes)插件。

原因 — 插件可以监听新备注,而无需修改模型。

查看 PR #46598

PR #46583 · 增强 · 在 UI 中过滤通知

内容 — 添加一个通知类型下拉菜单,与已读状态过滤器协同工作,并在加载更多通知时保持选择状态。

位置 — 完整的通知历史页面。

原因 — 结合已读和未读过滤器,按类型查找较早的提醒。

查看 PR #46583

PR #46596 · 功能 · 删除回复的提醒

内容 — 为应用内删除通知添加可选的群组列表。将操作和主题传递给有资格查看该讨论的管理员。

位置 — 普通主题回复的管理员通知历史。

原因 — 通知能查看受影响主题的选定管理员。

查看 PR #46596

PR #46584 · 功能 · 私信徽章持有者

内容 — 一个可选的管理员编辑器选择器会将当前草稿中添加活跃且不同的徽章持有者,同时保留现有的收件人和正常的发送步骤。

位置 — 管理员私信编辑器。

原因 — 管理员可以在普通私信草稿中添加徽章持有者。

查看 PR #46584

PR #46585 · 功能 · 管理员帖子阅读者报告

内容 — 一个可选的帖子管理员操作显示最多 200 位已登录阅读者,包括记录的查看时间及其对该主题的最后访问,仅限于可查看该帖子的管理员。

位置 — 普通主题上的帖子操作菜单。

原因 — 检查普通帖子或公告的记录阅读情况。

查看 PR #46585

PR #46604 · 功能 · 桌面通知吐司

内容 — 一个可选的吐司(Toast)在可见的桌面标签页中显示新的未读通知。用户从偏好设置中启用,站点设置持续时间、堆叠大小和排除的类型。遵循“请勿打扰”设置。

位置 — 桌面浏览器和用户通知偏好设置。

原因 — 提供尊重用户设置和“请勿打扰”的页面内提醒。

查看 PR #46604

PR #46591 · 增强 · 可关闭的全局公告

内容 — 一个可选的关闭按钮在浏览器中记住对确切显示文本的关闭操作。公告内容变更时会再次显示。

位置 — 站点顶部的全局公告。

原因 — 读者可以关闭公告并仍能看到下一个公告。

查看 PR #46591

PR #46597 · 功能 · 排队帖子结果提醒

内容 — 为批准和拒绝通知配置单独的收件人群组。只有有权访问审查项目的管理员才会收到通知。

位置 — 审查队列中的批准和拒绝。

原因 — 分别为批准和拒绝配置收件人。

查看 PR #46597

PR #46599 · 功能 · 用户备注提醒

内容 — 在用户备注中配置管理员收件人群组。通知链接到用户的个人资料,并在管理员失去访问权限或禁用用户备注时隐藏。

位置 — 内置的用户备注插件和管理员通知历史。

原因 — 通知选定的管理员关于新备注,但不包含备注文本。

查看 PR #46599

PR #46600 · 功能 · 审查备注提醒

内容 — 为审查备注配置一个管理员收件人群组。提醒链接到该条目,遵循审查访问权限和作用域 API 权限,并跳过已收到明确提及的收件人。

位置 — 审查队列中的备注。

原因 — 通知有资格的审查者并避免重复提及。

查看 PR #46600

审核与发帖 (12)
PR #46569 · 增强 · 关闭主题中的 TL4 回复

内容 — 添加一个站点设置,控制信任等级 4 用户是否可以在关闭的主题中回复。

位置 — 信任等级 4 回复权限。

原因 — 站点可以关闭针对关闭主题回复的 TL4 例外。

查看 PR #46569

PR #46570 · 增强 · TL4 主题重新打开

内容 — 为重新打开权限添加站点设置。主题菜单、直接状态更新和主题计时器均遵循此设置。

位置 — 信任等级 4 的主题状态菜单和计时器。

原因 — 站点可以将重新打开和重新打开计时器保留给管理员。

查看 PR #46570

PR #46571 · 增强 · 分类版主回复

内容 — 添加一个设置,控制在一个群组管理的分类中关闭主题的回复。

位置 — 群组管理分类中的回复权限。

原因 — 选择分类版主是否可以在关闭的主题中回复。

查看 PR #46571

PR #46572 · 增强 · 分类版主重新打开

内容 — 为重新打开管理分类中的主题添加设置。菜单、状态更改和主题计时器均遵循此设置。

位置 — 群组管理分类中的主题状态和计时器。

原因 — 选择分类版主是否可以重新打开主题。

查看 PR #46572

PR #46573 · 功能 · 分类版主移动主题

内容 — 添加将现有主题移动到该群组管理的可见分类的选项,受源编辑权限和目标审查要求的约束。

位置 — 分类群版主体的主题移动对话框。

原因 — 在现有访问规则下允许移动到管理分类。

查看 PR #46573

PR #46574 · 功能 · 分类版主设置

内容 — 为范围受限的分类编辑器添加选项。服务器仅允许定义的一组常规和外观字段以及主题模板设置。

位置 — 群组管理分类的设置。

原因 — 在保护权限的同时授权常规设置编辑。

查看 PR #46574

PR #46575 · 功能 · 分类版主子分类

内容 — 在符合条件的父分类上添加“创建子分类”操作。子分类继承父分类的访问规则、审核群组和发帖审查要求。

位置 — 群组管理分类下的子分类创建。

原因 — 允许版主创建继承父分类访问规则的子分类。

查看 PR #46575

PR #46601 · 功能 · 单一主题中的回复审批

内容 — 允许版主从主题操作菜单中要求对单一主题中的新回复进行审批。回复进入现有的审查队列,管理员可以审计对该设置的更改。

位置 — 主题审核菜单和审查队列。

原因 — 在不关闭讨论的情况下排队新回复。

查看 PR #46601

PR #46602 · 功能 · 逐用户慢速模式

内容 — 允许管理员在用户的后台页面设置发帖间隔和可选的过期时间。间隔适用于分类主题和回复,更改记录在管理员操作日志中。

位置 — 管理员用户控件和普通主题发帖。

原因 — 减缓单个成员的速度而不减缓整个主题。

查看 PR #46602

PR #46603 · 功能 · 分类确认提示

内容 — 分类编辑器可以设置纯文本确认,而不改变版主审批或权限,并带有可选的包含性信任等级上限。

位置 — 分类设置和新主题编辑器。

原因 — 在作者提交主题前提醒分类规则。

查看 PR #46603

PR #46586 · 功能 · 主题页脚公告

内容 — 一个可选的管理员操作添加、编辑或清除对已能阅读该主题的用户可见的纯文本页脚公告。更新显示在管理员日志中。

位置 — 管理员操作菜单和主题页脚。

原因 — 让管理员将说明放在回复按钮附近。

查看 PR #46586

PR #46587 · 功能 · 固定帖子到页脚

内容 — 一个可选的帖子管理员操作将一个普通帖子作为副本固定在主题页脚,并带有指向原帖的链接。副本独立于帖子流加载,如果查看者无法看到该帖子则省略副本。

位置 — 帖子操作菜单和主题页脚。

原因 — 在主题末尾保持一个有用的答案易于查找。

查看 PR #46587

移动布局与键盘访问 (14)
PR #46549 · Bug 修复 · 空白个人资料控件

内容 — 在 .user-main .about .controls ul 中隐藏 > li:empty,以匹配 .user-card .usercard-controls。

位置 — 用户个人资料操作行。

原因 — 没有内容的插件槽可能导致控件之间出现间隙。

查看 PR #46549

PR #46550 · Bug 修复 · 空白个人资料位置行

内容 — 隐藏空白行,同时保留位置、网站和由插件出口提供的内容。

位置 — 用户个人资料标题。

原因 — 当位置和网站均为空时移除空白空间。

查看 PR #46550

PR #46551 · Bug 修复 · iPad 滑入菜单

内容 — 从栏的下边缘开始菜单并减少菜单高度,使其适合屏幕。

位置 — iPad 导航栏和滑入菜单。

原因 — 防止导航栏覆盖菜单行。

查看 PR #46551

PR #46552 · Bug 修复 · 窄屏帖子历史对话框

内容 — 允许计数器缩小,以便所有四个箭头都适合页脚内。

位置 — 帖子修订历史对话框。

原因 — 在小屏幕上保持修订箭头在对话框内。

查看 PR #46552

PR #46553 · Bug 修复 · 移动私信标签

内容 — 允许选择器在标题下方换行并适合编辑器。

位置 — 移动私信编辑器。

原因 — 让标签在标题下方换行以防止水平溢出。

查看 PR #46553

PR #46554 · Bug 修复 · 移动偏好设置选择器

内容 — 允许偏好字段集缩小,并将选择器限制为其容器的宽度。

位置 — 窄屏幕上的偏好设置。

原因 — 让窄表单缩小以适合其多选控件。

查看 PR #46554

PR #46555 · Bug 修复 · 侧边栏键盘提示

内容 — 使用与其他快捷键提示相同的键盘功能检查。一旦检测到键盘使用,帮助信息就会出现。

位置 — 桌面侧边栏。

原因 — 在显示快捷键帮助之前等待键盘检测。

查看 PR #46555

PR #46556 · Bug 修复 · 移动代码复制间距

内容 — 将额外填充放置在代码块的行内末端,即按钮所在的位置。

位置 — 从右到左界面中手机上的代码块。

原因 — 在任一文本方向上保持复制按钮旁边的填充。

查看 PR #46556

PR #46557 · Bug 修复 · 混合方向引用边框

内容 — 使用引用自身的行内起始位置作为其边框。

位置 — 具有混合文本方向的帖子中的引用。

原因 — 将引用条放在被引用文本的起始侧。

查看 PR #46557

PR #46558 · Bug 修复 · 全宽打印主题

内容 — 在打印时隐藏侧边栏和跳过链接,并为内容提供单个全宽列。

位置 — 主题打印布局。

原因 — 在打印主题时利用页面宽度用于帖子。

查看 PR #46558

PR #46559 · Bug 修复 · 图像链接焦点轮廓

内容 — 当链接接收键盘焦点时,在图像内部绘制焦点轮廓。

位置 — 链接帖子图像上的键盘导航。

原因 — 恢复由灯箱移除的键盘焦点指示器。

查看 PR #46559

PR #46560 · Bug 修复 · 主题地图头像焦点

内容 — 使每个链接适应其头像并在链接内部绘制轮廓。

位置 — 主题地图中的头像行。

原因 — 在裁剪的头像行内保持键盘轮廓可见。

查看 PR #46560

PR #46561 · Bug 修复 · 帖子作者焦点

内容 — 将链接保持在行内,截断名称,并在链接内部绘制轮廓。

位置 — 帖子标题中的作者名称。

原因 — 在窄行内保持长名称及其焦点轮廓。

查看 PR #46561

PR #46562 · Bug 修复 · 粘性标题焦点

内容 — 在链接内部绘制两个轮廓。

位置 — 粘性标题中的主题和分类链接。

原因 — 在裁剪的主题和分类链接上保持焦点可见。

查看 PR #46562

主题与外观 (5)
PR #46545 · Bug 修复 · 主题默认调色板

内容 — 当选择器可见时,在命名调色板旁添加一个“主题默认”选项。

位置 — 偏好设置 → 界面 → 颜色方案。

原因 — 当主题限制调色板列表时显示默认选项。

查看 PR #46545

PR #46546 · Bug 修复 · 颜色预览模式切换

内容 — 在加载预览以及在浅色、深色和自动模式之间切换时更新 link#cs-preview-light 和 link#cs-preview-dark 的 media 属性。

位置 — 偏好设置 → 界面以及浅色/深色开关。

原因 — 防止旧预览覆盖选定的颜色模式。

查看 PR #46546

PR #46548 · Bug 修复 · 禁用期间选择器插入符

内容 — 当 this.selectKit.options.disabled 为真时隐藏 .angle-icon,并在 .period-chooser.is-disabled .period-chooser-header 上使用 cursor: default。

位置 — 游戏化排行榜上的期间选择器。

原因 — 固定的排行榜范围应看起来像是固定的范围。

查看 PR #46548

PR #46564 · 增强 · 移动端小 Logo

内容 — 在“外观 → Logo”中添加一个开关,当未上传移动端 Logo 时在移动端使用小 Logo。显式的移动端 Logo 具有优先级。

位置 — 后台 → 外观 → Logo。

原因 — 让站点在未设置移动端 Logo 时重用小型 Logo。

查看 PR #46564

PR #46565 · 增强 · 独立的遮罩图标

内容 — 在“外观 → Logo”中添加一个可选的遮罩图标上传,并将其用于遮罩清单条目。

位置 — 后台 → 外观 → Logo 和 Web 应用清单。

原因 — 让应用使用为具有遮罩功能的启动器设计的图标。

查看 PR #46565

阅读、搜索与导航 (9)
PR #46547 · 隐私修复 · AI 嵌入中的 whispers

内容 — 将 topic_truncation 和 post_truncation 过滤为常规、非隐藏帖子,并在 Jobs::GenerateEmbeddings 中跳过非常规帖子。

位置 — Discourse AI 语义搜索。

原因 — 防止管理员 whispers 影响公共语义搜索。

查看 PR #46547

PR #46588 · 增强 · 可点击的桌面主题行

内容 — 一个启用选项允许通过非交互式行空间使用正常或新标签页手势打开主题,同时保留链接、文本选择和批量操作。

位置 — 桌面主题列表。

原因 — 从行空白处打开,同时保留链接和控件。

查看 PR #46588

PR #46589 · 增强 · 最新回复预览

内容 — 一个可选字段提供最新可见常规回复的纯文本预览和作者元数据,每个列表使用一个批量查询,且无额外的作者查询。

位置 — 普通主题列表及其 API 载荷。

原因 — 让主题显示最新可见回复及其作者。

查看 PR #46589

PR #46590 · 增强 · 无表情符号摘录

内容 — 现有的摘录辅助函数接受一个可选的 strip_emojis 关键字,用于省略烹饪后的表情符号图像,同时保留其他图像处理。

位置 — Post.excerpt 和 PrettyText.excerpt 辅助函数。

原因 — 让紧凑预览在请求时省略表情符号短代码。

查看 PR #46590

PR #46563 · Bug 修复 · Discourse 外的同站点链接

内容 — 链接拦截器将没有匹配 Ember 路由的 URL 留给浏览器。已知的客户端路由和注册的重写继续通过路由器。

位置 — 在 Discourse 中点击的同源链接。

原因 — 打开独立的同站点页面而不遇到客户端 404。

查看 PR #46563

PR #46592 · 增强 · 代码语言标签

内容 — 一个可选标签使用作者显式指定的语言,即使代码块复制控件被禁用。

位置 — 帖子中的围栏代码块。

原因 — 即使复制控件关闭也显示声明的语言。

查看 PR #46592

PR #46594 · 增强 · 外部链接指示器

内容 — 一个可选的图标和无障碍描述标记帖子中的出站 HTTP 链接。站点可以将额外的确切主机名视为内部。

位置 — 普通帖子中的外部链接。

原因 — 显示何时链接离开论坛及其配置的主机。

查看 PR #46594

PR #46595 · 增强 · 搜索选中文本

内容 — 一个可选的选择工具栏按钮为具有搜索权限的用户打开论坛搜索,将选中的短语作为查询参数。

位置 — 帖子文本选择工具栏。

原因 — 直接从帖子工具栏搜索,标点符号保持完整。

查看 PR #46595

PR #46593 · 增强 · 代码行号

内容 — 一个单独的、同步的槽在代码旁边显示逻辑行号。它遵循代码的滚动位置和排版,并使代码文本可用于复制。

位置 — 帖子中的多行代码块。

原因 — 使行号易于引用而不改变复制的代码。

查看 PR #46593

这些功能中哪些会对你的论坛有帮助?我很想听听你会如何使用它们。

这一大批 PR 确实让人有些意外。很高兴看到大家直接贡献代码,但过去我们一直强烈建议先在这里讨论,再鼓励大家投入精力去处理那些可能不太合适的工作。

我们的系统并不是为这种情况设计的。Pull request 会消耗资源,包括机器资源和人力关注度。

随着贡献门槛的降低,我想我们需要思考如何在流程中引入一些适度的“摩擦”,既不增加贡献者或维护者的负担,又能起到筛选作用。

这是我们以前未曾遇到的情况,所以我目前还没有一套明确的指导方针(我也不是制定这些方针的合适人选)。我会让团队中更贴近这个问题的同事在有空时分享他们的看法。

这些 PR 中有些可能非常好,但我们需要与您一起找出评估的最佳方式。

先在此说明情况,以免您看到这些 PR 被提前关闭或打标签时感到疑惑。

感谢回复。我确实看过要求 PR 必须关联 Meta 帖子的规定,所以发了这个帖子。但我疏忽了,原来讨论应该在提交 PR 之前就进行。是我的错。

如果觉得合适,请随时关闭所有 62 个 PR。我们已经在自己的插件中应用了这些更改,所以无论结果如何,我们都没问题。我们原本想着其中一些更改或许也能帮助其他 Discourse 站点。

我一直认为 Discourse 是一个取得了巨大成功的了不起的开源项目。我之前并没有真正想过,像这样一批 PR 会耗费团队多少构建时间和注意力。你的回复让我对此有了清醒的认识。

补充一点背景:我们是一次性提交了所有 PR,但这些更改是我们在运营论坛的两年过程中逐步修复问题时积累下来的。我以为,既然 AI 工具帮助我们创建了这些 PR,应该也能协助完成初步的代码审查。我低估了团队后续仍需投入的工作量。

内容很多……我确实想捕捉并合并那些 bug,但其中很多是功能变更,需要进行讨论、论证等等。

我认为我们正在进行的这场对话很有价值。

我见过其他项目也经历过类似的情况:十年前确立的规范,正受到人们如今所能实现之新可能性的挑战。现在,做出更多优质贡献确实变得容易多了。

我们无疑正在经历一段全新的时期。

就我们而言,此前我们主要面对的是来自安全层面的大量报告。在这方面,我们也不得不调整策略。我们正在大力投入,以自行发现更多问题,自动化处理他人报告的部分分类工作、验证补丁等。

对于其他类型的变更(无论是缺陷还是功能),能够采取类似的做法,是我们应当认真考虑的问题。

我们需要时间,大家才能适应这一变化,并弄清楚何处该施加何种程度的反压。

我希望看看我们是否能借此机会共同测试一些想法,但本周即将结束。下周初我会带着更多思考再回来讨论。

谢谢,Dave。我已经查看了全部 62 个 PR,并在原帖中为每个 PR 添加了标签。

此外,我认为这是一个很好的契机,来审视我们如何鼓励和指导普遍意义上的贡献,特别是针对 Development 频道。对于许多贡献而言,代码已不再是瓶颈或主要工作量。相反,重点在于发起对话、建立共识以及让其他人参与进来。我们需要不同的工作流程和模式来更好地支持这一点。