@ohos-cpf/3rdloop 0.0.8 → 0.0.9

package/vendor/Archive/src/utils/path-safety.js

@@ -0,0 +1,96 @@
+/**
+ * path-safety.js — 路径安全防护
+ *
+ * 职责：
+ *   1. 验证数据目录可访问且为目录。
+ *   2. 防止 documentId 路径穿越（禁止 .. 和绝对路径）。
+ *   3. 校验文件在沙箱内、非常规符号链接。
+ *
+ * 与存储层配合，确保所有文件操作限制在 dataRoot 之内。
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 路径安全异常。
+ */
+export class PathSafetyError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'PathSafetyError';
+  }
+}
+
+export default class PathSafety {
+  /**
+   * @param {string} dataRoot 数据根目录
+   */
+  constructor(dataRoot) {
+    this.dataRoot = dataRoot;
+  }
+
+  /**
+   * 确保数据目录存在且为目录。
+   * @returns {Promise<void>}
+   */
+  async assertDataDirSafe() {
+    const realRoot = fs.realpathSync(this.dataRoot);
+    const stat = await fs.promises.stat(realRoot);
+    if (!stat.isDirectory()) {
+      throw new PathSafetyError('Data directory is not a directory.');
+    }
+  }
+
+  /**
+   * 确保目标路径位于数据目录内，返回规范化后的绝对路径。
+   * @param {string} target 相对 dataRoot 的路径
+   * @param {string} label  诊断标签
+   * @returns {string}
+   */
+  assertPathInside(target, label) {
+    const realTarget = path.resolve(this.dataRoot, target);
+    if (
+      realTarget !== this.dataRoot &&
+      !realTarget.startsWith(this.dataRoot + path.sep)
+    ) {
+      throw new PathSafetyError(`${label} resolves outside data directory.`);
+    }
+    return realTarget;
+  }
+
+  /**
+   * 校验文件存在且为常规文件（非符号链接越界）。
+   * 不存在时静默通过（交由调用方处理 ENOENT）。
+   * @param {string} filePath
+   */
+  assertRegularFile(filePath) {
+    try {
+      const stat = fs.statSync(filePath);
+      if (!stat.isFile()) {
+        throw new PathSafetyError('Path must be a regular file.');
+      }
+      const realPath = fs.realpathSync(filePath);
+      this.assertPathInside(realPath, 'file');
+    } catch (error) {
+      if (error instanceof PathSafetyError) throw error;
+      if (/** @type {NodeJS.ErrnoException} */ (error).code !== 'ENOENT') throw error;
+    }
+  }
+
+  /**
+   * 校验 documentId 合法性（防路径穿越）。
+   * @param {string} documentId
+   * @returns {string} 规范化后的 documentId
+   */
+  validateDocumentId(documentId) {
+    const normalized = documentId.replace(/\\/g, '/');
+    if (normalized.split('/').includes('..')) {
+      throw new PathSafetyError('Invalid document ID: path traversal detected.');
+    }
+    if (normalized.startsWith('/')) {
+      throw new PathSafetyError('Invalid document ID: absolute path not allowed.');
+    }
+    return normalized;
+  }
+}

package/vendor/Archive/src/utils/paths.js

@@ -0,0 +1,39 @@
+/**
+ * paths.js — 路径管理工具
+ *
+ * 集中计算 docs / .index / lock / meta 等运行时子路径，
+ * 保证全模块路径拼接一致。
+ */
+
+import path from 'node:path';
+
+/**
+ * 计算运行时各子目录/文件路径。
+ * @param {string} dataDir 数据根目录
+ * @returns {{
+ *   dataDir: string,
+ *   docsDir: string,
+ *   indexDir: string,
+ *   dbPath: string,
+ *   metaPath: string,
+ *   lockPath: string,
+ *   termsPath: string,
+ *   synonymsPath: string,
+ *   stopwordsPath: string,
+ * }}
+ */
+export function resolveRuntimePaths(dataDir) {
+  const docsDir = path.join(dataDir, 'docs');
+  const indexDir = path.join(dataDir, '.index');
+  return {
+    dataDir,
+    docsDir,
+    indexDir,
+    dbPath: path.join(indexDir, 'search.db'),
+    metaPath: path.join(indexDir, 'meta.json'),
+    lockPath: path.join(indexDir, 'write.lock'),
+    termsPath: path.join(indexDir, 'terms.txt'),
+    synonymsPath: path.join(indexDir, 'synonyms.json'),
+    stopwordsPath: path.join(indexDir, 'stopwords.txt'),
+  };
+}

package/vendor/BadCase/rn/INDEX.md

@@ -0,0 +1,127 @@
+# RN 三方库鸿蒙化已知问题知识库 — 一级索引
+
+> **分级结构**：本文件为一级索引（分类 + 索引），具体知识在二级文件中。
+> **维护方式**：由 rn-library-issue-generalizer SKILL 产出草稿，人工审核后合入。
+> **消费方式**：rn-library-known-issue-check SKILL 先读本索引预筛适用规则，再按需读取规则/案例文件。
+
+```
+BadCase/rn/
+├── INDEX.md    ← 一级：分类 + 索引（本文件）
+├── rules/      ← 二级：规则知识（检查的执行单元）
+├── cases/      ← 二级：案例知识（few-shot 参考 + 修复指引）
+└── pr-info/    ← 案例原始 PR diff 证据材料
+```
+
+**使用流程**（检视 Agent）：
+1. 读本索引 → 按"预筛特征"筛选与当前库相关的规则
+2. 读 `rules/R-XX-*.md` → 获取检查点、错误/正确特征、案例索引
+3. 需要代码级 few-shot 参考时 → 读 `cases/KI-XXX-*.md`
+
+---
+
+## 一、规则分类索引
+
+### 媒体与窗口类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-01 | 全屏/窗口状态管理完整性类 | high | 1 | [rules/R-01-全屏窗口状态管理完整性.md](rules/R-01-全屏窗口状态管理完整性.md) |
+| R-09 | 横竖屏/多形态布局适配类 | medium | 1 | [rules/R-09-横竖屏多形态布局适配.md](rules/R-09-横竖屏多形态布局适配.md) |
+| R-10 | 深色模式/主题颜色适配类 | medium | 1 | [rules/R-10-深色模式主题颜色适配.md](rules/R-10-深色模式主题颜色适配.md) |
+
+### 资源加载类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-02 | 资源 URI 形态分支覆盖类 | high | 2 | [rules/R-02-资源URI形态分支覆盖.md](rules/R-02-资源URI形态分支覆盖.md) |
+| R-13 | 文件/数据编码与格式兼容类 | high | 2 | [rules/R-13-文件数据编码与格式兼容.md](rules/R-13-文件数据编码与格式兼容.md) |
+| R-17 | 媒体资源生命周期与错误处理类 | high | 1 | [rules/R-17-媒体资源生命周期与错误处理.md](rules/R-17-媒体资源生命周期与错误处理.md) |
+
+### 流程健壮性类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-03 | 附属操作失败阻断主流程类 | high | 1 | [rules/R-03-附属操作失败阻断主流程.md](rules/R-03-附属操作失败阻断主流程.md) |
+| R-15 | 状态持久化与重启逻辑一致性类 | high | 1 | [rules/R-15-状态持久化与重启逻辑一致性.md](rules/R-15-状态持久化与重启逻辑一致性.md) |
+
+### 异步与回调类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-04 | 异步回调注册时序类 | high | 1 | [rules/R-04-异步回调注册时序.md](rules/R-04-异步回调注册时序.md) |
+| R-11 | 接口/回调实现完整性类 | high | 1 | [rules/R-11-接口回调实现完整性.md](rules/R-11-接口回调实现完整性.md) |
+
+### 工程规范类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-05 | 模块导入路径规范类 | low | 1 | [rules/R-05-模块导入路径规范.md](rules/R-05-模块导入路径规范.md) |
+| R-16 | 敏感信息日志泄露类 | high | 1 | [rules/R-16-敏感信息日志泄露.md](rules/R-16-敏感信息日志泄露.md) |
+| R-18 | 能力枚举/配置完整性类 | medium | 1 | [rules/R-18-能力枚举配置完整性.md](rules/R-18-能力枚举配置完整性.md) |
+
+### 手势与交互类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-08 | 手势/事件注册与冲突处理类 | high | 3 | [rules/R-08-手势事件注册与冲突处理.md](rules/R-08-手势事件注册与冲突处理.md) |
+
+### 动画与渲染类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-14 | 动画初始化时序与状态同步类 | medium | 1 | [rules/R-14-动画初始化时序与状态同步.md](rules/R-14-动画初始化时序与状态同步.md) |
+| R-19 | 图形渲染属性继承与重置类 | medium | 1 | [rules/R-19-图形渲染属性继承与重置.md](rules/R-19-图形渲染属性继承与重置.md) |
+
+### C++ 内存与生命周期类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-07 | C++ 智能指针生命周期管理类 | high | 1 | [rules/R-07-智能指针生命周期管理.md](rules/R-07-智能指针生命周期管理.md) |
+| R-12 | 原生运行时资源析构时序类 | high | 1 | [rules/R-12-原生运行时资源析构时序.md](rules/R-12-原生运行时资源析构时序.md) |
+
+### 隐私合规类
+
+| 编号 | 规则名 | 严重级别 | 案例数 | 规则文件 |
+|------|--------|----------|--------|----------|
+| R-06 | 传感器/硬件权限按需获取类 | high | 2 | [rules/R-06-传感器硬件权限按需获取.md](rules/R-06-传感器硬件权限按需获取.md) |
+
+---
+
+## 二、案例索引
+
+| 编号 | 库 | 现象简述 | 所属规则 | 验证方式 | 案例文件 |
+|------|-----|----------|----------|----------|----------|
+| KI-001 | react-native-webview | 视频无法横屏 | R-01 | diff | [cases/KI-001-webview视频无法横屏.md](cases/KI-001-webview视频无法横屏.md) |
+| KI-002 | react-native-fast-image | 热更新图片加载失败 | R-02 | diff | [cases/KI-002-fastImage热更新图片失败.md](cases/KI-002-fastImage热更新图片失败.md) |
+| KI-003 | react-native-wechat-lib | 缩略图不支持本地图片 | R-02, R-03 | diff | [cases/KI-003-wechat缩略图本地图片.md](cases/KI-003-wechat缩略图本地图片.md) |
+| KI-004 | react-native-wechat-lib | shareWebpage 回调时序问题 | R-04 | diff | [cases/KI-004-wechat回调时序.md](cases/KI-004-wechat回调时序.md) |
+| KI-005 | react-native-geolocation | 3.1.1 接入报错（IDE 爆红） | R-05 | diff | [cases/KI-005-geolocation导入路径后缀.md](cases/KI-005-geolocation导入路径后缀.md) |
+| KI-006 | react-native-SmartRefreshLayout | bad_weak_ptr 崩溃 | R-07 | diff | [cases/KI-006-SmartRefreshLayout智能指针崩溃.md](cases/KI-006-SmartRefreshLayout智能指针崩溃.md) |
+| KI-007 | react-native-orientation-locker | 加速度传感器初始化即打开 | R-06 | diff | [cases/KI-007-orientation-locker传感器初始化.md](cases/KI-007-orientation-locker传感器初始化.md) |
+| KI-008 | react-native-orientation-locker | 传感器频繁 open/close 优化 | R-06 | diff | [cases/KI-008-orientation-locker传感器引用计数.md](cases/KI-008-orientation-locker传感器引用计数.md) |
+| KI-009 | react-native-pager-view | 嵌套滑动父子组件无法联动 | R-08 | diff | [cases/KI-009-pager-view嵌套滑动.md](cases/KI-009-pager-view嵌套滑动.md) |
+| KI-010 | react-native-screens | 手势冲突与默认值错误 | R-08 | diff | [cases/KI-010-screens手势冲突.md](cases/KI-010-screens手势冲突.md) |
+| KI-011 | react-native-spring-scrollview | 手势重复绑定崩溃 | R-08 | diff | [cases/KI-011-spring-scrollview手势重复绑定.md](cases/KI-011-spring-scrollview手势重复绑定.md) |
+| KI-012 | react-native-qr-decode-image-camera | Pura X Max 横屏展示不正确 | R-09 | diff | [cases/KI-012-qr-camera横屏适配.md](cases/KI-012-qr-camera横屏适配.md) |
+| KI-013 | react-native-webview | 深色模式先闪白再变黑 | R-10 | diff | [cases/KI-013-webview深色模式背景色.md](cases/KI-013-webview深色模式背景色.md) |
+| KI-014 | react-native-amap-geolocation | onLocationError 未实现 | R-11 | diff | [cases/KI-014-amap-geolocation回调缺失.md](cases/KI-014-amap-geolocation回调缺失.md) |
+| KI-015 | react-native-reanimated | 动画 crash（滴滴线上 0.01%） | R-12 | diff | [cases/KI-015-reanimated运行时析构崩溃.md](cases/KI-015-reanimated运行时析构崩溃.md) |
+| KI-016 | react-native-fs | read 接口无法读取非文本文件 | R-13 | diff | [cases/KI-016-fs文件读取编码.md](cases/KI-016-fs文件读取编码.md) |
+| KI-017 | react-native-blob-util | 字符串参数被错误转为文件流 | R-13 | diff | [cases/KI-017-blob-util参数编码错误.md](cases/KI-017-blob-util参数编码错误.md) |
+| KI-018 | react-native-modal | 弹窗先闪一下 | R-14 | diff | [cases/KI-018-modal弹窗闪烁.md](cases/KI-018-modal弹窗闪烁.md) |
+| KI-019 | react-native-code-push | restartApp 在 ON_NEXT_RESTART 模式下失效 | R-15 | diff | [cases/KI-019-code-push重启逻辑失效.md](cases/KI-019-code-push重启逻辑失效.md) |
+| KI-020 | react-native-netinfo | 打印 MAC 地址和 IP 地址 | R-16 | diff | [cases/KI-020-netinfo敏感信息泄露.md](cases/KI-020-netinfo敏感信息泄露.md) |
+| KI-021 | react-native-video | 播放本地视频异常 | R-17 | diff | [cases/KI-021-video本地视频播放异常.md](cases/KI-021-video本地视频播放异常.md) |
+| KI-022 | react-native-audio-recorder-player | AAC 格式无法录制 | R-18 | diff | [cases/KI-022-audio-recorder-player枚举缺失.md](cases/KI-022-audio-recorder-player枚举缺失.md) |
+| KI-023 | react-native-svg | Text 组件渐变色失效 | R-19 | diff | [cases/KI-023-svg渐变继承失效.md](cases/KI-023-svg渐变继承失效.md) |
+
+> `验证方式`：diff = 基于实际 PR patch 验证（含错误/正确代码对照）；description-only = 仅基于问题描述。
+
+---
+
+## 三、变更记录
+
+| 日期 | 变更 | 说明 |
+|------|------|------|
+| 2026-08-24 | 初始创建 | 4 案例 → 5 规则（KI-003 复合问题拆 3 规则）；由单文件结构整改为分级结构 |
+| 2026-08-24 | 批量泛化（19 新案例） | 18 新案例 → 14 新规则（R-06~R-19）；新增手势与交互类、动画与渲染类、C++ 内存与生命周期类、隐私合规类四大分类 |

package/vendor/BadCase/rn/cases/KI-001-webview/350/247/206/351/242/221/346/227/240/346/263/225/346/250/252/345/261/217.md

@@ -0,0 +1,52 @@
+# KI-001 react-native-webview：视频无法横屏
+
+- **元数据**: `rule: R-01` · `verified: diff` · `source: dtse` · `severity: high`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-webview/pull/121（merged，+199/-7，2 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-webview-121.md](../pr-info/rntpc_react-native-webview-121.md)
+
+## 现象
+
+WebView 内视频点击全屏后无法横屏播放。
+
+## 根因
+
+鸿蒙侧实现完全缺失全屏事件处理链路——未监听 onFullScreenEnter/Exit、未保存初始方向、无窗口 API 调用、销毁无恢复。
+
+## 错误代码（修复前，ArkTS 层无任何全屏处理，仅布局尺寸绑定）
+
+```typescript
+// RNCWebView.ets — 声明了 allowsFullscreenVideo prop，但 ArkTS 层无对应实现
+.width(this.webviewWidth)
+.height(this.webviewHeight)
+// 无 onFullScreenEnter / onFullScreenExit 监听
+// 无窗口方向 / 沉浸式调用
+```
+
+## 正确代码（修复后关键片段）
+
+```typescript
+// ① 保存初始方向（aboutToAppear 时）
+private async saveInitialOrientation() {
+  const win = await window.getLastWindow(getContext(this));
+  this.initialOrientation = win.getPreferredOrientation();
+  this.isOrientationSaved = true;
+}
+// ② 监听全屏事件，串行执行且每步校验、失败回滚
+.onFullScreenEnter(async () => {
+  if (this.allowsFullscreenVideo) { await this.handleFullScreenEnter(); }
+})
+.onFullScreenExit(async () => { await this.handleFullScreenExit(); })
+// ③ 组件销毁时无条件恢复窗口状态（防异步竞态残留）
+aboutToDisappear() {
+  if (this.cachedWindow) {
+    this.cachedWindow.setPreferredOrientation(this.initialOrientation);
+    this.cachedWindow.setWindowLayoutFullScreen(false);
+    this.cachedWindow.setWindowSystemBarEnable(['status', 'navigation']);
+  }
+  this.isFullScreen = false;
+}
+```
+
+## 修复方式
+
+补全完整链路：新增 allowsFullscreenVideo prop → aboutToAppear 时 saveInitialOrientation → 监听 onFullScreenEnter/Exit → handleFullScreenEnter 串行执行（设方向→设沉浸式，任一步失败回滚全部）→ handleFullScreenExit 恢复 → aboutToDisappear 无条件恢复窗口状态（防异步竞态残留）→ isFullScreen 状态守卫防重入。

package/vendor/BadCase/rn/cases/KI-002-fastImage/347/203/255/346/233/264/346/226/260/345/233/276/347/211/207/345/244/261/350/264/245.md

@@ -0,0 +1,37 @@
+# KI-002 react-native-fast-image：加载热更新图片失败
+
+- **元数据**: `rule: R-02` · `verified: diff` · `source: community-issue` · `severity: high`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-fast-image/pull/102（merged，+7/-1，1 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-fast-image-102.md](../pr-info/rntpc_react-native-fast-image-102.md)
+
+## 现象
+
+fastImage 加载热更新 bundle 中的图片失败。
+
+## 根因
+
+C++ 层 asset:// 前缀分支未区分 rawfile 资源与沙箱文件路径，一律按 rawfile 资源方式（SetResource）加载，热更新图片实际位于沙箱文件路径，加载必然失败。
+
+## 错误代码（修复前）
+
+```cpp
+if (props->source.uri.rfind(ASSET_PREFIX, 0) == 0) {
+    m_imageKnifeOption->loadSrc.SetResource({.id = -1, .param = newUri.c_str()});
+}
+```
+
+## 正确代码（修复后）
+
+```cpp
+if (props->source.uri.rfind(ASSET_PREFIX, 0) == 0) {
+    if (newUri.find(RAWFILE_PREFIX, 0) == 0) {
+        m_imageKnifeOption->loadSrc.SetResource({.id = -1, .param = newUri.c_str()});
+    } else {
+        m_imageKnifeOption->loadSrc.SetString(newUri.c_str());
+    }
+}
+```
+
+## 修复方式
+
+在 asset:// 分支内二次判断：若路径以 RAWFILE_PREFIX 开头走 SetResource，否则走 SetString（文件路径加载）。

package/vendor/BadCase/rn/cases/KI-003-wechat/347/274/251/347/225/245/345/233/276/346/234/254/345/234/260/345/233/276/347/211/207.md

@@ -0,0 +1,62 @@
+# KI-003 react-native-wechat-lib：shareWebpage 缩略图不支持本地图片
+
+- **元数据**: `rule: R-02, R-03` · `verified: diff` · `source: community-issue` · `severity: high`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-wechat-lib/pull/15（merged，核心 3 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-wechat-lib-15.md](../pr-info/rntpc_react-native-wechat-lib-15.md)
+
+> **复合问题**：本案例同时命中 R-02（URI 形态缺失）与 R-03（附属操作失败阻断主流程），是同一处代码的两个缺陷面。
+
+## 现象
+
+分享网页时 thumbImageUrl 传本地图片报错，无法跳转微信（用户原报告聚焦"下载报错"，实际 patch 证实根因是本地 URI 形态缺失）。
+
+## 根因
+
+缩略图加载只实现了 http 下载一种形态，data:/asset://rawfile 等本地 URI 形态直接走下载逻辑必然失败；且下载失败直接 callback 错误阻断分享主流程。
+
+## 错误代码（修复前，仅 http 下载一种形态）
+
+```typescript
+let thumbImageUrl = (message.thumbImageUrl ? message.thumbImageUrl : null);
+if (thumbImageUrl != null && !(thumbImageUrl === "")) {
+  await new Promise<void>((resolve) => {
+    this.downloadImageWithUrl(thumbImageUrl!, async (imageData: ArrayBuffer) => {
+      if (!imageData) {
+        callback("shareWebpage Failed to retrieve imageData", null);  // ← 本地 URI 走下载必然失败，且阻断主流程
+        return;
+      }
+      // ... 压缩后 resolve
+    }, callback);
+  })
+}
+```
+
+## 正确代码（修复后，按前缀分支覆盖多形态）
+
+```typescript
+async loadThumbImage(thumbImageUrl: string, mediaMessage: wxopensdk.WXMediaMessage): Promise<void> {
+  const getBytes = (): Promise<ArrayBuffer> => {
+    return new Promise<ArrayBuffer>((resolve, reject) => {
+      if (thumbImageUrl.startsWith('http://') || thumbImageUrl.startsWith('https://')) {
+        this.downloadImageWithUrl(thumbImageUrl, resolve, reject);          // ① 远程：下载
+      } else if (thumbImageUrl.startsWith('data:')) {
+        const decoded = new util.Base64Helper().decodeSync(/* base64 部分 */);
+        resolve(decoded.buffer);                                            // ② data: base64 解码
+      } else {
+        let rawFilePath = thumbImageUrl;                                    // ③ asset:// / RAWFILE
+        if (rawFilePath.startsWith(ASSET_PREFIX)) { rawFilePath = 'assets/' + rawFilePath.substring(ASSET_PREFIX.length); }
+        else if (rawFilePath.startsWith(RAWFILE_PREFIX)) { rawFilePath = rawFilePath.substring(RAWFILE_PREFIX.length); }
+        resolve(getContext(this).resourceManager.getRawFileContentSync(rawFilePath).buffer);
+      }
+    });
+  };
+  const imageData = await getBytes();
+  // ... 压缩 + imageSource.release() / thumbPixel.release() 资源释放
+}
+```
+
+## 修复方式
+
+抽取统一 loadThumbImage 方法，按前缀分支：http(s) 走下载、data: 走 base64 解码、asset://RAWFILE 走 resourceManager，各形态独立处理后统一压缩；同时补资源释放（imageSource.release/thumbPixel.release）。
+
+> **R-03 视角注**：本 PR 将多形态加载收敛进 loadThumbImage，但远程下载失败仍会 reject（未完全降级）。理想模式应为 try-catch 包裹附属操作、失败置空 thumbData 继续分享——R-03 规则"正确特征"描述的是理想模式。

package/vendor/BadCase/rn/cases/KI-004-wechat/345/233/236/350/260/203/346/227/266/345/272/217.md

@@ -0,0 +1,47 @@
+# KI-004 react-native-wechat-lib：shareWebpage 回调时序问题
+
+- **元数据**: `rule: R-04` · `verified: diff` · `source: community-issue` · `severity: high`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-wechat-lib/pull/15（merged，与 KI-003 同 PR 复合问题）
+- **diff 材料**: [../pr-info/rntpc_react-native-wechat-lib-15.md](../pr-info/rntpc_react-native-wechat-lib-15.md)
+
+## 现象
+
+shareWebpage 调用偶发无响应/结果异常（用户报告为下载报错无法跳转，实际 patch 证实含回调时序缺陷）。
+
+## 根因
+
+src/index.ts 中先调 nativeShareWebpage(data) 后注册 emitter.once 监听，原生响应可能先于监听到达而丢失；固定 transaction="webpage" 标识在重入场景混淆响应。
+
+## 错误代码（修复前，先调用后注册 + 固定标识）
+
+```typescript
+return new Promise((resolve, reject) => {
+  nativeShareWebpage?.(data);                    // ← 先调 native，响应可能先于监听到达
+  emitter.once("SendMessageToWX.Resp", (resp) => {
+    if (resp.errCode === 0) { resolve(resp); }
+    else { reject(new WechatError(resp)); }
+  });
+});
+// ArkTS 侧：req.transaction = "webpage";        // ← 固定字符串，重入场景混淆响应
+```
+
+## 正确代码（修复后，先注册后调用 + 唯一标识 + 无效响应过滤）
+
+```typescript
+return new Promise((resolve, reject) => {
+  WechatLib.unregisterCallback("SendMessageToWX.Resp");   // ① 清理旧监听
+  WechatLib.registerCallback("SendMessageToWX.Resp", (result) => {
+    if (!result) { return; }                               // ② 过滤空响应
+    const resp = result as WechatResponse & { code?: string; returnKey?: string };
+    if (resp.code !== undefined || resp.returnKey !== undefined) { return; }  // 过滤错误码响应
+    WechatLib.unregisterCallback("SendMessageToWX.Resp");
+    if (resp.errCode === 0) { resolve(resp); } else { reject(new WechatError(resp)); }
+  });
+  nativeShareWebpage?.(data);                             // ③ 最后才调 native
+});
+// ArkTS 侧：req.transaction = util.generateRandomUUID().toString();  // 唯一标识
+```
+
+## 修复方式
+
+调整为先 unregisterCallback 清旧 → registerCallback 注册（含空结果/错误码过滤）→ 最后调 native；transaction 改为 generateRandomUUID。

package/vendor/BadCase/rn/cases/KI-005-geolocation/345/257/274/345/205/245/350/267/257/345/276/204/345/220/216/347/274/200.md

@@ -0,0 +1,31 @@
+# KI-005 react-native-geolocation：3.1.1 接入报错（IDE 爆红）
+
+- **元数据**: `rule: R-05` · `verified: diff` · `source: community-issue` · `severity: low`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-geolocation/pull/24（merged，55 文件，核心修复 2 文件 4 行）
+- **diff 材料**: [../pr-info/rntpc_react-native-geolocation-24.md](../pr-info/rntpc_react-native-geolocation-24.md)
+
+## 现象
+
+用户报告"3.1.1 版本的文件不对，按官方文档接入后直接报错"（用户以为是版本/产物问题）。
+
+## 根因
+
+实际 patch 证实是 index.ets/ts.ets 导入路径带 .ets 后缀导致 IDE 爆红，非版本/产物不一致问题——用户描述与实际根因偏差大，凸显必须看实际 diff。
+
+## 错误代码（修复前，index.ets / ts.ets）
+
+```typescript
+import { GeoLocationPackage } from './src/main/ets/GeoLocationPackage.ets';  // ← 带 .ets 后缀
+export * from './ts.ets';
+```
+
+## 正确代码（修复后）
+
+```typescript
+import { GeoLocationPackage } from './src/main/ets/GeoLocationPackage';     // ← 无后缀
+export * from './ts';
+```
+
+## 修复方式
+
+去除 index.ets/ts.ets 中导入路径的 .ets 后缀（核心修复 2 文件 4 行）；同 PR 附带补齐 example 工程、README、OAT.xml 等配套。

package/vendor/BadCase/rn/cases/KI-006-SmartRefreshLayout/346/231/272/350/203/275/346/214/207/351/222/210/345/264/251/346/272/203.md

@@ -0,0 +1,55 @@
+# KI-006 react-native-SmartRefreshLayout：bad_weak_ptr 崩溃
+
+- **元数据**: `rule: R-07` · `verified: diff` · `source: dtse` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-SmartRefreshLayout/pull/32（merged，6 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-SmartRefreshLayout-32.md](../pr-info/rntpc_react-native-SmartRefreshLayout-32.md)
+
+## 现象
+
+红圈云应用闪退，bad_weak_ptr 崩溃。
+
+## 根因
+
+多线程下 shared_ptr 并发访问未加锁——getPullToRefreshConfigurator() 无锁保护，直接 CHECK 断言非空；析构函数中 reset refreshConfigurator 也无锁，多线程并发访问时触发 bad_weak_ptr。
+
+## 错误代码（修复前）
+
+```cpp
+// PullToRefreshNode.h — getter 无锁，断言失败直接 abort
+std::shared_ptr<PullToRefreshConfigurator> getPullToRefreshConfigurator() {
+    CHECK(refreshConfigurator != nullptr)  // ← 断言失败直接 abort，无锁保护
+        << "[PullToRefreshNode] refreshConfigurator is null!";
+    return refreshConfigurator;
+}
+
+// PullToRefreshNode.cpp — 析构函数无锁 reset
+PullToRefreshNode::~PullToRefreshNode() {
+    refreshConfigurator = nullptr;  // ← 无锁，多线程并发访问
+}
+```
+
+## 正确代码（修复后）
+
+```cpp
+// PullToRefreshNode.h — ① 添加 shared_mutex 成员
+std::shared_mutex config_mutex_;
+
+// ② getter 使用 shared_lock 保护读取，判空记录日志而非 abort
+std::shared_ptr<PullToRefreshConfigurator> getPullToRefreshConfigurator() {
+    std::shared_lock<std::shared_mutex> lock(config_mutex_);
+    if (!refreshConfigurator) {
+        LOG(ERROR)<<"[PullToRefreshNode] getPullToRefreshConfigurator refreshConfigurator is null!";
+    }
+    return refreshConfigurator;
+}
+
+// PullToRefreshNode.cpp — ③ 析构函数加 unique_lock 后 reset
+PullToRefreshNode::~PullToRefreshNode() {
+    std::unique_lock<std::shared_mutex> lock(config_mutex_);
+    refreshConfigurator = nullptr;
+}
+```
+
+## 修复方式
+
+shared_ptr 成员添加 shared_mutex 保护：getter 使用 shared_lock 读取（允许多读），析构函数使用 unique_lock 后 reset（独占写）；getter 将 CHECK 断言改为判空 + LOG 日志，避免断言失败直接 abort。

package/vendor/BadCase/rn/cases/KI-007-orientation-locker/344/274/240/346/204/237/345/231/250/345/210/235/345/247/213/345/214/226.md

@@ -0,0 +1,58 @@
+# KI-007 react-native-orientation-locker：加速度传感器初始化即打开
+
+- **元数据**: `rule: R-06` · `verified: diff` · `source: community-issue` · `severity: high` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-orientation-locker/pull/45（merged，58 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-orientation-locker-45.md](../pr-info/rntpc_react-native-orientation-locker-45.md)
+
+## 现象
+
+使用 react-native-orientation-locker 库后，上架审核被拒——应用获取了用户的个人信息（加速度传感器），不符合相关法律法规要求。
+
+## 根因
+
+加速度传感器在模块初始化时即打开，而非在业务实际调用 addDeviceOrientationListener 时才按需开启——隐私合规要求"使用时才获取"，初始化即获取违反法规。
+
+## 错误代码（修复前）
+
+```typescript
+// 模块顶层或初始化时直接调用 openSensor
+// 每次 addListener 都 openSensor，removeListener 都 closeSensor
+static addDeviceOrientationListener = cb => {
+    OrientationNative.openSensor();  // ← 初始化即打开，每次添加都重复打开
+    // ...
+};
+static removeDeviceOrientationListener = cb => {
+    // ...
+    OrientationNative.closeSensor();  // ← 每次移除都关闭，可能影响其他 listener
+};
+```
+
+## 正确代码（修复后）
+
+```typescript
+// ① 引用计数变量
+var deviceOrientationListenerCount = 0;
+
+static addDeviceOrientationListener = cb => {
+    var key = getKey(cb);
+    if (!listeners[key]) {  // ② 去重：同一 cb 不重复 openSensor
+        if (deviceOrientationListenerCount === 0) {
+            OrientationNative.openSensor();  // ③ 计数为 0 时才打开
+        }
+        deviceOrientationListenerCount++;
+    }
+    // ...
+};
+
+static removeDeviceOrientationListener = cb => {
+    // ...
+    deviceOrientationListenerCount--;
+    if (deviceOrientationListenerCount === 0) {
+        OrientationNative.closeSensor();  // ④ 计数归 0 时才关闭
+    }
+};
+```
+
+## 修复方式
+
+将传感器从"初始化即打开"改为"按需获取"：引入引用计数，首次 addListener 且 count===0 时才 openSensor；removeListener 时 count--，count===0 时才 closeSensor；同一 cb 重复添加不重复计数和 openSensor。

package/vendor/BadCase/rn/cases/KI-008-orientation-locker/344/274/240/346/204/237/345/231/250/345/274/225/347/224/250/350/256/241/346/225/260.md

@@ -0,0 +1,47 @@
+# KI-008 react-native-orientation-locker：传感器频繁 open/close 性能优化
+
+- **元数据**: `rule: R-06` · `verified: diff` · `source: community-issue` · `severity: medium` · `status: draft`
+- **PR**: https://gitcode.com/CPF-RN/rntpc_react-native-orientation-locker/pull/51（merged，1 文件）
+- **diff 材料**: [../pr-info/rntpc_react-native-orientation-locker-51.md](../pr-info/rntpc_react-native-orientation-locker-51.md)
+
+## 现象
+
+优化加速度传感器的打开和关闭——PR 45 修复后，每次 addListener/removeListener 都调用 openSensor/closeSensor，频繁操作导致性能问题。
+
+## 根因
+
+虽有引用计数，但去重逻辑不完善——同一 cb 重复添加时未判断是否已存在，导致计数重复增加；removeAllListeners 时未复位计数和补 closeSensor。
+
+## 错误代码（修复前，PR 45 版本）
+
+```javascript
+// removeAllListeners 未处理传感器关闭
+static removeAllListeners = () => {
+    // 清空 listeners 但未复位计数、未 closeSensor  ← 传感器泄漏
+};
+```
+
+## 正确代码（修复后）
+
+```javascript
+// ① addDeviceOrientationListener 中增加去重判断
+if (!listeners[key]) {
+    if (deviceOrientationListenerCount === 0) {
+        OrientationNative.openSensor();  // ② 整个生命周期只调用一次
+    }
+    deviceOrientationListenerCount++;
+}
+
+// ③ removeAllListeners 中复位计数并补 closeSensor
+static removeAllListeners = () => {
+    // ...
+    if (deviceOrientationListenerCount > 0) {
+        deviceOrientationListenerCount = 0;
+        OrientationNative.closeSensor();
+    }
+};
+```
+
+## 修复方式
+
+完善引用计数管理的边界：addListener 时去重判断（同一 cb 不重复计数）；removeAllListeners 时复位计数并补一次 closeSensor，防止传感器泄漏。