ArkTS V2 状态管理三坑：@Local 判据 / 引用替换 / 双通道更新（HarmonyOS）

马赛克切块提速 17.6×~38×：desiredRegion 重复读盘与一次解码管线（HarmonyOS）

emitter.size 是双刃剑：粒子精确定位 [0,0] 与条带随机出生（HarmonyOS

粒子特效中，emitRate 与 count 真实语义易混淆：emitRate 为每秒出生数（默认5），非“每次发射数”；count 是总数上限。emitRate:1+count:1 导致粒子延迟0~1000ms出生，远超波浪间隔，引发时间错位。解决需 emitRate≥100 实现“挂载即显示”。同帧交接黑缝因组件挂载滞后于渲染（1-2帧），静态行卸载时出现短暂空白。修复方案：一、静态行延迟50

> **现象：** 三模块项目（entry + common HAR + lab HAR）刚脚手架完就三连炸：`00304064 Not Found`、`lab/oh_modules/` 进了 git、`Multiple entry modules found`。> **原因：** hvigor 6.1.1（DevEco 6.1.1）强制要求每个 HAR 模块有 module.json5；CLI

波纹场失效误归因API版本，实为三层设计缺陷：粒子无速度、场区越界、振幅过小衰减过强。翻案关键在实测sdkApiVersion=26，对照不公暴露逻辑漏洞。修复后加速度、绑定真实尺寸、放开振幅，两场生效。沉淀方法论：实测优先、公平对照、自洽≠正确，辅以运行时门槛与可视化诊断工具链。

摘要（148字）： 《PhotoMotion》项目探索HarmonyOS粒子特效实战，从零构建“照片动态化”创作工具。通过双轮驱动架构（实验台+编辑器）、55项特效清单与22卡实验台，系统梳理15大坑，涵盖构建、时序、定位、性能等难题。核心教训：归因必实测、性能先采基线、时序有语义。以d.ts为权威，真机验证破局，实现粒子特效高效落地，助力动态预览与视频生成。

date: 2026-09-29tags: [HarmonyOS, 数据建模, 端侧, 状态管理, 目标管理, 任务管理, 智能体]type: 实战笔记

date: 2026-09-29tags: [HarmonyOS, 端云协作, 智能体, 架构重构, LLM, 工作流, 小艺开放平台]type: 实战笔记

摘要（148字）： HarmonyOS端侧冷启动时，relationalStore初始化滞后于HistoryAppend意图执行，导致写入失败却返回“假成功”（append DONE但未写入）。因数据库初始化为fire-and-forget模式，进程刚拉起即执行写入，竞态窗口达57ms。后续读取历史无新问题，分析模型误判“无输入”，最终形成“孤儿回复”。三重缺陷叠加——竞态、静默失败、状态错位——