产品定位:校园健康生活交流广场,主张「健康这件事,一起就容易一点」。本演示为双击即开的离线移动端原型:无框架、无后端、无登录,全部人物与互动均为虚构,数据仅保存在本机浏览器。
每节末尾的「去体验」会关闭文档并直接跳到对应功能;完整文字版见随附 docs/功能需求说明.md。
单页应用,四个页面共用一套底部导航;头部无常驻标题与状态小字,广场为核心页。
入口底部固定导航:地图 · 记录 · 广场 · 我的
交互逻辑
- 点击导航项立即切换页面内容区,当前项高亮并标记
aria-current;切换后页面回到顶部。
- 搜索框、分类标签、发布加号按钮仅在广场页显示,其余页面自动隐藏,避免误触。
- 地图为范围外占位页:不读取定位、不提供虚构店铺或路线,给出「先去广场逛逛」返回按钮。
- 头部不显示常驻大标题与演示状态小字:页面标题仅保留给屏幕阅读器朗读;广场头部为搜索 + 分类 + 消息入口,其余三页内容在顶部安全区留白后直接开始。
- 存储不可用或写入失败时,头部出现橙色警示条「仅内存模式:刷新将丢失更改,请在『我的』导出」;存储正常时不占用头部空间。
边界与异常- 页面切换不丢失广场的搜索词与分类选择。
- 弹层打开时锁定背景滚动,关闭后恢复。
朋友圈式帖子流,预置 10 条虚构种子帖(食堂 3、运动 1、搭子 4、探店 1、心情 1,含本人 2 条)。
入口广场页顶部四个分类标签:推荐 · 找搭子 · 关注 · 我发布的
交互逻辑
- 推荐:展示全部帖子,按热度排序。热度 = 帖子赞数 + 我的点赞(0 或 1)+ 评论数 × 3;热度相同按发布时间倒序。我的点赞会实时影响排序。
- 找搭子:仅展示搭子招募帖(type = buddy),按发布时间倒序。
- 关注:仅展示已关注作者的帖子,按发布时间倒序;关注 / 取关立即反映到本列表。
- 我发布的:仅展示本人帖子,按发布时间倒序。
- 切换标签即时重渲染,标题文案与排序角标(按热度推荐 / 最新发布)同步变化;标签支持键盘左右方向键与 Home / End 循环切换。
- 帖子卡片包含:头像、昵称(本人帖带「我」标记)、相对时间(刚刚 / N 分钟前 / N 小时前 / 月日)、位置、分类话题标签、配图、独立成就图插槽、搭子信息框(类型 / 时间 / 地点 / 人数)、点赞 / 评论 / 申请操作。
- 他人帖子显示「关注」与「私信」;本人帖子显示「···」管理菜单。
边界与异常- 各分类有专属空态与引导按钮:关注空态 →「去发现同学」;我发布的空态 →「发布我的日常」。
- 列表上限 200 帖;时间字段非法时显示「时间未知」。
全宽搜索框,输入即搜,无需点击搜索按钮。
入口广场页顶部「搜索内容/用户」输入框
交互逻辑
- 每次输入实时过滤当前分类下的帖子,匹配规则:昵称 + 正文拼接后做不区分大小写的子串匹配;关键词最长 100 字。
- 有关键词时:隐藏划卡入口与活动推荐区,标题变为「找到 N 条相关动态」,并显示「在当前分类搜索『关键词』」提示条。
- 输入非空时右侧出现清空按钮;点击清空恢复完整列表并把焦点还给输入框。
- 无结果时展示空态「还没找到这份同频」,附「清空搜索」按钮。
- 发布成功后自动清空搜索并切到「我发布的」,保证新帖可见。
边界与异常- 搜索只作用于当前分类,不跨分类;切换分类保留关键词。
- 纯空白关键词视为无搜索。
推荐页展示用户表格中的徒步、篆刻体验与女声合唱音乐会;时间和平台账号按表格录入,原文尚未独立核验。
入口推荐分类顶部「校园活动推荐」横滑区
交互逻辑
- 点击卡片主体:直接在新窗口打开活动原文(
noopener noreferrer);无安全链接的卡片显示「原文链接待核实」,不可点击跳转。
- 点击卡片底部「来源与时效」:弹层展示校区、活动组织、平台账号、文章发布日期、官网收录日期、实际活动时间、具体场地、引用来源与核验说明;未核实项明确显示「待核实」,不推断。
- 时效判定:状态含「回顾 / 历史 / ended」等关键词,或文章发布超过 30 天 → 标记「活动回顾」;否则标记「活动资讯」。官网收录日期不等于活动日期。
- 标题右侧「N 条资讯 / 回顾 · 左右滑」按钮打开整体来源说明。
边界与异常- 活动数据缺失或为空时整区隐藏,不发起 404 请求、不编造链接。
- 回顾信息不代表正在报名;微信原文可能要求验证,需在微信中自行查看。
对广场里他人的搭子招募帖做「喜欢 / 不喜欢」快速筛选,左滑喜欢、右滑不喜欢。
入口推荐 / 找搭子分类顶部奶油绿插画横幅「划卡找搭子」(搜索时隐藏)
交互逻辑
- 候选规则:只取当前广场中其他用户的搭子招募帖(排除本人帖与普通帖),按发布时间倒序;完整保留作者、时间地点、正文换行、原配图、独立成就图、招募时间 / 地点 / 类型 / 人数与赞评数,不裁切成简介。
- 拖拽手势:卡片跟手平移并轻微旋转,「喜欢 / 不喜欢」角标随位移渐显。松手时水平位移 ≥ 80px 且水平 > 垂直 × 1.5 → 确认选择:向左为喜欢,向右为不喜欢。
- 滚动保护:垂直位移 > 10px 且 > 水平 × 1.2 时判定为纵向滚动,本次手势不再触发选择;短拖松手回弹复位,不产生选择。
- 卡片与切换:近全屏大卡片与真实下一帖叠放,有图显示原图封面,无图使用运动主题文字卡;完整正文可在卡内纵向滚动。确认后前卡 200ms 旋转离场,后卡接替并回到正文顶部;动画期间禁用选择按钮防连击。底部圆形「喜欢 / 撤销 / 不喜欢」按钮常驻,卡片聚焦时左右方向键提供等价操作。
- 即时保存:选择按帖子 ID 立即写入本机,关闭弹层不丢失;同一作者的不同帖子相互独立。
- 撤销:弹出上一次选择并重新展示该帖;「喜欢的帖子」列表可逐条跳回原帖;「查看原帖」关闭弹层、定位到广场对应帖子并高亮闪烁。
- 看完 / 无候选:分别显示「都看完啦」与「暂时没有他人的搭子帖」空态;「重新看这些帖子」需二次确认后清空本机选择记录。
边界与异常- 喜欢 ≠ 申请:不自动点赞、关注、申请或发私信,不伪造双向匹配;应征需回原帖点「来搭一下」。
- 系统开启「减少动态」时跳过位移动画,但保留 200ms 防连击窗口。
- 弹层被替换或关闭时,旧动画回调不会改写新弹层状态。
一个发布器覆盖普通动态与搭子招募两种类型,字段校验全部前置。
入口广场页右下角奶黄色加号按钮;各空态的发布引导按钮
交互逻辑
- 打开即发布抽屉,顶部分段控件切换「普通动态 / 找个搭子」;切换时保留已填内容,搭子类型自动锁定分类为「搭子」。
- 正文必填且 ≤ 500 字,右上角实时字数统计;分类五选一;位置选填 ≤ 60 字。
- 搭子必填四项:见面时间(必须晚于当前;编辑旧帖时允许保留原过去时间)、集合地点 1–60 字、搭子类型 1–20 字、总人数 2–30 的整数(含发起人)且不小于已有报名人数。
- 校验失败:表单内显示红色错误文案并自动聚焦出错字段;图片处理中禁止提交。
- 发布成功:保存 → 关闭抽屉 → 清空搜索并切到「我发布的」→ 平滑回顶 → Toast 提示。新帖置顶插入,发布时间为当前,赞与评论从零开始。
- 有未保存修改时关闭抽屉(点关闭 / Esc / 点遮罩)需确认「草稿尚未发布,确定放弃这次编辑吗?」。
边界与异常- 本机最多 200 帖,超出提示先删除部分动态并导出备份。
- 离开页面时若有未保存草稿,触发浏览器挽留提示。
发布器内配图,两种来源;成就图为独立对接插槽,不在发布器内生成。
入口发布抽屉「配一张生活照片」:预置餐食图 / 上传本地照片
交互逻辑
- 预置餐食图:一键写入草稿缩略图,可随时点 × 移除。
- 本地上传:仅接受 PNG / JPEG / WebP;MIME 与文件头签名字节双重校验,拒绝 SVG 与伪装格式;文件须 > 0 字节且 ≤ 5MB,像素 ≤ 3200 万。
- 压缩:最长边缩至 1280px,白底 JPEG 质量 0.82;结果仍超过 1.8MB 时降到 0.6 重试;仍过大则报错提示换图。
- 处理期间提交按钮显示「正在压缩图片…」并禁用;完成后缩略图回填草稿并 Toast「图片已压缩,仅保存在本机」。
- 成就图插槽只接收外部分享(记录页 / URL / API)传入的安全图片,与生活配图相互独立、分别可移除。
边界与异常- 格式不符、解码失败、像素过大、压缩后仍过大均有明确错误文案。
- 处理中切换草稿或关闭发布器会作废本次上传结果,不会写错草稿。
仅本人帖子可管理,删除需二次确认。
入口本人帖子右上角「···」→ 管理我的日常
交互逻辑
- 编辑:完整回填正文、分类、位置、配图、成就图与搭子四项;保留原发布时间、点赞数与全部评论;提交按钮变为「保存修改」,校验规则与发布一致。
- 删除:先弹确认层,明示「配图、评论与招募信息也会从本机移除,无法撤销」;「先留着」关闭,「确认删除」执行。
- 删除后同步清理本人对该帖的点赞与申请记录,列表即时刷新并 Toast。
边界与异常- 他人帖子无管理入口;帖子已被删除时操作提示「这条动态已被删除」。
- 编辑不存在或非本人的帖子会被拦截。
轻量社交互动,全部即时生效、可逆、不重复叠加。
入口帖子底部心形点赞按钮 / 评论按钮
交互逻辑
- 点赞:点击切换赞 / 取消。显示数 = 种子赞数 + 我的点赞(0 或 1),反复点击不会叠加;点赞后心形填充变色并 Toast「送出一个小小的鼓励」,取消则恢复。重渲染后键盘焦点保留在点赞按钮上。
- 评论:点击评论按钮打开弹层,顶部显示原帖摘要(前 80 字),下方评论列表(本人评论带「我」标记)与输入框。
- 评论校验:不能只含空白;≤ 200 字;单帖最多 100 条演示评论。
- 发送成功:评论追加到列表尾部,帖子流评论计数同步更新,弹层重开并保持输入焦点,便于连续评论。
边界与异常- 空评论 / 超长 / 超量均在弹层内显示红色错误并聚焦输入框。
- 原帖被删除时评论弹层自动关闭。
招募帖一键应征,人数实时核算,满员即止。
入口搭子招募帖底部「来搭一下」按钮
交互逻辑
- 点击「来搭一下」:记录本机申请(不通知发起人),按钮变为「取消申请」,展示人数 +1,Toast 说明仅本机演示。
- 人数核算:展示人数 = 发起人填写的已有成员数 + 我的申请(0 或 1)。取消申请只减去我的 1 人,绝不重复扣减。
- 达到总人数上限:标题变「已经满员」,按钮显示「已满员」并禁用;已申请者仍可取消退出。
- 本人发起的招募帖显示「我发起的」,不可应征自己。
- 「我的 → 我的搭子申请」汇总全部已申请招募,点击跳回原帖。
边界与异常- 满员瞬间的点击会被拦截并 Toast「已经满员,下次再一起吧」。
- 刷新恢复时自动清理失效申请(帖子已删 / 已满员)。
- 申请为本机占位,无真实预约保证。
按作者维度的订阅关系,立即驱动关注流。
入口他人帖子作者旁「关注」按钮;粉丝弹层内回关
交互逻辑
- 点击「关注」:按钮即时变为「已关注 ✓」,该作者全部帖子立即进入「关注」分类;再次点击取消关注并同步移出。
- 关注状态按用户 ID 全局同步:同一作者在任意帖子、粉丝弹层中的按钮状态一致。
- 「我的」页关注计数实时更新;「我的关注」菜单直达关注流。
边界与异常- 本人帖子不显示关注按钮,不能关注自己。
- 初始已关注 1 位示例同学,便于首次进入关注流不为空。
帖子旁保留私信入口,右上角消息中心统一管理四类消息;私信仅本机回显。
入口帖子作者旁「私信」;广场右上角消息图标(带未读红点)
交互逻辑
- 红点:首次进入显示未读红点;打开消息中心即消除并记忆,刷新后不再出现。
- 消息中心四分类:私聊(本机会话列表 + 新建私信)、评论(他人对我帖子的评论,点击打开对应评论区)、点赞(我帖子的种子赞汇总,点击定位原帖并高亮)、粉丝(示例粉丝「栗子同学」,可查看并回关)。
- 新建私信:列出全部虚构联系人,我喜欢的招募帖作者优先排序并标注「你喜欢过这位同学的招募帖 · 未通知对方」;点击进入会话。
- 会话:输入 ≤ 500 字、禁止空白;发送后气泡仅在本机回显,每条标注「本机演示,未发送」;无自动回复;单会话最多 100 条。
- 从帖子旁「私信」进入与从消息中心进入是同一会话,历史互通。
边界与异常- 不能给自己发私信;空消息 / 超长 / 超量均有错误提示。
- 评论通知不含本人对自己帖子的评论;点赞通知为种子数据,无真实推送。
帖子配图与成就图均可放大查看。
入口点击帖子中的配图或成就图
交互逻辑
- 点击图片打开预览弹层,按原比例放大展示,标题区分「生活配图」与「成就图 · 独立插槽」。
- 关闭方式三选一:关闭按钮、Esc 键、点击遮罩;关闭后焦点回到触发位置。
边界与异常- 任何图片加载失败自动替换为「图片暂不可用,文字分享依然在这里」占位,不影响其余内容。
- 预览前再次校验图片地址安全性。
双界面记录模块:饮食拍照/上传识别热量并记餐;健身记运动并演示关联手环应用。
入口底部导航「记录」→ 饮食 / 健身 子分类;外部 URL 分享;PlazaDemo.receiveShare()
交互逻辑
- 饮食:今日摄入环与碳水/蛋白/脂肪/纤维条;取景框支持拍照(相机不可用时回退上传)与相册上传;识别结果可编辑餐名、热量、餐次与四项营养素后保存,也可重拍或直接分享。
- AI 识别:默认本地演示识别(离线、明确标注非真实分析)。设置中可切换外部 OpenAI 兼容视觉接口:自填 Base URL / Key / 模型,密钥仅存本机浏览器、导出 JSON 时脱敏;请求 20 秒超时,失败自动回退演示并提示。
- 饮食记录:按早/午/晚/加餐分组,支持手动记一餐、编辑、删除(二次确认)与带图识别历史;每日摄入目标可调。
- 健身:今日消耗环与近七日消耗柱图;运动记录支持类型/时长/强度/消耗/备注的增改删;消耗留空按强度估算。
- 关联应用:小米健康助手 / 华为运动健康 / Apple 健康 / Keep 演示授权流,确认后生成本机演示手环摘要(步数/心率/睡眠/消耗),可同步、导入手环运动、断开;不跳转真实应用、不读取真实设备或账号。
- 分享联动:饮食页保留示例餐食「照烧鸡腿饭 · 486 kcal」一键分享;识别结果也可分享。均生成预填草稿(餐名热量文案、食堂分类、餐图),打开后可编辑再发布,绝不自动发布。
- URL 分享:
?share=calorie&dish=…&kcal=…&image=…&achievementImage=… 打开页面即导入草稿。
- API 分享:
PlazaDemo.receiveShare({dish, kcal, image, achievementImage}) 返回 {ok, draft} 或 {ok:false, error}。
- 入参校验:dish 1–60 字;kcal 为 1–5000 的有效数字;image / achievementImage 必须是安全图片地址;成就图与生活图严格独立。
边界与异常- 相机拒绝或不可用时提示并回退上传;照片仅接受 PNG/JPEG/WebP 且 ≤5MB,压缩后本机保存。
- 外部 AI 未配置、超时或返回无效结构时回退本地演示并 Toast 说明,不中断记录流程。
- 校验失败 Toast 说明具体原因,不创建草稿;当前有未保存草稿时先询问是否放弃。
- 识别与营养数值、手环数据均为演示,不构成营养或医疗建议。
本机演示身份的个人中心,汇总动态、关系与申请,并提供数据出口。
入口底部导航「我的」
交互逻辑
- 身份卡显示演示昵称与「本机演示身份 · 无账号登录」标记;三项统计(发布 / 关注 / 搭子申请)随操作实时联动。
- 菜单直达:我的动态(我发布的分类)、我的关注(关注分类)、我的搭子申请(列表弹层)、演示消息中心、导出本机数据、功能需求说明(本文档)。
- 导出:一键下载 JSON 文件,包含全部帖子、点赞、关注、申请、会话、划卡选择与活动数据,文件名含日期。
边界与异常- 浏览器下载失败时提示改用
PlazaDemo.exportData() 获取数据。 - 页脚明示数据仅存本机、私信不发送、清除浏览器数据会丢失记录。
所有状态本机保存、失败可感知;输入全量净化,弹层与键盘操作完整。
入口贯穿全局;存储失败警示见头部橙色警示条,常态隐私说明见「我的」页脚
交互逻辑
- 持久化:发帖、赞评、关注、申请、划卡选择、会话与红点状态写入 localStorage;刷新后恢复并逐项净化(版本校验、去重、数量上限、失效关联清理)。
- 失败降级:存储被拒 / 数据损坏 / 写入失败时进入仅内存模式:头部橙色警示条,成功 Toast 追加「(仅内存,未保存)」,并引导导出;此时离开页面触发浏览器挽留。
- 内容安全:外部文字全部 HTML 转义;外链仅允许 HTTP(S) 且带
noopener noreferrer;图片仅放行预置图、经签名校验的 base64(PNG/JPEG/WebP)与安全外链,拒绝 SVG 与 javascript:。
- 弹层无障碍:Esc 关闭、点击遮罩关闭、Tab 焦点圈闭、关闭后焦点归还触发元素;按钮触控目标 ≥ 44px。
- 键盘与动效:分类标签支持方向键 / Home / End;划卡支持左右方向键;尊重系统「减少动态」设置;适配刘海安全区。弹层开合与内容切换、分类切换入场、点赞/关注/来搭确认、评论与私信追加、toast 均带短促平滑过渡,滚动条主题化;减少动态下全部过渡与动画关闭,业务状态不等待动画结束。
边界与异常- 数据损坏时保留原存储不覆盖,提示后以种子数据启动。
- 图片加载失败有占位回退;空态均有引导文案与按钮。
底部中间的陪伴精灵:今日卡记录三件小事,对话页可聊健身饮食计划,也可闲聊。
入口底部导航中间凸起精灵钮(当前角色头像)
交互逻辑
- 双页签:「今日」默认展示今日卡,「对话」保留完整聊天;页签可用方向键切换,切回其他 tab 后状态保留。
- 今日卡:日期与分时问候、能量环(完成件数 ÷ 3)、连续完成天数与七日点阵;三件微任务为记一餐、动一动、喝杯水。点按或右滑打开记录 / 完成,已完成的左滑或再次点按可撤销(二次确认,不删除原记录);保存饮食、健身或精灵计划后会自动勾选对应任务。全部完成显示庆祝状态与「生成明日小计划」。
- 唤出与收起:点击中钮,精灵从钮位飞入今日卡(约 360ms 回弹)并弹出气泡;右上角关闭或 Esc 缩回并归还焦点。
- 四角色:苜蓿兔(默认)/ 团子熊 / 蓝芽 / 哨子猫;首次唤出四选一,右上角随时可换,选择只存本机,底栏头像与聊天气泡同步。
- 三姿态:待机呼吸浮动、工作姿态小跳并显示「正在想…」、完成切用餐姿态弹跳;系统减少动态时全部关闭。
- 多会话:对话页顶部显示当前会话与「新对话」;会话列表可切换、删除并自动按首条消息命名,最多 20 个;每个会话独立上下文,互不串聊,单会话最多 100 条。
- 上下文:每次只发送当前会话最近 8 条、合计 ≤6000 字与最多 2 张当前图片,另附「今日完成 N/3」快照;更早内容与图片不重发,其他会话、记录明细永不发送;新会话即清空上下文。
- 演示对话:识别三餐、减脂、增肌、健身、喝水、情绪与闲聊,回复标注「本机演示」;输入 ≤500 字,空白与超长有提示;聊天本机存档,导出包含文字、不含图片与文件全文。
- 内置模型:设置提供「本机演示 / 轻快 / 均衡 / 深度」四档,三个内置档位由站点统一提供国产多模态模型,用户无需填写地址或密钥;请求经 Cloudflare Worker 代理,20 秒超时,失败自动回退演示。
- 图片与文件:回形针可添加最多 2 张图片(PNG/JPEG/WebP,≥0 且 ≤5MB,压缩至 1280px)或 1 个 txt / md / csv / json 文本文件(≤20KB)。图片只保存 96px 缩略图、原图发送后丢弃;文件只保留摘要。本机演示明确提示不能识图。
- 计划卡:饮食 / 健身结构化计划,可一键保存到今日饮食或健身记录(二次确认)、分享到广场草稿(不自动发布)或复制文本;保存后自动完成对应微任务。
- 今日联动:「让精灵帮我安排」把今日完成情况带入对话;能量、连续天数与点阵只依据本机真实打卡,不虚构数据。
边界与异常- 角色、消息与打卡按白名单净化,未知角色回退苜蓿兔;撤销微任务不删除已保存记录;计划与数值均为演示估算,不构成医疗或营养建议。
- 外部模型被要求不做诊断、拒绝极端节食与危险训练;保存计划不自动点赞、发帖或发送消息。