workbuddy头像更新需按三步操作：一、通过个人中心编辑上传并裁剪；二、清除%userprofile%\workbuddy\claw\cache\avatar\下缓存后重启；三、用管理员终端运行cli.exe --sync-avatar --source local强制同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已登录 WorkBuddy 并希望更新个人资料中的头像，但当前界面未直接显示编辑入口或头像无法正常上传，则可能是由于权限未开启、头像格式/尺寸不合规，或头像缓存未刷新所致。以下是修改 WorkBuddy 头像的具体操作步骤：
一、通过个人中心界面修改头像
WorkBuddy 的头像设置入口位于主界面右上角的用户中心区域，需确保已完成首次登录并获得基础权限授权。该方式适用于常规头像更换，支持本地图片上传与裁剪。
1、启动 WorkBuddy 应用，确保已成功登录微信或企业微信账号。
2、点击右上角个人头像图标，进入「个人中心」页面。
3、在头像区域点击右侧出现的“编辑”图标（铅笔形状）。
4、在弹出窗口中选择“从电脑选择”，上传符合要求的图片文件。
5、上传后系统自动进入裁剪界面，拖动边框调整构图，点击“确认裁剪”完成保存。
二、检查并重置头像缓存
若新上传头像仍显示为旧图或默认灰色头像，说明客户端本地缓存未更新，需手动清除头像相关缓存数据以强制刷新显示。
1、关闭 WorkBuddy 主程序，包括后台运行进程（可在任务管理器中结束 WorkBuddy.exe 进程）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、打开文件资源管理器，在地址栏输入：%USERPROFILE%\WorkBuddy\Claw\cache\avatar\，按回车访问缓存目录。
3、选中该文件夹内所有文件，按Shift + Delete永久删除（跳过回收站）。
4、重新启动 WorkBuddy，登录后再次进入个人中心，此时头像将重新加载最新上传版本。
三、使用命令行强制同步头像
当图形界面编辑功能异常或头像上传后未同步至企业微信/飞书等绑定平台时，可通过内置 CLI 工具触发头像强制同步机制，该方式绕过 UI 层直接调用底层 AvatarSync 模块。
1、在 WorkBuddy 安装目录下找到 cli.exe 文件（默认路径为 C:\Program Files\WorkBuddy\cli.exe）。
2、以管理员身份运行 Windows 终端，执行命令：cli.exe --sync-avatar --source local。
3、等待终端返回 "Avatar sync completed: 1 file updated" 提示。
4、返回 WorkBuddy 主界面，刷新个人中心页面，验证头像是否已更新。
