字典是macos shortcuts中用于组织结构化数据的容器类型，可打包键值对以统一管理动态配置参数。它支持嵌套、运行时修改、json导入导出及外部数据注入，比多个独立变量更清晰易维护。
在 macOS Shortcuts 中，字典（Dictionary）是组织和传递结构化数据的高效方式，尤其适合存储动态配置参数，比如水印样式、API 选项、路径映射或用户偏好设置。它不是传统编程中的“变量”，而是一种容器类型，能将多个键值对打包为一个可传递、可查询、可修改的整体。
为什么用字典而不是多个独立变量
当你的快捷指令需要管理一组相关但可能变化的参数时，例如：
- 不同相机品牌对应的不同水印文字、位置、字体大小
- 多环境 API 地址（开发/测试/生产）+ 对应的 token 和超时设置
- 文件批量处理时，每种扩展名对应的重命名规则或目标文件夹
用单个字典统一承载这些配置，比分散创建 5–10 个变量更清晰、更易维护，也便于后续扩展或从外部（如 JSON 文件、URL 参数）导入。
如何在快捷指令中创建和填充字典
字典操作位于“脚本”类别下：
- 添加“创建字典”操作 → 点击“添加项目”逐个输入键（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，从外部配置文件读取内容并注入字典，突破快捷指令本地限制
