Mealie iOS 快捷指令Apple Shortcut实战从网页链接与照片一键导入菜谱【免费下载链接】mealieMealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor项目地址: https://gitcode.com/GitHub_Trending/me/mealie本文是 Mealie 社区指南 ios-shortcut.md 的深度展开。它面向所有在 iPhone、iPad 或 Mac 上使用 Mealie 自建菜谱库的用户讲解如何通过一个开箱即用的 Apple Shortcut快捷指令把 Safari 中打开的食谱网页、相册里的菜谱照片一键送进 Mealie 的 REST API 完成导入。读完本文你将掌握 API Token 的创建、Shortcut 的安装与变量配置、Safari 脚本权限的开通以及图片导入依赖 AI 集成的底层原因并能理解该 Shortcut 与 Mealie 后端各导入接口之间的对应关系。一、这个快捷指令在做什么从分享菜单到 REST APIMealie 的导入能力全部由后端 REST API 提供快捷指令本质上是一个轻客户端它负责采集素材网页原始 HTML、URL、照片再以 HTTP 请求的方式调用 Mealie 的接口完成菜谱创建。从源码看后端对应了三个核心入口均位于 recipe_crud_routes.py 的RecipeController中POST /api/recipes/create/url传入 URLMealie 抓取页面并提取菜谱源码见 recipe_crud_routes.pyPOST /api/recipes/create/html-or-json直接提交网页的原始 HTML 或 schema.org Recipe 的 JSON 字符串绕过抓取过程源码见 recipe_crud_routes.pyPOST /api/recipes/create/ai以multipart/form-data形式接收url、content文本/HTML/JSON与images文件列表交给 AI 服务综合生成菜谱源码见 recipe_crud_routes.py。其中html-or-json和ai两个接口正是这个 Shortcut 的杀手锏用法当某些网站开始屏蔽 AI 抓取爬虫进而也误伤了 Mealie 使用的菜谱抓取库时Shortcut 会在 Safari 中执行一段 JavaScript把浏览器里已经加载好的原始 HTML原样捕获并发送给 Mealie从而绕过站点的爬虫拦截。二、前置准备图片导入必须开启 Mealie 的 AI 集成!!! note 如果你只打算通过链接或 URL 导入菜谱可以跳过本节但通过照片导入菜谱必须依赖 Mealie 的 AI 集成因为照片中的文字手写或印刷需要由 AI 视觉模型识别。AI 集成的完整配置说明见仓库文档 ai-providers.md。要点如下进入 Mealie 的Group Settings群组设置配置一个默认 AI Provider如 OpenAI 兼容的gpt-5并填入 API Key若要支持图片识别本快捷指令的拍照/选图导入必须使用支持图像识别能力的模型如gpt-5若还希望把 YouTube、Instagram 等视频链接转写成菜谱可另配支持音频转写的 Provider如whisper-1。Mealie 兼容任何 OpenAI 兼容 API例如自托管的 Ollama将base_url设为http://localhost:11434/v1即可不过即使 Ollama 忽略密钥也仍需填写一个 API Key。此外一个模型可以同时承担多种能力如gpt-5既支持对话也支持图像识别只需在配置中为同一 Provider 勾选多个功能即可。三、初始配置创建 API Token 并安装快捷指令3.1 生成 API TokenShortcut 调用 Mealie 接口时需要身份认证因此必须先为一个用户创建 API Token。两种方式任选其一直接在浏览器访问http://YOUR_MEALIE_URL/user/profile/api-tokens或在 Mealie 首页点击左上角用户头像 →Api Tokens。对应的前端页面为 api-tokens.vue。后端创建逻辑在 api_tokens.py接口POST /api/users/api-tokens接收name与integration_id通过create_access_token(token_data, five_years)签发一个有效期长达 1825 天约 5 年的长期 Token并持久化到数据库。注意Token 只在创建时返回一次完整值请及时复制保存。3.2 安装快捷指令该快捷指令由社区成员编写并通过 iCloud 链接分发原始安装链接位于 ios-shortcut.md 中请前往原文点击安装。安装完成后需要编辑该快捷指令将两个占位符替换为你的实际信息变量替换为示例MEALIE_API_KEY第 3.1 步生成的 API TokeneyJhbGciOiJIUzI1NiIs...MEALIE_URI访问你 Mealie 实例的完整地址http://10.0.0.5:9000或https://mealie.domain.comMEALIE_URI必须与你的部署访问方式完全一致局域网 IP、域名或反代地址均可因为 Shortcut 会以此为基础拼接出形如{MEALIE_URI}/api/recipes/create/ai的实际请求地址。3.3 允许 Safari 运行脚本仅 iOS / macOS 必做Shortcut 需要在 Safari 中注入并执行 JavaScript 来抓取页面原始 HTML因此必须为快捷指令应用开启脚本运行权限iOS / iPadOS设置 App → App应用→ 快捷指令 → 高级 → 允许运行脚本macOS快捷指令 App → 设置⌘,→ 高级 → 允许运行脚本。如果你不使用 Safari 浏览器例如只用粘贴 URL方式导入可以跳过本节。这是该 Shortcut 唯一涉及系统级权限的地方漏开会导致分享网页时无法捕获 HTML、导入失败。四、使用方式从分享、主屏到四种导入入口安装并配置完成后这个快捷指令会自动出现在系统分享菜单中在 Safari 中打开任意食谱网页点击分享按钮即可看到它以选项形式出现分享网页时走 JavaScript 捕获 HTML URL 的方式。同时建议把它添加到设备主屏幕方便随手触发。若从主屏幕图标或快捷指令 App 内运行会弹出一个菜单提供四种导入入口拍摄照片taking photo(s)调用相机拍摄纸质菜谱选择照片selecting photo(s)从相册挑选已有菜谱照片扫描 URLscanning a URL调用相机扫描二维码/条形码中的 URL粘贴 URLpasting a URL粘贴剪贴板中的食谱链接。前两者依赖第 2 节配置的 AI 图像识别 Provider后两者走常规 URL 抓取链路即便没有 AI 也能导入大部分标准食谱站点。五、图片导入的限制为什么多张照片会被拼成一张!!! note 尽管 Mealie 的 AI 导入接口POST /api/recipes/create/ai在技术上支持一次提交多张图片见 recipe_crud_routes.py 中images: list[UploadFile]的签名但 Apple Shortcut 目前无法在一次 Web 请求中附带多个文件。因此该快捷指令采取了一个务实的妥协方案把用户选择的多张照片垂直拼接成一张长图再作为单个文件发送给 Mealie。这也带来一个可以预期的副作用——拼接后的长图会降低 OCR 文本识别的精度尤其是手写菜谱或排版密集的印刷页。如果你追求最高识别质量建议每次只选一张照片如果菜谱跨多页也可以分多次导入后在 Mealie 中手动合并。另外从源码可以确认/api/recipes/create/ai允许url、content、images任意组合提交Mealie 会把所有来源的素材合并成一份菜谱描述该能力也体现在前端Import with AI页面见 ai-providers.md 的 Import with AI 小节。因此你完全可以在一个网页导入失败时手动补充粘贴内容来兜底。六、工作原理小结与故障排查端到端流程可概括为Safari 捕获 HTML或用户提供 URL/照片→ Shortcut 携带MEALIE_API_KEY调用{MEALIE_URI}/api/...→ Mealie 校验 Token见 api_tokens.py→ 交给抓取器或 AI 服务生成菜谱 → 返回新菜谱 slug 并入库。整条链路的验证点在于Token 有效、URI 可达、对应 Provider 已启用。常见问题对照表现象原因与排查网页分享时提示无法捕获内容未开启允许运行脚本或该站点连浏览器渲染后的 HTML 都不包含 schema.org 数据可改用粘贴 URL让 Mealie 直接抓取照片导入失败未配置支持图像识别的默认 AI Provider或 API Key 无效返回 401/403MEALIE_API_KEY填错或 Token 被删除可在 Api Tokens 页面管理识别结果缺字/漏行多图被拼成长图降低了识别精度改用单张导入局域网访问失败MEALIE_URI填写了手机无法访问的地址如仅容器内部可达的 hostname请填设备实际可访问的 IP 或域名如需更深入地了解 Mealie 导入体系的完整能力批量 URL 导入、书签脚本等可继续阅读同目录下的 bulk-url-import.md 与 import-recipe-bookmarklet.md。如果发现该快捷指令存在问题欢迎按照文档开头所述向社区提交 PR 修正。【免费下载链接】mealieMealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor项目地址: https://gitcode.com/GitHub_Trending/me/mealie创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考