# 用户头像与昵称 个人页沿用头像登录入口。登录返回资料缺少头像、使用 `/assets/img/avatar.png` 或内嵌 SVG 默认头像,或昵称为空/`微信用户`(可带数字后缀)时,显示“完善资料”弹窗。用户可跳过,之后点击“修改信息”、头像或昵称修改。 头像通过原生 `button open-type="chooseAvatar"` 选择,昵称通过 `input type="nickname"` 快捷填写或输入。使用原生 form 的 submit 值读取昵称,避免快捷填写未触发 bindinput 时丢失昵称。支持基础库昵称检查事件;旧微信不支持这两项组件能力时提示更新。 ## 后端契约 - [微信登录](https://www.showdoc.com.cn/minnanCE/11559060627627644):POST `content/main_body_user/third`。除已有 token、userId、头像和昵称外,将 `mainBodyUserInfo.id` 保存为 `mainBodyUserId`。该值是主体用户 ID,与 `mainBodyUserInfo.user_id` 不同。 - [头像上传](https://www.showdoc.com.cn/minnanCE/11558683564191866):POST `common/upload`,使用 `wx.uploadFile`,文件字段为 `file`,携带业务 token 请求头。成功返回 `code=1`,优先使用 `data.fullurl`,否则将 `data.url` 转为本站 HTTPS 地址。不能保存 chooseAvatar 返回的临时文件路径。 - [修改资料](https://www.showdoc.com.cn/minnanCE/11559060627627649):POST `content/main_body_user/editMainBodyUser`,表单字段 `main_body_id`、`main_body_user_id`、`nickname`、修改后的 `avatar`,业务 token 放在请求头。成功返回 `code=1`、`data=null`。保留简介等未编辑字段。 - [旧缓存升级](https://www.showdoc.com.cn/minnanCE/11559060627627647):缺少主体用户 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 测试已验证对应请求契约和失败重试。