Khan Academy Perseus 项目 64.0.0 版本技术解析

Perseus 是 Khan Academy 开发的一个开源数学教育组件库，主要用于构建交互式数学题目和教学内容。该项目提供了丰富的数学组件和工具，帮助开发者创建高质量的数学学习体验。

主要变更

移除过时的 propUpgrades API

本次版本最重要的变更是移除了 widgets 中的 propUpgrades API。这个 API 原本用于处理组件属性的升级转换，但随着新解析器的引入，这套机制已经变得过时。新解析器提供了更现代化和高效的属性处理方式，使得 propUpgrades 不再必要。

这一变更反映了项目架构的演进方向，开发者应该迁移到新的解析器机制。对于现有代码库的影响评估显示，大多数现代应用已经不再依赖这个 API，因此移除不会造成广泛影响。

其他改进

状态管理优化

项目对组件状态管理逻辑进行了优化，特别是改进了判断何时清除 widget 状态的机制（answerless/answerful 状态）。这一改进使得组件在交互过程中能更智能地维护和重置状态，提升了用户体验的连贯性。

开发工具升级

开发团队将 Storybook 升级到了 v9 版本。Storybook 是流行的 UI 组件开发环境，这次升级带来了更快的构建速度、改进的文档功能以及更好的开发者体验。对于使用 Perseus 进行开发的团队来说，这意味着更高效的组件开发和测试流程。

依赖项更新

本次发布同步更新了多个核心依赖项，包括：

• perseus-core 升级到 13.0.0 版本
• math-input 升级到 26.0.1 版本
• 其他相关工具包也获得了兼容性更新

这些依赖项的更新确保了整个生态系统的协调一致，同时带来了性能改进和 bug 修复。

技术影响评估

对于现有项目的影响主要集中在对 propUpgrades API 的移除。开发团队建议检查项目代码中是否使用了这个 API，并考虑迁移到新的解析器机制。其他变更大多是内部优化，不会对现有功能产生破坏性影响。

这次发布体现了 Perseus 项目持续优化架构、提升开发体验的技术路线，同时也保持了良好的向后兼容性，是项目成熟度不断提升的标志。