feat: complete huihui square avatar workflows

overview-avatar-user-isolation-2026-07-21.md

@@ -0,0 +1,75 @@
+# 会会数字分身 · 用户资料与分身隔离落地说明
+
+## 问题
+用户登录成功后，发现页面显示"已有数字分身"，且没有看到当前登录账号的头像/昵称；同时希望在创建数字分身时直接沿用当前会会账号的名称和头像。
+
+## 根因
+1. **后端 `GET /api/avatar` 全局返回所有分身**，没有按用户隔离；且 `backend/main.py` 的 `seed()` 在数据库为空时会插入一个名为"我的数字分身"的种子记录。任何新登录用户都会看到它。
+2. 用户头像/昵称虽然已经在登录响应中返回并落库存入 `users` 表，但**仪表盘没有展示**。
+3. `AvatarCreate.vue` 只预填了昵称到 `displayName`，没有 `photoUrl` 字段，也没有头像预览。
+
+## 改动
+
+### 后端：分身按用户隔离
+- `backend/models.py`
+  - `Avatar` 新增 `owner_id` 字段（会会 `huihui_user_id`），索引，默认空字符串。
+  - `to_dict()` 暴露 `ownerId`。
+- `backend/database.py`
+  - 在 `_try_add_columns` 中加入 `("avatars", "owner_id", "VARCHAR DEFAULT ''")`，容器启动时自动给已有 SQLite 表加列。
+- `backend/routers/avatars.py`
+  - 新增 `_resolve_user()` 从 `Authorization: Bearer <app_token>` 解析当前用户。
+  - `GET /api/avatar` 仅返回 `owner_id == user.huihui_user_id` 的分身；无/无效 token 返回空列表。
+  - `POST /api/avatar` 创建时写入当前用户的 `owner_id`。
+
+### 前端：仪表盘展示用户资料头
+- `src/views/AvatarManage.vue`
+  - 引入 `useUserStore`。
+  - 顶部新增用户资料头：圆形头像（`userStore.user.avatarUrl`，无则 emoji 回退）+ 昵称 + 登录状态/手机号。
+  - 分身卡片优先显示真实头像 `photoUrl`，无则回退 emoji。
+
+### 前端：创建分身预填名称与头像
+- `src/views/AvatarCreate.vue`
+  - 表单新增 `photoUrl`。
+  - `onMounted` 从 `avatarStore.userProfile || userStore.user` 预填 `name`、`displayName`、`photoUrl`。
+  - Step1 新增"分身头像"预览区与"已沿用你的会会头像"提示。
+  - 确认页显示用户头像（或 emoji 回退）。
+  - 提交时携带 `photoUrl`。
+  - 引导页"已有数字分身？"文案改为 `v-if="avatarStore.avatars.length > 0"`，避免新用户被误导。
+
+### Ardot 视觉稿
+- 新建「会会数字分身-仪表盘与创建页」(`fileId: 706241841026616`)。
+- 包含两屏：
+  1. 数字分身管理仪表盘（状态栏、橙头、用户资料头、Token 余额、分身卡片、工具入口）。
+  2. 创建数字分身 Step1（头像预览、预填名称/显示名称、描述、下一步）。
+- 沿用 Glass Sunset Warm 品牌色系（`#FFF6EC` 背景、`#FF8C42` 主色、`#4A2511` 文字）。
+
+## 部署
+- 前端：`./node_modules/.bin/vite build` → `rsync dist/` → `docker cp` 进 `avatar-test-frontend` → restart。
+- 后端：`rsync models.py / database.py / routers/avatars.py` → `docker cp` 进 `avatar-test-backend` → restart；启动时自动迁移 `owner_id` 列。
+
+## 验证结果（容器内实测）
+| 检查项 | 结果 |
+|---|---|
+| `owner_id` 列已迁移 | ✅ |
+| 种子分身 `owner_id=''` | ✅ |
+| 无 auth `GET /api/avatar` | `{data:[],total:0}` ✅ |
+| 登录用户 `GET /api/avatar` | `{data:[],total:0}`（种子隐藏）✅ |
+| 创建分身写入 `ownerId` + `photoUrl` | ✅ |
+| 创建后本人列表只含 1 条 | ✅ |
+| 删除后列表回归空 | ✅ |
+
+## 用户现在体验
+1. 登录后进入 `/#/`（创建引导）或 `/#/avatar/manage`（仪表盘），**顶部会显示当前会会账号的头像和昵称**。
+2. 新用户首次登录时，**不会看到任何"已有"分身**（列表为空）。
+3. 点"立即创建一个"进入创建流程，**名称和头像已经自动预填**了当前用户的会会昵称和头像。
+4. 创建成功后，仪表盘只显示用户自己创建的分身。
+
+## 访问地址
+测试环境（同网段/隧道可达）：
+- 创建引导页：`http://192.168.1.188:8099/#/`
+- 仪表盘：`http://192.168.1.188:8099/#/avatar/manage`
+- 登录页：`http://192.168.1.188:8099/#/login/sms`
+
+## 后续可选
+- 生产环境切到 `99hui.com` 后可真正下发短信；当前 `fat-open` 预发环境建议继续用账号密码登录。
+- 可在创建页支持用户上传/裁剪自定义头像，替代目前直接沿用会会头像的方案。