PS插件移植：GetPluginXplatFileSpec返回mFileReference为空问题

该问题由两个操作错误共同导致：

• 调用时机错误：kSPPluginsSuiteVersion6版本的SPXPlatPluginsSuite中，GetPluginXplatFileSpec接口仅能在插件入口PluginMain处理kSPStartup消息的阶段返回有效数据。如果在插件加载完成后的其他生命周期节点（如菜单触发回调、滤镜执行回调）调用该接口，宿主会直接返回未初始化的XPlatFileSpec结构，对应你观测到的mFileSpecVersion = 0、mFileReference = 0x00现象。
• 套件版本认知错误：kSPPluginsSuiteVersion4属于Carbon时代的遗留兼容套件，其GetPluginFileSpecification接口的设计就仅会返回FSRef类型的文件引用，无论运行在哪个系统版本、哪个PS版本下，都不会自动填充CFURLRef相关字段，不存在“拿得到正确FSRef但拿不到CFURLRef”的异常，属于版本本身的设计限制。

1. 调整套件获取与接口调用时机：在PluginMain的kSPStartup消息处理分支内，通过SPBasicSuite->AcquireSuite获取kSPPluginsSuite对应kSPPluginsSuiteVersion6版本的SPXPlatPluginsSuite指针，拿到指针后立刻调用GetPluginXplatFileSpec，传入kSPStartup消息参数中携带的当前插件pluginRef，不要传入其他插件或宿主程序的引用。
2. 校验返回结构有效性：拿到XPlatFileSpec后先判断mFileSpecVersion字段，若值为kXPlatFileSpecVersion1（数值为1），则mFileReference字段就是有效的CFURLRef，可直接使用，无需再经过FSRef转路径的废弃逻辑。注意该CFURLRef由宿主持有生命周期，若需要长期保存需自行调用CFRetain，不要直接释放该对象。
3. 留存路径供后续使用：将启动阶段拿到的有效CFURLRef存在全局变量中，后续其他业务逻辑需要用到插件路径时直接读取该全局变量即可，不要在非启动阶段重复调用GetPluginXplatFileSpec。

• macOS 12+开启了App Sandbox权限校验，即便你通过v4版本套件拿到了有效FSRef，再调用废弃的CFURLCreateFromFSRef转路径，也会被系统拦截触发权限错误，无法正常访问文件，不要尝试走这种兼容方案。
• Photoshop 2022的早期小版本（23.0.x~23.2.x）存在v6插件套件返回空结构的已知bug，若完成上述调整后仍拿不到有效CFURLRef，将PS升级到23.3及以上版本即可，无需额外修改代码。

内容的提问来源于stack exchange，提问作者JoergEwald