workbuddy首次登录后头像默认为灰色字母图标，需手动上传并裁剪jpg/png格式人像图（≥200×200像素），否则影响ai员工创建、团队协作及微信同步中的身份识别；上传后可通过清空avatar缓存目录或命令行执行cli.exe --sync-avatar --source local强制同步至第三方平台。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy安装完成并首次登录后，头像默认为系统生成的灰色字母图标，需手动上传才能显示个人识别形象；若跳过此步，后续在AI员工创建、团队协作或微信同步场景中将无法准确标识身份。
通过个人中心上传并裁剪头像
1、启动WorkBuddy客户端，使用微信/企业微信/QQ扫码完成登录。
2、点击右上角当前头像图标，进入「个人中心」页面。
3、在头像区域右侧点击铅笔形状的【编辑】按钮。
4、选择“从电脑选择”，上传一张JPG/PNG格式、尺寸建议不小于200×200像素的正面人像或品牌图——过小会导致裁剪后模糊，过大可能触发前端上传超时。
5、拖动边框调整构图，确保关键内容居中，点击“确认裁剪”保存。这一步操作起来很简单，直接把文件拖进去就行。
清除本地缓存强制刷新显示
方法一：手动清空avatar缓存目录
1、完全退出WorkBuddy（包括任务栏右下角图标，需右键→退出）
2、按Win+R打开运行框，输入：%USERPROFILE%\WorkBuddy\Claw\cache\avatar\，回车进入该文件夹
3、全选所有文件 → 按Shift+Delete永久删除（跳过回收站）
4、重新启动WorkBuddy，登录后进入个人中心，新头像立即可见。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
方法二：重启并等待自动刷新（仅限网络稳定且未修改过缓存策略的默认安装）
关闭客户端后等待60秒以上再重开，系统会在初始化阶段自动拉取最新头像数据——但该方式失败率较高，【不推荐用于正式工作环境】。
用命令行强制同步至绑定平台
当头像已在个人中心更新，但在企业微信、飞书等第三方平台仍显示旧图时，必须执行底层同步：
第一步：确认cli.exe存在路径——默认为C:\Program Files\WorkBuddy\cli.exe（若自定义安装路径，请前往对应目录查找）
第二步：以管理员身份运行Windows终端（右键开始菜单→Windows终端(管理员)）
第三步：执行命令：cli.exe --sync-avatar --source local
第四步：等待终端返回Avatar sync completed: 1 file updated提示后，返回WorkBuddy刷新个人中心页面即可验证。
