在 AI DevSpace 体验鸿蒙灵感笔记:本地先落库、登录再同步的端云做法

举报
yd_297284506 发表于 2026/11/17 20:25:49 2026/11/17
【摘要】 今天在成长中心做任务时,把浏览案例、Star 代码仓和 AI DevSpace 体验串成了一个闭环:以鸿蒙灵感笔记案例为例,讲清本地先落库、登录再同步、幂等与重试的端云做法,并给出三条复用建议。

今天在华为云成长中心做日常任务时,三件事刚好串成了一个完整的学习闭环:浏览鸿蒙实践中心的案例、给灵感笔记案例的 GitCode 代码仓点 Star,又在 AI DevSpace 里向 AI 提问求证。把这次的真实体验记下来,重点讲这个案例“本地先落库、登录再同步”的端云做法。

一、结论先行:本地优先,云端是备份不是前提

灵感笔记这类应用最大的敌人是“想记的时候记不下来”。这个案例的做法是:新建一条灵感——无论是文字、图片还是录音——先写入 HarmonyOS 端侧的 relationalStore 关系型数据库,首页立刻就能看到,完全不依赖网络。每条记录带一个本地 ID 和 sync_status(dirty / synced)两个状态字段,离线状态下照样可读可写,内容不会丢。

这个顺序值得单独强调:先保证“随时可记”,再谈同步。很多端云应用把登录和联网放在第一步,用户没网、没登录就什么都做不了,体验上是本末倒置。

二、登录触发同步,顺序错了就会丢媒体

用户登录之后,App 拿到云端凭证(令牌用 Asset Store Kit 保存在端侧),同步调度器开始扫描所有 sync_status = dirty 的记录,推送顺序是:先上传图片、录音等媒体文件,拿到云端地址,再提交笔记的元数据。服务端用 NestJS 接收请求,经 Prisma 写入 MySQL,媒体文件则放到 Flexus X 服务器上的受控媒体目录;服务端返回云端版本号后,端侧再把记录标记为 synced。

顺序为什么不能反?如果先提交元数据、媒体还没传上去,云端就会出现一条“有标题、没图片、播不了录音”的残缺记录,后面再补传还要处理“记录已存在、媒体后到”的特殊情况。先媒体、后元数据,是一条很朴素但很容易被忽略的经验。

三、幂等与重试,才是“最终一致”的底线

同步最怕两种情况:重复和静默丢失。这个案例的兜底做法是:每条记录用本地 ID 做幂等键,服务端已经存在就更新、不存在才创建;同步失败不删数据,保留 dirty 状态,下次登录或联网时继续补传;重启后从云端拉取时,按版本与时间戳合并。

在 AI DevSpace 里,我向 AI Shell 提了同一个问题:“支持文字、图片、录音的 HarmonyOS 灵感笔记 App,怎样做到先本地落库、登录后再同步到云端?”它给出的三点——本地落库、登录触发同步、幂等兜底——和案例 README 的做法基本一致。区别在于,AI 给的是通用方案,而案例还给出了具体的约束:媒体单机存储上限 50 MiB、NestJS 只监听本机端口、Nginx 负责 HTTPS 终止、JWT 密钥至少 32 字符、.env、签名文件和证书私钥都已纳入 .gitignore,公共仓库不提供演示服务器。AI 的回答可以用来理清思路,落地时还是要按案例的部署手册逐项核对自己的 Flexus X 实例、域名和证书。

四、给想复用这套做法的开发者三条建议

第一,先跑通本地闭环再接同步。在模拟器(HarmonyOS API 24)里把新建、搜索、分类、标签、提醒这些本地能力验证完,再去做注册、登录和端云同步,出了问题也更容易定位在哪一层。

第二,媒体要先定上限和清理策略。单机媒体目录适合学习和小规模验证,50 MiB 的上限听起来不小,但录音攒起来很快;正式使用应当考虑对象存储、配额和生命周期,别等到磁盘满了再处理。

第三,密钥和连接串不要进仓库。数据库连接串、JWT 密钥、OAuth 和 Push Kit 的服务端配置都放在服务器 .env 里,发布截图和演示数据也要脱敏。这一步做不好,前面所有的同步设计都白费。

结尾

灵感稍纵即逝,工具的价值就是让“记录”这件事随时可做、登录之后不丢。今天这套组合——鸿蒙端侧本地优先、NestJS + MySQL 云端同步、AI DevSpace 辅助理解和验证——对做待办、日记、素材库这类轻量端云应用都有参考意义。下一步我打算按案例的快速体验路线,在 DevSpace 里把这套工程同步下来,实际跑一次构建和模拟器测试,再来写第二篇。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。