FreeScout 用户头像尺寸调整指南

问题背景

在使用 FreeScout 客服系统时，许多用户希望调整系统中显示的用户头像尺寸。默认情况下，FreeScout 的头像显示尺寸为 50x50 像素，这在某些情况下可能显得过小，影响视觉效果和用户体验。

解决方案

FreeScout 提供了两个环境变量来调整头像显示尺寸：

1. APP_USER_PHOTO_SIZE - 用于调整用户头像尺寸
2. APP_CUSTOMER_PHOTO_SIZE - 用于调整客户头像尺寸

具体操作步骤

对于标准部署

1. 找到 FreeScout 的 .env 配置文件
2. 添加或修改以下配置项：

   APP_USER_PHOTO_SIZE=100
   APP_CUSTOMER_PHOTO_SIZE=100
   

3. 保存文件后，需要清除系统缓存：
   • 进入 FreeScout 后台管理界面
   • 导航至"管理 > 系统 > 工具"
   • 执行缓存清除操作

对于 Pikapods 部署

在 Pikapods 平台上部署的 FreeScout 实例同样支持头像尺寸调整：

1. 登录 Pikapods 管理面板
2. 找到 FreeScout 应用的环境变量配置部分
3. 添加上述两个环境变量并设置期望的像素值
4. 保存配置后同样需要清除系统缓存

注意事项

1. 修改环境变量后必须清除缓存才能生效
2. 建议设置的尺寸值为正方形（长宽相同）
3. 过大的头像尺寸可能会影响页面布局，建议根据实际界面效果进行调整
4. 头像上传后会自动按设定尺寸进行裁剪和缩放

技术原理

FreeScout 的头像处理系统采用以下工作流程：

1. 用户上传原始图片
2. 系统根据配置的尺寸参数生成缩略图
3. 生成的缩略图会被缓存以提高性能
4. 前端界面调用时显示处理后的缩略图

这种设计既保证了显示效果的一致性，又避免了直接使用原始大图带来的性能问题。

通过合理配置头像尺寸参数，管理员可以根据实际需求优化系统的视觉效果，提升用户体验。