工程入口和 Stage 模型ArkTS 数据建模ArkUI 首页和底部导航本地搜索与筛选Preferences 持久化沉浸式详情页路线时间轴图片资源与启动体验适配和稳定性发布准备和项目复盘如果你正在学习 HarmonyOS，不建议只停留在零散 API。选择一个真实小产品，把数据、页面、状态、资源、发布都走一遍，成长会快很多。《疆域纪行》这个项目的价值就在这里：它不是最复杂的 App，但它把一个内容

内容型 App 很容易有长摘要。如果不限制，某些卡片会特别高，列表节奏会被破坏。两行摘要是一个平衡点：既能展示信息，也能保持列表可扫读。列表页：压缩、扫读。详情页：完整、舒适。

这一篇不讲业务逻辑，专门讲“看起来像不像成品”。旅行 App 很吃图片和启动体验：资源命名、图片裁切、渐变遮罩、启动窗口背景和应用内启动页，都会影响用户第一印象。读完这一篇，你可以复用一套离线图片管理思路：图片走资源系统，数据层保存Resource，UI 层统一裁切和遮罩，启动体验保持前后一致。

return `${this.getItineraryRoutes().length}条路线 / ${this.getItinerarySpots().length}个景点｜本地保存`;这里没有单独保存 count，而是每次从推导。对于这种小数据，派生计算比手动维护计数更安全。手动维护计数常见问题是：添加成功了但计数没更新，删除失败了但计数先减了。派生值能避免这类不一致。

这一篇拆详情页。detailIddetailKindInfoGrid()读完这一篇，你可以复用一套详情页骨架：状态驱动进入详情，大图做顶部视觉，圆角内容面板承载正文，底部固定栏承载关键操作。

这一篇把 App 从“只读内容”推进到“有个人状态”。轻量本地状态用 Preferences 就能完成闭环。读完这一篇，你可以复用一套 local-first 状态方案：页面维护@State，服务层封装 Preferences，持久化只保存稳定 id，不复制完整内容对象。

这一篇讲一个很实用的链路：不接后端，如何在本地内容库上完成搜索、类型切换、地区筛选、主题筛选、排序和无结果提示。探索页是内容 App 的“找东西”能力，写顺了，用户才不会迷路。searchText读完这一篇，你可以复用一套本地检索链路：输入更新状态、提交写入历史、多条件过滤列表、无结果时给用户下一步提示。

这一篇进入 ArkUI 页面搭建。目标不是堆控件，而是把一个旅行 App 的首页做出“第一眼想继续看”的感觉：顶部大图负责氛围，快捷入口负责效率，横向卡片和底部导航负责主流程。HomePage()Hero()ListCard()读完这一篇，你可以复用一套内容型 App 首页结构：Hero 大图、分区标题、横向精选卡、纵向列表卡和固定底部导航。

这一篇专门拆“内容底座”。

这一篇先不急着写复杂页面，而是把项目从“能打开工程”到“能理解启动链路”跑通。重点看三个问题：工程模块怎么分、Stage 模型从哪里加载首页、发布配置里哪些内容可以讲、哪些内容必须脱敏。