HEIC 照片在群晖 Photos 里没预览？Image Assistant 两个组件一次讲清

痛点场景

iPhone 拍出来的照片和视频默认是 HEIC、HEVC 格式，整理进群晖 Photos 之后，网页上有的能看、有的只剩一个占位——问题多半不在手机，而在看照片的那台电脑缺解码器。

两组件怎么分工

Synology Image Assistant 由两个部件配合：桌面程序 Image Assistant for desktop，和浏览器里的 Image Assistant Extension 扩展。两者一起工作，为 HEIC 照片、HEVC 视频这类格式生成 JPEG 预览和压缩视频。使用前提是把 DSM 上的 Synology Photos 升到 1.7.0 或以上版本。

看懂托盘图标

桌面程序启动后会缩在系统托盘里后台运行。图标正常，说明转换链路在岗；图标带红点，表示这台电脑缺解码器，无法生成预览或压缩视频——按程序里给出的说明装上完整解码器，或者升级操作系统，让更多文件格式直接显示出来。

设置与调试日志

右键托盘图标进设置，能改两样：界面语言（可跟随电脑语言设置）、是否开机自动启动。遇到故障要提支持工单时，设置里有导出调试日志一项，导出完成后装着 logs.zip 的文件夹会自动弹出，把它附进支持请求里，问题定位能快不少。

扩展检测不到桌面程序时

• Safari：从启动台打开 Image Assistant Extension，再到 Safari 设置的扩展页把它重新启用（以 Safari 17 为例，措辞随系统版本略有出入）；
• Chrome 及其他浏览器：到扩展商店重新启用并刷新 Photos 网页，或从右上角拼图图标进管理扩展，重载或再切换一次；
• 两种情况都要确认桌面程序已启动并在后台运行；仍不行就退出桌面程序重开一次。

小结

• 两组件=桌面程序加浏览器扩展，Photos 1.7.0 起可用；
• 托盘红点=缺解码器，装解码器或升操作系统；
• 扩展失灵先重新启用，再确认桌面程序在跑。

相册这类系统验收时，拿一台没装解码器的电脑打开一次 Photos——预览照样出得来，说明转换链路真的在工作，而不是只在你自己电脑上碰巧能看。诚鑫致达科技交付相册类项目，会把这台试机电脑写进验收步骤。