端侧搜索适合小数据、高频输入的场景。联系人、功能入口、城市列表这类内容，如果每敲一个字都请求网络，体验反而会被抖动拖慢。这篇单独聊联系人搜索这个场景。重点不是堆 API，而是为小数据量建立端侧索引，让高频输入时列表即时响应。数据量继续变大时，不要硬扛本地过滤。几百条以内端侧索引很舒服，更多数据就要考虑分页、后端搜索或更专业的索引结构。搜索方案要跟数据量匹配，不能只看当前 mock 数据很顺。

分布式流转能力本身很强，但入口文案如果只写“流转”，用户很难判断会发生什么。UI 需要说清楚目标设备、当前可用性和发起后的反馈。这篇单独聊跨设备这个场景。重点不是堆 API，而是让分布式入口清楚说明目标设备、当前可用性和发起后的 UI 反馈。真实项目里，设备发现、账号一致性、网络状态和权限状态都可能影响入口可用性。UI 不需要暴露所有技术细节，但要把用户能理解的原因讲明白，例如“暂未发现附近设备”

复杂表单真正难的不是输入框多，而是流程状态多。草稿、校验失败、提交中、已提交、被驳回如果都靠布尔值拼，很容易出现非法组合。这篇单独聊报销申请这个场景。重点不是堆 API，而是用状态机约束复杂表单的草稿、校验失败、提交中和已提交流程。后续如果增加“被驳回”“草稿已保存”“等待审批”，也应该继续扩展状态和迁移动作，而不是再随手加布尔值。流程越复杂，越要先问清楚：当前状态下允许用户做什么。

异常文案是检验布局韧性的最好材料。标题一长、按钮一多、屏幕一窄，平时看起来很整齐的卡片就可能把操作区挤没。这篇单独聊长标题卡片这个场景。重点不是堆 API，而是用弹性布局保证极端文案、按钮和状态标签不会互相挤压。测试时不要只放正常中文短句。英文长串、设备编号、异常码、系统字号放大、多语言翻译都会给布局制造压力。能扛住这些异常文案，卡片才算真正稳定。

骨架屏不是灰色占位块越多越专业。它应该贴近真实页面结构，让用户知道内容正在加载，也让页面从加载到完成时不会明显跳动。这篇单独聊通用加载这个场景。重点不是堆 API，而是把骨架屏抽成足够小的 ArkUI 构建器，让加载态贴近真实页面结构。失败态要和加载态分开。骨架只表示“正在加载”，接口失败后应该切到错误提示和重试入口。如果骨架无限显示，用户会以为还在等待，实际已经没有下一步了。

颜色 token 的重点不是把色值藏起来，而是让颜色具备语义。品牌色、危险色、辅助文字、页面背景这些角色稳定了，主题切换才不会牵一发动全身。这篇单独聊品牌页这个场景。重点不是堆 API，而是把品牌色、危险色、辅助文字和背景色按语义收口，避免主题切换时到处改组件。暗色模式尤其要注意层级。页面背景和卡片背景如果太接近，内容会糊成一片；辅助文字如果过暗，低亮度设备上会很难读。主题适配不是简单换一组色值，

尺寸数字散落在页面里，短期看不出问题，等视觉规范调整时会非常痛苦。HarmonyOS7 页面里即使暂时不接资源文件，也应该先给核心尺寸命名。这篇单独聊通用间距这个场景。重点不是堆 API，而是给核心尺寸命名，让页面后续迁到资源或主题 token 时有清晰路径。也不要一开始就消灭所有裸数字。只在某个徽标里用一次的微调值，可以先保留；页面主间距、按钮高度、卡片圆角这类会反复出现的值，才值得优先命名。等

性能优化不要一上来就找高级工具。很多 HarmonyOS7 页面卡顿，第一眼看代码就能发现：容器套容器、条件分支改根节点、列表项重复造结构。这篇单独聊复杂首页这个场景。重点不是堆 API，而是先从页面树、列表项结构和重复 modifier 入手排查性能问题。优化后一定要用真实数据量验证。只有三四条数据时看不出差异，换成几十条、上百条，再加上低端设备和真实图片，滚动问题才会暴露出来。渲染层级优化不是

日志打印不是开发时随手写一句success。等问题到了测试机、灰度包、线上用户那里，能不能按模块和动作搜到日志，直接决定排查效率。这篇单独聊登录流程这个场景。重点不是堆 API，而是让日志能按模块、动作和关键参数串起一条可追踪链路。生产环境还要控制日志边界。账号、手机号、验证码、token 都不应该明文打印；输入框变化这类高频日志也要降级或关闭。日志的目标是定位问题，不是把用户隐私和无效噪声都塞进

详情页最怕失败后空白。用户不知道是没数据、没权限、网络断了，还是页面坏了。HarmonyOS7 页面里我会把这些状态显式拆开，用页面状态做兜底。这篇单独聊详情页这个场景。重点不是堆 API，而是用页面状态把加载、成功、空数据和失败兜底说清楚。真实项目里建议把用户文案和开发日志分层处理。用户看到“加载失败，请检查网络后重试”，开发日志里记录模块名、订单 id、错误码和重试次数。这样既不吓用户，也能给