AnkiDroid自定义学习功能中"按卡片状态或标签学习"的实现优化

背景介绍

AnkiDroid作为一款流行的闪卡学习应用，其自定义学习功能允许用户根据特定需求创建临时学习会话。其中"按卡片状态或标签学习"是一个重要但尚未完全实现的功能，目前仅通过标签对话框提供了部分支持。

当前实现的问题分析

现有实现存在几个关键问题：

1. 功能不完整：相比Anki桌面版，移动端缺少完整的卡片状态筛选选项
2. UI设计不合理：标签对话框被复用但并非最佳选择
3. 交互流程不清晰：用户无法直观地设置学习参数

技术方案设计

新UI设计方案

基于讨论，建议采用以下UI结构：

1. 标题区域：明确显示"按卡片状态或标签学习"

2. 卡片状态选择：使用下拉菜单提供四种选项：

   • 仅新卡片
   • 仅到期卡片
   • 所有复习卡片随机排序
   • 所有卡片随机排序(不重新安排)

3. 标签选择按钮：打开弹窗选择标签，包含搜索功能

4. 卡片数量输入：默认值100，可调整

5. 操作按钮：开始学习和取消

后端架构调整

1. 引入CustomStudyCramResponse数据结构，封装：

   • 学习类型(CramKind)
   • 卡片数量限制

2. 重构CardStateFilter枚举，与后端API对齐：

   • 每种状态对应描述文本和排序顺序
   • 提供从序号到枚举值的转换方法

3. 优化标签对话框：

   • 仅在学习模式下显示相关选项
   • 添加卡片数量设置功能

实现细节

状态管理

使用枚举清晰定义卡片状态筛选条件：

enum class CardStateFilter(
    val getDescription: () -> String, 
    val order: Int, 
    val cramKind: CramKind
) {
    NEW({ "仅新卡片" }, 0, CramKind.CRAM_KIND_NEW),
    DUE({ "仅到期卡片" }, 1, CramKind.CRAM_KIND_DUE),
    REVIEW({ "所有复习卡片随机排序" }, 2, CramKind.CRAM_KIND_REVIEW),
    ALL_CARDS({ "所有卡片随机排序(不重新安排)" }, 3, CramKind.CRAM_KIND_ALL);
}

UI组件交互

1. 卡片数量设置：

   • 使用IntegerDialog收集用户输入
   • 实时更新显示当前设置值

2. 状态选择：

   • 动态生成单选按钮组
   • 垂直布局提高可点击区域

3. 标签选择：

   • 复用现有标签选择逻辑
   • 添加搜索和批量操作支持

技术挑战与解决方案

1. 向后兼容：

   • 保持现有标签对话框的其他使用场景不变
   • 通过类型检查区分不同使用模式

2. 状态持久化：

   • 保存用户选择的卡片数量
   • 处理配置变更时的状态恢复

3. 性能优化：

   • 延迟加载非必要UI组件
   • 使用约束布局优化渲染性能

最佳实践建议

1. 原子提交：每个提交应保持独立可编译和测试
2. 清晰的提交信息：准确描述变更内容和目的
3. 渐进式开发：先实现核心功能，再逐步完善
4. UI一致性：遵循Material Design规范
5. 错误处理：提供有意义的错误反馈

总结

通过重新设计"按卡片状态或标签学习"功能的UI和实现架构，可以显著提升AnkiDroid用户的学习体验。关键在于提供清晰的操作流程、完整的功能支持，同时保持代码的可维护性和扩展性。这种改进不仅解决了当前功能不完整的问题，也为未来可能的扩展奠定了基础。

对于开发者而言，理解Anki的核心学习算法与UI设计原则的平衡是成功实现这类功能的关键。建议在开发过程中持续参考桌面版的实现，同时考虑移动端特有的交互模式和限制。