合并master后提交

Author: wangxiaokou

.agents/skills/mpx2rn/references/rn-api-reference.md

@@ -186,7 +186,7 @@
 | `selectComponent(selector)` | 方法 | 共用 | 按选择器取第一个匹配实例。RN 不能像小程序一样按 selector 遍历视图树，须在模板目标节点声明 **空 wx:ref**，由编译期建立 **`#id` / `.class` 与节点**的映射后，本 API 才能按小程序写法解析。 |
 | `selectAllComponents(selector)` | 方法 | 共用 | 取全部匹配实例数组，**RN 侧与 `selectComponent` 相同**：依赖模板 **空 wx:ref** 与编译期 selector 映射，仅支持 **`#id` / `.class`**。 |
 | `createSelectorQuery()` | 方法 | 共用 | 在实例作用域内创建查询对象。后续 **`select(selector)`** 等链式调用在 RN 上同样依赖目标节点 **空 wx:ref**，通过编译映射将 `#id` / `.class` 落到真实视图；命中非 virtualHost 自定义组件时，返回该组件实体 host 节点信息。 |
-| `createIntersectionObserver(options?)` | 方法 | 共用 | 在实例作用域内创建交叉观察。若相对某一节点观察且传入 **`#id` / `.class`**（如 `relativeTo` 等），RN 侧同样要求该节点模板已声明 **空 wx:ref** 并完成编译期映射，其余行为依赖 `@mpxjs/api-proxy` 的 RN 实现。 |
+| `createIntersectionObserver(options?)` | 方法 | 共用 | 在实例作用域内创建交叉观察。输出 RN 时应优先使用此实例方法，框架会自动将最近的滚动容器上下文填充为底层工厂方法的第三个参数。若相对某一节点观察且传入 **`#id` / `.class`**（如 `relativeTo` 等），RN 侧同样要求该节点模板已声明 **空 wx:ref** 并完成编译期映射，其余行为依赖 `@mpxjs/api-proxy` 的 RN 实现。 |
 | `$refs` | 属性 | 共用 | 模板 **`wx:ref="refName"`** 对应的懒解析访问器（如 `this.$refs.refName`）；**空 wx:ref 不会注册具名 ref**，但与 selector 映射可并存——需按名取子实例时再写 **`wx:ref="refName"`**。 |
 | `$watch` | 方法 | 共用 | 动态创建对数据路径或表达式的侦听，返回用于停止侦听的函数，行为与选项式 `watch` 对齐。 |
 | `$forceUpdate` | 方法 | 共用 | 强制触发视图更新，可传入数据对象参与本次刷新，RN 侧由 `MpxProxy` 与 React 更新调度配合完成。 |

.agents/skills/mpx2rn/references/rn-script-reference.md

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2026 Anthropic, PBC.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

.agents/skills/skill-creator/LICENSE.txt

@@ -55,8 +55,8 @@ jobs:
       - name: build-plugin
         run: npm run build --prefix test/e2e/plugin-project
 
-      - name: build-perf
-        run: npm run build -w @mpxjs/perf
+      - name: build-tsc
+        run: npm run build:tsc
 
       - name: exec unit test
         run: npm t && npm t --prefix test/e2e/miniprogram-project && npm t --prefix test/e2e/plugin-project

.github/workflows/test.yml

@@ -24,3 +24,4 @@ dev-dist
 packages/webpack-plugin/lib/runtime/components/react/dist/
 packages/perf/dist/
 .agent-workflows/
+.agents/skills/mpx/

.gitignore

@@ -209,6 +209,10 @@ const sidebar: ExtendedSidebar = {
               text: 'arrayBufferToBase64',
               link: '/api-proxy/base/arrayBufferToBase64',
             },
+            {
+              text: 'canIUse',
+              link: '/api-proxy/base/canIUse',
+            },
             {
               text: '系统',
               collapsed: true,

docs-vitepress/.vitepress/config.ts

@@ -0,0 +1,28 @@
+## mpx.canIUse(string schema)
+
+判断当前环境是否支持指定的 API、对象或方法。
+
+RN 支持情况：支持。RN 下使用静态能力表判断，不会为了检测能力而加载原生模块。
+
+[参考文档](https://developers.weixin.qq.com/miniprogram/dev/api/base/wx.canIUse.html)
+
+### 参数 {#parameters}
+
+**string schema**\
+API、对象或方法的能力描述，写法遵循小程序 `canIUse` 的 `schema` 约定。
+
+RN 静态能力表只收录抹平层已有实际能力的内置 API、对象与方法，不收录 `envError`、空实现或明确未实现的兼容占位能力。该判断不会检测可选原生依赖是否安装、运行时权限是否授予，也不包含通过 `custom` 注入的业务 API。
+
+### 返回值 {#return-value}
+
+**boolean**\
+支持返回 `true`，否则返回 `false`。
+
+### 示例代码 {#example-code}
+
+```js
+mpx.canIUse('request') // true
+mpx.canIUse('RequestTask.abort') // true
+mpx.canIUse('RequestTask.onHeadersReceived') // false（RN 暂未实现）
+mpx.canIUse('previewImage') // false（RN 暂未实现）
+```

docs-vitepress/api-proxy/base/canIUse.md

@@ -115,7 +115,7 @@
         </tbody>
       </table>
     </td></tr>
-    <tr><td>deviceOrientation</td><td>string</td><td>设备方向（注意：IOS客户端横屏游戏获取deviceOrientation可能不准，建议以屏幕宽高为准）值： portrait(竖屏)/landscape(横屏)</td><td></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
+    <tr><td>deviceOrientation</td><td>string</td><td>设备方向，值：portrait（竖屏）/ landscape（横屏）。RN 端根据屏幕宽高计算。</td><td></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
   </tbody>
 </table>
 

docs-vitepress/api-proxy/base/system/getSystemInfo.md

@@ -16,6 +16,8 @@ mpx.closeBLEConnection(Object object)
 | fail | function |  | 否 | 接口调用失败的回调函数 |
 | complete | function |  | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
 
+> RN 平台未传 `deviceId` 时进入 `fail` 回调，`errMsg` 为 `closeBLEConnection:fail parameter error`，随后以同一结果调用 `complete`。
+
 ### 错误 {#error}
 
 | 错误码 | 错误信息 | 说明 | 支付宝 |

docs-vitepress/api-proxy/device/bluetooth-ble/closeBLEConnection.md

@@ -19,6 +19,8 @@ mpx.createBLEConnection(Object object)
 | fail | function |  | 否 | 接口调用失败的回调函数 | **<span style="color: green;">✓</span>** |
 | complete | function |  | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） | **<span style="color: green;">✓</span>** |
 
+> RN 平台未传 `deviceId` 时进入 `fail` 回调，`errMsg` 为 `createBLEConnection:fail parameter error`，随后以同一结果调用 `complete`。
+
 
 ### 错误 {#error}