新功能
截至 2026 年 2 月，Shopify Minis 提供以下新功能：
用户生成内容的商品标记
use Create Image Content useCreateImageContent 钩子 现在支持直接将商品标记到用户生成内容中。三个新参数为合作伙伴提供了对内容创建的更精细控制：
- productIds: 将一个或多个商品与一段内容关联。
- externalId: 将内容与自有系统中的标识符链接。
- description: 为内容添加文本描述。
SafeArea 组件和 useSafeArea Hook
新的SafeArea文档组件和useSafeArea文档钩子帮助迷你应用处理设备安全区域边距，这对于在带缺口设备上渲染全屏或使用自定义布局的迷你应用尤为重要。
import {SafeArea, useSafeArea} from '@shopify/shop-minis-react'; // Option 1: Wrap content in the SafeArea component function MyMini() { return (CLI 启用和禁用命令
Shop Minis CLI 现在包含 enable 和 disable 命令，允许直接从命令行切换迷你应用状态，这有助于测试开发中的迷你应用或在审核过程中管理迷你应用的可用性。
npx minis enable npx minis disable更多文档请参见此处
同意流程与作用域
- 条款同意提示：用户在接受条款时会看到确认提示，从而提升清晰度。
- 开发模式同意：当迷你应用在开发模式下请求权限范围时，同意对话框现在会显示出来，便于在开发期间更轻松地测试同意流程。
- 收藏与取消收藏绕过：点击迷你应用的收藏或取消收藏按钮不再触发同意弹窗，减少了不必要的操作摩擦。
- 已移除的同意权限范围：平台已移除未使用的读取权限范围；仅使用 ProductCard 或 ProductLink 的迷你应用不再需要 product_list:write 权限范围，从而减轻了简单迷你应用的同意负担。
- OpenId 权限范围已移除：openid 权限范围不再用于自定义后端支持；仅当您的迷你应用使用公开用户 ID（publicId）进行个性化或数据持久化时才需要它。
首页快捷链接
Minis 现在可以通过 Shop App 主屏幕上的快捷链接访问，使用户更容易发现和浏览“探索”部分。这一增强功能使 Minis 在应用内获得了更高的可见度。
文档更新
以下文档更新与这些变更同步进行：
清单文件
更新的文档反映了清单文件中已移除的传统读取权限范围，使用这些已移除权限范围的合作伙伴应相应更新其 manifest.json。
自定义后端
自定义后端指南已修订，提供了更清晰的说明并更新了 Markdown 格式。
其他变更
- 移除了未使用的 variants 字段，这是自一月以来持续进行的清理工作的一部分。
- CLI 模板默认 manifest.json 中不再包含不必要的权限范围。
- 开发迷你应用现在可以在启用前通过 UUID 进行查询，从而支持开发期间的同意检查。
总结
二月的重点在于提供更丰富的内容、改善开发者体验并减少摩擦：
- UGC 产品标记：将产品直接标记到用户生成内容中，打造可购物体验。
- SafeArea 支持：新增组件和钩子，用于处理全屏迷你应用中的设备安全区域。
- CLI 启用/禁用：直接从命令行切换迷你应用状态。
- 同意流程改进：提供更顺畅的同意流程，支持开发模式并减少不必要的弹窗。
- 简化范围：移除了旧版读取权限，并减少了简单迷你应用所需的同意要求。
- 探索快捷链接：提升了Shop App主屏幕上迷你应用的可见度。
如有任何问题或反馈，请联系Shop Minis团队或在社区论坛发帖。