字典是macOS Shortcuts中用于组织结构化数据的容器类型，可打包键值对以统一管理动态配置参数。它支持嵌套、运行时修改、JSON导入导出及外部数据注入，比多个独立变量更清晰易维护。

在 macOS Shortcuts 中，字典（Dictionary）是组织和传递结构化数据的高效方式，尤其适合存储动态配置参数，比如水印样式、API 选项、路径映射或用户偏好设置。它不是传统编程中的“变量”，而是一种容器类型，能将多个键值对打包为一个可传递、可查询、可修改的整体。

为什么用字典而不是多个独立变量

当你的快捷指令需要管理一组相关但可能变化的参数时，例如：

• 不同相机品牌对应的不同水印文字、位置、字体大小
• 多环境 API 地址（开发/测试/生产）+ 对应的 token 和超时设置
• 文件批量处理时，每种扩展名对应的重命名规则或目标文件夹

用单个字典统一承载这些配置，比分散创建 5–10 个变量更清晰、更易维护，也便于后续扩展或从外部（如 JSON 文件、URL 参数）导入。

如何在快捷指令中创建和填充字典

字典操作位于“脚本”类别下：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 添加“创建字典”操作 → 点击“添加项目”逐个输入键（Key）和值（Value）
• 键建议用英文小写+下划线（如 watermark_position），避免空格或特殊符号
• 值可以是文本、数字、布尔值，也可以是其他操作的输出（例如“获取剪贴板”结果作为 user_input 的值）
• 支持嵌套：值本身可以是另一个字典或列表，适合多层配置（如 fuji: {text: "FUJIFILM", size: 24}）

怎么读取和使用字典里的参数

字典一旦创建，就能被后续操作调用：

• 添加“获取字典值”操作 → 选择源字典，输入要查的键名 → 输出即为对应值
• 可在“文本”“条件判断”“设置变量”等操作中直接插入该输出，实现动态分支（例如：若 brand 是 "iPhone"，则用 A 模板；若是 "RICOH"，则用 B 模板）
• 配合“如果”操作 + “包含”或“等于”判断，可实现基于字典内容的逻辑跳转

进阶技巧：让字典真正“动态”起来

字典的价值在于其可变性。你可以：

• 用“设置字典值”操作，在运行中修改某个键的值（例如根据用户输入更新 output_folder）
• 把字典转成 JSON 文本，保存到文件或剪贴板，方便跨设备同步或调试
• 从 URL Scheme 的 text 参数接收 JSON 字符串，再用“解析 JSON”还原为字典（需确保格式合法）
• 搭配“自动操作”或 AppleScript，从外部配置文件读取内容并注入字典，突破快捷指令本地限制