Cooklang-Chef 项目中的配方分量缩放问题解析

Cooklang-Chef 项目中的配方分量缩放问题解析

在 Cooklang-Chef 项目中，用户可能会遇到一个常见问题：当尝试调整配方分量时，系统会提示"这些值不会缩放"的错误。本文将深入分析这一问题的原因，并提供多种解决方案。

问题现象

用户在使用 Cooklang-Chef 时发现，无论尝试调整哪个配方，当修改分量大小时，配方中的数量不会相应变化。系统会在数量值下方显示黄色波浪线，表示缩放操作未能成功执行。

根本原因

这一问题源于 Cooklang 规范当前版本的默认行为：配方中的数值默认不会自动按比例缩放。这是 Cooklang 解析库的当前实现方式，虽然未来版本可能会对此进行修改，但目前需要开发者或用户采取特定措施来实现分量缩放功能。

解决方案

方法一：显式标记可缩放数值

在配方文件中，为每个需要按比例缩放的数值添加星号(*)标记：

@oil{60*%ml}
@water{240*%ml}
@flour{8*%gram}

这种方法的优点是可以精确控制哪些数值需要缩放，而哪些保持固定不变。

方法二：全局自动缩放设置

在配方的 frontmatter 之后添加自动缩放配置指令：

>> [auto scale]: true

这一设置会启用整个配方的自动缩放功能，无需逐个标记数值。适合需要整体调整分量的情况。

最佳实践建议

1. 明确缩放意图：在设计配方时，应明确考虑哪些成分需要随分量变化而调整，哪些应保持固定。

2. 混合使用：可以在同一配方中结合两种方法，例如启用全局自动缩放，同时对特定不需要缩放的数值移除星号标记。

3. 版本兼容性：注意未来 Cooklang 解析库更新可能会改变这一行为，建议关注项目更新日志。

4. 文档记录：在团队协作或公开分享配方时，应注明使用的缩放策略，避免其他用户困惑。

技术背景

Cooklang 作为一种食谱标记语言，其设计初衷是提供清晰、可执行的烹饪指令。分量缩放功能需要考虑多种因素：

• 某些成分（如调味料）可能不需要严格按比例调整
• 烹饪时间等参数可能需要非线性调整
• 不同厨具的容量限制可能影响实际缩放比例

理解这些设计考量有助于更好地使用 Cooklang-Chef 工具链进行食谱开发和调整。