harmonyos

HarmonyOS 7 + Spatial Recon Kit-Core File Kit：3DGS 重建产物的原子发布与中断恢复【鸿蒙心迹】作者：李游一份 3DGS 重建结果从“算法已经算完”到“用户下一次还能打开”，中间隔着一段很容易被忽略的工程距离。空间重建管线关心输入、计算与输出，应用层还要处理目录、断点、校验、进程终止和最终可见性。只要在错误时机把半成品目录当成成品展示，重建成功率再高，用户看到的仍然是损坏场景。

【共创稿事节】HarmonyOS 7空间排布原则：视锥、舒适区与可达性空间界面里能放东西的地方看似无限，实际上有一圈硬边界：看得清的、够得着的、待着不累的，只有一个有限的区域。把内容丢到视野边缘或者手臂够不着的地方，用户就得转头、伸手、扭腰，体验立刻掉档。这篇讲三件事——视锥怎么限制可见范围、舒适区怎么界定体感、可达性怎么决定交互成本，最后给一份能直接用的排布参数表。

HarmonyOS 7 Core Vision Kit + Image Kit：超分批处理的 PixelMap 预算、失败降级与结果原子替换【鸿蒙心迹】作者：李游这次做的不是“把一张图变清晰”的展示页，而是一个会连续处理十二张旧照片的批任务。单张调用一直正常，批量跑到第七张却开始抖动，偶尔还会把上一张预览留在页面上。真正需要收拾的是 PixelMap 的所有权、内存峰值和结果提交时机。

HarmonyOS 7 AbilityAccessCtrl + ArkUI：权限弹窗重入治理与提审证据链【鸿蒙心迹】这次提审前自测，我故意连续点了三次“扫描讲义”。结果权限说明弹层叠了两层，系统授权请求也被触发了两次。功能最终能用，却很难向审核人员解释：应用究竟在什么场景申请相机权限，用户拒绝后会发生什么。

HarmonyOS 7 Spatial Recon Kit + Preferences：重建会话中断恢复与脏任务回收【鸿蒙心迹】端侧重建最麻烦的并不是把任务跑起来，而是跑到一半接电话、锁屏或被系统回收以后，应用还能不能解释清楚：刚才采到哪里、哪些文件有效、旧任务是否已经释放，以及用户下一步应该继续还是重来。

《HarmonyOS 7 ArkGraphics 3D 空间设计开发实战》03：glTF模型加载、实例复用与资源生命周期【鸿蒙心迹】同一把椅子放三次，为什么加载了三次模型？前两篇搭好了工程骨架，也搞清楚了坐标体系。这一篇开始往房间里放真正的家具模型：沙发、桌子、椅子、台灯、绿植、柜子。

HarmonyOS 7 + ArkTS-HUKS：精准碰一碰载荷的签名校验与重放窗口【鸿蒙心迹】一次跨设备业务交接是否可信，不能只看“碰一碰已经触发”和“UnifiedData 已经取到”。系统能力负责发现设备、建立交互并传递统一数据；业务仍要判断收到的字段是否被改动、消息是否过期、同一份载荷是否被重复消费。

HarmonyOS 7 状态手记 01｜页面状态别乱放做 HarmonyOS 7 页面时，最容易把人绕进去的往往不是布局，而是“这个值到底该放哪儿”。页面计数、加载状态与条件渲染看起来只是几行代码，真接进项目后，经常会遇到 UI 不刷新、返回页面数据变旧、弹窗取消后值却被改掉，或者一个请求失败把整个页面状态搅成一团。

HarmonyOS 7 + Hvigor-Localization Kit：多语言资源占位符签名与回退链路预检【鸿蒙心迹】作者：李游多语言资源最棘手的错误，往往不是“翻译得不够好”，而是构建能通过、页面也能打开，直到某个带参数的文案在特定语言下才暴露类型错位。%d 被译成 %s、复数分支缺少 other、关键文案依赖默认资源回退，这些问题靠逐页肉眼检查很难稳定发现。

HarmonyOS 7 AVSession + Float Window：闪控窗播放控制权的会话移交与重复指令去重【鸿蒙心迹】作者：李游播放器缩成闪控窗以后，暂停按钮偶尔要点两次；把窗口展开回主页面，进度又会倒退半秒。音频没有断，AVSession 也仍然活着，表面看只是 UI 抖动。真正的问题是主页面和闪控窗都认为自己拥有播放控制权。

HarmonyOS 7 + ArkTS-UDMF：精准碰一碰载荷的协议版本协商与字段降级【鸿蒙心迹】精准碰一碰把设备发现、目标选择和内容交接压缩成一个很自然的动作。真正进入持续迭代后，麻烦却常常出现在“内容已经送到，对端还是拒绝打开”这一步。发送端刚升级到第三版载荷，接收端还停在第二版；网络没有失败，UDMF 记录也能读到，失败发生在业务字段的解释上。

HarmonyOS 7 + Core Vision Kit-TaskPool：文搜图相似度阈值分桶与硬负样本回流【鸿蒙心迹】文搜图接口返回了相似度，工程里最容易做的决定就是找一个全局阈值：大于 0.72 展示，小于 0.72 丢弃。这个实现只需要一行代码，却把三个问题揉在一起：人像描述、票据文字和风景语义的分数分布并不相同；TopK 结果中的高分错误项往往有稳定模式；阈值一旦改动，如果没有可重复的样本集，团队只能靠几次手工搜索判断“好像更准了”。

HarmonyOS 7 EasyGo + ArkUI Navigation：平行视界导航模式的列表选中态、右栏路由栈与全局返回收口【鸿蒙心迹】这次不写“平行视界怎么打开”，而是把问题往真实阅读类 App 里再推进一步：左边文章列表固定，右边详情可以继续点相关推荐；当右栏已经压入第二层详情以后，用户执行全局返回，应该只退右栏，不应该把左边选中的文章一起重置。

HarmonyOS 7 + ArkUI Accessibility：闪控窗紧凑态的语义树裁剪与读屏焦点收敛【鸿蒙心迹】闪控窗从完整态切到紧凑态，视觉上通常只是少了几枚按钮、缩短了标题、把进度区域压成一行。对读屏服务来说，事情并不只是“画面变小”：如果旧节点还留在无障碍语义树里，焦点可能继续落到不可见按钮；如果每个子组件都单独播报，用户要听完九个节点才能找到主操作；如果形态切换和焦点恢复同时发生，旧任务还会把焦点抢回已经消失的控件。

HarmonyOS 7 ArkUI Navigation + WindowStage：折叠屏窗口宽度驱动的单双栏切换与草稿状态保持【鸿蒙心迹】这篇不从“折叠屏有几种形态”开始，而是从一个更具体的问题切入：同一个笔记页面，在 420vp 的窄窗口里应该是单栏，在 840vp 的展开窗口里应该变成列表 + 详情双栏；真正麻烦的是，布局切换以后，用户正在编辑的草稿不能丢，当前选中的笔记也不能跳回首页。

【共创稿事节】HarmonyOS 7材质与光照：真实感的营造与性能的平衡一块界面元素看起来"真不真"，取决于两件事：它的表面是什么材质，以及光是怎么打到它上面的。材质给了物体性格，光照给了物体体积，两者叠加才有立体感。问题在于，真实感的东西都要算——模糊要算、反射要算、阴影要算，而空间计算的每一帧都紧张。设计的功夫在于知道哪些能省、哪些不能省。

otlinx-datetime 官方 KMP 日期时间库的 OpenHarmony 鸿蒙化适配实战库版本：Kotlin/kotlinx-datetime 8b7616d（master 线，Apache 2.0）｜验证环境：Kotlin 2.2.21-1.0.0（鸿蒙定制版）｜kotlinx-serialization 1.9.1-1.0.0｜DevEco Studio 26.0.0｜DevEco 模拟器｜HarmonyOS 7.0.0（API 26）

Flutter 鸿蒙化实战：flutter_iot_wifi 适配 OpenHarmony，IoT 设备 WiFi 配网

HarmonyOS 7 + Hvigor-module.json5：权限增量审计与隐私声明一致性门禁【鸿蒙心迹】应用提审前，权限问题很少表现为“完全没配”。更常见的是一次功能合并顺手增加了两项 requestPermissions：相机权限有理由和使用场景，麦克风权限只有名称；隐私声明仍沿用上个版本，代码评审又只看到业务文件。构建可以通过，真正的问题被推迟到发布检查甚至用户授权界面。

HarmonyOS 7 ArkTS + Node.js：把权限声明、运行时授权与隐私文案做成提审前一致性扫描【鸿蒙心迹】有些上架问题不是“功能坏了”，而是工程里的三份事实没有对齐：module.json5 声明了一套权限，ArkTS 实际申请的是另一套，隐私文案又写成第三套。页面自己测没有问题，到了提审阶段才开始逐项找差异，成本会比开发时高很多。