Oppia项目中NumberWithUnits交互规则的命名优化方案

背景介绍

在开源在线学习平台Oppia中，NumberWithUnits（带单位的数字）是一种常见的交互类型，用于处理涉及数值和单位的数学问题。该交互类型包含两条核心规则："is equal to..."（等于...）和"is equivalent to..."（等价于...）。这两条规则虽然功能不同，但命名方式容易让问题创建者产生混淆。

问题分析

当前实现中，"is equal to..."规则要求数值和单位都必须与指定答案完全一致，而"is equivalent to..."规则则只要求数值相等，允许单位不同（如1米等价于100厘米）。这种细微但重要的区别在现有命名方式下不够直观，可能导致教育内容创建者错误地选择规则。

解决方案

经过社区讨论，决定将"is equal to..."规则更名为"Has the same value and units as..."（具有相同的值和单位）。这一修改具有以下优势：

1. 语义更清晰：新名称明确表达了需要同时匹配数值和单位的双重要求
2. 区分度更高：与"is equivalent to..."形成更明显的对比
3. 降低误用风险：教育工作者能更直观地理解规则差异

技术实现

该修改涉及三个关键文件的变更：

1. rule_templates.json：更新规则描述模板
2. interaction_specs.json：调整交互规范
3. parameterize-rule-description.pipe.spec.ts：更新相关测试用例

为确保向后兼容性，开发团队进行了全面测试：

• 创建包含原规则的课程
• 应用修改后验证课程的可编辑性
• 确保课程播放功能不受影响

教育意义

这一看似简单的命名优化实际上体现了教育软件设计中的重要原则：

• 界面文本应准确反映功能逻辑
• 术语选择应考虑非技术用户的理解能力
• 一致性是降低认知负荷的关键

在STEM教育中，单位和数值转换是基础但容易混淆的概念，清晰的交互规则命名能有效辅助教学。

总结

Oppia社区通过这一改进展示了开源教育平台如何持续优化用户体验。命名规范的精确化不仅提升了软件质量，也间接支持了更有效的数字化教学实践。这种关注细节的迭代过程正是开源项目保持活力的关键所在。