Tusky客户端对Mastodon 4.3.0私信过滤机制的技术适配方案

背景介绍

Mastodon社交网络平台在4.3.0版本中引入了一项重要的服务器端功能变更——私信通知过滤机制。这项变更已经在mastodon.social实例上先行部署，并将随正式版发布推广到所有Mastodon-Ruby服务器。作为Android平台的主流客户端，Tusky需要及时适配这一变更，否则用户可能会在不知情的情况下错过重要私信。

技术变更详情

旧版机制回顾

在4.3.0版本之前，Mastodon通过"偏好设置"中的"屏蔽未关注用户的私信"选项来控制私信接收。当启用时，系统会静默隐藏来自未关注用户的私信，类似于"静音"而非"屏蔽"的效果。

新版机制解析

4.3.0版本对此进行了重构，主要变化包括：

1. 将过滤设置移至"通知过滤器"面板（而非偏好设置）
2. 新增四种过滤条件选项：
   • 未关注用户
   • 未回关用户
   • 新注册账户
   • 未经请求的私信提及
3. 默认情况下，"过滤未经请求的私信提及"选项对新用户自动启用

当过滤条件触发时，系统会在通知栏顶部显示"N条通知被过滤"的提示框。点击后会展示发送过滤通知的用户列表，进一步点击可查看该用户的具体通知。

客户端适配挑战

技术兼容性问题

由于这一变更完全在服务器端实现，不支持新特性的客户端（如未更新的Tusky）将面临以下问题：

1. 无法显示"过滤通知"提示
2. 用户无法访问被过滤的通知
3. 用户无法知晓内容被过滤的事实
4. 无法在客户端内关闭此功能

API接口分析

新功能涉及四个主要API端点：

1. 通知请求列表（仅支持轮询）
2. 接受通知请求的RPC
3. 拒绝通知请求的RPC
4. 修改服务器端通知过滤策略的RPC

Tusky适配方案

短期方案（v25版本）

1. 实现/api/v1/notifications/policy接口的前端界面
2. 在"账户偏好设置"中新增"通知过滤器"子面板
3. 提供四个过滤条件的复选框控制
4. 为每个选项添加解释性文字说明

中期方案（v26版本）

1. 完整支持过滤通知的显示、审批和驳回功能
2. 重用"关注请求"的UI设计模式
3. 添加"全部拒绝"的批量操作功能（针对可能的骚扰场景）
4. 考虑在左侧边栏添加过滤通知入口

用户体验优化建议

1. 避免将过滤通知提示置于通知列表顶部（可能引起不必要的注意）
2. 提供"永久忽略过滤通知"的全局选项
3. 考虑将提示置于界面底部，减少对主要操作的干扰
4. 确保过滤通知的查看和驳回操作尽可能简便

技术实现细节

版本兼容性处理

1. 通过检测/api/v1/notifications/policy端点存在性来判断功能可用性
2. 对不支持新特性的旧版服务器保持原有行为

UI设计方案

1. 将现有"过滤器"拆分为"内容过滤器"和"通知过滤器"
2. 采用类似Web界面的复选框布局，但优化移动端显示
3. 在通知栏添加非侵入式的过滤通知提示（考虑使用底部弹出式设计）

总结

Mastodon 4.3.0的私信过滤机制变更为客户端开发带来了新的挑战。Tusky需要通过分阶段的技术适配，既确保功能的完整性，又兼顾用户体验的合理性。特别是在处理可能包含骚扰内容的过滤通知时，需要特别考虑用户的心理感受和操作便利性。通过合理的API调用和UI设计，Tusky可以在保持应用简洁性的同时，完整支持这一重要的安全功能。