@ohos-cpf/3rdloop 0.0.2 → 0.0.4

package/vendor/Server/Skills/rn-library-known-issue-check/assets/REPORT_TEMPLATE.md

@@ -1,96 +1,96 @@
-# {repoName} 已知问题检视报告
-
-## 一、检视概览
-
-| 字段 | 内容 |
-|------|------|
-| **仓库名称** | {repoName} |
-| **鸿蒙化仓库** | {ohosRepoUrl} |
-| **上游原库** | {upstreamRepoUrl}（可选） |
-| **检视时间** | {时间} |
-| **知识库规则总数** | {N} 条 |
-| **适用规则数** | {M} 条 |
-| **命中规则数** | {K} 条 |
-| **评分** | {score} / 100（命中 {K} 条 → 100 − 30×{K}） |
-
-> ⚠️ **数据置信度说明**（如适用）：本次检视时知识库中 {X} 条规则的状态字段均为 `draft`（未经人工验证）。按 SKILL 核心定位原则 #3「只消费 active 状态规则」，draft 规则原则上不参与检视。但若全部跳过将导致 Phase 2/3（预筛与逐条检视）这一关键环节被架空，与任务「不可跳过或合并关键环节」的要求冲突。故本次仍按预筛特征对 draft 规则执行完整检视，**所有结论标注为「参考级」，待规则转为 active 后复核生效**。
-
----
-
-## 二、规则命中清单
-
-### 适用规则判定结果
-
-| 规则编号 | 规则名 | 严重级别 | 判定 | 命中检查点 | 参考案例 |
-|----------|--------|----------|------|------------|----------|
-| R-XX | {规则名} | {high/medium/low} | 命中/通过/疑似 | {检查点描述} | [KI-XXX](#r-xx) |
-| ... | ... | ... | ... | ... | ... |
-
-### 不适用规则清单（预筛未命中，跳过）
-
-| 规则编号 | 规则名 | 不适用原因 |
-|----------|--------|------------|
-| R-XX | {规则名} | {具体原因} |
-| ... | ... | ... |
-
----
-
-## 三、命中问题详情
-
-<a id="r-xx"></a>
-
-### R-XX {规则名}（严重级别：{high/medium/low}）
-
-- **参考案例**：[KI-XXX {库名} {现象}]({案例文件相对路径})
-- **问题本质**：{问题本质}
-
-#### 命中检查点
-
-| 检查点 | 判定 | 说明 |
-|--------|------|------|
-| 1. {检查点描述} | **命中** | {证据说明} |
-| 2. {检查点描述} | 通过 | {说明} |
-| ... | ... | ... |
-
-#### 错误特征（源码位置）
-
-**{缺陷描述}**：
-```cpp
-// {文件路径}:{行号}
-{错误代码片段，用 // ← 标注缺陷点}
-```
-
-#### 修复指引（正确特征）
-
-按 {案例编号} 案例的正确代码，{修复方案描述}：
-
-```cpp
-// {文件路径}
-{正确代码片段，用 ①②③ 标注修复步骤}
-```
-
-#### 风险评估
-
-- {风险描述：影响场景、严重程度}
-- **缓解因素**：{如有}
-- 建议优先级：{高/中/低}
-
----
-
-## 四、通过规则简要说明
-
-| 规则 | 通过依据 |
-|------|----------|
-| R-XX | {通过理由，含源码证据} |
-| ... | ... |
-
----
-
-## 五、检视结论
-
-1. **命中 {K} 条 {级别} 已知问题（R-XX）**：{总结命中问题及影响}
-2. **其余 {M-K} 条适用规则全部通过**：{总结通过情况}
-3. **{N-M} 条规则预筛不适用**：{总结不适用原因}
-4. **评分 {score}/100**：{评分说明}。建议 {修复建议} 后复检可恢复至 {目标分}。
-
-> ⚠️ 如适用：因知识库规则当前均为 `draft` 状态，本报告所有判定为「参考级」，待规则经人工验证转为 `active` 后正式生效。
+# {repoName} 已知问题检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **鸿蒙化仓库** | {ohosRepoUrl} |
+| **上游原库** | {upstreamRepoUrl}（可选） |
+| **检视时间** | {时间} |
+| **知识库规则总数** | {N} 条 |
+| **适用规则数** | {M} 条 |
+| **命中规则数** | {K} 条 |
+| **评分** | {score} / 100（命中 {K} 条 → 100 − 30×{K}） |
+
+> ⚠️ **数据置信度说明**（如适用）：本次检视时知识库中 {X} 条规则的状态字段均为 `draft`（未经人工验证）。按 SKILL 核心定位原则 #3「只消费 active 状态规则」，draft 规则原则上不参与检视。但若全部跳过将导致 Phase 2/3（预筛与逐条检视）这一关键环节被架空，与任务「不可跳过或合并关键环节」的要求冲突。故本次仍按预筛特征对 draft 规则执行完整检视，**所有结论标注为「参考级」，待规则转为 active 后复核生效**。
+
+---
+
+## 二、规则命中清单
+
+### 适用规则判定结果
+
+| 规则编号 | 规则名 | 严重级别 | 判定 | 命中检查点 | 参考案例 |
+|----------|--------|----------|------|------------|----------|
+| R-XX | {规则名} | {high/medium/low} | 命中/通过/疑似 | {检查点描述} | [KI-XXX](#r-xx) |
+| ... | ... | ... | ... | ... | ... |
+
+### 不适用规则清单（预筛未命中，跳过）
+
+| 规则编号 | 规则名 | 不适用原因 |
+|----------|--------|------------|
+| R-XX | {规则名} | {具体原因} |
+| ... | ... | ... |
+
+---
+
+## 三、命中问题详情
+
+<a id="r-xx"></a>
+
+### R-XX {规则名}（严重级别：{high/medium/low}）
+
+- **参考案例**：[KI-XXX {库名} {现象}]({案例文件相对路径})
+- **问题本质**：{问题本质}
+
+#### 命中检查点
+
+| 检查点 | 判定 | 说明 |
+|--------|------|------|
+| 1. {检查点描述} | **命中** | {证据说明} |
+| 2. {检查点描述} | 通过 | {说明} |
+| ... | ... | ... |
+
+#### 错误特征（源码位置）
+
+**{缺陷描述}**：
+```cpp
+// {文件路径}:{行号}
+{错误代码片段，用 // ← 标注缺陷点}
+```
+
+#### 修复指引（正确特征）
+
+按 {案例编号} 案例的正确代码，{修复方案描述}：
+
+```cpp
+// {文件路径}
+{正确代码片段，用 ①②③ 标注修复步骤}
+```
+
+#### 风险评估
+
+- {风险描述：影响场景、严重程度}
+- **缓解因素**：{如有}
+- 建议优先级：{高/中/低}
+
+---
+
+## 四、通过规则简要说明
+
+| 规则 | 通过依据 |
+|------|----------|
+| R-XX | {通过理由，含源码证据} |
+| ... | ... |
+
+---
+
+## 五、检视结论
+
+1. **命中 {K} 条 {级别} 已知问题（R-XX）**：{总结命中问题及影响}
+2. **其余 {M-K} 条适用规则全部通过**：{总结通过情况}
+3. **{N-M} 条规则预筛不适用**：{总结不适用原因}
+4. **评分 {score}/100**：{评分说明}。建议 {修复建议} 后复检可恢复至 {目标分}。
+
+> ⚠️ 如适用：因知识库规则当前均为 `draft` 状态，本报告所有判定为「参考级」，待规则经人工验证转为 `active` 后正式生效。

package/vendor/Server/Skills/rn-library-known-issue-check/references/COMPLIANCE_CHECKLIST.md

@@ -1,58 +1,58 @@
-# 已知问题检视合规检查清单
-
-> 检视流程完成后，对照此清单进行自检，确保检视质量。
-
----
-
-## 1. 输入检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 1.1 | 知识库 INDEX.md 存在 | `{knowledgeDir}/INDEX.md` 可读取 |
-| 1.2 | 鸿蒙化源码目录存在 | `{outputDir}/source/ohos/` 非空 |
-| 1.3 | 接口规格说明存在 | `{outputDir}/接口规格说明.md` 可读取 |
-| 1.4 | 上游原库代码存在 | `{outputDir}/source/RN/` 非空（可选） |
-
----
-
-## 2. 预筛检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 2.1 | 已读取所有规则文件 | 覆盖 INDEX.md 列出的全部规则 |
-| 2.2 | 适用规则有明确判定依据 | 每条规则记录「适用/不适用」及原因 |
-| 2.3 | 预筛特征准确 | 依赖/文件/API/能力四维度至少使用两个维度 |
-| 2.4 | 不适用规则记录原因 | 不适用原因具体化，非模板化描述 |
-
----
-
-## 3. 检视检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 3.1 | 每条适用规则已逐条检查 | 所有检查点已给出判定 |
-| 3.2 | 命中问题有证据 | 文件路径 + 行号 + 代码片段 |
-| 3.3 | 命中问题引用案例 | 至少引用一个案例作为修复指引 |
-| 3.4 | 通过规则有通过依据 | 简要说明通过的理由 |
-| 3.5 | 疑似命中已标注 | 标注"需人工复核" |
-
----
-
-## 4. 评分检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 4.1 | 评分公式正确 | `max(0, 100 - 30 × 命中规则数)` |
-| 4.2 | 不适用规则不计入分母 | 评分基于「适用规则」计算 |
-| 4.3 | 无适用规则时评分 100 | 标注"无适用规则" |
-
----
-
-## 5. 报告检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 5.1 | 报告包含五部分 | 检视概览、规则命中清单、命中问题详情、通过规则说明、检视结论 |
-| 5.2 | 不适用规则清单完整 | 列出所有不适用规则及原因 |
-| 5.3 | 命中问题详情有修复指引 | 含正确特征描述或修复方案 |
+# 已知问题检视合规检查清单
+
+> 检视流程完成后，对照此清单进行自检，确保检视质量。
+
+---
+
+## 1. 输入检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 1.1 | 知识库 INDEX.md 存在 | `{knowledgeDir}/INDEX.md` 可读取 |
+| 1.2 | 鸿蒙化源码目录存在 | `{outputDir}/source/ohos/` 非空 |
+| 1.3 | 接口规格说明存在 | `{outputDir}/接口规格说明.md` 可读取 |
+| 1.4 | 上游原库代码存在 | `{outputDir}/source/RN/` 非空（可选） |
+
+---
+
+## 2. 预筛检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 2.1 | 已读取所有规则文件 | 覆盖 INDEX.md 列出的全部规则 |
+| 2.2 | 适用规则有明确判定依据 | 每条规则记录「适用/不适用」及原因 |
+| 2.3 | 预筛特征准确 | 依赖/文件/API/能力四维度至少使用两个维度 |
+| 2.4 | 不适用规则记录原因 | 不适用原因具体化，非模板化描述 |
+
+---
+
+## 3. 检视检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 3.1 | 每条适用规则已逐条检查 | 所有检查点已给出判定 |
+| 3.2 | 命中问题有证据 | 文件路径 + 行号 + 代码片段 |
+| 3.3 | 命中问题引用案例 | 至少引用一个案例作为修复指引 |
+| 3.4 | 通过规则有通过依据 | 简要说明通过的理由 |
+| 3.5 | 疑似命中已标注 | 标注"需人工复核" |
+
+---
+
+## 4. 评分检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 4.1 | 评分公式正确 | `max(0, 100 - 30 × 命中规则数)` |
+| 4.2 | 不适用规则不计入分母 | 评分基于「适用规则」计算 |
+| 4.3 | 无适用规则时评分 100 | 标注"无适用规则" |
+
+---
+
+## 5. 报告检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 5.1 | 报告包含五部分 | 检视概览、规则命中清单、命中问题详情、通过规则说明、检视结论 |
+| 5.2 | 不适用规则清单完整 | 列出所有不适用规则及原因 |
+| 5.3 | 命中问题详情有修复指引 | 含正确特征描述或修复方案 |
 | 5.4 | 报告路径正确 | 生成到 `{outputDir}/已知问题检视报告.md` |

package/vendor/Server/Skills/rn-library-known-issue-check/references/INSPECTION_GUIDE.md

@@ -1,99 +1,99 @@
-# 规则检视指南
-
-> 本文档为 Phase 3「逐条规则检视」的详细操作指南，覆盖规则文件读取、源码对照检查、判定规则、few-shot 参考四个环节。
-
----
-
-## 1. 规则文件结构
-
-读取 `rules/R-XX-*.md`，获取以下字段：
-
-| 字段 | 用途 |
-|------|------|
-| **状态** | `draft` / `active`。只消费 `active` 状态规则（见 SKILL.md 核心定位 #3） |
-| **严重级别** | high / medium / low，及判定依据 |
-| **适用范围** | 含预筛特征（Phase 2 使用） |
-| **问题本质** | 机制层描述，理解这类问题为什么会发生 |
-| **检查点** | 逐条可判定的源码检查动作（2-5 条） |
-| **错误特征** | 命中此类问题的典型代码形态 |
-| **正确特征** | 修复后的代码形态 |
-| **来源案例** | 案例索引（编号/库/现象/案例文件） |
-
----
-
-## 2. 对照源码检查
-
-按规则文件的**检查点**逐条对照 `{outputDir}/source/ohos/` 源码检查。
-
-### 2.1 检查点判定
-
-每条检查点给出 **是/否/疑似** 判定：
-
-| 判定 | 含义 | 处理 |
-|------|------|------|
-| **是**（命中） | 源码存在规则描述的**错误特征** | 记录为命中问题，引用案例作为修复指引 |
-| **否**（通过） | 源码符合**正确特征** | 记录为通过 |
-| **疑似** | 无法确定，需进一步确认 | 记录为疑似命中，报告中标注"需人工复核" |
-
-### 2.2 检查点判定技巧
-
-| 检查点类型 | 判定方法 |
-|------------|----------|
-| 存在性检查（是否存在某文件/某调用） | 全量扫描源码目录，grep 关键词 |
-| 顺序检查（析构顺序/注册时序） | 阅读相关函数/析构函数，分析成员声明顺序与销毁顺序 |
-| 完整性检查（接口是否全部实现） | 对照接口声明与实现文件，逐一核对 |
-| 健壮性检查（异常处理/空判） | 阅读异常分支代码，检查 try-catch / null 判断 |
-
-### 2.3 证据记录
-
-命中检查点时，必须记录**证据**：
-- 文件路径 + 行号（如 `ReanimatedModuleProxy.cpp:192-200`）
-- 关键代码片段（≤15 行，用 `// ←` 标注缺陷点）
-- 判定依据（为什么判定为命中）
-
-> 证据是报告「命中问题详情」的核心内容，缺失证据的命中判定视为无效。
-
----
-
-## 3. 规则命中判定
-
-- 规则中**任一检查点命中错误特征** → 该规则**命中**（记 1 个问题）
-- 所有检查点均通过 → 该规则**通过**
-- 疑似命中 → 按命中处理（报告中标注"疑似"），避免漏报
-
----
-
-## 4. few-shot 参考
-
-判定困难时，读取规则文件引用的案例文件（`cases/KI-XXX-*.md`），对照"错误代码/正确代码"片段辅助判定。
-
-### 4.1 案例文件结构
-
-| 字段 | 用途 |
-|------|------|
-| 库与现象 | 原始具体信息 |
-| 根因 | 机制层根因（与规则"问题本质"呼应） |
-| 错误代码 | 修复前代码片段（`verified: diff` 时必填） |
-| 正确代码 | 修复后代码片段（`verified: diff` 时必填） |
-| 修复方式 | 可迁移的修复模式 |
-| PR 链接 | 修复 PR 完整 URL |
-| diff 材料 | 链接到 `pr-info/{repo}-{number}.md` |
-
-### 4.2 使用场景
-
-| 场景 | 用法 |
-|------|------|
-| 判定困难 | 对照案例错误/正确代码，确认当前库代码形态属于哪一类 |
-| 修复指引 | 从案例「修复方式」提炼可迁移的修复建议 |
-| 证据补充 | 案例 diff 材料可作为命中判定的佐证 |
-
----
-
-## 5. 常见判定陷阱
-
-| 陷阱 | 规避方法 |
-|------|----------|
-| 只看 ArkTS 层，忽略 C++ 层 | 同时检索 `.cpp` / `.h` 文件 |
-| 只看 `source/ohos/`，忽略 `source/RN/` 对比 | 命中判定需与上游对比，确认是鸿蒙化引入的问题还是上游遗留 |
-| 凭印象判定，不记录证据 | 每条命中必须记录文件路径 + 行号 + 代码片段 |
-| 疑似命中直接跳过 | 疑似按命中处理，报告中标注"需人工复核" |
+# 规则检视指南
+
+> 本文档为 Phase 3「逐条规则检视」的详细操作指南，覆盖规则文件读取、源码对照检查、判定规则、few-shot 参考四个环节。
+
+---
+
+## 1. 规则文件结构
+
+读取 `rules/R-XX-*.md`，获取以下字段：
+
+| 字段 | 用途 |
+|------|------|
+| **状态** | `draft` / `active`。只消费 `active` 状态规则（见 SKILL.md 核心定位 #3） |
+| **严重级别** | high / medium / low，及判定依据 |
+| **适用范围** | 含预筛特征（Phase 2 使用） |
+| **问题本质** | 机制层描述，理解这类问题为什么会发生 |
+| **检查点** | 逐条可判定的源码检查动作（2-5 条） |
+| **错误特征** | 命中此类问题的典型代码形态 |
+| **正确特征** | 修复后的代码形态 |
+| **来源案例** | 案例索引（编号/库/现象/案例文件） |
+
+---
+
+## 2. 对照源码检查
+
+按规则文件的**检查点**逐条对照 `{outputDir}/source/ohos/` 源码检查。
+
+### 2.1 检查点判定
+
+每条检查点给出 **是/否/疑似** 判定：
+
+| 判定 | 含义 | 处理 |
+|------|------|------|
+| **是**（命中） | 源码存在规则描述的**错误特征** | 记录为命中问题，引用案例作为修复指引 |
+| **否**（通过） | 源码符合**正确特征** | 记录为通过 |
+| **疑似** | 无法确定，需进一步确认 | 记录为疑似命中，报告中标注"需人工复核" |
+
+### 2.2 检查点判定技巧
+
+| 检查点类型 | 判定方法 |
+|------------|----------|
+| 存在性检查（是否存在某文件/某调用） | 全量扫描源码目录，grep 关键词 |
+| 顺序检查（析构顺序/注册时序） | 阅读相关函数/析构函数，分析成员声明顺序与销毁顺序 |
+| 完整性检查（接口是否全部实现） | 对照接口声明与实现文件，逐一核对 |
+| 健壮性检查（异常处理/空判） | 阅读异常分支代码，检查 try-catch / null 判断 |
+
+### 2.3 证据记录
+
+命中检查点时，必须记录**证据**：
+- 文件路径 + 行号（如 `ReanimatedModuleProxy.cpp:192-200`）
+- 关键代码片段（≤15 行，用 `// ←` 标注缺陷点）
+- 判定依据（为什么判定为命中）
+
+> 证据是报告「命中问题详情」的核心内容，缺失证据的命中判定视为无效。
+
+---
+
+## 3. 规则命中判定
+
+- 规则中**任一检查点命中错误特征** → 该规则**命中**（记 1 个问题）
+- 所有检查点均通过 → 该规则**通过**
+- 疑似命中 → 按命中处理（报告中标注"疑似"），避免漏报
+
+---
+
+## 4. few-shot 参考
+
+判定困难时，读取规则文件引用的案例文件（`cases/KI-XXX-*.md`），对照"错误代码/正确代码"片段辅助判定。
+
+### 4.1 案例文件结构
+
+| 字段 | 用途 |
+|------|------|
+| 库与现象 | 原始具体信息 |
+| 根因 | 机制层根因（与规则"问题本质"呼应） |
+| 错误代码 | 修复前代码片段（`verified: diff` 时必填） |
+| 正确代码 | 修复后代码片段（`verified: diff` 时必填） |
+| 修复方式 | 可迁移的修复模式 |
+| PR 链接 | 修复 PR 完整 URL |
+| diff 材料 | 链接到 `pr-info/{repo}-{number}.md` |
+
+### 4.2 使用场景
+
+| 场景 | 用法 |
+|------|------|
+| 判定困难 | 对照案例错误/正确代码，确认当前库代码形态属于哪一类 |
+| 修复指引 | 从案例「修复方式」提炼可迁移的修复建议 |
+| 证据补充 | 案例 diff 材料可作为命中判定的佐证 |
+
+---
+
+## 5. 常见判定陷阱
+
+| 陷阱 | 规避方法 |
+|------|----------|
+| 只看 ArkTS 层，忽略 C++ 层 | 同时检索 `.cpp` / `.h` 文件 |
+| 只看 `source/ohos/`，忽略 `source/RN/` 对比 | 命中判定需与上游对比，确认是鸿蒙化引入的问题还是上游遗留 |
+| 凭印象判定，不记录证据 | 每条命中必须记录文件路径 + 行号 + 代码片段 |
+| 疑似命中直接跳过 | 疑似按命中处理，报告中标注"需人工复核" |

package/vendor/Server/Skills/rn-library-known-issue-check/references/PRESCREEN_GUIDE.md

@@ -1,64 +1,64 @@
-# 预筛指南
-
-> 本文档为 Phase 2「预筛适用规则」的详细操作指南。预筛是**核心环节**：知识库 19+ 条规则不可能全部适用于每个库，预筛决定哪些规则进入深度检查，直接影响检视效率与评分准确性。
-
----
-
-## 1. 预筛特征四维度
-
-对每条规则，读取其规则文件（`rules/R-XX-*.md`）的**适用范围 + 预筛特征**，从四个维度判定是否适用：
-
-| 维度 | 判定依据 | 检索位置 |
-|------|----------|----------|
-| **依赖特征** | 当前库的 `oh-package.json5` / `package.json` 依赖中是否包含规则描述的依赖类型 | `{outputDir}/source/ohos/oh-package.json5`、`package.json` |
-| **文件特征** | 源码中是否存在规则描述的文件类型（`.ets` / `.cpp` / `module.json5` 等） | `{outputDir}/source/ohos/` 全量文件扫描 |
-| **API 特征** | 源码中是否调用规则描述的 API（`sensor.on` / `.gesture()` / `window` API 等） | `{outputDir}/source/ohos/` 代码内容检索 |
-| **能力声明** | 接口规格说明.md / README 中是否声明规则描述的能力（全屏/横屏/传感器等） | `{outputDir}/接口规格说明.md`、README |
-
----
-
-## 2. 判定规则
-
-| 判定 | 条件 | 处理 |
-|------|------|------|
-| **适用** | 命中任一预筛特征 | 进入 Phase 3 深度检查 |
-| **不适用** | 未命中任何预筛特征 | 跳过，记录跳过原因 |
-
-> ⚠️ **预筛不适用规则不计入评分分母**。评分只基于「适用规则」计算。
-
----
-
-## 3. 常见预筛误判与规避
-
-### 3.1 误判为「适用」（过度预筛）
-
-| 场景 | 规避方法 |
-|------|----------|
-| 库的 `example/` 目录含某能力，但库本体没有 | 预筛只看库本体源码，排除 `example/` |
-| 依赖中声明了某 SDK，但代码从未调用 | 依赖特征需**结合 API 特征**确认，仅依赖声明不足以判定适用 |
-| 上游 RN 原库有某能力，但鸿蒙化实现未移植 | 预筛针对**鸿蒙化实现**（`source/ohos/`），不看上游 `source/RN/` |
-
-### 3.2 误判为「不适用」（漏筛）
-
-| 场景 | 规避方法 |
-|------|----------|
-| 能力通过 C++ 层实现，ArkTS 层无痕迹 | 同时检索 `.cpp` / `.h` 文件中的 API 特征 |
-| 能力声明在 README 但代码中命名不同 | 以「能力声明」维度兜底，README/接口文档声明即视为候选 |
-| 规则描述的能力是「间接依赖」（如手势库被本库依赖） | 检查 `oh-package.json5` 的 dependencies 是否含相关库 |
-
-### 3.3 判定技巧
-
-- **先读 INDEX.md 分类**：媒体与窗口类规则（R-01/R-09/R-10）只对媒体/窗口类库可能适用；C++ 内存类规则（R-07/R-12）只对含 C++ 层的库可能适用。分类可快速缩小候选集。
-- **能力声明优先**：接口规格说明.md 是预筛的最快入口，先读它了解库对外声明的能力，再对照规则分类。
-- **记录跳过原因**：不适用规则必须记录具体原因（如「库无全屏/视频/Web 媒体能力声明，ArkTS 层无窗口状态 API」），供报告「不适用规则清单」使用。
-
----
-
-## 4. 预筛输出
-
-预筛完成后，输出两类清单：
-
-1. **适用规则清单**：规则编号 + 规则名 + 命中预筛特征（进入 Phase 3）
-2. **不适用规则清单**：规则编号 + 规则名 + 不适用原因（写入报告）
-
-> 预筛结果示例参见 [报告模板](assets/REPORT_TEMPLATE.md) 的「二、规则命中清单」。
+# 预筛指南
+
+> 本文档为 Phase 2「预筛适用规则」的详细操作指南。预筛是**核心环节**：知识库 19+ 条规则不可能全部适用于每个库，预筛决定哪些规则进入深度检查，直接影响检视效率与评分准确性。
+
+---
+
+## 1. 预筛特征四维度
+
+对每条规则，读取其规则文件（`rules/R-XX-*.md`）的**适用范围 + 预筛特征**，从四个维度判定是否适用：
+
+| 维度 | 判定依据 | 检索位置 |
+|------|----------|----------|
+| **依赖特征** | 当前库的 `oh-package.json5` / `package.json` 依赖中是否包含规则描述的依赖类型 | `{outputDir}/source/ohos/oh-package.json5`、`package.json` |
+| **文件特征** | 源码中是否存在规则描述的文件类型（`.ets` / `.cpp` / `module.json5` 等） | `{outputDir}/source/ohos/` 全量文件扫描 |
+| **API 特征** | 源码中是否调用规则描述的 API（`sensor.on` / `.gesture()` / `window` API 等） | `{outputDir}/source/ohos/` 代码内容检索 |
+| **能力声明** | 接口规格说明.md / README 中是否声明规则描述的能力（全屏/横屏/传感器等） | `{outputDir}/接口规格说明.md`、README |
+
+---
+
+## 2. 判定规则
+
+| 判定 | 条件 | 处理 |
+|------|------|------|
+| **适用** | 命中任一预筛特征 | 进入 Phase 3 深度检查 |
+| **不适用** | 未命中任何预筛特征 | 跳过，记录跳过原因 |
+
+> ⚠️ **预筛不适用规则不计入评分分母**。评分只基于「适用规则」计算。
+
+---
+
+## 3. 常见预筛误判与规避
+
+### 3.1 误判为「适用」（过度预筛）
+
+| 场景 | 规避方法 |
+|------|----------|
+| 库的 `example/` 目录含某能力，但库本体没有 | 预筛只看库本体源码，排除 `example/` |
+| 依赖中声明了某 SDK，但代码从未调用 | 依赖特征需**结合 API 特征**确认，仅依赖声明不足以判定适用 |
+| 上游 RN 原库有某能力，但鸿蒙化实现未移植 | 预筛针对**鸿蒙化实现**（`source/ohos/`），不看上游 `source/RN/` |
+
+### 3.2 误判为「不适用」（漏筛）
+
+| 场景 | 规避方法 |
+|------|----------|
+| 能力通过 C++ 层实现，ArkTS 层无痕迹 | 同时检索 `.cpp` / `.h` 文件中的 API 特征 |
+| 能力声明在 README 但代码中命名不同 | 以「能力声明」维度兜底，README/接口文档声明即视为候选 |
+| 规则描述的能力是「间接依赖」（如手势库被本库依赖） | 检查 `oh-package.json5` 的 dependencies 是否含相关库 |
+
+### 3.3 判定技巧
+
+- **先读 INDEX.md 分类**：媒体与窗口类规则（R-01/R-09/R-10）只对媒体/窗口类库可能适用；C++ 内存类规则（R-07/R-12）只对含 C++ 层的库可能适用。分类可快速缩小候选集。
+- **能力声明优先**：接口规格说明.md 是预筛的最快入口，先读它了解库对外声明的能力，再对照规则分类。
+- **记录跳过原因**：不适用规则必须记录具体原因（如「库无全屏/视频/Web 媒体能力声明，ArkTS 层无窗口状态 API」），供报告「不适用规则清单」使用。
+
+---
+
+## 4. 预筛输出
+
+预筛完成后，输出两类清单：
+
+1. **适用规则清单**：规则编号 + 规则名 + 命中预筛特征（进入 Phase 3）
+2. **不适用规则清单**：规则编号 + 规则名 + 不适用原因（写入报告）
+
+> 预筛结果示例参见 [报告模板](assets/REPORT_TEMPLATE.md) 的「二、规则命中清单」。