Synology Photos 人脸识别补丁使用教程

项目介绍

Synology Photos 人脸识别补丁是一款开源项目，专为Synology Photos相册应用增加人脸识别功能而设计。该项目通过修改Synology Photos的插件，使不支持GPU的设备（如DS918+）能够实现人脸识别功能。新版本还支持物体和地点识别，为用户提供更全面的照片管理体验。

功能特性

• 人脸识别支持：让不支持GPU的Synology设备具备人脸识别能力
• 物体识别：自动识别照片中的物体，需要至少4GB内存支持
• 地点识别：基于照片的GPS信息自动识别拍摄地点
• 多设备兼容：支持DS918+、DS3615xs等多种Synology型号

系统要求

• Synology DSM 7.0及以上版本
• 至少4GB内存（推荐8GB以上以获得更好性能）
• Synology Photos应用已安装并运行

安装方法

方法一：通过任务计划器（推荐，无需SSH）

1. 打开控制面板 -> 任务计划器
2. 点击"创建" -> "计划任务" -> "用户定义脚本"
3. 在用户字段中选择"root"
4. 在任务设置中，将以下代码粘贴到"运行命令"字段：

wget https://gitcode.com/gh_mirrors/sy/Synology_Photos_Face_Patch/-/raw/main/libsynophoto-plugin-platform.so -O /var/packages/SynologyPhotos/target/usr/lib/libsynophoto-plugin-platform.so && synopkgctl stop SynologyPhotos && synopkgctl start SynologyPhotos

5. 点击"确定"并运行此任务

方法二：手动上传文件

1. 下载libsynophoto-plugin-platform.so文件
2. 将文件上传到Synology的home文件夹
3. 使用SSH连接到Synology，执行以下命令：

cp /volume1/homes/你的用户名/libsynophoto-plugin-platform.so /var/packages/SynologyPhotos/target/usr/lib/

4. 重启Photos应用：

synopkgctl restart SynologyPhotos

使用说明

人脸识别功能

• 确保照片中包含人物面部
• 系统会自动扫描图库中的人脸并进行分组
• 可以通过Synology Photos的人脸识别界面进行管理

物体识别功能

• 仅对不包含人物的图片进行物体识别
• 需要至少4GB内存支持
• 识别内容包括建筑、动物、植物等常见物体

地点识别功能

• 依赖照片中的GPS元数据
• 手机拍摄时需开启GPS功能
• 自动在地图上显示照片拍摄位置

注意事项

1. 风险提示：使用此补丁可能存在数据丢失风险，请务必备份重要数据
2. 版本兼容性：从V1.6.0-0629版本开始，文件名称从libsynophoto-plugin-model.so改为libsynophoto-plugin-platform.so
3. 文件验证：如果libsynophoto-plugin-platform.so不起作用，可以尝试使用libsynophoto-plugin-platform.so.1.0文件
4. 系统重启：部分修改需要重启DSM系统才能生效

故障排除

常见问题

1. 补丁不生效：检查文件路径是否正确，确认文件权限
2. 内存不足：物体识别需要至少4GB内存，建议升级内存
3. 识别错误：确保照片质量良好，光线充足

恢复原状

如需恢复原始状态，可以通过Synology的套件中心重新安装Synology Photos应用。

高级功能

自定义编译

项目提供源代码文件，高级用户可以进行自定义编译：

• prelibsynophoto.c - Photos插件补丁源码
• prelibsynosdk.c - SDK补丁源码

自动化脚本

项目包含自动化补丁脚本：

• auto_patch_Photos.sh - 自动下载和修补Photos插件
• auto_patch_SynoSDK.sh - 自动下载和修补SDK文件

技术支持

如遇到技术问题，建议：

1. 查看项目文档和README文件
2. 检查系统日志获取详细错误信息
3. 确保系统版本和补丁版本兼容

更新日志

项目会持续更新以支持新的Synology Photos版本，建议定期检查更新以获取最新功能和性能优化。

通过本教程，您应该能够成功在Synology设备上启用人脸识别功能，提升照片管理体验。记得在使用前备份重要数据，并按照步骤谨慎操作。