user-profile.md 4.0 KB

用户头像与昵称

个人页沿用头像登录入口。登录返回资料缺少头像、使用 /assets/img/avatar.png 或内嵌 SVG 默认头像,或昵称为空/微信用户(可带数字后缀)时,显示“完善资料”弹窗。用户可跳过,之后点击“修改信息”、头像或昵称修改。

头像通过原生 button open-type="chooseAvatar" 选择,昵称通过 input type="nickname" 快捷填写或输入。使用原生 form 的 submit 值读取昵称,避免快捷填写未触发 bindinput 时丢失昵称。支持基础库昵称检查事件;旧微信不支持这两项组件能力时提示更新。

后端契约

  • 微信登录:POST content/main_body_user/third。除已有 token、userId、头像和昵称外,将 mainBodyUserInfo.id 保存为 mainBodyUserId。该值是主体用户 ID,与 mainBodyUserInfo.user_id 不同。
  • 头像上传:POST common/upload,使用 wx.uploadFile,文件字段为 file,携带业务 token 请求头。成功返回 code=1,优先使用 data.fullurl,否则将 data.url 转为本站 HTTPS 地址。不能保存 chooseAvatar 返回的临时文件路径。
  • 修改资料:POST content/main_body_user/editMainBodyUser,表单字段 main_body_id、main_body_user_id、nickname、修改后的 avatar,业务 token 放在请求头。成功返回 code=1、data=null。保留简介等未编辑字段。
  • 旧缓存升级:缺少主体用户 ID 时,POST minnansoul/main_body_user/refreshUser,传 main_body_id 和 token,获取 mainBodyUserInfo.id。验证返回用户 ID 与当前账号一致;返回信息不完整时提示重新登录,不以普通用户 ID 替代。

资料保存成功后才更新登录缓存和个人页。失败保留草稿,允许重试;保存期间禁用重复提交与关闭。开始上传、提交与回写缓存之间校验登录 token 和用户 ID,避免退出或切换账号后旧请求写入当前资料,旧 token 的 401 也不清除新账号。

资料弹窗使用 form 内的普通 view 承载 flex 布局,避免原生 form 内部容器让头像偏左。原头像未修改时不上传,且不发送可选 avatar 字段;实际后端的默认头像是 SVG data URI,不能作为文件路径传给 wx.uploadFile。

微信临时头像可能使用 wxfile:// 或 http(s)://tmp/、http(s)://usr/ 地址,不能仅凭 HTTP 协议判断为远程图片。这些地址必须先上传,再将返回的 HTTPS 图片地址提交给 content/main_body_user/editMainBodyUser;旧缓存中相同的临时地址也会重新上传。上传响应若仍返回临时地址则拒绝保存。

验证

  • .tmp/acceptance/verify-user-profile.mjs:验证上传/保存参数、头像临时路径转换、旧缓存主体 ID 刷新及账号匹配、快捷填写、登录提示/跳过/收藏跳转、失败重试、重复提交、昵称检查、旧微信提示、退出/账号切换竞态与编辑入口。
  • .tmp/acceptance/verify-user-login.mjs:回归登录、授权确认、令牌缓存、退出与收藏分页。
  • 类型检查、目标文件 ESLint/Stylelint 与 pnpm build。

wv screenshot 的自动化连接仍失败。2026-10-10 使用 Computer Use 直接操作当前仓库的开发者工具窗口,完成头像点击登录、修改信息按钮打开、资料框居中、取消关闭、用原头像原昵称提交成功,以及微信头像选择菜单打开/取消。点击保存时发现默认 SVG 头像误上传,修复后复测成功,页面提示“资料已保存”,未改变现有头像和昵称。

桌面截图记录在 .tmp/acceptance/user-edit-entry-desktop.png、user-edit-dialog-desktop.png、user-profile-save-desktop.png。本次未提交新选择的微信头像,因此新头像实际上传、真机昵称快捷填写仍需微信端联调;mock 测试已验证对应请求契约和失败重试。