mn-docs-mcp 0.6.1 → 1.0.0

package/src/content/docs/reference/uikit/uibutton.md

@@ -19,7 +19,7 @@ description: 按钮控件，需通过 addTargetActionForControlEvents 绑定点
 | `setTitleColorForState(color, state)` | 设置标题颜色。 |
 | `setImageForState(image, state)` | 设置图片。 |
 | `setBackgroundImageForState(image, state)` | 设置背景图。 |
-| `addTargetActionForControlEvents(target, action, event)` | target 通常为 self，action 为 'methodName:'，event 1<<6 为点击。 |
+| `addTargetActionForControlEvents(target, action, event)` | target 为 self，action 为 'methodName:'，event 1<<6 为点击。 |
 
 ## 相关
 

package/src/content/docs/reference/uikit/uicollection-view-cell.md

@@ -1,22 +1,22 @@
 ---
 title: UICollectionViewCell
-description: UICollectionView 的基础单元格类型。在插件运行时主要作为参数/返回值类型出现。
+description: UICollectionView 的基础单元格类型。主要作为参数/返回值类型出现。
 ---
 
-`UICollectionViewCell` 是 `UICollectionView` 的单元格类型，通常由 `UICollectionView` 通过复用机制创建并返回。
+`UICollectionViewCell` 是 `UICollectionView` 的单元格类型，默认由 `UICollectionView` 通过复用机制创建并返回。
 
-在当前插件运行时环境中，`UICollectionViewCell` **没有额外暴露专属的可调用成员**（即不提供区别于其父类/通用视图的新增属性或方法）。因此它更多用于：
+在当前插件环境中，`UICollectionViewCell` **没有额外暴露专属的可调用成员**（即不提供区别于其父类/通用视图的新增属性或方法）。因此它更多用于：
 
 - 作为 `UICollectionView.cellForItemAtIndexPath(...)` 等方法的返回值类型
 - 作为 `indexPathForCell(cell)` 等查询方法的入参类型
 
 ## 实例成员 (Instance members)
 
-当前运行时未额外暴露 `UICollectionViewCell` 的实例成员。
+当前接口未额外暴露 `UICollectionViewCell` 的实例成员。
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UICollectionViewCell` 的类成员。
+当前接口未额外暴露 `UICollectionViewCell` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uicollection-view-controller.md

@@ -5,6 +5,16 @@ description: 承载 UICollectionView 的控制器。可通过布局初始化并
 
 `UICollectionViewController` 继承自 [UIViewController](/reference/uikit/uiview-controller/)，用于管理一个 `UICollectionView` 实例与其布局对象，适合在插件中以“控制器 + view”的方式复用界面逻辑。
 
+## 推荐创建路径
+
+当前插件环境下，更稳定的路径是：
+
+1. 创建`UICollectionViewFlowLayout`并先设置固定参数，如`itemSize`、`sectionInset`、`minimumLineSpacing`。
+2. 使用`initWithCollectionViewLayout(layout)`创建`UICollectionViewController`。
+3. 通过`controller.collectionView`取得实例，完成`registerClass...`、`dataSource/delegate`绑定与`reloadData()`。
+
+相比之下，直接走`UICollectionView`的`initWithFrame:collectionViewLayout:`路径在当前桥接里不稳定，不建议作为主路径。
+
 ## 实例成员 (Instance members)
 
 ### 属性
@@ -22,11 +32,21 @@ description: 承载 UICollectionView 的控制器。可通过布局初始化并
 | --- | --- | --- | --- |
 | `initWithCollectionViewLayout(layout)` | layout: UICollectionViewLayout | id | 以指定布局初始化。 |
 
+### 数据源最小实现
+
+至少实现以下方法：
+
+- `numberOfSectionsInCollectionView`
+- `collectionView:numberOfItemsInSection:`
+- `collectionView:cellForItemAtIndexPath:`
+
+`dataSource/delegate`使用`JSB.defineClass`导出的实例对象承载，以确保selector映射稳定。
+
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UICollectionViewController` 的类成员。
+当前接口未额外暴露 `UICollectionViewController` 的类成员。
 
 ## 相关
 
 - [UIViewController](/reference/uikit/uiview-controller/)
-- [UICollectionView](/reference/uikit/uicollection-view/)、[UICollectionViewLayout](/reference/uikit/uicollection-view-layout/)
+- [UICollectionView](/reference/uikit/uicollection-view/)、[UICollectionViewLayout](/reference/uikit/uicollection-view-layout/)、[UICollectionViewFlowLayout](/reference/uikit/uicollection-view-flow-layout/)

package/src/content/docs/reference/uikit/uicollection-view-flow-layout.md

@@ -0,0 +1,54 @@
+---
+title: UICollectionViewFlowLayout
+description: UICollectionView的流式布局。常用于固定网格参数配置。
+---
+
+`UICollectionViewFlowLayout`是`UICollectionViewLayout`的常用子类，用于按行列流式排布cell。插件场景优先使用固定`itemSize/sectionInset/minimumLineSpacing`方案。
+
+## 使用规范
+
+- 更稳定的创建路径是：先创建`UICollectionViewFlowLayout`，再用`UICollectionViewController.initWithCollectionViewLayout(layout)`拿到`collectionView`。
+- `initWithFrame:collectionViewLayout:`在当前桥接里不稳定，不建议作为主路径。
+- 动态尺寸回调例如`sizeForItemAtIndexPath`在JS桥接里风险较高，后置。
+
+## 实例成员 (Instance members)
+
+### 属性
+
+| 属性 | 类型 | 说明 |
+| --- | --- | --- |
+| `itemSize` | [`CGSize`](/reference/value-sturct/#cgsize) | 单个item尺寸。 |
+| `sectionInset` | [`UIEdgeInsets`](/reference/value-sturct/#uiedgeinsets) | section内边距。 |
+| `minimumLineSpacing` | number | 最小行间距。 |
+| `minimumInteritemSpacing` | number | 最小item间距。 |
+| `headerReferenceSize` | [`CGSize`](/reference/value-sturct/#cgsize) | 头部参考尺寸。 |
+| `footerReferenceSize` | [`CGSize`](/reference/value-sturct/#cgsize) | 尾部参考尺寸。 |
+| `invalidateFlowLayoutAttributes` | boolean | 只读。布局属性是否失效。 |
+| `invalidateFlowLayoutDelegateMetrics` | boolean | 只读。delegate度量是否失效。 |
+
+### 方法
+
+| 方法 | 参数 | 返回值 | 说明 |
+| --- | --- | --- | --- |
+| `invalidateLayout()` | — | void | 标记布局失效并触发重算。 |
+| `prepareLayout()` | — | void | 布局准备阶段。 |
+| `layoutAttributesForElementsInRect(rect)` | rect: [`CGRect`](/reference/value-sturct/#cgrect) | NSArray | 返回区域内元素布局属性。 |
+| `collectionViewContentSize()` | — | [`CGSize`](/reference/value-sturct/#cgsize) | 返回内容尺寸。 |
+
+## 类成员 (Class members)
+
+| 成员 | 返回值 | 说明 |
+| --- | --- | --- |
+| `layoutAttributesClass()` | Class | 返回布局属性类。 |
+| `invalidationContextClass()` | Class | 返回失效上下文类。 |
+
+## 问题排查
+
+- 创建成功但不显示时，优先检查`frame/bounds`是否为0、`itemSize`是否为0、是否已挂到可见view层级。
+- `registerClass...`缺失或`reuseId`不一致会导致`dequeue`失败。
+
+## 相关
+
+- [UICollectionView](/reference/uikit/uicollection-view/)
+- [UICollectionViewController](/reference/uikit/uicollection-view-controller/)
+- [UICollectionViewLayout](/reference/uikit/uicollection-view-layout/)

package/src/content/docs/reference/uikit/uicollection-view-layout.md

@@ -3,7 +3,13 @@ title: UICollectionViewLayout
 description: UICollectionView 的布局基类。负责提供元素布局属性、内容尺寸与滚动目标位置等。
 ---
 
-`UICollectionViewLayout` 用于为 [UICollectionView](/reference/uikit/uicollection-view/) 计算布局信息。插件运行时暴露了一组用于布局生命周期、注册 decoration view、查询布局属性与计算内容尺寸/目标偏移的成员。
+`UICollectionViewLayout` 用于为 [UICollectionView](/reference/uikit/uicollection-view/) 计算布局信息。插件环境暴露了一组用于布局生命周期、注册 decoration view、查询布局属性与计算内容尺寸/目标偏移的成员。
+
+## 接口状态
+
+`UICollectionViewLayout`类本身可见，但直接构造路径不稳定。实践上优先通过现有`UICollectionView`实例读取`collectionViewLayout`，不要在插件里直接新建布局实例。
+
+在插件里做首版网格列表时，优先使用`UICollectionViewFlowLayout`并设置固定`itemSize/sectionInset/minimumLineSpacing`。`sizeForItemAtIndexPath`这类动态尺寸路径在JS桥接里风险较高，后置。
 
 ## 实例成员 (Instance members)
 
@@ -28,7 +34,7 @@ description: UICollectionView 的布局基类。负责提供元素布局属性
 | `hidden` | boolean | 是否隐藏。 |
 | `zIndex` | number | zIndex。 |
 
-> 注意：以上属性中一部分在系统 UIKit 的语义上更常见于“布局属性对象”。这里以**插件运行时实际暴露**为准进行记录；如果你只在运行时把它当作数据结构读写，也完全可行。
+> 注意：本页记录的是 `JSBUICollectionViewLayout` 已导出的属性与方法。插件中按本页清单调用，不再扩展解释为其它对象语义。
 
 ### 方法
 
@@ -56,5 +62,6 @@ description: UICollectionView 的布局基类。负责提供元素布局属性
 ## 相关
 
 - [UICollectionView](/reference/uikit/uicollection-view/)
+- [UICollectionViewFlowLayout](/reference/uikit/uicollection-view-flow-layout/)
 - [UICollectionViewLayoutAttributes](/reference/uikit/uicollection-view-layout-attributes/)
 - [NSIndexPath](/reference/foundation/ns-index-path/)、[NSArray](/reference/foundation/ns-array/)

package/src/content/docs/reference/uikit/uicollection-view.md

@@ -3,7 +3,12 @@ title: UICollectionView
 description: 网格/瀑布流式列表视图。支持注册与复用 cell、批量更新、查询布局属性与可见项。
 ---
 
-`UICollectionView` 是用于展示大量条目的滚动视图，继承自 [UIScrollView](/reference/uikit/uiscrollview/)。在插件运行时通常配合 `dataSource` 与 `collectionViewLayout` 使用，通过“注册 → 复用”机制创建 cell，并在需要时对 section/item 做增删改或批量更新。
+`UICollectionView` 是用于展示大量条目的滚动视图，继承自 [UIScrollView](/reference/uikit/uiscrollview/)。默认配合 `dataSource` 与 `collectionViewLayout` 使用，通过“注册 → 复用”机制创建 cell，并在需要时对 section/item 做增删改或批量更新。
+
+## 使用规范
+
+- 优先通过`UICollectionViewController.initWithCollectionViewLayout(...)`创建并拿到`collectionView`，不要把`UICollectionView`直接构造作为主路径。
+- 首版优先固定尺寸布局，动态尺寸回调在JS桥接里稳定性较差。
 
 ## 实例成员 (Instance members)
 
@@ -11,7 +16,7 @@ description: 网格/瀑布流式列表视图。支持注册与复用 cell、批
 
 | 属性 | 类型 | 说明 |
 | --- | --- | --- |
-| `item` | number | 只读。运行时暴露的整数属性（常见于布局/交互状态字段）。 |
+| `item` | number | 只读。插件环境暴露的整数属性（常见于布局/交互状态字段）。 |
 | `backgroundView` | UIView | 背景视图。 |
 | `allowsMultipleSelection` | boolean | 是否允许多选。 |
 | `allowsSelection` | boolean | 是否允许选中。 |
@@ -27,6 +32,8 @@ description: 网格/瀑布流式列表视图。支持注册与复用 cell、批
 | `dequeueReusableCellWithReuseIdentifierForIndexPath(identifier, indexPath)` | identifier: string, indexPath: NSIndexPath | id | 取出复用 cell。 |
 | `dequeueReusableSupplementaryViewOfKindWithReuseIdentifierForIndexPath(elementKind, identifier, indexPath)` | elementKind: string, identifier: string, indexPath: NSIndexPath | id | 取出复用 supplementary view。 |
 
+> 失败场景：未先`registerClass...`或`identifier`不一致会导致`dequeue`失败。
+
 ### 选择与可见项
 
 | 方法 | 参数 | 返回值 | 说明 |
@@ -46,6 +53,8 @@ description: 网格/瀑布流式列表视图。支持注册与复用 cell、批
 | `finishInteractiveTransition()` | — | void | 结束交互式转场。 |
 | `cancelInteractiveTransition()` | — | void | 取消交互式转场。 |
 
+> 创建后不显示时，优先检查`frame/bounds`是否为0、`itemSize`是否为0、是否已加入可见view层级。
+
 ### 查询
 
 | 方法 | 参数 | 返回值 | 说明 |
@@ -56,7 +65,7 @@ description: 网格/瀑布流式列表视图。支持注册与复用 cell、批
 | `layoutAttributesForSupplementaryElementOfKindAtIndexPath(kind, indexPath)` | kind: string, indexPath: NSIndexPath | UICollectionViewLayoutAttributes | 获取 supplementary element 的布局属性。 |
 | `indexPathForItemAtPoint(point)` | point: { x: number, y: number } | NSIndexPath \| null | 根据点坐标反查 item 的 indexPath。 |
 | `indexPathForCell(cell)` | cell: UICollectionViewCell | NSIndexPath \| null | 根据 cell 反查 indexPath。 |
-| `cellForItemAtIndexPath(indexPath)` | indexPath: NSIndexPath | UICollectionViewCell \| null | 返回当前已创建并可见的 cell（不可见则可能为 null）。 |
+| `cellForItemAtIndexPath(indexPath)` | indexPath: NSIndexPath | UICollectionViewCell \| null | 返回当前已创建并可见的 cell（不可见则为 null）。 |
 
 ### 增删改与批量更新
 
@@ -74,7 +83,7 @@ description: 网格/瀑布流式列表视图。支持注册与复用 cell、批
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UICollectionView` 的类成员。
+当前接口未额外暴露 `UICollectionView` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uicolor.md

@@ -7,7 +7,7 @@ description: 颜色对象，用于视图背景、文本等。
 
 ## 实例成员 (Instance members)
 
-`UIColor` 的实例通常作为“值对象”被传递与使用（例如赋给 `UIView.backgroundColor`、`UILabel.textColor`、`CALayer.borderColor` 等）。如果你需要把颜色转换为可读字符串，可关注运行时是否提供 `stringValue` / `hexStringValue` 等只读属性（站内搜索即可定位）。
+`UIColor` 的实例默认作为“值对象”被传递与使用（例如赋给 `UIView.backgroundColor`、`UILabel.textColor`、`CALayer.borderColor` 等）。如果你需要把颜色转换为可读字符串，可关注插件环境是否提供 `stringValue` / `hexStringValue` 等只读属性（站内搜索即可定位）。
 
 ## 类成员 (Class members)
 

package/src/content/docs/reference/uikit/uicontrol.md

@@ -7,14 +7,12 @@ description: 控件基类（target/action 事件机制）。
 
 ## 实例成员 (Instance members)
 
-`UIControl` 的核心是事件绑定与派发：你通常会在控件实例上调用 `addTargetAction...` / `removeTargetAction...` / `sendActionsForControlEvents...` 等成员（具体名称以运行时实际暴露为准，可站内搜索定位）。
+`UIControl` 的核心是事件绑定与派发。标准调用入口是 `addTargetActionForControlEvents(...)`、`removeTargetActionForControlEvents(...)` 与 `sendActionsForControlEvents(...)`。
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIControl` 的类成员。
+当前接口未额外暴露 `UIControl` 的类成员。
 
 ## 提示
 
-- 常用方法集中在 `addTargetAction(...)` / `removeTargetAction(...)` / `sendActionsForControlEvents(...)` 等。
-- 具体成员建议用站内搜索成员名。
-
+- 常用方法集中在 `addTargetActionForControlEvents(...)`、`removeTargetActionForControlEvents(...)` 与 `sendActionsForControlEvents(...)`。

package/src/content/docs/reference/uikit/uidate-picker.md

@@ -29,7 +29,7 @@ description: 日期/时间选择控件。支持时区/语言环境、最小/最
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIDatePicker` 的类成员。
+当前接口未额外暴露 `UIDatePicker` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uievent.md

@@ -3,7 +3,7 @@ title: UIEvent
 description: 触摸/系统事件对象。可查询事件类型、时间戳与 touches 集合。
 ---
 
-`UIEvent` 表示一次输入事件（常见为触摸事件），通常在 `UIResponder` 的触摸回调或 `UIGestureRecognizer` 相关流程中出现。
+`UIEvent` 表示一次输入事件（常见为触摸事件），默认在 `UIResponder` 的触摸回调或 `UIGestureRecognizer` 相关流程中出现。
 
 ## 实例成员 (Instance members)
 
@@ -26,7 +26,7 @@ description: 触摸/系统事件对象。可查询事件类型、时间戳与 to
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIEvent` 的类成员。
+当前接口未额外暴露 `UIEvent` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uifont.md

@@ -3,7 +3,7 @@ title: UIFont
 description: 字体对象。提供系统字体/粗体/斜体、按名称创建，以及枚举字体家族与字体名。
 ---
 
-`UIFont` 表示字体。插件运行时主要使用其**类成员**创建字体（系统字体、指定名称字体、按文本风格获取偏好字体），并可在需要时基于已有字体生成新字号的字体对象。
+`UIFont` 表示字体。插件环境主要使用其**类成员**创建字体（系统字体、指定名称字体、按文本风格获取偏好字体），并可在需要时基于已有字体生成新字号的字体对象。
 
 ## 实例成员 (Instance members)
 

package/src/content/docs/reference/uikit/uigesture-recognizer.md

@@ -145,7 +145,7 @@ locationOfTouchInView(touchIndex: number, view: UIView): any
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIGestureRecognizer` 的类成员。
+当前接口未额外暴露 `UIGestureRecognizer` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uiimage-picker-controller.md

@@ -3,7 +3,7 @@ title: UIImagePickerController
 description: 系统媒体选择/拍摄控制器。支持选择来源、媒体类型、拍照与视频录制控制。
 ---
 
-`UIImagePickerController` 用于从相册/相机选择图片或视频，或直接拍摄。它在插件运行时以控制器形式出现，常配合导航控制器/弹出层展示。
+`UIImagePickerController` 用于从相册/相机选择图片或视频，或直接拍摄。它以控制器形式出现，常配合导航控制器/弹出层展示。
 
 ## 实例成员 (Instance members)
 

package/src/content/docs/reference/uikit/uiimage-view.md

@@ -17,7 +17,7 @@ description: 图片视图。支持设置 image/highlightedImage 与帧动画（a
 | `animationImages` | NSArray | 帧动画图片数组。 |
 | `highlightedAnimationImages` | NSArray | 高亮状态下的帧动画图片数组。 |
 | `animationDuration` | number | 动画时长（秒）。 |
-| `animationRepeatCount` | number | 重复次数（0 通常表示无限）。 |
+| `animationRepeatCount` | number | 重复次数（0 默认表示无限）。 |
 
 ### 方法
 
@@ -29,7 +29,7 @@ description: 图片视图。支持设置 image/highlightedImage 与帧动画（a
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIImageView` 的类成员。
+当前接口未额外暴露 `UIImageView` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uiimage.md

@@ -49,8 +49,8 @@ description: 图片对象。支持按名称/文件/数据创建，绘制到点
 | `imageWithDataScale(data, scale)` | data: NSData, scale: number | UIImage \| null | 从数据创建并指定 scale。 |
 | `imageWithCGImage(cgImage)` | cgImage: id | UIImage \| null | 从 CGImage 创建图片。 |
 | `imageWithCGImageScaleOrientation(cgImage, scale, orientation)` | cgImage: id, scale: number, orientation: number | UIImage \| null | 从 CGImage 创建并指定 scale 与方向。 |
-| `addOSImageEncoding(image)` | image: UIImage | void | 注册/注入系统侧图片编码支持（用途依赖运行时）。 |
-| `removeAllOSImageEncoding()` | — | void | 清理所有系统侧图片编码支持（用途依赖运行时）。 |
+| `addOSImageEncoding(image)` | image: UIImage | void | 注册/注入系统侧图片编码支持（用途依赖插件环境）。 |
+| `removeAllOSImageEncoding()` | — | void | 清理所有系统侧图片编码支持（用途依赖插件环境）。 |
 
 ## 相关
 

package/src/content/docs/reference/uikit/uikey-command.md

@@ -14,7 +14,7 @@ description: 键盘快捷键命令对象。可指定 input、修饰键并绑定
 | `input` | string | 只读。按键输入（例如 `"K"`）。 |
 | `modifierFlags` | number | 只读。修饰键标记（例如 command/option/shift 等）。 |
 | `undoManager` | NSUndoManager | 只读。关联的撤销管理器。 |
-| `keyCommands` | NSArray | 只读。当前对象暴露的快捷键命令列表（通常在响应者上查询）。 |
+| `keyCommands` | NSArray | 只读。当前对象暴露的快捷键命令列表（默认在响应者上查询）。 |
 | `inputView` | UIView | 只读。输入视图。 |
 | `inputAccessoryView` | UIView | 只读。输入附件视图。 |
 | `textInputContextIdentifier` | string | 只读。输入上下文标识。 |
@@ -23,7 +23,7 @@ description: 键盘快捷键命令对象。可指定 input、修饰键并绑定
 
 | 方法 | 参数 | 返回值 | 说明 |
 | --- | --- | --- | --- |
-| `keyCommandWithInputModifierFlagsAction(input, modifierFlags, action)` | input: string, modifierFlags: number, action: string | UIKeyCommand | 创建一个快捷键命令。`action` 通常传入要触发的实例方法名字符串（例如 `"onHotkey:"`）。 |
+| `keyCommandWithInputModifierFlagsAction(input, modifierFlags, action)` | input: string, modifierFlags: number, action: string | UIKeyCommand | 创建一个快捷键命令。`action` 默认传入要触发的实例方法名字符串（例如 `"onHotkey:"`）。 |
 
 ## 相关
 

package/src/content/docs/reference/uikit/uilabel.md

@@ -7,20 +7,20 @@ description: 静态文本标签。
 
 ## 实例成员 (Instance members)
 
-### 属性（常用）
+### 属性
 
 | 属性 | 类型 | 说明 |
 |------|------|------|
 | `text` | string | 显示文本。 |
 | `textColor` | UIColor | 文本颜色。 |
 | `font` | UIFont | 字体（如 UIFont.systemFontOfSize(14)）。 |
-| `frame` | CGRect | 位置与大小。 |
+| `frame` | [CGRect](/reference/value-sturct/#cgrect) | 位置与大小。 |
 | `textAlignment` | number | 对齐（如 1 居中；部分平台不可用，例如 xrOS 环境）。 |
 | `numberOfLines` | number | 行数（0 多行）。 |
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UILabel` 的类成员。
+当前接口未额外暴露 `UILabel` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uilocal-notification.md

@@ -3,7 +3,7 @@ title: UILocalNotification
 description: 本地通知对象（旧）。可设置触发时间、提示文案、声音与 userInfo。
 ---
 
-`UILocalNotification` 表示一条本地通知（旧接口）。在插件运行时它主要作为“数据对象”使用，用于配置通知的触发时间、提示文案与附加信息。
+`UILocalNotification` 表示一条本地通知（旧接口）。它主要作为“数据对象”使用，用于配置通知的触发时间、提示文案与附加信息。
 
 ## 实例成员 (Instance members)
 
@@ -19,7 +19,7 @@ description: 本地通知对象（旧）。可设置触发时间、提示文案
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UILocalNotification` 的类成员。
+当前接口未额外暴露 `UILocalNotification` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uilong-press-gesture-recognizer.md

@@ -11,14 +11,14 @@ description: 长按手势识别器。支持最小按压时长、允许移动距
 
 | 属性 | 类型 | 说明 |
 | --- | --- | --- |
-| `allowableMovement` | number | 允许的最大移动距离（超过后可能识别失败）。 |
+| `allowableMovement` | number | 允许的最大移动距离（超过后会识别失败）。 |
 | `minimumPressDuration` | number | 最小按压时长（秒）。 |
 | `numberOfTapsRequired` | number | 所需点击次数。 |
 | `numberOfTouchesRequired` | number | 所需触点数。 |
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UILongPressGestureRecognizer` 的类成员。
+当前接口未额外暴露 `UILongPressGestureRecognizer` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uinavigation-bar.md

@@ -11,7 +11,7 @@ description: 导航栏视图。管理导航项栈、左右按钮、标题/提示
 
 | 属性 | 类型 | 说明 |
 | --- | --- | --- |
-| `title` | string | 标题（部分运行时会把它映射到 `topItem.title`）。 |
+| `title` | string | 标题（插件环境会把它映射到 `topItem.title`）。 |
 | `prompt` | string \| null | 提示文案。 |
 | `items` | NSArray | 导航项栈。 |
 | `topItem` | UINavigationItem | 只读。栈顶导航项。 |
@@ -42,7 +42,7 @@ description: 导航栏视图。管理导航项栈、左右按钮、标题/提示
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UINavigationBar` 的类成员。
+当前接口未额外暴露 `UINavigationBar` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uinavigation-controller.md

@@ -36,7 +36,7 @@ description: 导航控制器。管理 ViewController 栈，并控制导航栏/
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UINavigationController` 的类成员。
+当前接口未额外暴露 `UINavigationController` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uinavigation-item.md

@@ -32,7 +32,7 @@ description: 导航项。用于配置标题、左右按钮、返回按钮与提
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UINavigationItem` 的类成员。
+当前接口未额外暴露 `UINavigationItem` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uipage-control.md

@@ -27,7 +27,7 @@ description: 页码指示控件。支持设置页数、当前页、单页隐藏
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIPageControl` 的类成员。
+当前接口未额外暴露 `UIPageControl` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uipage-view-controller.md

@@ -29,7 +29,7 @@ description: 分页容器控制器。支持设置数据源/代理、转场样式
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIPageViewController` 的类成员。
+当前接口未额外暴露 `UIPageViewController` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uipan-gesture-recognizer.md

@@ -24,7 +24,7 @@ description: 平移手势识别器。支持查询/设置 translation，并获取
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIPanGestureRecognizer` 的类成员。
+当前接口未额外暴露 `UIPanGestureRecognizer` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uipasteboard.md

@@ -13,7 +13,7 @@ description: 系统剪贴板，读写文本与图片等。
 
 ## 实例成员 (Instance members)
 
-### 属性（常用）
+### 属性
 
 | 属性 | 类型 | 说明 |
 |------|------|------|

package/src/content/docs/reference/uikit/uipicker-view.md

@@ -3,7 +3,7 @@ title: UIPickerView
 description: 滚轮选择器视图。支持多列组件、行选择、刷新组件，以及通过 dataSource/delegate 提供内容。
 ---
 
-`UIPickerView` 继承自 [UIView](/reference/uikit/uiview/)，用于展示多列滚轮选择器。插件运行时通过 `dataSource` 与 `delegate` 提供行数与行视图。
+`UIPickerView` 继承自 [UIView](/reference/uikit/uiview/)，用于展示多列滚轮选择器。插件环境通过 `dataSource` 与 `delegate` 提供行数与行视图。
 
 ## 实例成员 (Instance members)
 
@@ -22,7 +22,7 @@ description: 滚轮选择器视图。支持多列组件、行选择、刷新组
 | --- | --- | --- | --- |
 | `numberOfRowsInComponent(component)` | component: number | number | 返回某组件的行数。 |
 | `rowSizeForComponent(component)` | component: number | { width: number, height: number } | 返回某组件行尺寸。 |
-| `viewForRowForComponent(row, component)` | row: number, component: number | UIView \| null | 返回某行对应的 view（由运行时/代理提供）。 |
+| `viewForRowForComponent(row, component)` | row: number, component: number | UIView \| null | 返回某行对应的 view（由插件环境/代理提供）。 |
 | `reloadAllComponents()` | — | void | 刷新全部组件。 |
 | `reloadComponent(component)` | component: number | void | 刷新指定组件。 |
 | `selectRowInComponentAnimated(row, component, animated)` | row: number, component: number, animated: boolean | void | 选中指定行。 |
@@ -30,7 +30,7 @@ description: 滚轮选择器视图。支持多列组件、行选择、刷新组
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIPickerView` 的类成员。
+当前接口未额外暴露 `UIPickerView` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uipinch-gesture-recognizer.md

@@ -16,7 +16,7 @@ description: 捏合缩放手势识别器。支持 scale 读写与 velocity 读
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIPinchGestureRecognizer` 的类成员。
+当前接口未额外暴露 `UIPinchGestureRecognizer` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uipopover-controller.md

@@ -29,7 +29,7 @@ description: 弹出层控制器（旧）。可设置 contentViewController、从
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIPopoverController` 的类成员。
+当前接口未额外暴露 `UIPopoverController` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uiresponder.md

@@ -7,14 +7,13 @@ description: 响应链基类（事件/第一响应者）。
 
 ## 实例成员 (Instance members)
 
-`UIResponder` 在插件运行时环境中可用的成员较多，且多数会由子类（如 `UIView`、`UIViewController`）以更直观的方式间接使用。若你需要定位某个事件/响应相关成员，建议直接用站内搜索成员名。
+`UIResponder` 可用的成员较多，且多数会由子类（如 `UIView`、`UIViewController`）以更直观的方式间接使用。若你需要定位某个事件/响应相关成员，直接用站内搜索成员名。
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIResponder` 的类成员。
+当前接口未额外暴露 `UIResponder` 的类成员。
 
 ## 提示
 
 - 事件分发相关成员较多（touch/press/motion/remoteControl 等）。
-- 在插件里你通常通过 `UIView`/`UIViewController` 间接使用它。
-
+- 在插件里你默认通过 `UIView`/`UIViewController` 间接使用它。

package/src/content/docs/reference/uikit/uirotation-gesture-recognizer.md

@@ -16,7 +16,7 @@ description: 旋转手势识别器。支持读取/设置 rotation，并读取 ve
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIRotationGestureRecognizer` 的类成员。
+当前接口未额外暴露 `UIRotationGestureRecognizer` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/uikit/uiscreen-mode.md

@@ -3,7 +3,7 @@ title: UIScreenMode
 description: 屏幕显示模式对象，提供像素比例与尺寸信息。
 ---
 
-`UIScreenMode` 表示某个屏幕的显示模式（分辨率/尺寸）。通常从 `UIScreen.availableModes` 获取，或由 `UIScreen.currentMode` 返回。
+`UIScreenMode` 表示某个屏幕的显示模式（分辨率/尺寸）。默认从 `UIScreen.availableModes` 获取，或由 `UIScreen.currentMode` 返回。
 
 ## 实例成员 (Instance members)
 
@@ -14,4 +14,4 @@ description: 屏幕显示模式对象，提供像素比例与尺寸信息。
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIScreenMode` 的类成员。
+当前接口未额外暴露 `UIScreenMode` 的类成员。

package/src/content/docs/reference/uikit/uiscrollview.md

@@ -131,4 +131,4 @@ zoomToRectAnimated(rect: any, animated: boolean): void
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `UIScrollView` 的类成员。
+当前接口未额外暴露 `UIScrollView` 的类成员。