【OpenHarmony/HarmonyOs 】近场快传学习卡片设计基于模型路由、收藏状态与权限最小化本文基于我的 OpenHarmony/HarmonyOS 项目「物理视界 PhysicsVision」整理。当前项目已经有模型元数据、路由、收藏、最近浏览和学习进度。这一篇不是说项目已经完成近场快传而是基于现有结构设计“模型学习卡片如何通过近场快传分享”。对应主题近场快传、全场景智慧生活、精细化权限管控。一、为什么物理模型适合近场快传物理学习经常发生在多人场景同桌互相推荐模型老师课堂分发实验学生把错题相关模型发给同学家长让孩子打开某个复习内容平板和手机之间续接学习。如果每次都让用户手动搜索模型成本比较高。近场快传可以把“某个模型入口”直接发送给附近设备。二、项目已有的模型路由实验室页中已经维护了模型路由privateroutes:string[] [pages/SoundPropagation,pages/LightReflection,pages/SeriesParallelCircuit,pages/UniformAcceleration,pages/FreeFall,pages/ForceComposition,pages/ProjectileMotion]每个模型还有名称、描述、分类、年级和难度privatenames:string[] [声音的传播,光的反射,串并联电路]privatecategoryTags:string[] [波动,光学,电磁学]privatedifficulties:string[] [基础,基础,基础]这些数据已经足够生成一张“学习卡片”。三、学习卡片可以包含什么一个模型分享卡片可以设计为interfacePhysicsShareCard{ modelIndex: number name:stringdesc:stringcategory:stringgrade:stringdifficulty:stringroute:string}例如{modelIndex:11,name:光的干涉,category:光学,grade:高三,difficulty:挑战,route:pages/LightInterference}接收端拿到route后就可以打开对应模型。四、为什么只传模型索引和路由近场快传不一定要传复杂文件。对于这个项目来说模型内容已经内置在 App 中所以分享时只需要传模型索引路由标题简短描述。这样有几个好处数据很小传输快不涉及用户隐私不需要上传云端接收端打开稳定。这也符合权限最小化原则。五、分享入口放在哪里我认为可以放在三个位置1. 实验室模型卡片每个模型卡片右侧增加分享按钮。适合快速推荐。2. 模型详情页顶部栏当前顶部栏已有返回和收藏Text(this.isFav() ?❤️:) .fontSize(22) .onClick(() {this.toggleFav() })后续可以在收藏旁边增加分享← 光的干涉 ❤️ 3. 收藏页用户收藏的通常是重点模型从收藏页分享也很自然。六、接收端如何处理接收端拿到卡片后可以校验modelIndex是否在合法范围校验route是否存在记录访问跳转到模型详情页。项目中已有访问记录方法recordVisit(idx: number): void {if(this.visitedModels.length 0) {this.visitedModels idx.toString()return} let parts this.visitedModels.split(,)for(let i 0; i parts.length; i) {if(parseInt(parts[i]) idx)return}this.visitedModels this.visitedModels , idx.toString() }接收分享后也可以调用类似逻辑把模型加入最近浏览。七、权限管控用户主动分享时才触发近场快传属于用户主动行为不应该在 App 启动时申请相关权限或能力。建议流程用户点击分享弹出分享确认说明将发送模型名称和入口用户确认后触发近场能力发送成功后提示。这样用户知道自己发送了什么也知道什么时候触发系统能力。八、不应该分享哪些内容为了隐私保护不建议默认分享用户挑战成绩最近浏览完整列表个人学习画像设备信息用户身份任何图片、音频或定位信息。如果未来要分享成就卡片也应该让用户明确选择。九、和全场景智慧生活的关系近场快传可以让学习在设备之间流动手机上找到模型发给平板大屏学习老师设备发给学生设备同学之间分享同一个实验家庭场景中把复习模型发给孩子设备。这就是全场景智慧学习内容不是被锁在某个设备里而是跟着学习场景流转。十、总结「物理视界」当前还没有真正接入近场快传但它已经具备做近场分享的基础模型元数据、路由、收藏、最近浏览和详情页入口。后续只要把模型封装成轻量学习卡片就能实现低权限、低数据量、强场景感的分享体验。这篇文章对应的主题是近场快传 全场景智慧生活 精细化权限管控。它没有脱离当前项目而是基于真实路由和模型结构做扩展设计。