故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT免登录分享窗口的头像自定义问题

用户在使用FastGPT生成的免登录分享链接对应的窗口时,发现窗口内展示的头像为灰色默认人头图标,与登录后聊天界面使用的个性化头像不一致。用户希望能够将该默认头像替换为自定义的图片,或同步为登录聊天界面中使用的头像,并提供了当前灰头像的展示截图与期望的自定义头像效果截图。

现象

用户在使用FastGPT生成的免登录分享链接对应的窗口时,发现窗口内展示的头像为灰色默认人头图标,与登录后聊天界面使用的个性化头像不一致。用户希望能够将该默认头像替换为自定义的图片,或同步为登录聊天界面中使用的头像,并提供了当前灰头像的展示截图与期望的自定义头像效果截图。

可能原因

免登录分享窗口默认调用平台内置的灰色人头图标,未提供原生的自定义配置选项,且未同步登录聊天界面的头像展示逻辑。由于该功能未在官方公开文档中提及相关配置项,需按实际部署环境确认是否存在隐藏配置或未开放的功能开关。

排查步骤

  1. 进入FastGPT的分享管理后台,定位到免登录分享的配置界面。
  2. 浏览当前所有配置项,查找与分享窗口头像相关的设置选项,确认是否存在自定义头像的上传或关联功能。
  3. 若未找到直接配置项,可检查开源部署版本的前端代码,定位免登录分享窗口的相关组件文件,查找头像渲染的代码逻辑。

解决与验证

目前FastGPT官方未提供免登录分享窗口头像的原生自定义配置。可通过两种方式实现需求:

  1. 准备自定义头像的图片资源,修改前端代码中免登录分享窗口的头像渲染逻辑,替换默认的灰色人头图标引用路径。
  2. 若需与登录聊天界面的头像保持一致,需获取登录用户的头像地址,将其传递到免登录分享窗口的渲染逻辑中,实现头像同步。

修改完成后,重新构建并部署前端代码,打开免登录分享链接,确认头像已替换为自定义图标或与登录聊天界面一致。

来源:FastGPT GitHub issue