OpenAI Plugins：包示例、便携格式与连接边界
阅读 Figma 插件示例：草稿一致性钩子只是打印提醒
追踪清单、应用映射与钩子脚本，不把声明的工作流或打印提示误当成真实视觉回归检查。
你将学会
- 沿引用追踪，而不假设已经实现
- 这个钩子是提醒，不是截图比较器
- 测试真正存在的约定
开始前需要
- 了解基本 JSON 和目录路径
- 理解技能及外部服务权限
区分仓库示例与当前格式指导，检查插件包时不把元数据当作运行证明。
先看结论
- 应用映射标识连接，但不实现服务工具。
- 草稿钩子打印提醒，没有图像比较。
- 测试结论必须对应真正执行的代码。
沿引用追踪，而不假设已经实现
固定版本 Figma 清单声明 2.0.20，skills 指向 ./skills，apps 指向 ./.app.json。映射文件包含连接标识，不是 API 密钥，也没有实现 Figma 工具。包 README 说明这是应用支持的工作流，并把命令、钩子和界面目录标为示例框架。
Read 或 Write 这类清单能力是展示元数据，不会自行实现访问检查，也不能证明工具被调用。理解示例时应沿引用找到资源，先区分配置、自然语言工作流和可执行行为，再判断它能支持什么运行保证。
这个钩子是提醒，不是截图比较器
hooks.json 声明 PostToolUse，对 Write 或 Edit 匹配后指向 scripts/post_write_figma_parity_check.sh。脚本使用 Bash、启用严格选项，并打印提醒：界面相关写入后应重新核对 Figma 一致性。文件头也将其称为面向未来钩子运行环境的草稿示例。
脚本里没有截图采集、图像比较或阈值判定。即使执行成功，也只能说明提醒被打印，不能证明视觉还原准确。它和包放在一起，也不证明当前宿主会自动发现这个历史示例钩子文件。
测试真正存在的约定
配置教学部分的合成模型测试整对象覆盖选择和固定便携组件路径，不是对 Figma、草稿钩子或 Codex 加载器的测试。本次没有运行 Shell 脚本、安装插件，或把真实设计与实现进行截图比较。
如果要把提醒扩展成真实一致性检查，应先定义图像取得方式、视口、基线版本、容差和审阅输出。有效门禁还需要非零失败路径及可复现产物。这属于扩展建议，不是被检查脚本已经具备的行为。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
从清单追踪到真实资源文件。
- 2
完整阅读钩子声明与脚本。
- 3
列出脚本会做和不会做的事情。
- 4
宣称一致性门禁前独立设计视觉证据。
可复制示例
已检查草稿钩子的行为：
1. 以严格选项启动 Bash。
2. 打印一致性复核提醒。
没有：截图采集、像素比较、通过或失败阈值。常见问题
仓库钩子会验证截图吗？
不会。本次检查的脚本只打印提醒。
模型测试执行了真实插件加载器吗？
没有。它执行的是独立合成配置模型。
资料来源
- OpenAI Plugins / plugins/figma/.codex-plugin/plugin.json来源核查 2026-09-14
- OpenAI Plugins / plugins/figma/.app.json来源核查 2026-09-14
- OpenAI Plugins / plugins/figma/README.md来源核查 2026-09-14
- OpenAI Plugins / plugins/figma/hooks.json来源核查 2026-09-14
- OpenAI Plugins / plugins/figma/scripts/post_write_figma_parity_check.sh来源核查 2026-09-14
- OpenAI — Package your plugin (checked 2026-09-14)来源核查 2026-09-14