每日诗词-鸿蒙应用

1. 立项背景与目标
在数字阅读时代，古典诗词承载的文化价值因碎片化生活而被稀释。HarmonyOS的全场景智慧生态为文化应用提供了新可能。本作品旨在打造一款沉浸式诗词赏析工具，通过随机推荐、智能检索、收藏沉淀、背景音乐、深色护眼及拍照记录等功能，让用户重拾诗词之美，实现文化传承与技术创新的融合。核心目标是培养用户每日读诗习惯，提供流畅、优雅、个性化的交互体验。
2. 软件功能与核心模块
应用包含六大核心模块：①诗词获取模块：调用开放API，兼容多种JSON格式，稳定获取随机诗词。②列表与搜索模块：首页采用懒加载渲染长列表，支持按标题或作者实时过滤。③收藏管理模块：基于Preferences持久化存储，支持一键收藏/取消，数据快速读写。④沉浸式媒体模块：AVPlayer引擎实现全局背景音乐，支持循环播放与独立音量调节，设置自动记忆。⑤视觉适配模块：响应系统深色/浅色模式，动态切换全局配色。⑥外设交互模块：集成系统相机拍照保存至沙箱，并每日推送诗词通知，增强用户粘性。
3. 业务流程与功能路径
用户启动应用即触发网络请求，展示5首随机诗词，同时发送每日通知。首页下拉刷新更换诗单，搜索框实时筛选。点击卡片进入详情页，可收藏/取消，状态即时持久化。进入设置页可开关背景音乐并调节音量。在收藏页可浏览所有珍品，点击相机按钮拍照，照片自动存入应用私有目录，实现图文记忆管理。

1. 整体架构与技术栈
采用HarmonyOS Stage模型分层架构：UI表现层基于ArkUI声明式开发，通过@State/@StorageLink驱动自动渲染；业务逻辑层封装为单例或工具类（MusicManager、HttpUtil、PreferencesUtil等），解耦系统API；数据访问层对接Preferences与HTTP接口。技术栈涵盖ArkTS、ArkUI、@ohos.net.http、@ohos.multimedia.media、@ohos.file.picker、@ohos.data.preferences及@ohos.notificationManager。设计上坚持数据驱动视图，适配LazyForEach增量更新。
2. 我的负责模块与量化成果
作为独立开发者，我完成全链路研发：编写800余行核心代码，构建首页、详情页、收藏页、设置页4个页面，封装5个工具类。性能上，长列表滑动帧率稳定60fps；弱网重试成功率提升30%；深色模式覆盖20+颜色常量，切换无闪变；收藏数据冷启动加载＜50ms，确保极致响应。
3. 遇到的难点与解决方案
①AVPlayer状态机：误在创建后直接播放导致无声。解决：在stateChange回调中依次处理initialized→prepare→prepared→play。②深色模式页面闪变：各页面独立监听颜色不一致。解决：在EntryAbility的onConfigurationUpdate中统一写入AppStorage，所有页面通过@StorageLink同步消费。③LazyForEach不刷新：直接修改数组无效。解决：自定义数据源实现IDataSource，调用notifyDataReload()强制更新。④API字段不固定：origin有时为字符串有时为对象。解决：用typeof判断类型，分别解析并设默认值，兼容率达99.9%，彻底避免崩溃。