在少儿跑酷教学场景里,教练和加盟商经常需要快速查询品牌课程知识、确认动作教学方法、设计训练游戏。核心力量·跑酷助手小程序,将这些高频需求集中到一个移动端入口:用户可以随时提问、查看教学辅助内容、生成训练游戏,并管理自己的创作记录。

小程序服务于核心力量品牌体系内的教练与加盟商。不同会员等级可使用的知识库内容、动作二维码和创作能力有所不同;相关权益由后台统一配置,小程序据此展示用户可用的能力与内容。

一、解决什么问题?

常见教学问题依赖人工答复

课程准备、动作教学和日常运营中有大量重复问题。过去,教练和加盟商往往需要等待人工客服或同事答复,效率有限。

小程序接入品牌专属知识库与 AI 问答能力。用户选择对应技能后即可发起提问,系统以流式方式返回回答,让常见问题能够自助解决,也减少重复沟通。

动作知识难以快速转化为教学示范

只有文字回答并不能完全满足动作教学需求。针对命中动作知识的问答内容,小程序可以展示对应教学视频二维码,帮助用户从“查到知识”进一步走到“看到示范”。

训练游戏设计与生成等待成本高

为不同年龄、活动形式和参与人数设计训练游戏,需要消耗不少时间。小程序将这类创作需求变成向导式填写:用户输入关键参数后提交任务,系统在后台生成内容,并在小程序中实时反馈任务进度。

二、核心体验:问答、创作与个人内容管理

AI 问答:快速查询品牌知识

问答页是小程序的主要入口,支持多会话管理、历史消息查看和新建对话。用户可以选择不同技能进入相应的知识库检索能力;技能是否可用会根据用户权限状态展示。

在回答过程中,小程序通过 WebSocket 接收流式内容,用户可以实时看到回复,也可以停止正在生成的回答。当问题无法精确匹配知识库时,系统会给出提示与可点击的推荐选项,帮助用户继续探索,而不是只返回无意义的兜底回答。

创作工坊:生成适配训练场景的游戏

创作工坊会展示当前可用的创作技能和最近创作记录。用户选择“游戏生成”后,按照向导填写适用年龄、游戏类型和参与人数等信息,即可提交生成任务。

生成过程采用异步任务模式。提交完成后,小程序会展示排队、生成中、完成或失败等状态;用户不必一直停留在当前页面,任务状态会通过 WebSocket 实时更新。生成完成后,可继续查看内容、重新生成、收藏、分享,或在详情页切换音乐。

创作记录:让有价值的方案沉淀下来

最近生成的内容会显示在创作页,“全部创作”页面支持分页浏览,并可按时间、活动模式和适用年龄筛选。用户可以收藏有价值的游戏方案,并在个人中心查看自己的收藏内容。

这让 AI 生成结果不只是一份一次性回答,而逐渐成为可以查找、复用和分享的训练内容资产。

个人中心:管理账号与个人内容

个人中心提供编辑资料、账号设置、收藏游戏和退出登录等功能。小程序支持微信登录与账号密码登录;首次微信登录时,用户可以补充昵称与头像。

认证层采用双 Token 机制。Access Token 临近过期时会主动刷新;请求收到 401 时也会进行兜底刷新。若登录状态失效,用户完成登录后可以回到原本访问的页面,避免重复操作。

登录
知识库问答
创作
创作参数设置
生成结果
个人中心

三、技术实现:保证移动端的实时与稳定

技术栈

分类 技术方案 作用
跨端框架 Taro 4、React 18、TypeScript 构建微信小程序,并保留多端编译能力
UI 与样式 NutUI、Tailwind CSS、Sass 页面组件与统一视觉样式
状态管理 Zustand 管理用户、会话、创作和任务状态
实时通信 WebSocket AI 流式问答和游戏生成状态推送
表单与校验 React Hook Form、Zod 登录及表单数据校验
工程化 pnpm、ESLint、Prettier、Husky 依赖管理、代码检查和提交规范

WebSocket:支撑流式问答与任务进度

实时通信是小程序体验的关键。AI 问答使用 WebSocket 逐步接收回答内容;游戏生成使用同一套实时能力推送任务状态。

连接管理同时处理心跳保活、网络断开重连、前后台切换和断线恢复。应用回到前台后,会检查登录令牌和连接状态,并同步进行中的任务及遗漏事件,尽可能避免网络切换导致的页面状态不一致。

多设备会话同步:让同一账号看到一致的内容

同一个账号可能在多台设备打开同一会话。项目通过会话角色控制发送权限:先进入会话的设备为 chatter,能够发送消息;后进入的设备为 viewer,仅浏览会话内容。发送端离开后,系统通过角色变更事件完成接力。

在消息状态上,当前设备会立即插入“AI 回复中”的占位内容;其他设备则根据进入会话的时机选择流式拼接或重新拉取完整消息。回复最终完成后,以服务端完整内容更新消息,从而实现多端最终一致。

登录安全与状态恢复

小程序同时支持微信登录和账号密码登录。账号密码登录使用 RSA 加密传输;认证信息持久化保存,并通过双 Token 刷新机制维持登录状态。多个请求同时触发刷新时,系统通过全局锁与等待队列避免重复刷新造成冲突。

四、后续优化方向

当前版本已经完成 AI 问答、游戏生成、内容管理与账号体系等核心链路。后续将持续增强移动端体验:

  • 支持图片等多模态内容上传,让用户能够围绕实际动作或场地问题发起咨询;
  • 接入更多智能技能与知识库能力;
  • 扩展教案生成、赛道图片生成、动作视频分析等创作功能;
  • 优化收藏、分享与内容复用体验,持续沉淀品牌训练内容资产。

结语

核心力量·跑酷助手小程序,将品牌知识、动作教学辅助与训练游戏创作放进教练和加盟商随手可用的移动端工具中。它既帮助用户更快找到答案,也通过实时问答、异步生成和内容沉淀,让日常教学准备更高效、更可复用。