AI 助手

一个懂冰淇淋的助手——能重新平衡配方、建议替换，并根据描述或条形码自动填充自定义食材。

Gelato Maestro 的 AI 功能运行在你只需在“设置”中连接一次的外部 AI 提供商上。提供商设置完成后，两个助手随即可用：

• 配方详情中的配方助手——帮你设计冰淇淋配方、平衡配方、排查混合物问题，并回答关于冰淇淋制作的一般性问题。
• 添加或编辑食材中的食材助手——帮你添加新食材，并回答有关填写数值过程的问题，从冰淇淋食材理论到填写细节，再到从 OpenFoodFacts 拉取数据。

设置 AI 提供商

Gelato Maestro 本身不运行 AI 模型。大脑由你提供：选择一个提供商，粘贴一个 API 密钥（或登录），助手便会点亮。打开设置 › AI 提供商即可开始。

我该选哪个提供商？

同样的建议也显示在应用内的“AI 提供商”界面上的“初次接触 AI？从这里开始”卡片中：

• 你已经为 ChatGPT 付费（Plus、Pro 或 Team） → 选 OpenAI 订阅。这会用你现有的 ChatGPT 账户登录。最简单的路径；无需 API 密钥，也无需单独计费。
• 你没有 ChatGPT 订阅 → 试试用 API 密钥的 Google Gemini。Gemini 自带慷慨的免费额度；如果用尽了，约 $5 的额度也能用很久。
• 你已经在用 Anthropic 或 Mistral → 就选那个。否则没必要。

支持的提供商

分步操作：添加提供商

1. 打开设置 › AI 提供商，点按添加 AI 提供商。
2. 从提供商选择器中选一个提供商。下方的设置面板会随之更新，显示该提供商专属的说明和一个会在浏览器中打开正确页面的获取 API 密钥链接。
3. 点击获取 API 密钥，在提供商网站上创建密钥并复制。
4. 将密钥粘贴到 API 密钥字段中。（对于 OpenAI 订阅，请改用登录按钮。）
5. 可选：在名称字段中重命名该来源（例如“个人 Gemini”）。如果你添加多个提供商，这会很有用。
6. 可选：打开高级以选择特定模型和推理强度。默认值适合大多数用户。
7. 点按添加。Gelato Maestro 会通过获取模型列表来测试连接。如果成功，该提供商会出现在列表中。

订阅 vs. API 密钥

• 订阅——用你现有的账户登录（目前仅 OpenAI）。你支付你已经在付的固定月费；Gelato Maestro 不会额外收取任何费用。
• API 密钥——你在提供商网站上创建的一段密钥代码。提供商按请求向你计费。先充值约 $5 的额度，留意你的用量，仅在需要时再续费。在现代模型上，一次完整的配方重新平衡至多花费几美分。

配方助手

提供商配置好后，配方详情中的 AI 按钮便会激活。打开助手，你会看到一个聊天输入框，带有类似“让你的助手帮忙改进这份配方。”的占位提示。

它能做什么

这个助手不是通用聊天机器人。它通过一小套冰淇淋专用工具直接访问你的配方——它能读取当前的食材与 KPI，并一次性重写它们。你可以提出的实用请求：

• “设计一款西西里开心果冰淇淋，开心果酱比例要慷慨，从展示柜冷冻里取出就能柔软舀取。”——从零组成一份完整配方，挑选符合你舀取与口感目标的结构性食材与比例。
• “这份混合物从急冻柜出来冻得太硬，在展示柜放一天后变得冰碴。请诊断并修复，且不要改变风味。”——调查当前配方，推断可能的原因，并在保留主导风味食材不变的前提下重新平衡以修复口感。
• “我的巧克力冰淇淋入口发砂、发涩。请重做。”——找出可能负责的食材，提出重新平衡方案，并解释其中道理，让你从中学习。
• “只用我目前库存里有的食材帮我做一款榛子冰淇淋。”——查阅你的食材库，挑出有现货的子集，并完全用你已有的食材组成一份平衡配方。
• “我的冰淇淋为什么发黏、融化慢？如果我去掉葡萄糖会有什么变化？”——回答诊断与理论问题，不一定改动配方。

一次对话如何进行

1. 你写下请求。提示越清晰，结果越好。说明你想要什么、想避免什么，以及任何约束——目标重量、要保留的风味、你手头没有的食材。
2. 助手借助实证工具一步步工作。它不是即兴发挥：它使用的是应用向你公开的同一套平衡与分析工具。它读取配方、尝试一处改动、检查结果、调整，然后再试。你可以在聊天中实时看到每一步出现。
3. 你可以随时暂停并引导。如果助手走错了方向，停下它并发送新指令——“其实把开心果酱比例保持原样”“别动奶粉”“改往更柔软的方向走”。它会带着新指引继续。
4. 它以结构化摘要收尾。完整的拟议配方——每种食材及其比例、由此得到的仪表盘，以及关于改了什么、为什么改的简短说明。
5. 由你决定。点按保留将变更提交到你的配方，或点按放弃将其丢弃、保持原配方不变。

获得好结果的小贴士

• 要具体。“让它更开心果一点”很含糊；“提高开心果酱比例并重新平衡”才是助手能直接执行的。
• 先用好食材标志。如果你已经用用于配方平衡 = 关标记了你的夹心物并设置了剂量上限，助手会继承这些约束，不会浪费 token 去与它们对抗。
• 每次请求只改一处。复合请求（“让它不那么甜、换掉牛奶并降低成本”）也能用——但聚焦的请求往往效果更好，而且你可以一次审核一处变更。

食材助手

当配方助手需要一种你的食材库中尚不存在的食材时——或者当你正在手动创建自定义食材时——Gelato Maestro 会尝试为你填入组成字段。这就是食材助手。

需要新食材时会发生什么

1. OpenFoodFacts 查询。助手按名称搜索 OpenFoodFacts——一个免费的全球产品数据库。
2. 唯一明确匹配 → 该食材会自动用 OpenFoodFacts 的组成（水、糖、脂肪、蛋白质、纤维、热量）创建。
3. 多个候选 → 你会看到一张含 2–3 个候选项的选择卡片（“榛子酱 — 通用”“榛子酱 — 品牌 X”……），从中挑选最接近的匹配。所选项随后从 OpenFoodFacts 创建。
4. 没有 OpenFoodFacts 匹配，或 OpenFoodFacts 无法访问 → 会在一次独立调用中请求 AI 估算组成。返回的数值在创建食材之前会经过校验（钳制在 0–100%，核对总和）。
5. 如果连 AI 后备方案也未能产出有效组成，助手会告知你，并让配方保持不变。

助手会填入什么

对于一种新的自定义食材，助手会填入你本会在添加或编辑食材中手动输入的同样字段：

• 水、总糖（蔗糖、葡萄糖、果糖、乳糖）、总脂肪、MSNF、纤维、蛋白质。
• 每 100 g 的热量。
• 派生的 KPI 贡献（PAC、POD）——由糖/脂肪分项计算得出，而非直接来自 AI。
• 默认分类（糖、脂肪、乳制品、水果、结构、风味、夹心物）。

每个数值在食材详情视图中都保持可编辑。如果 AI 弄错了什么——把果泥标成 100% 水、把乳制品漏掉其 MSNF——你都可以当场更正。

当 AI 出错时

把 AI 当作一个能干但会犯错的助手——而不是真理之源。模型可能：

• 编造食材数值。当 OpenFoodFacts 没有数据时，后备解析器会被要求估算组成。估算可能偏差，有时还很大。对任何由 AI 填充的食材，务必核查其脂肪和糖的百分比是否合理。
• 选错 OpenFoodFacts 产品。当多个候选项相似时，选择卡片让你来挑——但如果你太快接受，助手可能会继承一个并非你实际使用的产品的数值。
• 平衡到仪表盘却不合口味。与自动平衡一样，助手针对设置 › 仪表盘中的 KPI 范围进行优化。它对冰糕里该不该放 60% 柠檬汁没有看法——只要数字落入范围，它就视该配方为有效。
• 误判烹饪上限。助手并不总是知道柠檬汁有合理的最大值、浓缩咖啡是苦的，或酒精会限制舀取性。请先在你的自定义食材上设置合理的剂量上限与用于配方平衡标志——助手会继承它们。
• 中途失败。速率限制、网络错误或模型问题都可能中断一次运行。错误会在聊天中以红色气泡显示，并附人类可读的原因。重新发送请求，或切换到另一个已配置的提供商。

内置的安全网

Gelato Maestro 力求让 AI 的错误可恢复，而非具有破坏性：

• 保留 / 放弃审核。在你点按保留之前，没有任何变更会提交到你的配方。放弃会让原配方保持不变。
• 针对歧义的选择卡片。当 OpenFoodFacts 返回多个候选项时，由你来挑——助手绝不会默默猜测。
• 轮次上限。每次请求中，助手只能调整配方有限的几次，之后就必须产出最终摘要。不会有失控的循环。
• 校验。AI 后备方案返回的组成数值会被钳制到合理范围，若它们无法构成一个连贯的食材，则会被拒绝。
• 处处可编辑。AI 提供的每个数字——组成、比例、分类——事后都可以手动编辑。

切换、移除或编辑提供商

你添加的每个提供商在设置 › AI 提供商中显示为一行。点按一行可打开编辑界面——你可以重命名它、替换 API 密钥、选择不同的默认模型，或将它彻底移除。移除提供商会从你的设备上删除已存储的密钥；不会向该提供商发送任何请求。

你可以同时配置多个提供商——例如用 OpenAI 订阅做日常工作，用 Google Gemini 作为备用。所有已配置的提供商都会在助手中可用。