@ohos-cpf/3rdloop 0.0.7 → 0.0.9

package/vendor/BadCase/rn/cases/KI-009-pager-view/345/265/214/345/245/227/346/273/221/345/212/250.md

@@ -0,0 +1,38 @@
+# KI-009 react-native-pager-view：嵌套滑动父子组件无法联动
+
+- **元数据**: `rule: R-08` · `verified: diff` · `source: dtse` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-pager-view/pull/32（merged，8 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-pager-view-32.md](../pr-info/rntpc_react-native-pager-view-32.md)
+
+## 现象
+
+RN pager-view 嵌套滑动问题——父子组件无法联动响应。
+
+## 根因
+
+SwiperNode 嵌套在 ScrollView 中时，未配置 NestedScroll 模式，导致手势事件被外层 ScrollView 独占，内层 pager-view 无法响应滑动。
+
+## 错误代码（修复前，C++ 层）
+
+```cpp
+// SwiperNode.cpp — init() 中无 NestedScroll 配置
+void SwiperNode::init() {
+    // 未设置 NestedScrollMode  ← 嵌套滚动时手势被外层拦截
+}
+```
+
+## 正确代码（修复后）
+
+```cpp
+// SwiperNode.cpp — ① 设置 NestedScroll 模式
+void SwiperNode::init() {
+    // 配置 NestedScrollMode 为 PARENT_FIRST，支持嵌套滚动联动
+    ArkUI_NumberValue value[] = {{.i32 = ARKUI_NESTED_SCROLL_PARENT_FIRST}};
+    ArkUI_AttributeItem item = {value, 1};
+    nativeModule->setAttribute(m_nodeHandle, NODE_NESTED_SCROLL, &item);
+}
+```
+
+## 修复方式
+
+在 SwiperNode 初始化时配置 NestedScroll 模式，使嵌套在 ScrollView 中的 pager-view 能正确参与嵌套滚动手势分发。

package/vendor/BadCase/rn/cases/KI-010-screens/346/211/213/345/212/277/345/206/262/347/252/201.md

@@ -0,0 +1,48 @@
+# KI-010 react-native-screens：手势冲突与默认值错误
+
+- **元数据**: `rule: R-08` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-screens/pull/87, https://gitcode.com/CPF-RN/rntpc_react-native-screens/pull/93（merged）
+- **diff 材料**: [../pr-info/rntpc_react-native-screens-87.md](../pr-info/rntpc_react-native-screens-87.md), [../pr-info/rntpc_react-native-screens-93.md](../pr-info/rntpc_react-native-screens-93.md)
+
+## 现象
+
+houldBuiltInRecognizerParallelWith 无法触发回调；原生组件手势和库冲突。
+
+## 根因
+
+1. gestureEnabled 默认值为 false，导致手势整体失效；2. 手势冲突时缺少 onGestureRecognizerJudgeBegin 仲裁逻辑，系统手势（如返回）与库手势冲突。
+
+## 错误代码（修复前）
+
+```typescript
+// RNSScreen.ets
+private gestureEnabled: boolean = false;  // ← 默认 false，手势整体失效
+// 无 onGestureRecognizerJudgeBegin 仲裁  ← 手势冲突
+.gesture(
+    PanGesture({ direction: this.from ? PanDirection.None : PanDirection.All })
+    // ...
+)
+```
+
+## 正确代码（修复后）
+
+```typescript
+// ① gestureEnabled 默认值改为 true
+private gestureEnabled: boolean = true;
+
+// ② 添加手势仲裁逻辑
+.onGestureRecognizerJudgeBegin((event: BaseGestureEvent, current: GestureRecognizer, others: Array<GestureRecognizer>): GestureJudgeResult => {
+    if (this.gestureEnabled && this.fullScreenSwipeEnabled && !this.isRootStackGesturePopDisallowed()) {
+        return GestureJudgeResult.CONTINUE;  // ③ 允许手势继续
+    }
+    return GestureJudgeResult.REJECT;  // ④ 拒绝手势
+})
+.gesture(
+    PanGesture({ direction: this.from ? PanDirection.None : PanDirection.All })
+    // ...
+)
+```
+
+## 修复方式
+
+1. gestureEnabled 默认值从 false 改为 true（与功能声明一致）；2. 添加 onGestureRecognizerJudgeBegin 仲裁回调，在手势开关开启且允许侧滑时返回 CONTINUE，否则返回 REJECT 避免冲突。

package/vendor/BadCase/rn/cases/KI-011-spring-scrollview/346/211/213/345/212/277/351/207/215/345/244/215/347/273/221/345/256/232.md

@@ -0,0 +1,49 @@
+# KI-011 react-native-spring-scrollview：手势重复绑定崩溃
+
+- **元数据**: `rule: R-08` · `verified: diff` · `source: dtse` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-spring-scrollview/pull/38（merged，2 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-spring-scrollview-38.md](../pr-info/rntpc_react-native-spring-scrollview-38.md)
+
+## 现象
+
+线上 crash，美团管家 app——SpringScrollView 崩溃，根因疑似手势重复绑定到同一节点。
+
+## 根因
+
+init() 方法中调用 registerPanGesture() 无防重入保护，当 init() 被多次调用时（如组件重建），手势被重复绑定到同一节点导致崩溃。
+
+## 错误代码（修复前，C++ 层）
+
+```cpp
+// SpringScrollViewNode.cpp — init() 中无条件注册手势
+void SpringScrollViewNode::init() {
+    if (this->isInitialContentOffset) {
+        return;
+    }
+    this->registerPanGesture();  // ← 无防重入，多次 init 会重复绑定手势
+    // ...
+}
+```
+
+## 正确代码（修复后）
+
+```cpp
+// SpringScrollViewNode.h — ① 添加防重入标志
+bool isPanGestureRegistered = false;
+
+// SpringScrollViewNode.cpp — ② 注册前检查标志
+void SpringScrollViewNode::init() {
+    if (this->isInitialContentOffset) {
+        return;
+    }
+    if (!this->isPanGestureRegistered) {  // ③ 仅首次注册
+        this->isPanGestureRegistered = true;
+        this->registerPanGesture();
+    }
+    // ...
+}
+```
+
+## 修复方式
+
+引入 isPanGestureRegistered 标志位防止手势重复绑定：init() 中注册手势前检查标志，首次注册后置 true，后续 init() 调用跳过注册。

package/vendor/BadCase/rn/cases/KI-012-qr-camera/346/250/252/345/261/217/351/200/202/351/205/215.md

@@ -0,0 +1,59 @@
+# KI-012 react-native-qr-decode-image-camera：Pura X Max 横屏展示不正确
+
+- **元数据**: `rule: R-09` · `verified: diff` · `source: community-issue` · `severity: medium` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-qr-decode-image-camera/pull/37（merged，2 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-qr-decode-image-camera-37.md](../pr-info/rntpc_react-native-qr-decode-image-camera-37.md)
+
+## 现象
+
+react-native-qr-decode-image-camera 库在 Pura X Max 上横屏状态下相机视图向下偏移，展示不正确。
+
+## 根因
+
+相机组件使用固定 aspectRatio（3/4）和固定定位，未检测横竖屏状态动态调整布局——横屏时 aspectRatio 不再适用，提示文字固定 bottom 定位导致在横屏时位置错误。
+
+## 错误代码（修复前）
+
+```tsx
+// Camera.tsx — ① 固定 3:4 宽高比
+camera: {
+    width: '100%',
+    aspectRatio: 3 / 4,  // ← 横屏时比例不适用
+},
+
+// QRScannerView.js — ② 提示文字固定 bottom 定位
+<View style={{ position: 'absolute', bottom: this.props.hintTextPosition }}>
+    <Text style={[this.props.hintTextStyle, { top: this.props.finderY, left: this.props.finderX }]}>
+        {this.props.hintText}
+    </Text>
+</View>
+```
+
+## 正确代码（修复后）
+
+```tsx
+// Camera.tsx — ① 改用 flex 自适应
+camera: {
+    flex: 1,  // 自适应横竖屏
+},
+
+// QRScannerView.js — ② 检测横竖屏状态
+const { width, height } = Dimensions.get('window');
+this.state = { isLandscape: width > height };
+
+// ③ 根据横竖屏切换定位
+<View style={{
+    position: 'absolute',
+    ...(this.state.isLandscape
+        ? { top: this.getBottomMaskHeight() - this.props.finderY + 10, left: 0, right: 0, alignItems: 'center' }
+        : { bottom: this.props.hintTextPosition })
+}}>
+    <Text style={[this.props.hintTextStyle, !this.state.isLandscape ? { top: this.props.finderY, left: this.props.finderX } : {}]}>
+        {this.props.hintText}
+    </Text>
+</View>
+```
+
+## 修复方式
+
+1. 相机组件从固定 aspectRatio 改为 flex: 1 自适应；2. 通过 Dimensions.get('window') 检测横竖屏（width > height）；3. 提示文字叠加层根据 isLandscape 状态切换 top/bottom 定位。

package/vendor/BadCase/rn/cases/KI-013-webview/346/267/261/350/211/262/346/250/241/345/274/217/350/203/214/346/231/257/350/211/262.md

@@ -0,0 +1,37 @@
+# KI-013 react-native-webview：深色模式先闪白再变黑
+
+- **元数据**: `rule: R-10` · `verified: diff` · `source: dtse` · `severity: medium` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-webview/pull/112（merged，1 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-webview-112.md](../pr-info/rntpc_react-native-webview-112.md)
+
+## 现象
+
+RNCWebView 源码中深色模式时加了一个白背景，导致先闪一下白背景再变黑。
+
+## 根因
+
+深色模式（forceDarkOn）下 WebView 背景色取值错误——深色模式应使用 Color.Black 但错误使用了 Color.White，导致 WebView 先渲染白色背景再切换为深色。
+
+## 错误代码（修复前）
+
+```typescript
+// RNCWebView.ets — 深色模式用白色背景
+.backgroundColor(BaseOperate.getColorMode(this.ctx.uiAbilityContext,
+    this.descriptorWrapper.rawProps.forceDarkOn) === WebDarkMode.On
+    ? Color.White   // ← 深色模式用白色，错误
+    : Color.Transparent)
+```
+
+## 正确代码（修复后）
+
+```typescript
+// RNCWebView.ets — ① 深色模式用黑色背景
+.backgroundColor(BaseOperate.getColorMode(this.ctx.uiAbilityContext,
+    this.descriptorWrapper.rawProps.forceDarkOn) === WebDarkMode.On
+    ? Color.Black   // ② 深色模式用黑色，正确
+    : Color.Transparent)
+```
+
+## 修复方式
+
+深色模式分支中 backgroundColor 从 Color.White 改为 Color.Black，使 WebView 初始背景色与深色主题一致，消除白色闪烁。

package/vendor/BadCase/rn/cases/KI-014-amap-geolocation/345/233/236/350/260/203/347/274/272/345/244/261.md

@@ -0,0 +1,42 @@
+# KI-014 react-native-amap-geolocation：onLocationError 未实现
+
+- **元数据**: `rule: R-11` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-amap-geolocation/pull/27（merged，48 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-amap-geolocation-27.md](../pr-info/rntpc_react-native-amap-geolocation-27.md)
+
+## 现象
+
+react-native-amap-geolocation 的 onLocationError 没实现——用户传入 onLocationError 回调但错误发生时无任何反馈。
+
+## 根因
+
+JS 层声明了 onLocationError 回调 prop，但鸿蒙侧 ArkTS 实现中定位失败时未触发该回调，调用方无法感知错误——接口声明与实现之间存在断层。
+
+## 错误代码（修复前，ArkTS 层）
+
+```typescript
+// AMapGeolocationModule.ts — 定位失败时无 onLocationError 触发
+try {
+    // 定位逻辑...
+} catch (e) {
+    // ← 无 onLocationError 回调触发，调用方无法感知错误
+}
+```
+
+## 正确代码（修复后）
+
+```typescript
+// AMapGeolocationModule.ts — ① 定位失败时触发 onLocationError
+try {
+    // 定位逻辑...
+} catch (e) {
+    this.ctx.emit('onLocationError', {  // ② 触发声明的错误回调
+        code: e.code,
+        message: e.message
+    });
+}
+```
+
+## 修复方式
+
+在定位失败的错误分支中补充 onLocationError 回调触发代码，使鸿蒙侧实现与 JS 层接口声明对齐。

package/vendor/BadCase/rn/cases/KI-015-reanimated/350/277/220/350/241/214/346/227/266/346/236/220/346/236/204/345/264/251/346/272/203.md

@@ -0,0 +1,54 @@
+# KI-015 react-native-reanimated：动画 crash（滴滴线上 0.01%）
+
+- **元数据**: `rule: R-12` · `verified: diff` · `source: dtse` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-reanimated/pull/82（merged，1 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-reanimated-82.md](../pr-info/rntpc_react-native-reanimated-82.md)
+
+## 现象
+
+鸿蒙 RN 0.77.48 动画 crash，滴滴线上 crash rate 0.01%。
+
+## 根因
+
+ReanimatedModuleProxy 析构时 uiWorkletRuntime_ 先于 UIManager 析构——Hermes GC 在 workletRuntime 析构时回收了相同持有 ShadowNode::Shared 的 JSI 对象，但此时 ComponentDescriptorRegistry 已失效，触发 ~ShadowNodeFamily → ~InstanceHandle 崩溃。
+
+## 错误代码（修复前）
+
+```cpp
+// ReanimatedModuleProxy.cpp — 析构顺序错误
+ReanimatedModuleProxy::~ReanimatedModuleProxy() {
+    // ...
+    layoutAnimationsProxy_.reset();
+    // ← 无主动 GC；commitHook_/mountHook_/uiManager_ 直接 reset
+    commitHook_.reset();
+    mountHook_.reset();
+    uiManager_.reset();
+    uiWorkletRuntime_.reset();  // ← 此时 GC 回收 ShadowNode 时 ComponentDescriptorRegistry 已失效
+}
+```
+
+## 正确代码（修复后）
+
+```cpp
+// ReanimatedModuleProxy.cpp — ① 在 runtime 析构前主动 GC
+#if JS_RUNTIME_HERMES
+  if (uiWorkletRuntime_) {
+    try {
+      auto &uiRuntime = uiWorkletRuntime_->getJSIRuntime();
+      auto gc = uiRuntime.global().getPropertyAsFunction(uiRuntime, "gc");
+      gc.call(uiRuntime);  // ② 回收持有 ShadowNode::Shared 的 JSI 对象
+    } catch (const std::exception &) {
+      // ③ gc() 失败不阻止后续析构
+    } catch (...) {}
+  }
+#endif
+  // ④ GC 之后再注销 hooks，确保 ComponentDescriptorRegistry 仍存活
+  commitHook_.reset();
+  mountHook_.reset();
+  uiManager_.reset();
+  uiWorkletRuntime_.reset();  // ⑤ 最后 reset runtime
+```
+
+## 修复方式
+
+调整析构顺序：在 uiWorkletRuntime_.reset() 之前主动调用 Hermes gc() 回收持有 ShadowNode::Shared 的 JSI 对象（此时 UIManager 仍存活），GC 后再 reset hooks/UIManager，最后 reset runtime；GC 调用有 try-catch 保护。

package/vendor/BadCase/rn/cases/KI-016-fs/346/226/207/344/273/266/350/257/273/345/217/226/347/274/226/347/240/201.md

@@ -0,0 +1,58 @@
+# KI-016 react-native-fs：read 接口无法读取非文本文件
+
+- **元数据**: `rule: R-13` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-fs/pull/38（merged，24 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-fs-38.md](../pr-info/rntpc_react-native-fs-38.md)
+
+## 现象
+
+react-native-fs 的 read 接口以前只能读取文本文件，无法读取其他格式文件。
+
+## 根因
+
+read 接口底层使用了 readText API，而 readText 仅支持文本编码，二进制文件（图片/音频等）读取时解码失败；且文件关闭逻辑不在 finally 块中，异常时 fd 泄漏。
+
+## 错误代码（修复前）
+
+```typescript
+// FsTurboModule.ts — read 使用 readText
+read(path: string, length: number, position: number): Promise<string> {
+    return new Promise((resolve, reject) => {
+        let readTextOption: ReadTextOptions = { offset: position, length, encoding: this.UTF_8 };
+        fs.readText(path, readTextOption, (err: BusinessError, str: string) => {  // ← 仅支持文本
+            // ...
+        });
+    });
+}
+
+// readFile 中文件关闭不在 finally 块
+let file = fs.openSync(path);
+// ...读取循环...
+fs.closeSync(file);  // ← 异常时跳过，fd 泄漏
+```
+
+## 正确代码（修复后）
+
+```typescript
+// FsTurboModule.ts — ① read 改用 readSync（通用二进制读取）
+read(path: string, length: number, position: number): Promise<string> {
+    return new Promise((resolve, reject) => {
+        let file: fs.File | null = null;
+        try {
+            file = fs.openSync(path);
+            // ② 用 readSync 循环读取二进制内容
+            // ...
+        } catch (e) {
+            reject(e);
+        } finally {  // ③ 文件关闭转移到 finally 块
+            if (file) {
+                try { fs.closeSync(file); } catch (closeErr) { /* log */ }
+            }
+        }
+    });
+}
+```
+
+## 修复方式
+
+1. read 接口底层从 readText 改为 readSync（通用二进制读取）；2. 文件关闭逻辑从 try 块转移到 finally 块，确保异常时也关闭 fd。

package/vendor/BadCase/rn/cases/KI-017-blob-util/345/217/202/346/225/260/347/274/226/347/240/201/351/224/231/350/257/257.md

@@ -0,0 +1,39 @@
+# KI-017 react-native-blob-util：字符串参数被错误转为文件流
+
+- **元数据**: `rule: R-13` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-blob-util/pull/23（merged，1 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-blob-util-23.md](../pr-info/rntpc_react-native-blob-util-23.md)
+
+## 现象
+
+使用 react-native-blob-util 调用接口传递参数时，默认把 value 为 string 字符数字的参数（如 expectedQuota）转换成文件流形式传递给服务端，导致服务端报错。
+
+## 根因
+
+HTTP 请求体组装时（getABData 方法），当 data 为非 path 路径时使用 `buffer.alloc(data.length, data, 'base64')` 将其转化为二进制数据，字符串参数被错误地以 base64 编码为二进制流，而非以 utf-8 编码为文本。
+
+## 错误代码（修复前）
+
+```typescript
+// ReactNativeBlobUtilReq.ts — 非 path 数据错误地 base64 编码
+if (fs.类型判断) {
+    // path 文件读取...
+} else {
+    buf = buffer.alloc(data.length, data, 'base64').buffer;  // ← 字符串被 base64 编码为二进制流
+}
+```
+
+## 正确代码（修复后）
+
+```typescript
+// ReactNativeBlobUtilReq.ts — ① 非 path 数据用 utf-8 编码
+if (fs.类型判断) {
+    // path 文件读取...
+} else {
+    buf = buffer.from(data, 'utf-8').buffer;  // ② 字符串用 utf-8 编码，与上游保持一致
+}
+```
+
+## 修复方式
+
+HTTP 请求体组装时，非文件路径的字符串参数从 `buffer.alloc(data.length, data, 'base64')` 改为 `buffer.from(data, 'utf-8')`，与上游一致使用 utf-8 编码，避免字符串参数被误转为二进制文件流。

package/vendor/BadCase/rn/cases/KI-018-modal/345/274/271/347/252/227/351/227/252/347/203/201.md

@@ -0,0 +1,53 @@
+# KI-018 react-native-modal：弹窗先闪一下
+
+- **元数据**: `rule: R-14` · `verified: diff` · `source: dtse` · `severity: medium` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-modal/pull/20（merged，3 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-modal-20.md](../pr-info/rntpc_react-native-modal-20.md)
+
+## 现象
+
+RN 工程中拉起弹窗，弹窗会先闪一下——升级到 rnoh 新框架后出现。
+
+## 根因
+
+弹窗打开时 animationValue 保留了上一次动画的终值（1.0），setAnimation 基于当前 animationValue 创建 animationStyle 时 content 瞬间显示在最终位置（一帧闪烁），然后 startAnimation 才重置 animationValue 到 0。同时 backdrop 使用 ref.transitionTo 在新框架下不兼容。
+
+## 错误代码（修复前）
+
+```tsx
+// modal.tsx — ① animationValue 未重置就 setAnimation
+this.contentRef.setAnimation(this.animationIn, () => { /* ... */ });
+// ② backdrop 使用 ref.transitionTo（新框架不兼容）
+if (this.backdropRef) {
+    this.backdropRef.transitionTo({ opacity: this.props.backdropOpacity }, timing);
+}
+// ③ showContent 初始为 true，内容立即显示
+state = { showContent: true };
+```
+
+## 正确代码（修复后）
+
+```tsx
+// ① 先 stopAnimation + setValue(0) 再 setAnimation
+this.contentRef.stopAnimation();
+if (this.contentRef.state && this.contentRef.state.animationValue) {
+    this.contentRef.state.animationValue.setValue(0);
+}
+// ② 用 requestAnimationFrame 延迟 setAnimation
+const rafId = requestAnimationFrame(() => {
+    this.contentRef.setAnimation(this.animationIn, () => { /* ... */ });
+});
+
+// ③ backdrop 改用 Animated.Value 驱动
+this.backdropAnimated = new Animated.Value(0);
+Animated.timing(this.backdropAnimated, { toValue: opacity, duration, useNativeDriver }).start();
+
+// ④ animationReady 控制渲染时机
+state = { showContent: false, animationReady: false };
+// ⑤ 卸载时清理 pendingRAF/pendingTimeout/stopAnimation
+this._pendingRAF.forEach(id => cancelAnimationFrame(id));
+```
+
+## 修复方式
+
+1. setAnimation 前先 stopAnimation + setValue(0) 重置动画值；2. 用 requestAnimationFrame 延迟 setAnimation 确保重置生效；3. backdrop 从 ref.transitionTo 改为 Animated.Value 驱动；4. 引入 animationReady 标志在动画初始化完成前阻止内容渲染；5. 组件卸载时清理所有 pending 动画资源。

package/vendor/BadCase/rn/cases/KI-019-code-push/351/207/215/345/220/257/351/200/273/350/276/221/345/244/261/346/225/210.md

@@ -0,0 +1,79 @@
+# KI-019 react-native-code-push：restartApp 在 ON_NEXT_RESTART 模式下失效
+
+- **元数据**: `rule: R-15` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-code-push/pull/17（merged，76 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-code-push-17.md](../pr-info/rntpc_react-native-code-push-17.md)
+
+## 现象
+
+更新流程是先使用 ON_NEXT_RESTART 的 installMode 调用 CodePush.sync 方法，然后再视情况调用 CodePush.allowRestart()、CodePush.restartApp() 来重启 RN。但上面流程在 iOS 和安卓是正常的，在鸿蒙上无法工作，因为 this.installMode 是个属性，在调用 restartApp 的时候还是 -1。
+
+## 根因
+
+installMode 状态标志位在 restartApp 调用时未及时复位——ON_NEXT_RESTART(1) 模式下 restartApp 完成后 installMode 仍为 1，后续 restartApp 条件判断 `installMode === 0 || installMode === -1` 不满足，导致重启失效。同时 allow() 未设置 _allowed 标志，disallow 后 allow 无法恢复。
+
+## 错误代码（修复前）
+
+```typescript
+// CodePushNativeModule.ts — ① restartApp 条件判断遗漏 ON_NEXT_RESTART
+if (this.installMode === 0 || this.installMode === -1) {
+    this.ctx.devToolsController.eventEmitter.emit("RELOAD", { reason: 'HotReload2' })
+}
+// ← ON_NEXT_RESTART(1) 分支未处理，installMode 未复位
+
+// ② allow() 未设置 _allowed 标志
+async allow() {
+    return new Promise((resolve) => {
+        Logger.info(TAG, "Re-allowing restarts");
+        // ← 未设置 this._allowed = true
+    })
+}
+
+// ③ restartAppInternal 无防重入保护
+restartAppInternal(onlyIfUpdateIsPending: boolean) {
+    this.loadBundle();  // ← 无 _restartInProgress 检查
+}
+```
+
+## 正确代码（修复后）
+
+```typescript
+// ① ON_NEXT_RESTART 分支复位 installMode
+if (this.installMode === 1) {
+    this.installMode = -1;  // ② 复位为 -1
+}
+
+// ③ allow() 设置 _allowed 标志并处理排队
+async allow() {
+    this._allowed = true;
+    if (this._restartQueue.length > 0) {
+        let buf = this._restartQueue[0];
+        this._restartQueue.splice(0, 1);
+        this.restartAppInternal(buf);
+    }
+}
+
+// ④ restartAppInternal 防重入 + 排队机制
+restartAppInternal(onlyIfUpdateIsPending: boolean) {
+    if (this._restartInProgress) {  // ⑤ 防重入
+        this._restartQueue.push(onlyIfUpdateIsPending);
+        return;
+    } else if (!this._allowed) {  // ⑥ 允许检查
+        this._restartQueue.push(onlyIfUpdateIsPending);
+        return;
+    }
+    this._restartInProgress = true;
+    // ...执行重启...
+    this._restartInProgress = false;
+    // ⑦ 处理排队请求
+    if (this._restartQueue.length > 0) {
+        let buf = this._restartQueue[0];
+        this._restartQueue.splice(0, 1);
+        this.restartAppInternal(buf);
+    }
+}
+```
+
+## 修复方式
+
+1. ON_NEXT_RESTART 模式完成后复位 installMode 为 -1；2. allow() 设置 _allowed = true 并处理排队请求；3. restartAppInternal 增加防重入保护（_restartInProgress）和排队机制（_restartQueue）；4. disallow() 设置 _allowed = false。

package/vendor/BadCase/rn/cases/KI-020-netinfo/346/225/217/346/204/237/344/277/241/346/201/257/346/263/204/351/234/262.md

@@ -0,0 +1,60 @@
+# KI-020 react-native-netinfo：打印 MAC 地址和 IP 地址
+
+- **元数据**: `rule: R-16` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-netinfo/pull/31（merged，1 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-netinfo-31.md](../pr-info/rntpc_react-native-netinfo-31.md)
+
+## 现象
+
+@react-native-ohos/netinfo 三方库打印敏感信息——RN 侧调用 NetInfoTurboModule 里面 getCurrentState 会打印 MAC 地址和 IP 地址，安全测试不过。
+
+## 根因
+
+日志中直接 JSON.stringify 打印了网络连接事件数据（netConnection 回调数据），其中包含 MAC 地址、IP 地址等敏感信息，安全扫描检测到敏感信息泄露。
+
+## 错误代码（修复前）
+
+```typescript
+// NetInfoTurboModule.ts — 多处打印敏感数据
+configure(config: Details): void {
+    Logger.info('configure,' + JSON.stringify(config));  // ← 打印配置信息
+}
+
+getCurrentState(requestedInterface?: string): Promise<NetInfoState> {
+    // ...
+    Logger.info('events,' + JSON.stringify(events));  // ← 打印网络状态含 MAC/IP
+}
+
+this.netConnection.register((data) => {
+    Logger.info('netConnection,' + JSON.stringify(data));  // ← 打印连接数据
+});
+
+this.netConnection.on('netAvailable', (data) => {
+    Logger.info('netAvailable,' + JSON.stringify(data));  // ← 打印网络可用事件
+});
+```
+
+## 正确代码（修复后）
+
+```typescript
+// NetInfoTurboModule.ts — ① 删除所有敏感日志
+configure(config: Details): void {
+    // ② 不再打印 config
+}
+
+getCurrentState(requestedInterface?: string): Promise<NetInfoState> {
+    // ③ 不再打印 events
+}
+
+this.netConnection.register((data) => {
+    // ④ 不再打印 netConnection 数据
+});
+
+this.netConnection.on('netAvailable', (data) => {
+    // ⑤ 不再打印 netAvailable 数据
+});
+```
+
+## 修复方式
+
+删除所有打印网络连接原始数据的日志语句（Logger.info），包括 configure、getCurrentState、netConnection.register、netAvailable 等回调中的 JSON.stringify 日志。