集成

有些功能需要使用专门的服务，例如天气或地图服务套餐、支付服务商，或你已经付费使用的 AI 服务商。这些服务会提供一个密钥，也就是一串较长的机密字符，用来表明请求来自你的账户。Yorki 会在你的应用的 设置、集成 中保存这些密钥。

AI 功能无需密钥：Yorki 会为你运行 AI，详见应用中的 AI。

密钥的用途

密钥可以让应用的服务器代码通过你的账户调用某项服务。服务会根据你的应用用量，按照你在该服务上的套餐向你收费。Yorki 不会为此收费，也看不到账单。

密钥会以加密形式保存。保存后，密钥不会再次显示，包括你和 Yorki 的 AI 都无法查看，只有应用的服务器代码可以读取。密钥不会传到访客的浏览器中。

先提出功能需求

你无需知道某项功能需要哪个密钥。只要提出功能需求即可，例如“添加一个页面，显示斯德哥尔摩今天的天气，数据来自 OpenWeather”。Yorki 会构建完整功能，并在回复中和页面上告诉你要添加哪个密钥，例如：

在设置 → 集成中添加 OPENWEATHER_API_KEY，即可显示天气预报。

不要把密钥粘贴到聊天中。Yorki 不需要在聊天中获取密钥，而是会让你在设置中添加。

添加密钥

1. 从服务商处获取密钥，通常可以在其控制面板的 API 密钥 中找到。
2. 在 Yorki 中打开 设置、集成。
3. 在 名称 下输入 Yorki 告诉你的名称，例如 OPENWEATHER_API_KEY。名称只能使用大写字母、数字和下划线。
4. 在 值 下粘贴密钥，然后按 添加密钥。

如果预览处于打开状态，下次加载页面时，该功能就会开始运行。无需重新构建。

替换或移除密钥

替换 会用新值保存同名密钥，例如你在服务商处轮换密钥时。移除 会删除密钥；在你重新添加密钥之前，使用该密钥的功能会再次显示“添加密钥”的提示。

如果要让密钥在所有地方都无法使用，还要在服务商自己的控制面板中撤销该密钥。

已发布的应用

发布应用时，应用的服务器代码也会一并上线，并在上线后读取这些密钥。之后添加、替换或移除的密钥会在一分钟内同步到已发布的应用，无需再次发布。

AI 密钥

此列表中每个应用还有一个名为 YORKI_AI_KEY 的密钥，标记为 由 Yorki 管理。Yorki 会创建此密钥，让应用能够使用 AI。你无法在此处替换或移除它。如需替换，请打开 设置、AI 功能，然后按 重新生成。