@deveco-test/deveco-code 1.0.3 → 1.0.4

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/03-data-display.md

@@ -0,0 +1,81 @@
+## 3. 数据展示组件
+
+
+> **组件索引**：`Gauge`、`DataPanel`、`QRCode`、`CalendarPicker / TextClock / TextTimer 速查`
+
+### Gauge
+
+仪表盘组件。
+
+**构造：** `Gauge(options: GaugeOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| value | number | 是 | — | 当前值 |
+| min | number | 否 | 0 | 最小值 |
+| max | number | 否 | 100 | 最大值 |
+
+**属性方法：**
+
+| 方法 | 签名 | 默认值 | 说明 |
+|------|------|--------|------|
+| .value | `.value(value: number)` | — | 当前值 |
+| .startAngle | `.startAngle(value: number)` | 0 | 起始角度 |
+| .endAngle | `.endAngle(value: number)` | 360 | 结束角度 |
+| .colors | `.colors(value: Array)` | — | 颜色分段 |
+| .strokeWidth | `.strokeWidth(value: Length)` | 4vp | 线宽 |
+| .description | `.description(value: CustomBuilder)` | — | 描述区域 |
+| .trackShadow | `.trackShadow(value: ShadowOptions)` | — | 轨道阴影 |
+| .indicator | `.indicator(value: GaugeIndicatorOptions)` | — | 指示器 |
+
+---
+
+### DataPanel
+
+数据面板。
+
+**构造：** `DataPanel(options: DataPanelOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| values | number[] | 是 | — | 数据值(最多9项) |
+| max | number | 否 | 100 | 最大值 |
+| type | DataPanelType | 否 | Circle | 类型(Line/Circle) |
+
+**属性方法：**
+
+| 方法 | 签名 | 默认值 | 说明 |
+|------|------|--------|------|
+| .closeEffect | `.closeEffect(value: boolean)` | false | 关闭动效 |
+| .valueColors | `.valueColors(value: Array\<ResourceColor \| LinearGradient\>)` | — | 数据颜色 |
+| .trackBackgroundColor | `.trackBackgroundColor(value: ResourceColor)` | — | 轨道背景色 |
+| .strokeWidth | `.strokeWidth(value: Length)` | 24vp | 线宽 |
+| .trackShadow | `.trackShadow(value: ShadowOptions)` | — | 轨道阴影 |
+
+---
+
+### QRCode
+
+二维码组件。
+
+**构造：** `QRCode(value: string)`
+
+**属性方法：**
+
+| 方法 | 签名 | 默认值 | 说明 |
+|------|------|--------|------|
+| .color | `.color(value: ResourceColor)` | Black | 二维码颜色 |
+| .backgroundColor | `.backgroundColor(value: ResourceColor)` | White | 背景色 |
+| .contentOpacity | `.contentOpacity(value: number)` | 1.0 | 内容透明度 |
+
+---
+
+### CalendarPicker / TextClock / TextTimer 速查
+
+| 组件 | 构造签名 | 核心属性 | 核心事件 |
+|------|---------|---------|---------|
+| **CalendarPicker** | `CalendarPicker(options?: CalendarPickerOptions)` | `.selectedDate(Date)` `.edgeAlign(CalendarAlign)` `.startDate(Date)` `.endDate(Date)` | `.onDateChange(callback)` |
+| **TextClock** | `TextClock(options?: {timeZoneOffset?, is24Hour?})` | `.format(string)` | `.onDateChange(callback)` |
+| **TextTimer** | `TextTimer(options?: {isCountDown?, count?, controller?})` | `.format(string)` `.fontColor()` `.fontSize()` | `.onTimer(callback)` |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/04-selectors.md

@@ -0,0 +1,76 @@
+## 4. 选择器组件
+
+
+> **组件索引**：`DatePicker`、`TimePicker`、`TextPicker`、`PatternLock`、`Stepper / StepperItem 速查`
+
+### DatePicker
+
+日期选择器。
+
+**构造：** `DatePicker(options?: DatePickerOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| start | Date | 否 | 1970-1-1 | 起始日期 |
+| end | Date | 否 | 2100-12-31 | 结束日期 |
+| selected | Date | 否 | 当前日期 | 选中日期 |
+| lunar | boolean | 否 | false | 农历 |
+
+**属性方法：** `.lunar(boolean)`
+
+**事件：** `.onDateChange(callback)` `.onDateAccept(callback)`
+
+---
+
+### TimePicker
+
+时间选择器。
+
+**构造：** `TimePicker(options?: TimePickerOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| selected | Date | 否 | 当前时间 | 选中时间 |
+| useMilitaryTime | boolean | 否 | true | 24小时制 |
+
+**事件：** `.onChange(callback)`
+
+---
+
+### TextPicker
+
+文本选择器。
+
+**构造：** `TextPicker(options?: TextPickerOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| range | string[] \| Resource | 否 | — | 数据范围 |
+| selected | number | 否 | 0 | 选中索引 |
+| value | string | 否 | — | 选中值 |
+
+**属性方法：** `.canLoop(boolean)` `.defaultPickerItemHeight(number)`
+
+**事件：** `.onChange(callback)` `.onAccept(callback)`
+
+---
+
+### PatternLock
+
+图案密码锁。
+
+**构造：** `PatternLock(options?: PatternLockOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| controller | PatternLockController | 否 | — | 控制器 |
+| sideLength | number | 否 | 300vp | 边长 |
+| circleRadius | number | 否 | 14vp | 圆点半径 |
+| regularColor | ResourceColor | 否 | #FF182431 | 常规颜色 |
+| selectedColor | ResourceColor | 否 | #FF182431 | 选中颜色 |
+| activeColor | ResourceColor | 否 | #FF182431 | 激活颜色 |
+| pathColor | ResourceColor | 否 | #FF317AF7 | 路径颜色 |
+
+**属性方法：** `.autoReset(boolean)` `.challengeResult(PatternLockChallengeResult)`
+
+**事件：** `.onPatternComplete(callback: (input: number[]) => void)`

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/05-media.md

@@ -0,0 +1,60 @@
+## 5. 媒体与绘图组件
+
+### Video
+
+视频播放组件。
+
+**构造：** `Video(value: VideoOptions)`
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| src | string \| Resource | 是 | — | 视频源 |
+| currentProgressRate | number \| PlaybackSpeed | 否 | 1 | 播放倍速 |
+| previewUri | string \| Resource \| PixelMap | 否 | — | 预览图 |
+| controller | VideoController | 否 | — | 控制器 |
+
+**属性方法：**
+
+| 方法 | 签名 | 默认值 | 说明 |
+|------|------|--------|------|
+| .muted | `.muted(value: boolean)` | false | 静音 |
+| .autoPlay | `.autoPlay(value: boolean)` | false | 自动播放 |
+| .controls | `.controls(value: boolean)` | true | 显示控制栏 |
+| .loop | `.loop(value: boolean)` | false | 循环播放 |
+| .objectFit | `.objectFit(value: ImageFit)` | Cover | 填充方式 |
+
+**事件：**
+
+| 事件 | 签名 | 说明 |
+|------|------|------|
+| .onStart | `.onStart(event: () => void)` | 播放开始 |
+| .onPause | `.onPause(event: () => void)` | 暂停 |
+| .onFinish | `.onFinish(event: () => void)` | 播放完成 |
+| .onError | `.onError(event: () => void)` | 错误 |
+| .onPrepared | `.onPrepared(callback: Callback<PreparedInfo>)` | 准备完成，PreparedInfo 有 `.duration` 属性（秒） |
+| .onSeeking | `.onSeeking(callback: Callback<PlaybackInfo>)` | 拖动进度，PlaybackInfo 有 `.time` 属性（秒） |
+| .onUpdate | `.onUpdate(callback: Callback<PlaybackInfo>)` | 播放进度更新，PlaybackInfo 有 `.time` 属性（秒） |
+
+> 注意：onUpdate/onPrepared 回调参数是**对象**不是 number。不存在 onTimeUpdate。
+> 官方示例写法：`.onUpdate((e?: TimeObject) => { if (e) { let t = e.time } })`
+
+---
+
+### Canvas / Shape 绘图速查
+
+| 组件/接口 | 构造签名 | 核心方法/属性 |
+|-----------|---------|-------------|
+| **Canvas** | `Canvas(context?: CanvasRenderingContext2D)` | 子组件方式使用，context 提供 2D 绑定 |
+| **CanvasRenderingContext2D** | `new CanvasRenderingContext2D(settings?)` | `fillRect/strokeRect/clearRect/drawImage/fillText/strokeText/arc/beginPath/closePath/moveTo/lineTo/bezierCurveTo/quadraticCurveTo/rotate/scale/translate/save/restore/clip/createLinearGradient/createRadialGradient` |
+| **OffscreenCanvas** | `new OffscreenCanvas(width, height)` | 离屏渲染 |
+| **Path2D** | `new Path2D()` | `addPath/arc/arcTo/bezierCurveTo/ellipse/lineTo/moveTo/quadraticCurveTo/rect` |
+| **Shape** | `Shape(options?: {viewPort})` | `.fill()` `.stroke()` `.strokeWidth()` `.strokeDashArray()` `.strokeLineCap()` `.antiAlias()` |
+| **Rect** | `Rect(options?)` | `.width()` `.height()` `.radiusWidth()` `.radiusHeight()` `.fill()` `.stroke()` |
+| **Circle** | `Circle(options?)` | `.width()` `.height()` `.fill()` `.stroke()` |
+| **Ellipse** | `Ellipse(options?)` | `.width()` `.height()` `.fill()` `.stroke()` |
+| **Line** | `Line(options?)` | `.startPoint()` `.endPoint()` `.fill()` `.stroke()` `.strokeWidth()` |
+| **Polyline** | `Polyline(options?)` | `.points(Array\<Point\>)` `.fill()` `.stroke()` |
+| **Polygon** | `Polygon(options?)` | `.points(Array\<Point\>)` `.fill()` `.stroke()` |
+| **Path** | `Path(options?)` | `.commands(string)` `.fill()` `.stroke()` |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/06-advanced.md

@@ -0,0 +1,32 @@
+## 6. 高级/组合组件
+
+| 组件 | 构造签名 | 分类 | 核心说明 |
+|------|---------|------|---------|
+| **XComponent** | `XComponent({id, type: XComponentType, libraryname?, controller?})` | 渲染 | 支持 EGL/OpenGLES 渲染，type: surface/texture/component |
+| **RichEditor** | `RichEditor(options: {controller?: RichEditorController})` | 编辑 | 富文本编辑器，支持图文混排、自定义菜单 |
+| **RichText** | `RichText(content: string)` | 展示 | 富文本展示，支持 HTML 子集 |
+| **TreeView** | `TreeView({treeController, itemProvider})` | 树形 | 树形列表 |
+| **Chip** | `Chip(options: ChipOptions)` | 标签 | `{label?, icon?, allowClose?, enabled?, backgroundColor?}` |
+| **ChipGroup** | `ChipGroup(options)` | 标签组 | 管理多个 Chip |
+| **ComposeListItem** | `ComposeListItem(options)` | 列表项 | 组合列表项 |
+| **ComposeTitleBar** | `ComposeTitleBar(options)` | 标题栏 | 主标题栏 |
+| **EditableTitleBar** | `EditableTitleBar(options)` | 标题栏 | 可编辑标题栏 |
+| **SelectTitleBar** | `SelectTitleBar(options)` | 标题栏 | 选择型标题栏 |
+| **TabTitleBar** | `TabTitleBar(options)` | 标题栏 | Tab 型标题栏 |
+| **ToolBar / ToolBarV2** | `ToolBar(options)` / `ToolBarV2(options)` | 工具栏 | 底部工具栏 |
+| **SubHeader / SubHeaderV2** | `SubHeader(options)` | 子标题 | 分组标题 |
+| **Filter** | `Filter(options)` | 过滤器 | 筛选 |
+| **SwipeRefresher** | `SwipeRefresher(options)` | 刷新 | 下拉刷新 |
+| **SegmentButton / V2** | `SegmentButton(options)` | 分段按钮 | — |
+| **ProgressButton / V2** | `ProgressButton(options)` | 进度按钮 | — |
+| **DownloadFileButton** | `DownloadFileButton(options)` | 下载按钮 | — |
+| **ArcButton** | `ArcButton(options)` | 圆形按钮 | 手表端 |
+| **ArcSlider** | `ArcSlider(options)` | 圆形滑块 | 手表端 |
+| **SplitLayout** | `SplitLayout(options)` | 分栏布局 | — |
+| **FoldSplitContainer** | `FoldSplitContainer(options)` | 折叠分栏 | — |
+| **MultiNavigation** | `MultiNavigation(options)` | 多级导航 | — |
+| **GridObjectSortComponent** | `GridObjectSortComponent(options)` | 排序 | 网格排序 |
+| **ExceptionPrompt** | `ExceptionPrompt(options)` | 提示 | 异常提示 |
+| **FullScreenLaunchComponent** | `FullScreenLaunchComponent(options)` | 全屏启动 | — |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/07-security.md

@@ -0,0 +1,30 @@
+## 7. 安全组件
+
+### SaveButton / PasteButton
+
+免权限安全按钮。
+
+**构造：**
+
+```typescript
+SaveButton(options: SaveButtonOptions)
+PasteButton(options: PasteButtonOptions)
+```
+
+**通用属性方法 (Security 组件特有)：**
+
+| 方法 | 说明 |
+|------|------|
+| `.iconColor(color)` | 图标颜色 |
+| `.fontColor(color)` | 字体颜色 |
+| `.bgColor(color)` | 背景颜色 |
+| `.borderWidth(Length)` | 边框宽度 |
+| `.borderRadius(Length)` | 圆角 |
+| `.iconSize(Size)` | 图标尺寸 |
+| `.fontWeight(FontWeight)` | 字重 |
+| `.fontSize(Length)` | 字号 |
+| `.fontStyle(FontStyle)` | 字体样式 |
+| `.description(ResourceStr)` | 描述文本 |
+| `.textIconSpace(Length)` | 文字图标间距 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/08-state-decorators.md

@@ -0,0 +1,79 @@
+## 8. 状态管理装饰器
+
+
+> **组件索引**：`V1 装饰器`、`V1 全局状态 API`、`V2 装饰器 (API 12+)`、`V2 全局状态 API`
+
+### V1 装饰器
+
+| 装饰器 | 适用场景 | 装饰变量类型 | 说明 |
+|--------|---------|-------------|------|
+| **@State** | 组件内状态 | Object/class/string/number/boolean | 观察第一层属性变化，触发 UI 刷新 |
+| **@Prop** | 父→子单向 | 同 @State | 父组件单向传递，子组件本地副本 |
+| **@Link** | 父↔子双向 | 同 @State | 双向同步，需用 `$变量` 传递 |
+| **@Observed** | 类装饰器 | class | 观察类实例的嵌套属性变化 |
+| **@ObjectLink** | 嵌套对象 | @Observed 装饰的类实例 | 配合 @Observed 实现嵌套观测 |
+| **@Provide / @Consume** | 跨层级 | 同 @State | 祖先提供，后代消费 |
+| **@Watch** | 变量监听 | 追加在其他装饰器后 | `@Watch('onChanged')` 变化时回调 |
+| **@Builder** | UI 复用 | 函数 | 声明式 UI 描述函数。参数传递方式决定是否刷新（见下表） |
+| **@BuilderParam** | UI 插槽 | @Builder 函数 | 接收外部传入的 UI，类型必须与传入的 @Builder 匹配 |
+| **@LocalBuilder** | 本地 UI | 函数 | 不追踪外部依赖变化；@ComponentV2 中优先用 @LocalBuilder 替代 @Builder |
+
+**@Builder 参数传递方式速查**（完整错误用法对照见 `common-mistakes/12-builder-params.md`）：
+
+| 传递方式 | 调用形式 | 状态变量变化是否刷新 | 限制 |
+|---------|---------|-------------------|------|
+| 按值传递（默认） | `builder(this.label)` 或 `builder(label: string)` | ❌ 不刷新 | 简单类型参数默认按值 |
+| 按引用传递 | `builder({ paramA1: this.label })` 单参数对象字面量 | ✅ 刷新 | 仅 1 个参数且为对象字面量才生效；多参数不刷新 |
+| 按回调传递（API 20+） | `builder(UIUtils.makeBinding(() => this.x, setter))` | ✅ 刷新且可在 Builder 内修改 | 需传 SetterCallback 才能回写 |
+
+> ⚠️ 高频坑：按值传状态变量不刷新 / 两个及以上参数不刷新 / @Builder 内改入参报 140109 / @Builder 内建组件传整个对象不刷新。
+| **@Extend** | 样式扩展 | 组件类型 | `@Extend(Text) function myStyle() {}` |
+| **@Styles** | 通用样式 | 无参 | `@Styles function myStyles() {}` |
+| **@StateStyles** | 多态样式 | — | {normal, pressed, disabled, focused, selected} |
+| **@AnimatableExtend** | 动画扩展 | 可动画属性 | 自定义可动画扩展 |
+| **@Reusable** | 组件复用 | @Component | 实现 `aboutToReuse` |
+| **@Require** | 必填参数 | 变量 | 标记参数为必填 |
+
+### V1 全局状态 API
+
+| API | 签名/用法 | 说明 |
+|-----|----------|------|
+| **AppStorage** | `.setOrCreate(key, value)` `.get(key)` `.set(key)` `.delete(key)` | 应用级全局状态 |
+| **@StorageLink** | `@StorageLink('key') var: type` | 与 AppStorage 双向同步 |
+| **@StorageProp** | `@StorageProp('key') var: type` | 与 AppStorage 单向同步 |
+| **LocalStorage** | `new LocalStorage()` `.setOrCreate()` `.get()` | 页面/模块级状态 |
+| **@LocalStorageLink** | `@LocalStorageLink('key') var: type` | 与 LocalStorage 双向同步 |
+| **@LocalStorageProp** | `@LocalStorageProp('key') var: type` | 与 LocalStorage 单向同步 |
+| **PersistentStorage** | `.persistProp('key', default)` `.deleteProp()` | 持久化存储 |
+| **Environment** | `.envProp('key', value)` | 环境变量 |
+
+### V2 装饰器 (API 12+)
+
+| 装饰器 | 适用场景 | 说明 |
+|--------|---------|------|
+| **@Local** | 组件内状态 | 替代 @State |
+| **@Param** | 父→子传递 | 替代 @Prop/@Link |
+| **@Once** | 追加 @Param | 仅初始化同步一次 |
+| **@Event** | 子→父回调 | `@Event onValueChange: (val) => void` |
+| **@Provider / @Consumer** | 跨层级 | V2 版 |
+| **@Monitor** | 属性监听 | `@Monitor('p1','p2') onPChange(mon: IMonitor) {}` |
+| **@SyncMonitor** | 同步监听 | 同步版本 |
+| **@Computed** | 计算属性 | `@Computed get name(): string {}` |
+| **@ObservedV2** | 类装饰器 | V2 版深度观测 |
+| **@Trace** | 属性追踪 | `@Trace name: string = ''` |
+| **@Type** | 类型标记 | 序列化类型 |
+| **@ReusableV2** | 组件复用 | V2 版 |
+| **@Binding** | 双向绑定 | V2 版双向绑定 |
+
+### V2 全局状态 API
+
+| API | 签名 | 说明 |
+|-----|------|------|
+| **AppStorageV2** | `.connect(this, 'key', type?)` | V2 应用级状态 |
+| **PersistenceV2** | `.connect(this, 'key', type?)` | V2 持久化 |
+| **makeObserved** | `makeObserved(target)` | 将对象变为可观测 |
+| **canBeObserved** | `canBeObserved(target)` | 判断是否可观测 |
+| **getTarget** | `getTarget(proxy)` | 获取 Proxy 原始对象 |
+| **addMonitor / clearMonitor** | `addMonitor(obj, prop, cb)` / `clearMonitor(id)` | 动态监听 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/09-animation.md

@@ -0,0 +1,111 @@
+## 9. 动画 API
+
+
+> **组件索引**：`属性动画`、`动画曲线`、`转场动画`、`帧动画`
+
+### 属性动画
+
+| API | 签名 | 参数说明 |
+|-----|------|---------|
+| **animateTo** | `animateTo(value: AnimateParam, event: () => void)` | 显式动画 |
+
+> **核心语义**：`event` 闭包内必须放**状态变更**（如 `this.width = 200`），框架会对闭包内的状态变化自动插入过渡动画。闭包内不放状态变更则无动画效果。
+>
+> **推荐写法**：`this.getUIContext()?.animateTo({ duration: 1000, curve: Curve.EaseOut }, () => { this.widthSize = 200 })`
+>
+> **注意**：全局 animateTo 已从 API 18 开始废弃，推荐通过 `this.getUIContext().animateTo()` 调用。禁止在 aboutToAppear/aboutToDisappear 中调用动画。
+| **animateToImmediately** | `animateToImmediately(value: AnimateParam, event: () => void)` | 立即播放 |
+| **.animation** | `.animation(value: AnimateParam)` | 隐式属性动画(链式) |
+| **keyframeAnimateTo** | `keyframeAnimateTo(context, keyframes, options?)` | 关键帧动画 |
+
+> **关键约束**：`.animation()` 必须放在**被动画属性之后**，且它会作用于该组件上**所有**属性变化（不只是前一个）。建议只对需要动画的属性链末尾添加 `.animation()`，避免不相关的属性变化也被动画化。
+
+**AnimateParam：**
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| duration | number | 1000 | 时长(ms) |
+| curve | Curve \| ICurve | Ease | 曲线 |
+| delay | number | 0 | 延迟(ms) |
+| iterations | number | 1 | 迭代次数 |
+| playMode | PlayMode | Normal | 播放模式 |
+| tempo | number | 1.0 | 速率 |
+| direction | AnimationDirection | — | 方向 |
+| fill | FillMode | None | 填充模式 |
+| onFinish | () => void | — | 完成回调 |
+
+### 动画曲线
+
+> **注意：** `curves.springCurve` 需要 **4 个参数** `(velocity, mass, stiffness, damping)`，如 `curves.springCurve(10, 1, 228, 30)`，不能只传 2 个。不存在 `curves.easeInOut()`，缓动用 `curves.initCurve(Curve.EaseInOut)`。
+>
+> **命名空间区别**：`curves.*`（如 curves.springCurve）需要 `import { curves } from '@kit.ArkUI'`；`Curve.*`（如 Curve.EaseInOut）是全局枚举，不需要 import。
+
+| 曲线 | 签名 | 说明 |
+|------|------|------|
+| **预设曲线** | `Curve.Linear/Ease/EaseIn/EaseOut/EaseInOut/FastOutSlowIn/...` | 13种预设 |
+| **贝塞尔** | `Curve.cubicBezierCurve(x1,y1,x2,y2)` | 三阶贝塞尔 |
+| **弹簧** | `curves.springCurve(velocity,mass,stiffness,damping)` | **必须 4 参数**，需 `import { curves } from '@kit.ArkUI'` |
+| **弹簧运动** | `Curve.springMotion(response?,dampingFraction?,velocity?)` | 弹簧物理运动 |
+| **响应弹簧** | `Curve.responsiveSpringMotion(response?,dampingFraction?,velocity?)` | 响应式 |
+| **插值弹簧** | `Curve.interpolatingSpring(velocity,mass,stiffness,damping)` | 插值弹簧 |
+| **自定义** | `Curve.customCurve(interpolate: (t) => number)` | 自定义 |
+| **初始化曲线** | `curves.initCurve(Curve.EaseInOut)` | 获取预设曲线实例 |
+
+### 转场动画
+
+| API | 签名 | 说明 |
+|-----|------|------|
+| **.transition** | `.transition(value: TransitionEffect \| TransitionOptions)` | 出现/消失过渡 |
+| **TransitionEffect** | `.OPACITY / .SLIDE / .FADE / .MOVE / .ROTATE / .SCALE / .ASYMMETRIC / .IDENTITY` | 可组合 |
+
+### TransitionEffect 组合用法
+
+通过 `.combine()` 链式组合多个转场效果，通过 `.animation()` 指定动画参数：
+
+```typescript
+// 组合多个效果
+TransitionEffect.OPACITY
+  .combine(TransitionEffect.scale({ x: 0, y: 0 }))
+  .combine(TransitionEffect.rotate({ angle: 90 }))
+  .animation({ duration: 300, curve: Curve.Friction })
+
+// 非对称转场（出现和消失不同效果）
+TransitionEffect.asymmetric(
+  TransitionEffect.scale({ x: 0, y: 0 }),  // 出现效果
+  TransitionEffect.rotate({ angle: 90 })    // 消失效果
+)
+
+// 从边缘滑入
+TransitionEffect.move(TransitionEdge.END)  // TransitionEdge: TOP/BOTTOM/START/END
+```
+
+可用效果：OPACITY, SLIDE, scale({x,y}), rotate({angle}), opacity(value), translate({x,y}), move(TransitionEdge), asymmetric(appear, disappear)
+组合方法：`.combine(otherEffect)` 链式调用
+动画参数：`.animation({ duration, curve, delay })` 可附加在任何效果上
+
+| **.sharedTransition** | `.sharedTransition(id, options?)` | 共享元素转场 |
+| **.geometryTransition** | `.geometryTransition(id, options?)` | 几何转场 |
+| **PageTransition** | `PageTransitionEnter / PageTransitionExit` | 页面转场 |
+
+### PageTransition 用法
+
+```typescript
+// 页面入场
+PageTransitionEnter({ duration: 500, curve: Curve.EaseOut })
+  .slide(SlideEffect.Right)
+
+// 页面出场
+PageTransitionExit({ duration: 500, curve: Curve.EaseIn })
+  .slide(SlideEffect.Left)
+```
+
+SlideEffect 枚举：Left / Right / Up / Down
+
+### 帧动画
+
+| API | 签名 | 说明 |
+|-----|------|------|
+| **Animator** | `animator.create({duration, easing, delay, fill, direction, iterations, begin, end})` | 创建动画 |
+| **AnimatorResult** | `.play()` `.pause()` `.cancel()` `.reverse()` `.finish()` | 控制方法 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/10-gesture.md

@@ -0,0 +1,59 @@
+## 10. 手势与事件
+
+
+> **组件索引**：`基础手势`、`组合手势`、`手势绑定`、`通用事件`、`拖拽事件`
+
+### 基础手势
+
+| 手势 | 构造签名 | 参数 |
+|------|---------|------|
+| **TapGesture** | `TapGesture(value?: number)` | `count?:1` `fingers?:1` |
+| **LongPressGesture** | `LongPressGesture(options?)` | `fingers?:1` `repeat?:true` `duration?:500` |
+| **PanGesture** | `PanGesture(options?)` | `fingers?:1` `distance?:5vp` `direction?:All` |
+| **PinchGesture** | `PinchGesture(options?)` | `fingers?:2` `distance?:3vp` |
+| **RotationGesture** | `RotationGesture(options?)` | `fingers?:2` `angle?:1deg` |
+| **SwipeGesture** | `SwipeGesture(options?)` | `fingers?:1` `direction?:All` `speed?:100` |
+
+### 组合手势
+
+| 类型 | 签名 | 说明 |
+|------|------|------|
+| **GestureGroup** | `GestureGroup(mode: GestureMode, ...gestures)` | Sequence/Parallel/Exclusive |
+
+### 手势绑定
+
+| 方法 | 说明 |
+|------|------|
+| `.gesture(gesture, mask?)` | 绑定手势(子组件优先) |
+| `.priorityGesture(gesture, mask?)` | 优先于子组件 |
+| `.parallelGesture(gesture, mask?)` | 与子组件并行 |
+
+### 通用事件
+
+| 事件 | 签名 | 说明 |
+|------|------|------|
+| .onClick | `.onClick((event: ClickEvent) => void)` | 点击，ClickEvent: {x,y,timestamp,target,source} |
+| .onTouch | `.onTouch((event: TouchEvent) => void)` | 触摸，TouchEvent: {touches,changedTouches,type} |
+| .onHover | `.onHover((isHover, event) => void)` | 鼠标悬停 |
+| .onMouse | `.onMouse((event: MouseEvent) => void)` | 鼠标事件 |
+| .onKeyEvent | `.onKeyEvent((event: KeyEvent) => void)` | 按键事件 |
+| .onFocus | `.onFocus(() => void)` | 获取焦点 |
+| .onBlur | `.onBlur(() => void)` | 失去焦点 |
+| .onAppear | `.onAppear(() => void)` | 挂载 |
+| .onDisappear | `.onDisappear(() => void)` | 卸载 |
+| .onAreaChange | `.onAreaChange((old, new) => void)` | 区域变化 |
+| .onSizeChange | `.onSizeChange((old, new) => void)` | 尺寸变化 |
+| .onVisibleChange | `.onVisibleChange((isVisible) => void)` | 可见性变化 |
+
+### 拖拽事件
+
+| 事件 | 签名 | 说明 |
+|------|------|------|
+| .onDragStart | `.onDragStart((event) => CustomBuilder \| DragItemInfo)` | 拖拽开始 |
+| .onDragEnter | `.onDragEnter((event) => void)` | 拖入 |
+| .onDragMove | `.onDragMove((event) => void)` | 移动 |
+| .onDragLeave | `.onDragLeave((event) => void)` | 离开 |
+| .onDrop | `.onDrop((event) => void)` | 释放 |
+| .onDragEnd | `.onDragEnd((event) => void)` | 结束 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/11-dialog-menu.md

@@ -0,0 +1,92 @@
+## 11. 弹窗/菜单/模态
+
+
+> **组件索引**：`弹窗 API`、`菜单`、`Popup`、`模态`
+
+### 弹窗 API
+
+| API | 签名 | 核心参数 |
+|-----|------|---------|
+| **AlertDialog** | `AlertDialog.show(options)` | `{title?, message, alignment?, primaryButton?, secondaryButton?, buttons?[]}` |
+| **ActionSheet** | `ActionSheet.show(options)` | `{title, message?, confirm, cancel?, sheets: SheetInfo[]}` |
+| **CustomDialog** | `new CustomDialogController(options)` | `{builder, alignment?, autoCancel?, customStyle?}`；调用 `.open()` `.close()` |
+| **Toast** | `promptAction.showToast({message, duration?, bottom?})` | `{message, duration?, bottom?, showMode?}` |
+| **DatePickerDialog** | `DatePickerDialog.show(options)` | `{start?, end?, selected?, lunar?, onDateAccept?: (value: Date) => void, onDateChange?: (value: Date) => void}` |
+| **TimePickerDialog** | `TimePickerDialog.show(options)` | `{selected?, useMilitaryTime?, onAccept?: (value: TimePickerResult) => void}` |
+| **TextPickerDialog** | `TextPickerDialog.show(options)` | `{range, selected?, onAccept?: (value: TextPickerResult) => void}` |
+| **CalendarPickerDialog** | `CalendarPickerDialog.show(options)` | `{selected?, onAccept?: (value: Date) => void, onCancel?, onChange?: (value: Date) => void}` |
+
+**AlertDialog 按钮结构：**
+
+> **按钮结构**：`{ value: string, action?: () => void, enabled?: boolean, defaultFocus?: boolean, style?: DialogButtonStyle }`
+> ⚠️ 用 `value` 不用 `text`（AI 常误写为 text）
+
+- AlertDialog 的 primaryButton/secondaryButton 和 buttons 数组中每个元素用 **`value`** 不是 `text`：`{ value: '确定', action: () => {} }`
+- ActionSheet 的选项列表用 **`sheets`** 不是 `buttons`，每个选项用 **`title`** 不是 `text`：`{ title: '选项', icon?, action }`
+- confirm 字段也是 `{ value, action }` 格式
+
+### CustomDialogController 使用模式（两步）
+
+步骤 1：用 @CustomDialog 装饰器定义弹窗组件
+```typescript
+@CustomDialog
+struct MyDialog {
+  controller: CustomDialogController
+  
+  build() {
+    Column() {
+      Text('对话框内容')
+      Button('关闭')
+        .onClick(() => { this.controller.close() })
+    }
+  }
+}
+```
+
+步骤 2：在父组件中创建控制器并调用
+```typescript
+@Component
+struct Parent {
+  dialogController: CustomDialogController = new CustomDialogController({
+    builder: MyDialog(),
+    alignment: DialogAlignment.Center,
+    autoCancel: true,
+    customStyle: false
+  })
+  
+  build() {
+    Button('打开弹窗')
+      .onClick(() => { this.dialogController.open() })
+  }
+}
+```
+
+> **注意**：CustomDialogController 只能在 @Component/@ComponentV2 struct 内部定义并赋值才有效。控制器必须在 @CustomDialog 组件中声明为属性才能调用 close()。
+
+### 菜单
+
+| 组件/方法 | 签名 | 核心参数 |
+|-----------|------|---------|
+| **MenuItem** | `MenuItem(options)` | `{value, icon?, startIcon?, endIcon?, selected?, onChange?}` |
+| **MenuItemGroup** | `MenuItemGroup(options)` | `{header?, footer?}` |
+| **.bindMenu** | `.bindMenu(content: MenuElement[] \| CustomBuilder)` | 绑定菜单 |
+| **.bindContextMenu** | `.bindContextMenu(content, responseType)` | 右键/长按菜单，responseType：`ResponseType.LongPress` / `ResponseType.RightClick` |
+
+### Popup
+
+| 方法 | 签名 | 核心参数 |
+|------|------|---------|
+| **.bindPopup** | `.bindPopup(show: boolean, options)` | `{message, placement?, offset?, showInSubWindow?, mask?, onStateChange?}` |
+
+> **bindPopup 回调注意：** `onStateChange` 回调参数是 `{ isVisible: boolean }` **对象**，不是原始 boolean。正确写法：`onStateChange: (event: PopupStateEvent) => { this.show = event.isVisible }`
+
+### 模态
+
+| 方法 | 签名 | 核心参数 |
+|------|------|---------|
+| **.bindSheet** | `.bindSheet($$isShow, builder, options?)` | options: `{detents?, height?, preferType?, dragBar?, backgroundColor?, blurStyle?, title?, showInSubWindow?, enableOutsideInteractive?, onWillDismiss?, onWillAppear?, onAppear?, onWillDisappear?, onDisappear?}`。注意：没有 `sheetSize` 字段，用 `detents` 或 `height` |
+| **.bindContentCover** | `.bindContentCover(isShow, builder, options?)` | `{modalTransition?}` |
+
+> **⚠️ $$ 双向绑定必须**：第一个参数必须用 `$$this.showXxx`，不能用 `this.showXxx`。只有用 $$ 绑定，设置 showXxx = false 时面板才会关闭。
+
+---