Quantified API

《▒ 欢迎来到新一代 ▒》

随着 V2 的发布，Quantified API 已经得到了巨大的升级。

调度器、CPU 运行时、缓存系统、任务图、GPU 路由、兼容层、支持的平台、构建系统和整体 API 设计都得到了大幅改进或完全重建。

Quantified API 现在也拥有了完整的官方文档，涵盖从基本安装到高级计算工作负载、GPU 路由、缓存、迁移、故障排除和示例的所有内容 :DDD

《▒ 它实际做什么 ▒》

• 正确的异步调度，具备工作线程通道、工作负载路由、遥测和合理的回退行为
• 并行执行，适用于可以安全地分配到多个 CPU 线程上的工作负载
• 依赖感知的任务图，适用于需要按特定顺序运行作业的工作流程
• 后端感知的计算路由，可在 CPU、Vulkan 和 OpenCL 之间进行选择
• 重复任务抑制，使重复的相同工作可以合并，而不是被执行数百次
• 高级缓存，支持内存、磁盘、持久化、过期、压缩和刷新
• 自动模组注册，通过 Fabric、Forge 和 NeoForge 元数据实现
• 实时诊断，通过运行时遥测和 Quantified Web 面板实现

《▒ Vulkan 和 OpenCL 加速 ▒》

Quantified API 提供了开箱即用的 Vulkan 计算加速，无需用户先手动配置一堆随机设置。

Vulkan 是首选的 GPU 后端，而 OpenCL 仍然作为兼容性和回退选项提供。

GPU 加速也不会盲目地用于每个微小任务。Quantified API 会考虑工作负载、运行时状态、可用硬件和首选后端，然后再决定工作应该在哪里运行。

• 隔离的 Vulkan 探测，即使驱动损坏或加载器问题也不会立即毁掉游戏
• 延迟初始化，GPU 启动不会与仍在加载中的 Minecraft 冲突
• 更清晰的运行时状态，失败或半初始化的后端不会被误认为就绪
• 自动回退路由，从 Vulkan 到 OpenCL，最后在需要时回退到 CPU
• 设备选择和诊断，通过 Quantified Web 面板实现

《▒ 更快的运行时 ▒》

Quantified API 底层的运行时经过了大规模重新设计，以减少模组实际想执行的工作周围所增加的开销。

• 微小且独特任务的开销更低
• 重复突发任务的抑制能力更强
• 并行工作负载编排更廉价
• 较小任务图的执行速度大幅提升
• 对线程安全和非线程安全工作负载的处理更好
• 持久化和异步缓存行为得到改进

基本上，现在花在管理工作上的时间少了很多，而把更多时间花在实际执行上。疯狂的想法，我知道 xd

《▒ 性能改进 ▒》

针对旧版 v1.4.4 发布的内部运行时基准测试显示，所有测试的工作负载类型都有显著改进。

• 微小独特任务突发：大约快了 3.95x
• 重复任务突发：大约快了 45.4x
• 小型并行工作负载：大约快了 5.54x
• 中型并行工作负载：大约快了 9.16x
• 小型 DAG 工作负载：在测试的设置下，快了高达大约 2952x

重复抑制也从不实际的 2048 次执行，改善为测试重复突发中仅 1 次实际执行。

所以是的，V2 可不只是个小更新 :DDD

《▒ Quantified Web 面板 ▒》

Quantified API 包含一个实时 Web 面板，让开发者和用户可以查看运行时实际在做什么，而不是盲目信任神秘的后台线程。

可以通过配置文件或 /quantified webpanel 命令来启用它。

• 调度器和队列活动
• CPU 和 GPU 后端状态
• 已连接模组的使用情况
• Vulkan 和 OpenCL 诊断
• 首选 GPU 和后端选择
• 诊断导出，方便调试
• 可选的认证和 HTTPS 支持

《▒ 兼容性 ▒》

• 支持 Fabric、Forge 和 NeoForge
• 支持从 1.20.1 到当前受支持的 1.21.X 和 1.26.X 平台线的 Minecraft 版本
• Vulkan 完全是可选的，并且在不可用时能干净地降级
• OpenCL 仍然可用于较旧或兼容性较差的硬件
• CPU 执行始终作为最终回退方案可用
• 为旧版 V1 API 制作的模组可以通过兼容层继续工作
• 自动加载器元数据检测减少开发者的手动设置

《▒ 官方文档 ▒》

Quantified API 现在为新老开发者都提供了适当的官方文档。

它涵盖了安装、支持的平台、计算工作负载、并行处理、任务图、缓存、Vulkan 和 OpenCL 路由、兼容性、迁移、故障排除以及完整的示例。

探索 Quantified API 文档

《▒ 许可与支持 ▒》

基于 BRSSLA V2.0 许可，该许可对个人和非商业用途免费。

将 Quantified API 作为依赖项包含在内的模组开发者将自动获得其模组的商业权利。

Quantified API 的构建目标是灵活、易于集成、尽可能用户友好，同时仍然给予开发者对其工作负载的适当控制权。

如果您有任何请求、想法、文档改进建议，或者发现了错误，欢迎开启一个 GitHub Issue，甚至直接提交一个 Pull Request :]