android2harmony 0.1.2 → 0.1.4

package/skills/hmos-incremental-ui-align/references/MVVM/345/274/200/345/217/221/346/226/207/346/241/243V2/_/350/214/203/345/274/217/351/200/211/346/213/251/350/257/264/346/230/216.md

@@ -0,0 +1,47 @@
+# 状态管理范式选择（V1 / V2）
+
+本目录是鸿蒙状态管理 **V2** 参考文档；同级 `../MVVM开发文档/` 是 **V1** 参考文档。改码前必须先对目标鸿蒙工程做一次**范式探测**，全程沿用同一范式，**不在同一工程内混用 V1/V2**。
+
+## 探测规则（项目级判定）
+
+扫描 `harmony_project_dir/entry/src/main/ets` 下已有 `.ets` 文件的装饰器：
+
+| 判定结果 | 依据 |
+|---|---|
+| **V1** | 出现 `@Component` + `@State` / `@Prop` / `@Link` / `@Provide` / `@Consume` / `@Observed` / `@ObjectLink` / `@Watch` |
+| **V2** | 出现 `@ComponentV2` / `@Local` / `@Param` / `@Once` / `@Event` / `@ObservedV2` / `@Trace` / `@Monitor` / `@Computed` |
+| **默认 V2** | 空工程 / 0→1 全新转换 / 找不到任何状态装饰器 |
+| **混用（多数优先）** | V1、V2 同时存在时，按占多数者定工程范式；新增代码贴合**目标页所在目录**的既有范式，并在报告中标注 |
+
+判定为 V1 → 读 `../MVVM开发文档/MVVM模式V1.md` 等；判定为 V2 → 读本目录。
+
+## V2 文档索引
+
+| 类别 | 文档 |
+|---|---|
+| 模式总览 | `MVVM模式（V2）.md` |
+| 迁移与混用 | `状态管理V1向V2迁移与混用指导.md` |
+| 组件内部状态 | `@Local装饰器：组件内部状态.md` |
+| 组件外部输入 | `@Param装饰器：组件外部输入.md`、`@Once装饰器：初始化同步一次.md` |
+| 组件输出事件 | `@Event装饰器：规范组件输出.md` |
+| 跨层级双向同步 | `@Provider装饰器和@Consumer装饰器：跨组件层级双向同步.md` |
+| 类属性观测 | `@ObservedV2装饰器和@Trace装饰器：类属性变化观测.md`、`@Type装饰器：标记类属性的类型.md` |
+| 监听与计算 | `@Monitor装饰器：状态变量修改异步监听.md`、`@Computed装饰器：计算属性.md` |
+| 应用态存储 | `AppStorageV2：应用全局UI状态存储.md`、`PersistenceV2：持久化存储UI状态.md` |
+| 语法糖 | `!!语法：双向绑定.md` |
+
+## V1↔V2 装饰器对照速查
+
+| 能力 | V1 | V2 |
+|---|---|---|
+| 自定义组件 | `@Component` | `@ComponentV2` |
+| 组件内状态 | `@State` | `@Local` |
+| 父→子单向 | `@Prop` | `@Param`（+ `@Once` 仅初始化一次） |
+| 父子双向 | `@Link` | `@Param` + `@Event`（或 `!!` 语法糖） |
+| 跨层级双向 | `@Provide` / `@Consume` | `@Provider` / `@Consumer` |
+| 类属性可观测 | `@Observed` + `@ObjectLink` | `@ObservedV2` + `@Trace` |
+| 属性级更新 | `@Track` | `@Trace` |
+| 变更监听 | `@Watch` | `@Monitor` |
+| 计算属性 | 无（手动） | `@Computed` |
+| 应用全局存储 | `AppStorage` | `AppStorageV2` |
+| 持久化存储 | `PersistentStorage` | `PersistenceV2` |