@deveco-test/deveco-code 1.0.3 → 1.0.4

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/08-navigation.md

@@ -0,0 +1,102 @@
+# 11. 导航与路由约束
+
+## 规则
+
+| 规则 | 说明 | 错误码 |
+|------|------|--------|
+| 推荐使用 Navigation + NavDestination | 替代 @ohos.router 和 pageTransition | — |
+| Router 页面栈上限 32 | 超过 32 页报错 | **100003** |
+| Navigation 默认转场时长不可控 | 弹簧曲线，时长因设备而异。**不要将业务逻辑耦合到默认转场时长** | — |
+| 共享元素转场需禁用默认转场 | geometryTransition 时**必须禁用**系统默认转场动画 | — |
+| customNavContentTransition 优先级更高 | 同时设置 Navigation 级和 NavDestination 级转场时，Navigation 级优先 | — |
+| 未注册 builder 函数 | Navigation 跳转未注册 builder 的页面 | **100005** |
+| 无 NavDestination 组件 | Navigation 跳转未包含 NavDestination 的页面 | **100006** |
+| pushPath/pushDestination param 禁内联字面量 | `param: { id: 1 }` 是无类型字面量 → **10605038** | **10605038** |
+| NavDestination 无 titleMode | titleMode 是 Navigation 专属属性，NavDestination 只有 `.title()` | **10505001** |
+| 路由栈读取 | 目标页 `NavDestination().onReady((ctx: NavDestinationContext) => { this.navPathStack = ctx.pathStack })` 取栈，`ctx.pathInfo.param` 取参；不推荐 `@Provide`/`@Consume` 传 NavPathStack | — |
+| 目标页根节点为 NavDestination | 目标页 `build()` 首节点必须是 `NavDestination`，否则白屏/挂载失败 | **100006** |
+| 单 navDestination builder | 链式多次 `.navDestination()` 后者覆盖前者，所有路由落到最后一个页面（编译期不报错，运行时白屏） | — |
+| hideNavBar 语义陷阱 | `.hideNavBar(true)` 隐藏导航页（标题+内容+工具栏），栈空时首页显示空白，且失去自适应分栏能力；全屏需求用 NavDestination 的 `.fullScreenOverlay(true)`，只藏标题用 `.hideTitleBar(true)` | — |
+| Dialog 类型 NavDestination 无默认转场 | API 13 前无默认转场动画 | — |
+
+### 参数传递
+
+```ts
+// ❌ WRONG -- param 内联字面量
+this.stack.pushPath({ name: 'first', param: { id: 1 } })   // 10605038
+
+// ✅ RIGHT -- param 先声明类型再传变量
+interface PageParam { id: number }
+const p: PageParam = { id: 1 }
+this.stack.pushPath({ name: 'first', param: p })
+```
+
+### 转场动画约束
+
+| 规则 | 说明 |
+|------|------|
+| 默认转场时长不可控 | 弹簧曲线，因设备而异，不要把业务逻辑耦合到默认转场时长 |
+| geometryTransition 须禁用默认转场 | 否则叠加产生视觉异常 |
+| 同时设置 Navigation 级和 NavDestination 级转场 | Navigation 级（customNavContentTransition）优先 |
+| pageTransition 已废弃 | 用 Navigation 转场和 Modal 转场 |
+
+---
+
+## 多文件 Navigation 路由架构
+
+**不要把所有页面放在一个文件**。`@ComponentV2 export struct` 支持跨文件导出。
+
+### 方案一（推荐）：系统路由表 router_map.json
+
+无需 import 页面、按需加载、天然跨模块，多页面一律用此方案。
+
+- 配置 `resources/base/profile/router_map.json`（`routerMap` 数组：`name` + `buildMethod` + `pageSourceFile`）
+- `module.json5` 添加 `"routerMap": "$profile:router_map"`
+- 页面文件导出 `@Builder export function XxxBuilder(): void { XxxPage() }`
+- 主文件用 `pushDestination({ name: 'PageName', param })` 跳转：Promise 返回、错误码经 reject 传递（`pushPath`/`pushPathByName` 无错误码返回，不推荐）
+- 目标页在 `NavDestination().onReady((ctx: NavDestinationContext) => { this.navPathStack = ctx.pathStack })` 取栈，`ctx.pathInfo.param` 取参（见上方规则表）
+
+### 方案二（备选）：自定义路由表 .navDestination(builder)
+
+仅限单层简单场景。必须用**单个** builder 内 `if/else` 做 name→page 映射；**链式多次 `.navDestination()` 后者覆盖前者**，所有路由会落到最后一个页面（编译期不报错，运行时白屏）。
+
+```ts
+// PageA.ets
+@ComponentV2 export struct PageA {
+  @Param navPathStack: NavPathStack = new NavPathStack()
+  @Param goodsIdValue: string = ''
+  build() { NavDestination() { /* ... */ } }
+}
+
+// MainHost.ets
+import { PageA } from './PageA'
+@Entry @ComponentV2 struct MainHost {
+  @Local navPathStackValue: NavPathStack = new NavPathStack()
+  @Builder pageMap(name: string, param: Object) {
+    if (name === 'PageA') { PageA({ navPathStack: this.navPathStackValue, goodsIdValue: '123' }) }
+  }
+  build() {
+    Navigation(this.navPathStackValue) { /* 首页 */ }.navDestination(this.pageMap)
+  }
+}
+```
+
+> 页面获取栈：`onReady` 从 NavDestinationContext 取（推荐，可同时取 `pathInfo.param`）；`queryNavigationInfo()`（12+，推荐）任意自定义组件任意时机可取、不依赖生命周期。不推荐 `@Provide`/`@Consume` 或 AppStorage 传栈。
+
+---
+
+## 常见错误对比
+
+| ❌ 错误写法 | ✅ 正确写法 | 说明 |
+|------------|-----------|------|
+| 使用 `@ohos.router` 做页面跳转 | Navigation + NavDestination | Router 不推荐 |
+| 多个页面各自 `@Entry` | 单 Page 应用只有一个 @Entry | 多页面通过 Navigation 管理 |
+| Navigation 跳转未注册 builder | 必须在 Navigation 中注册 destination builder | 100005 |
+| 使用 `pageTransition` 做页面转场 | Navigation 转场或 Modal 转场 | pageTransition 已废弃 |
+| pushPath 的 param 内联字面量 | 先声明 interface 再用 interface 类型变量传递 | 10605038 |
+| NavDestination 调用 titleMode | NavDestination 只用 `.title()`，`.titleMode()` 只挂 Navigation | 10505001 |
+
+## 参考
+
+- 废弃接口替换见 [19-deprecated](14-deprecated.md)
+- 对话框与半模态见 [12-dialog](09-dialog.md)

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/09-dialog.md

@@ -0,0 +1,72 @@
+# 12. 对话框与半模态约束
+
+## 规则
+
+| 规则 | 说明 | 错误码 |
+|------|------|--------|
+| 多弹窗堆叠 | 多个弹窗按**后弹优先**原则堆叠，退出时从高到低 | — |
+| 系统弹窗阻塞自定义弹窗 | 系统弹窗显示时，非系统弹窗显示接口被阻塞 | — |
+| 不建议后台弹窗 | 应用不在前台时不建议调用弹窗显示接口 | — |
+| bindSheet onWillDismiss | 声明后所有关闭操作必须通过 `dismiss()` 调用处理，否则无法关闭 | — |
+| bindSheet UIExtension 限制 | Sheet 内嵌入 UIExtension 时，不支持在 UIExtension 内再启动额外的 sheet/dialog | — |
+| bindSheet 悬停避让限制 | 悬停/中轴避让不支持子窗口模式（showInSubWindow 为 true 时） | — |
+| CustomDialogController 不推荐 | API 12 起不推荐，用 `promptAction.openCustomDialog` | — |
+| **AlertDialog 调用方式** | 通过 `this.getUIContext().showAlertDialog()` 或全局 `AlertDialog.show()`（全局可用，建议走 UIContext） | — |
+
+### AlertDialog 按钮字段
+
+```ts
+// ❌ WRONG -- 用 text 字段 → 10505001
+this.getUIContext().showAlertDialog({
+  message: '确认？',
+  buttons: [{ text: '取消', action: () => {} }]
+})
+
+// ✅ RIGHT -- 用 value + action
+this.getUIContext().showAlertDialog({
+  message: '确认？',
+  buttons: [{ value: '取消', action: () => {} }, { value: '确认', action: () => {} }]
+})
+```
+
+`AlertDialog` 最多 `primaryButton` + `secondaryButton` 两个按钮字段，**无 `tertiaryButton`**；要更多按钮用 `buttons` 数组。
+
+### bindSheet
+
+```ts
+// ✅ RIGHT
+.bindSheet($$this.isShow, this.sheetBuilder, {
+  height: SheetSize.MEDIUM,   // SheetSize 只有 MEDIUM/LARGE，没有 HALF
+  dragBar: true,
+  showClose: true
+})
+```
+
+`SheetSize` 只有 `MEDIUM`/`LARGE`，**没有 `HALF`**（`10505001`）。`$$` 双向绑定必填，否则 sheet 关不掉。用 `detents`/`height`，**没有 `sheetSize` 字段**。
+
+### ActionSheet 用 `sheets`，不是 `buttons`
+
+```ts
+// ❌ WRONG
+ActionSheet.show({ buttons: [{ title: 'x', action: () => {} }] })
+// ✅ RIGHT
+this.getUIContext().showActionSheet({ sheets: [{ title: 'x', action: () => {} }] })
+```
+
+### bindContextMenu 第二参数用枚举
+
+`.bindContextMenu(this.menu, ResponseType.LongPress)`，不要传字符串 `'longpress'`。
+
+## 常见错误对比
+
+| ❌ 错误写法 | ✅ 正确写法 | 说明 |
+|------------|-----------|------|
+| `buttons: [{ text: '取消' }]` | `buttons: [{ value: '取消', action: () => {} }]` | AlertDialog 按钮用 value 非 text |
+| `height: SheetSize.HALF` | `height: SheetSize.MEDIUM` | SheetSize 无 HALF，只有 MEDIUM/LARGE |
+| `ActionSheet.show({ buttons: [...] })` | `showActionSheet({ sheets: [...] })` | ActionSheet 用 sheets |
+| `CustomDialogController` | `promptAction.openCustomDialog` | 已废弃 |
+
+## 参考
+
+- 废弃接口替换见 [19-deprecated](14-deprecated.md)
+- 导航与路由见 [11-navigation](08-navigation.md)

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/10-style.md

@@ -0,0 +1,90 @@
+# 13. 样式与主题约束
+
+## 规则
+
+### @Extend
+
+| 规则 | 说明 | 错误码 |
+|------|------|--------|
+| 仅支持全局定义 | 不能在组件内部定义 | — |
+| 仅当前文件可用 | 不支持 export（需 export 用 AttributeModifier） | — |
+| **不能与 @Styles 混用** | | — |
+| **必须省略返回类型** | 不写 `: void`，否则破坏链式调用 | — |
+| **禁止嵌套函数定义** | 逻辑抽到顶层方法，否则连锁语法崩溃 | arkts-no-nested-funcs |
+
+```ts
+// ❌ WRONG -- 标了 :void，链式调用炸
+@Extend(Text) function card(): void { .padding(8) }
+// -> .card().width() 报 Property 'width' does not exist on type 'void'
+
+// ❌ WRONG -- 内嵌套函数
+@Extend(Text) function card() { function inner() {} .padding(8) }
+// -> 连锁引发 ';' expected / Only UI component syntax can be written here
+
+// ✅ RIGHT -- 省略返回类型，逻辑抽顶层
+@Extend(Text) function card() { .padding(8) .backgroundColor(Color.White) }
+```
+
+### @Styles
+
+| 规则 | 说明 |
+|------|------|
+| 不支持参数 | |
+| 不支持业务逻辑语句 | |
+| 仅支持通用属性 | 不支持组件私有属性（如 Button 的 fontColor） |
+| 不支持 export | |
+
+### stateStyles
+
+| 规则 | 说明 |
+|------|------|
+| 仅支持通用属性 | 组件私有属性不生效 |
+| 聚焦状态仅通过外接键盘 Tab/方向键触发 | 不支持嵌套滚动组件内按键触发 |
+
+### 实时模糊性能
+
+| 接口 | 说明 |
+|------|------|
+| backdropBlur / blur / backgroundBlurStyle / foregroundBlurStyle / motionBlur | **每帧实时渲染，性能开销大** |
+| 静态模糊场景 | 用 effectKit 的静态模糊接口 |
+
+### clipShape
+
+- clipShape 使用时，shape 的 **fill 属性不生效**
+
+### 深色/浅色模式
+
+| 规则 | 说明 |
+|------|------|
+| 通过函数返回值动态读取 colorMode 不可靠 | 热更新时属性设置代码可能不重新执行 |
+| BuilderNode / ComponentContent 需手动传播系统环境变更 | 调用 `updateConfiguration()` |
+
+### 动画约束
+
+| 规则 | 说明 |
+|------|------|
+| 位置/尺寸动画性能差 | 推荐用 scale 替代 |
+| onFinish 回调慎用 | 关闭开发者转场动画或 UIAbility 后台时，finish 回调立即触发 |
+| animateToImmediately 慎用 | 绕过 vsync，正常用 animateTo |
+| keyframeAnimateTo 不支持弹簧曲线 | 不支持 springMotion/responsiveSpringMotion/interpolatingSpring |
+| springMotion/interpolatingSpring 自动计算时长 | 开发者指定的 duration 被忽略 |
+| springCurve 不推荐 | 扭曲物理时间 |
+| TransitionEffect.animation 的 onFinish 不生效 | |
+| 父组件必须有 transition | 否则子组件消失转场不触发 |
+| pageTransition 已废弃 | 用 Navigation 转场 / Modal 转场 |
+| @AnimatableExtend 参数限制 | 只允许 number/string/Color 及其联合类型；卡片动画最大 1000ms |
+| AnimatorResult 需及时销毁 | 否则内存泄漏 |
+
+## 常见错误对比
+
+| ❌ 错误写法 | ✅ 正确写法 | 说明 |
+|------------|-----------|------|
+| `@Extend(Text) function card(): void { ... }` | 省略 `: void` | 破坏链式调用 |
+| `@Extend` 内写 `function inner() {}` | 逻辑抽到顶层方法 | arkts-no-nested-funcs |
+| `@Styles` 里写组件私有属性 | 仅通用属性 | 不生效 |
+| `@Extend` 与 `@Styles` 混用 | 分开使用 | 不能混用 |
+
+## 参考
+
+- @Extend/@Styles 在状态管理中的位置见 [05-state-v1](05-state.md)
+- 废弃接口 pageTransition 见 [19-deprecated](14-deprecated.md)

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/11-extension.md

@@ -0,0 +1,54 @@
+# 11. 扩展能力与交互
+
+## 扩展能力
+
+### DrawModifier
+- **一个实例只能设置给一个组件**，禁止多个组件复用同一个 DrawModifier
+- **不支持**在 attributeModifier 内调用 drawModifier
+
+### GestureModifier
+- **不支持**自定义组件
+- **不支持**在 attributeModifier 内调用 gestureModifier
+
+### AttributeUpdater
+- **一个对象只能关联一个组件**，用于多个组件时只有一个生效
+- 与状态变量同时更新同一属性时会**互相覆盖**
+
+### NodeContainer
+- **仅支持**自定义 FrameNode 节点和 BuilderNode 根节点作为子节点
+- 系统组件代理节点**不能**成功挂载
+
+### 节点单父规则
+- 一个节点**只能有一个父节点**。挂载到多个 NodeContainer 会导致异常
+- 迁移节点时**必须先从旧父节点移除**，再添加到新父节点
+
+### FrameNode
+- 声明式（系统）FrameNode **不可修改**：不能设置属性、增删子节点、绑定控制器（错误码 100021）
+- 未挂载的节点**不能进行节点操作**（错误码 106203）
+
+---
+
+## 交互与手势
+
+| 规则 | 说明 |
+|------|------|
+| 长按与拖拽冲突 | 长按手势与拖拽手势同时绑定时可能冲突，需注意优先级 |
+| onDragLeave 限制 | onDragLeave 在某些场景下不触发，不要将核心逻辑挂在其上 |
+| 匿名函数 this 问题 | ArkTS 中**不允许使用匿名函数**绑定事件，必须使用箭头函数 |
+| bind(this) 不推荐 | 成员函数配合 bind(this) 配置事件方法不推荐 |
+| TouchEvent 类型 | 触摸事件参数是 `TouchEvent`/`TouchObject`，**不存在 `TouchInfo`** |
+
+### 事件绑定
+
+```ts
+// ❌ WRONG
+.onClick(function() { this.do() })
+.onClick(this.handler.bind(this))
+
+// ✅ RIGHT
+.onClick(() => { this.handler() })
+```
+
+## 参考
+
+- 错误码：**100021**（声明式 FrameNode 不可修改）、**106203**（未挂载节点操作）

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/12-layout.md

@@ -0,0 +1,69 @@
+# 16. 布局容器约束
+
+## 规则
+
+### 容器直接子组件约束
+
+| 容器 | 只接受直接子组件 |
+|------|----------------|
+| `List` | `ListItem`（或 `ListItemGroup`） |
+| `Grid` | `GridItem` |
+| `Tabs` | `TabContent` |
+| `WaterFlow` | `FlowItem` |
+| `Shape` | `Rect`/`Path`/`Circle`/`Ellipse`/`Shape`/`Polyline`/`Polygon`/`Image`/`Text`/`Column`/`Row` |
+
+```ts
+// ❌ WRONG
+List() { Text('item') }
+Grid() { Text('cell') }
+Tabs() { Text('tab') }
+
+// ✅ RIGHT
+List() { ListItem() { Text('item') } }
+Grid() { GridItem() { Text('cell') } }
+Tabs() { TabContent() { Text('tab') } }
+```
+
+`if/else` 是"透明"的：即使条件分支，`Grid` 内仍只能出现 `GridItem`。
+
+### List / Grid / WaterFlow / Swiper
+
+| 规则 | 说明 |
+|------|------|
+| 使用 LazyForEach 时子组件尺寸不能缺失 | 否则懒加载失效 |
+| 同一容器内不建议同时使用 ForEach 和 LazyForEach | |
+| 设置 cachedCount 可优化懒加载性能 | |
+
+### Flex
+
+| 规则 | 说明 |
+|------|------|
+| 注意 flexWrap 默认值和主轴方向的对齐方式 | |
+| 嵌套过深可能导致性能问题 | |
+
+### RelativeContainer
+
+| 规则 | 说明 |
+|------|------|
+| 锚点规则需正确设置 | |
+| center/middle 等对齐规则需指定 anchor 和 align | |
+
+### Scroll
+
+| 规则 | 说明 |
+|------|------|
+| 嵌套滚动场景注意滚动冲突 | |
+| Scroll 内不支持 LazyForEach | 仅 List/Grid/WaterFlow/Swiper 支持懒加载 |
+
+## 常见错误对比
+
+| ❌ 错误写法 | ✅ 正确写法 | 说明 |
+|------------|-----------|------|
+| `List()` 内直接放非 `ListItem` | `List() { ListItem() { Text('...') } }` | List 仅接受 ListItem 作为直接子组件 |
+| `Tabs()` 内直接放非 `TabContent` | `Tabs() { TabContent() { Text('...') } }` | Tabs 仅接受 TabContent |
+| `Grid()` 内直接放非 `GridItem` | `Grid() { GridItem() { Text('...') } }` | Grid 仅接受 GridItem |
+| `WaterFlow()` 内直接放非 `FlowItem` | `WaterFlow() { FlowItem() { Text('...') } }` | WaterFlow 仅接受 FlowItem |
+
+## 参考
+
+- 渲染控制（LazyForEach/Repeat）见 [08-rendering](06-rendering.md)

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/13-performance.md

@@ -0,0 +1,27 @@
+# 13. 性能与可见性
+
+## 性能
+
+| 规则 | 说明 |
+|------|------|
+| **禁止在 build() 的 UI 描述中改变状态** | 会导致无限重渲染循环或性能下降 |
+| 网络图片 syncLoad | 大量网络图片场景，注意 syncLoad 设置，避免同步加载导致卡顿 |
+| 注销回调 | 组件销毁时必须**及时注销**事件回调，避免内存泄漏 |
+| AnimatorResult 销毁 | 不及时销毁会导致内存泄漏 |
+| 长列表优先用 Repeat/LazyForEach | ForEach 在大数据量场景性能差 |
+| 组件复用 | 使用 @Reusable/@ReusableV2 配合 LazyForEach 实现节点复用 |
+| @Track 精准更新 | 使用 @Track 装饰器可减少不必要的组件重渲染 |
+| 组件冻结 | 使用 freeze/freezeV2 实现非活跃组件冻结，减少不必要的更新 |
+
+## 可见性
+
+| 规则 | 说明 |
+|------|------|
+| onVisibleAreaChange | 可见区域**受父组件边界限制**，超出父组件的区域不计入。每帧计算，**尽量减少使用** |
+| nodeRenderState | **不推荐**用于列表项（因节点回收），更适合页面级或 Tab 级可见性监控 |
+| 渲染状态 ≠ 可见性 | ABOUT_TO_RENDER_IN 表示进入渲染管线，但可能被其他组件遮挡。渲染状态不完全等于视觉可见性 |
+
+## 参考
+
+- build() 约束见 [04-build](04-build.md)
+- 渲染控制（ForEach/LazyForEach/Repeat）见 [06-rendering](06-rendering.md)

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/14-deprecated.md

@@ -0,0 +1,28 @@
+# 19. 废弃接口替换
+
+## 规则
+
+| 规则 | 说明 |
+|------|------|
+| **禁止使用 CustomDialogController** | API 12 起不推荐，用 `promptAction.openCustomDialog` 替代 |
+| **禁止使用 pageTransition** | 用 Navigation 转场或 Modal 转场替代 |
+| **禁止使用 @ohos.* 路径导入** | 旧版导入路径已废弃，必须用 `@kit.*` 替代 |
+| **禁止在 @Component 中使用 static {}** | V1 中静态代码块不执行（API 22 起告警） |
+
+## 废弃对照表
+
+| ❌ 废弃写法 | ✅ 正确替代 |
+|------------|-----------|
+| `CustomDialogController` | `promptAction.openCustomDialog` |
+| `pageTransition()` | Navigation 转场 / Modal 转场 |
+| `@ohos.router` 做导航 | Navigation + NavDestination |
+| 全局 `animateTo`/`vp2px` 等（API 18+） | `this.getUIContext().animateTo()` 等 |
+| `@Component` + `static {}` | 使用 @ComponentV2 或移除静态代码块 |
+| `@ohos.*` 导入 | `@kit.*` 导入 |
+| `SwiperDisplayMode.AutoLinear` | `SwiperDisplayMode.Auto`（AutoLinear 已废弃） |
+
+## 参考
+
+- 导入规则见 [01-import](01-import.md)
+- UIContext 替换见 [02-uicontext](02-uicontext.md)
+- 导航与路由见 [11-navigation](08-navigation.md)

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-rules/_index.md

@@ -0,0 +1,79 @@
+# ArkUI 编码规范统一索引
+
+> **定位**：编码规范、错误预防、编译错误码三位一体。每个文件包含"规则（正面规范）→ 常见错误（错误对照）→ 参考（错误码/版本）"三层。
+>
+> **使用时机**：
+> 1. **编码前**：扫 00-arkts-syntax（ArkTS 语法规则）和 01-import / 02-uicontext（最高频错误）
+> 2. **编码中**：写属性参数对照 07-attribute-params；状态管理看 05-state；列表渲染看 06-rendering；视图架构看 08-navigation/12-layout；@Builder 看 05-state；@Observed 看 05-state
+> 3. **多页面/多文件生成时**：必扫 03-component（跨文件接口重名——单类实测毁掉 11/44 失败用例）
+> 4. **检视时**：逐条对照下方检视清单
+
+## 文件索引
+
+| 文件 | 主题 | 覆盖范围 |
+|------|------|---------|
+| [00-arkts-syntax](00-arkts-syntax.md) | ArkTS 语法规则 | 83 条 `arkts-*` 规则索引、TS→ArkTS 改写表、空安全、export/import、类型注解 |
+| [01-import](01-import.md) | 模块导入 | import 规则、kit 速查表、全局内置、常见错误对照 |
+| [02-uicontext](02-uicontext.md) | UIContext 全局接口 | 全局接口 → UIContext 替换表、常见错误 |
+| [03-component](03-component.md) | 自定义组件与命名 | 组件基本约束、保留字全表、框架方法名冲突(10505001)、跨文件重名(arkts-no-decl-merging) |
+| [04-build](04-build.md) | build() 函数约束 | 根节点约束、禁止项（变量/console/switch/三元）、sort/filter 陷阱 |
+| [05-state](05-state.md) | 状态管理（V1+V2+混用） | @State/@Prop/@Link/@ObjectLink/@Observed/@Provide/@Consume/@Watch、@Builder、@Observed 不刷新排查、@Local/@Param/@Once/@Event/@Monitor/@Computed/@ObservedV2/@Trace、V1/V2 混用桥接 |
+| [06-rendering](06-rendering.md) | 渲染控制 | ForEach/LazyForEach/Repeat、if/else、key 生成器、DataChangeListener |
+| [07-attribute-params](07-attribute-params.md) | 属性与 API 参数 | 属性命名、枚举值、参数格式、构造器参数、回调参数类型、空安全、臆造 API 清单、不存在的 API |
+| [08-navigation](08-navigation.md) | 导航与路由 | Navigation+NavDestination、多文件路由方案、pushPath param、转场约束 |
+| [09-dialog](09-dialog.md) | 对话框与半模态 | AlertDialog/ActionSheet/bindSheet/bindContextMenu、堆叠规则 |
+| [10-style](10-style.md) | 样式与主题 | @Extend/@Styles/stateStyles、模糊效果、clipShape、深色模式、@Extend 返回类型陷阱 |
+| [11-extension](11-extension.md) | 扩展能力与交互 | DrawModifier/GestureModifier/AttributeUpdater/NodeContainer/FrameNode、手势绑定、拖拽冲突、事件规则 |
+| [12-layout](12-layout.md) | 布局容器 | List/Grid/Tabs/WaterFlow 直接子组件约束、容器用法 |
+| [13-performance](13-performance.md) | 性能与可见性 | 状态变更、@Reusable/@Track、freeze、长列表策略、onVisibleAreaChange、渲染状态≠可见性 |
+| [14-deprecated](14-deprecated.md) | 废弃接口替换 | CustomDialogController/pageTransition/@ohos.*/static {} 替换 |
+
+## 编码检视清单
+
+### import 和模块
+- [ ] 所有 import 使用 `@kit.*` 路径（见 01-import）
+- [ ] import 的符号名和所属 kit 正确（见 01-import Kit导入速查表）
+- [ ] 不存在 import 了但未使用的模块
+- [ ] 不存在遗漏的 import
+
+### UIContext 和全局接口
+- [ ] router、promptAction、AlertDialog、animateTo、vp2px 等全局接口均通过 `this.getUIContext()` 调用（见 02-uicontext）
+
+### 状态管理
+- [ ] 所有状态变量声明了类型（见 00-arkts-syntax Types 节）
+- [ ] 每个装饰器用在正确的位置（见 05-state）
+- [ ] 避免 V1 与 V2 混用（见 05-state 混用节）
+- [ ] @Link / @ObjectLink 不存在本地初始化（见 05-state）
+- [ ] @Builder 按引用传递用单参数对象字面量；@Builder 内不修改入参（见 05-state）
+
+### 渲染控制
+- [ ] ForEach / LazyForEach 有第三个参数作为 key，且用业务 ID 不用索引（见 06-rendering）
+- [ ] dataSource 不重新赋值，通过 DataChangeListener 更新（见 06-rendering）
+
+### build() 函数
+- [ ] build() 中不存在本地变量声明、console.info、switch、三元表达式（见 04-build）
+- [ ] build() 中不直接改变状态变量（见 04-build）
+
+### 命名和嵌套
+- [ ] 变量名避开框架保留字（见 03-component 保留字全表）
+- [ ] 组件和变量命名避开框架内置组件和属性名（见 03-component）
+- [ ] 组件嵌套符合约束（List 内必须用 ListItem，Tabs 内必须用 TabContent）（见 12-layout）
+- [ ] **多页面生成时，所有顶层 interface/class 名必须带用例 ID 或页面名前缀**（防 arkts-no-decl-merging，见 03-component）
+
+### 属性参数
+- [ ] 不捏造属性名/枚举值（见 07-attribute-params 臆造API清单）
+- [ ] 回调参数类型用编译器声明的联合类型，不自行收窄（见 07-attribute-params）
+- [ ] 从回调 result/Map.get/Array.find/可选属性取值时做了空安全处理（?? 默认值或判空）（见 07-attribute-params / 00-arkts-syntax）
+- [ ] 传给组件构造/API 的对象字面量，字段名与 Options 类型逐字一致（见 07-attribute-params）
+
+### 导航
+- [ ] 路由跳转使用 Navigation 实现，不使用 Router（见 08-navigation）
+- [ ] pushPath 的 param 先声明 interface 类型变量，不内联字面量（见 08-navigation）
+
+### 废弃接口
+- [ ] 不使用 CustomDialogController、pageTransition、@ohos.* 导入（见 14-deprecated）
+
+### 代码风格
+- [ ] 组件/变量命名遵循 PascalCase/camelCase
+- [ ] 组件内部结构顺序：状态定义 → 属性 → 私有成员 → 生命周期 → 私有方法 → build()
+- [ ] 链式调用每个方法一行；逻辑语句加分号，UI 语句不加分号

package/resources/deveco/skills/hmos-runtime-fix-skill/.deveco-builtin

@@ -0,0 +1 @@
+hmos-runtime-fix-skill