@ohos-cpf/3rdloop 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (393) hide show
  1. package/README.md +245 -425
  2. package/bin/3rdloop.mjs +46 -46
  3. package/lib/cli.js +781 -740
  4. package/lib/config-cmd.js +452 -0
  5. package/lib/config.js +318 -317
  6. package/lib/doctor.js +113 -113
  7. package/lib/exit-codes.js +30 -30
  8. package/lib/opencode.js +155 -155
  9. package/lib/orch.js +426 -426
  10. package/lib/queries.js +263 -263
  11. package/lib/step.js +325 -325
  12. package/lib/ui.js +222 -222
  13. package/lib/update.js +280 -0
  14. package/lib/workflow.js +308 -290
  15. package/lib/workflows.js +131 -131
  16. package/package.json +50 -50
  17. package/vendor/Server/Agent/SkillSelector/README.md +343 -343
  18. package/vendor/Server/Agent/SkillSelector/core/Agent.js +207 -207
  19. package/vendor/Server/Agent/SkillSelector/index.js +14 -14
  20. package/vendor/Server/Agent/SkillSelector/llm/llmClient.js +313 -313
  21. package/vendor/Server/Agent/SkillSelector/llm/prompts.js +161 -161
  22. package/vendor/Server/Agent/SkillSelector/llm/reactSteps.js +144 -144
  23. package/vendor/Server/Agent/SkillSelector/matcher/fuzzyMatcher.js +433 -433
  24. package/vendor/Server/Agent/SkillSelector/scanner/skillScanner.js +382 -382
  25. package/vendor/Server/Agent/SkillSelector/utils/actionWords.js +59 -59
  26. package/vendor/Server/Brain/AnalysisStrategies.js +422 -422
  27. package/vendor/Server/Brain/Brain.js +686 -686
  28. package/vendor/Server/Brain/DecompositionStrategies.js +621 -621
  29. package/vendor/Server/Brain/PlanPersistence.js +196 -196
  30. package/vendor/Server/Brain/SkillExecutor.js +251 -251
  31. package/vendor/Server/Brain/index.js +11 -11
  32. package/vendor/Server/CLI/cli.js +275 -243
  33. package/vendor/Server/CLI/deveco-code/index.js +71 -0
  34. package/vendor/Server/CLI/deveco-code.js +5 -0
  35. package/vendor/Server/CLI/opencode/index.js +817 -804
  36. package/vendor/Server/CLI/opencode.js +5 -5
  37. package/vendor/Server/DbUse/MessageArchive.js +61 -61
  38. package/vendor/Server/DbUse/StorageManager.js +107 -107
  39. package/vendor/Server/DbUse/adapters/BaseAdapter.js +94 -94
  40. package/vendor/Server/DbUse/adapters/FileAdapter.js +138 -138
  41. package/vendor/Server/DbUse/adapters/JsonAdapter.js +138 -138
  42. package/vendor/Server/DbUse/adapters/JsonlAdapter.js +114 -114
  43. package/vendor/Server/DbUse/adapters/SqliteAdapter.js +157 -157
  44. package/vendor/Server/DbUse/index.js +160 -160
  45. package/vendor/Server/DbUse/stores/SessionStore.js +279 -279
  46. package/vendor/Server/DbUse/stores/TaskExecutionStore.js +133 -133
  47. package/vendor/Server/DbUse/stores/TaskRegistryStore.js +262 -262
  48. package/vendor/Server/DbUse/stores/TaskStepStore.js +279 -279
  49. package/vendor/Server/FlexRunner/FlexRunner.js +1759 -1759
  50. package/vendor/Server/FlexRunner/index.js +12 -12
  51. package/vendor/Server/Knowledge/KnowledgeImporter.js +523 -523
  52. package/vendor/Server/Knowledge/KnowledgeManager.js +341 -341
  53. package/vendor/Server/Knowledge/index.js +33 -33
  54. package/vendor/Server/LoopEngine/LoopEngine.js +1133 -1133
  55. package/vendor/Server/LoopEngine/index.js +11 -11
  56. package/vendor/Server/Orchestrator/Orchestrator.js +0 -3
  57. package/vendor/Server/Orchestrator/StepNode.js +312 -312
  58. package/vendor/Server/Orchestrator/index.js +13 -13
  59. package/vendor/Server/Routes/controllers/BrainController.js +241 -241
  60. package/vendor/Server/Routes/controllers/FlexRunnerController.js +1125 -1125
  61. package/vendor/Server/Routes/controllers/HealthController.js +44 -44
  62. package/vendor/Server/Routes/controllers/KnowledgeImportController.js +355 -355
  63. package/vendor/Server/Routes/controllers/LoopEngineController.js +788 -788
  64. package/vendor/Server/Routes/controllers/StatsController.js +57 -57
  65. package/vendor/Server/Routes/controllers/StreamController.js +67 -67
  66. package/vendor/Server/Routes/library/logger.js +179 -179
  67. package/vendor/Server/Routes/library/zipArchive.js +172 -172
  68. package/vendor/Server/Routes/router/Router.js +204 -204
  69. package/vendor/Server/Routes/routes/brain.js +47 -47
  70. package/vendor/Server/Routes/routes/flexrunner.js +72 -72
  71. package/vendor/Server/Routes/routes/health.js +28 -28
  72. package/vendor/Server/Routes/routes/index.js +57 -57
  73. package/vendor/Server/Routes/routes/knowledge.js +55 -55
  74. package/vendor/Server/Routes/routes/loopengine.js +58 -58
  75. package/vendor/Server/Routes/routes/orchestrator.js +61 -61
  76. package/vendor/Server/Routes/routes/registry.js +97 -97
  77. package/vendor/Server/Routes/routes/stats.js +23 -23
  78. package/vendor/Server/Routes/routes/stream.js +30 -30
  79. package/vendor/Server/Routes/server.js +203 -202
  80. package/vendor/Server/Routes/sse/SseHub.js +308 -308
  81. package/vendor/Server/Skills/acceptance-check/SKILL.md +191 -174
  82. package/vendor/Server/Skills/acceptance-check/references/PHASE1_ARTIFACT_COLLECTION.md +52 -52
  83. package/vendor/Server/Skills/acceptance-check/references/PHASE2_CRITERIA_EVALUATION.md +77 -77
  84. package/vendor/Server/Skills/acceptance-check/references/PHASE2_EVIDENCE_VERIFICATION.md +70 -0
  85. package/vendor/Server/Skills/arkts-code-check/SKILL.md +320 -313
  86. package/vendor/Server/Skills/arkts-code-check/references/CODE_CHECK_GUIDE.md +210 -159
  87. package/vendor/Server/Skills/arkts-code-check/references/FILE_TYPE_GUIDE.md +28 -28
  88. package/vendor/Server/Skills/arkts-code-check/references/PHASE1_INFO_COLLECTION.md +233 -222
  89. package/vendor/Server/Skills/arkts-code-check/references/REPORT_TEMPLATE.md +219 -219
  90. package/vendor/Server/Skills/arkts-library-compile-validate/SKILL.md +328 -328
  91. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/build.ps1 +93 -93
  92. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/code-linter.cjs +432 -432
  93. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/migrate.cjs +851 -851
  94. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/ohpm-switch.cjs +788 -788
  95. package/vendor/Server/Skills/arkts-library-demo-code/SKILL.md +291 -291
  96. package/vendor/Server/Skills/arkts-library-demo-code/references/API_SIGNATURE_CHECKS.md +68 -68
  97. package/vendor/Server/Skills/arkts-library-demo-code/references/BUILD_VALIDATION.md +184 -184
  98. package/vendor/Server/Skills/arkts-library-demo-code/references/CODE_STANDARDS.md +337 -337
  99. package/vendor/Server/Skills/arkts-library-demo-code/references/EXAMPLES.md +400 -400
  100. package/vendor/Server/Skills/arkts-library-demo-code/references/SYSTEM_API_LOOKUP.md +98 -98
  101. package/vendor/Server/Skills/arkts-library-demo-code/references/TEMPLATE.md +544 -544
  102. package/vendor/Server/Skills/arkts-library-demo-code/scripts/build.ps1 +93 -93
  103. package/vendor/Server/Skills/arkts-library-demo-code/scripts/code-linter.cjs +432 -432
  104. package/vendor/Server/Skills/arkts-library-demo-code/scripts/migrate.cjs +851 -851
  105. package/vendor/Server/Skills/arkts-library-demo-code/scripts/ohpm-switch.cjs +788 -788
  106. package/vendor/Server/Skills/arkts-library-demo-coverage/SKILL.md +174 -174
  107. package/vendor/Server/Skills/arkts-library-demo-scenario/SKILL.md +321 -321
  108. package/vendor/Server/Skills/arkts-library-demo-scenario/references/EXAMPLES.md +100 -100
  109. package/vendor/Server/Skills/arkts-library-demo-scenario/references/TEMPLATE.md +185 -185
  110. package/vendor/Server/Skills/arkts-library-documentation-quality-check/SKILL.md +233 -233
  111. package/vendor/Server/Skills/arkts-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +102 -102
  112. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/CHECK_DIMENSIONS.md +89 -89
  113. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/COMPLIANCE_CHECKLIST.md +62 -62
  114. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/KB_QUERY_GUIDE.md +107 -107
  115. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/MCP_TOOL_DISCOVERY.md +124 -124
  116. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/REPORT_TEMPLATE.md +90 -90
  117. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/SCORING_FORMULA.md +57 -57
  118. package/vendor/Server/Skills/arkts-library-documentation-quality-check/scripts/validate-skill.cjs +259 -259
  119. package/vendor/Server/Skills/arkts-library-interface-spec/SKILL.md +97 -97
  120. package/vendor/Server/Skills/arkts-library-memory-leak-check/SKILL.md +391 -391
  121. package/vendor/Server/Skills/arkts-library-source-clone/SKILL.md +113 -113
  122. package/vendor/Server/Skills/arkts-library-stability-check/SKILL.md +312 -312
  123. package/vendor/Server/Skills/arkts-library-stability-check/assets/REPORT_TEMPLATE.md +154 -154
  124. package/vendor/Server/Skills/arkts-library-stability-check/references/CHECKLIST.md +165 -165
  125. package/vendor/Server/Skills/arkts-library-stability-check/references/CODE_EXAMPLES.md +308 -308
  126. package/vendor/Server/Skills/arkts-library-stability-check/references/SCORING_RULES.md +90 -90
  127. package/vendor/Server/Skills/arkts-library-stability-check/scripts/validate-skill.cjs +282 -282
  128. package/vendor/Server/Skills/arkts-library-test-coverage-check/SKILL.md +360 -360
  129. package/vendor/Server/Skills/arkts-library-test-coverage-check/assets/REPORT_TEMPLATE.md +145 -145
  130. package/vendor/Server/Skills/arkts-library-test-coverage-check/references/CHECKLIST.md +252 -252
  131. package/vendor/Server/Skills/arkts-library-test-coverage-check/references/MCP_TOOL_USAGE.md +114 -114
  132. package/vendor/Server/Skills/arkts-library-test-coverage-check/scripts/validate-skill.cjs +262 -262
  133. package/vendor/Server/Skills/arkts-library-xts-code/SKILL.md +455 -455
  134. package/vendor/Server/Skills/arkts-library-xts-code/assets/report-template.md +60 -60
  135. package/vendor/Server/Skills/arkts-library-xts-code/references/ACCESS_MODIFIER_PRECHECK.md +76 -76
  136. package/vendor/Server/Skills/arkts-library-xts-code/references/BUILD_VERIFICATION.md +200 -200
  137. package/vendor/Server/Skills/arkts-library-xts-code/references/CODE_STANDARDS.md +518 -518
  138. package/vendor/Server/Skills/arkts-library-xts-code/references/SUBAGENT_PROMPT_TEMPLATE.md +276 -276
  139. package/vendor/Server/Skills/arkts-library-xts-code/references/SYSTEM_API_LOOKUP.md +92 -92
  140. package/vendor/Server/Skills/arkts-library-xts-code/references/XTS_TEMPLATE.md +767 -767
  141. package/vendor/Server/Skills/arkts-library-xts-code/scripts/build.ps1 +93 -93
  142. package/vendor/Server/Skills/arkts-library-xts-code/scripts/code-linter.cjs +432 -432
  143. package/vendor/Server/Skills/arkts-library-xts-code/scripts/migrate.cjs +851 -851
  144. package/vendor/Server/Skills/arkts-library-xts-code/scripts/ohpm-switch.cjs +788 -788
  145. package/vendor/Server/Skills/arkts-library-xts-code/scripts/precheck-access-modifiers.cjs +221 -221
  146. package/vendor/Server/Skills/arkts-library-xts-code-fix/SKILL.md +228 -228
  147. package/vendor/Server/Skills/arkts-library-xts-coverage/SKILL.md +97 -97
  148. package/vendor/Server/Skills/arkts-library-xts-doc/SKILL.md +194 -194
  149. package/vendor/Server/Skills/arkts-library-xts-doc/references/EXAMPLES.md +575 -575
  150. package/vendor/Server/Skills/arkts-library-xts-doc/references/TEMPLATE.md +574 -574
  151. package/vendor/Server/Skills/arkts-library-xts-doc/references/TESTABILITY_GUIDE.md +182 -182
  152. package/vendor/Server/Skills/arkts-library-xts-execution/SKILL.md +490 -490
  153. package/vendor/Server/Skills/arkts-library-xts-execution/references/error-fixing-examples.md +217 -217
  154. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/build.ps1 +93 -93
  155. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/code-linter.cjs +432 -432
  156. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/migrate.cjs +851 -851
  157. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/ohpm-switch.cjs +788 -788
  158. package/vendor/Server/Skills/flutter-code-check/SKILL.md +299 -299
  159. package/vendor/Server/Skills/flutter-code-check/assets/OUTPUT_TEMPLATE.md +311 -311
  160. package/vendor/Server/Skills/flutter-code-check/references/CHECKLIST.md +190 -190
  161. package/vendor/Server/Skills/flutter-code-check/references/PLATFORMS.md +133 -133
  162. package/vendor/Server/Skills/flutter-code-check/scripts/validate-skill.cjs +259 -259
  163. package/vendor/Server/Skills/flutter-interface/README.md +75 -75
  164. package/vendor/Server/Skills/flutter-interface/SKILL.md +291 -291
  165. package/vendor/Server/Skills/flutter-interface/references/EXAMPLES.md +336 -336
  166. package/vendor/Server/Skills/flutter-interface/references/GIT_CLONE_GUIDE.md +190 -190
  167. package/vendor/Server/Skills/flutter-interface/references/SCRIPT_REFERENCE.md +258 -258
  168. package/vendor/Server/Skills/flutter-interface/references/TEMPLATE.md +254 -254
  169. package/vendor/Server/Skills/flutter-library-consistency-check/SKILL.md +517 -517
  170. package/vendor/Server/Skills/flutter-library-consistency-check/references/CHECKLIST.md +381 -381
  171. package/vendor/Server/Skills/flutter-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +341 -341
  172. package/vendor/Server/Skills/flutter-library-consistency-check/references/PLATFORM_LIMITATION_GUIDE.md +71 -71
  173. package/vendor/Server/Skills/flutter-library-documentation-quality-check/SKILL.md +518 -518
  174. package/vendor/Server/Skills/flutter-library-documentation-quality-check/references/CHECKLIST.md +406 -406
  175. package/vendor/Server/Skills/flutter-library-memory-leak-check/SKILL.md +652 -652
  176. package/vendor/Server/Skills/flutter-library-memory-leak-check/references/CHECKLIST.md +396 -396
  177. package/vendor/Server/Skills/flutter-library-stability-check/SKILL.md +744 -744
  178. package/vendor/Server/Skills/flutter-library-stability-check/references/CHECKLIST.md +720 -720
  179. package/vendor/Server/Skills/flutter-library-test-coverage-check/SKILL.md +414 -414
  180. package/vendor/Server/Skills/flutter-library-test-coverage-check/assets/REPORT_TEMPLATE.md +150 -150
  181. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/CHECKLIST.md +304 -304
  182. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCORING_RULES.md +265 -265
  183. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCRIPT_USAGE.md +286 -286
  184. package/vendor/Server/Skills/knowledge-import/SKILL.md +383 -383
  185. package/vendor/Server/Skills/knowledge-import/references/MCP_TOOL_USAGE.md +165 -165
  186. package/vendor/Server/Skills/knowledge-import/references/SKILL_LOCATOR_GUIDE.md +91 -91
  187. package/vendor/Server/Skills/knowledge-import/references/SKILL_OPTIMIZATION_GUIDE.md +127 -127
  188. package/vendor/Server/Skills/ohos-lib-pr-push/SKILL.md +453 -301
  189. package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_CHECKLIST.md +151 -0
  190. package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_ISSUE_TEMPLATE.md +257 -105
  191. package/vendor/Server/Skills/ohos-lib-pr-push/references/GITCODE_API.md +191 -127
  192. package/vendor/Server/Skills/ohos-lib-pr-push/scripts/gitcode-api.cjs +317 -208
  193. package/vendor/Server/Skills/rn-code-check/SKILL.md +320 -320
  194. package/vendor/Server/Skills/rn-code-check/references/API-GUIDE.md +234 -234
  195. package/vendor/Server/Skills/rn-code-check/references/CHECKLIST.md +188 -188
  196. package/vendor/Server/Skills/rn-code-check/references/REPORT-TEMPLATE.md +246 -246
  197. package/vendor/Server/Skills/rn-lib-add-example/SKILL.md +198 -198
  198. package/vendor/Server/Skills/rn-lib-add-example/references/APP_RENAME_GUIDE.md +40 -40
  199. package/vendor/Server/Skills/rn-lib-add-example/references/SHELL_ADAPTATION_CHECKLIST.md +78 -78
  200. package/vendor/Server/Skills/rn-lib-add-example/references/TEMPLATE_REPO_GUIDE.md +70 -70
  201. package/vendor/Server/Skills/rn-lib-add-example/references/VERIFICATION_GUIDE.md +47 -47
  202. package/vendor/Server/Skills/rn-lib-add-example/scripts/create-example.cjs +252 -252
  203. package/vendor/Server/Skills/rn-lib-update-doc/SKILL.md +176 -176
  204. package/vendor/Server/Skills/rn-lib-update-doc/config.json +5 -5
  205. package/vendor/Server/Skills/rn-lib-update-doc/references/changelog-template.md +35 -35
  206. package/vendor/Server/Skills/rn-lib-update-doc/references/format-diff.md +137 -137
  207. package/vendor/Server/Skills/rn-lib-update-doc/references/link-registry.json +33 -33
  208. package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2-overview.md +40 -40
  209. package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2.md +429 -429
  210. package/vendor/Server/Skills/rn-lib-update-doc/scripts/detect-readme-format.cjs +105 -105
  211. package/vendor/Server/Skills/rn-lib-update-doc/scripts/find-usage-doc.cjs +90 -90
  212. package/vendor/Server/Skills/rn-lib-update-doc/scripts/link-verify.cjs +213 -213
  213. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-changelog.cjs +73 -73
  214. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-package-meta.cjs +258 -258
  215. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-readme-links.cjs +341 -341
  216. package/vendor/Server/Skills/rn-lib-update-doc/scripts/resolve-usage-docs.cjs +67 -67
  217. package/vendor/Server/Skills/rn-library-consistency-check/SKILL.md +299 -299
  218. package/vendor/Server/Skills/rn-library-consistency-check/assets/REPORT_TEMPLATE.md +293 -293
  219. package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_COMPONENT_CHECK_GUIDE.md +857 -857
  220. package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_TURBOMODULE_CHECK_GUIDE.md +856 -856
  221. package/vendor/Server/Skills/rn-library-consistency-check/references/CHECKLIST.md +157 -157
  222. package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_COMPONENT_CHECK_GUIDE.md +801 -801
  223. package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_TURBOMODULE_CHECK_GUIDE.md +683 -683
  224. package/vendor/Server/Skills/rn-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +233 -233
  225. package/vendor/Server/Skills/rn-library-consistency-check/references/NATIVE_COMPONENT_IDENTIFICATION.md +1373 -1373
  226. package/vendor/Server/Skills/rn-library-consistency-check/references/SCORING_STANDARD.md +220 -220
  227. package/vendor/Server/Skills/rn-library-consistency-check/scripts/validate-skill.py +245 -245
  228. package/vendor/Server/Skills/rn-library-documentation-quality-check/SKILL.md +263 -263
  229. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL.md +414 -414
  230. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL_en.md +413 -413
  231. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +311 -311
  232. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CHECK_CHECKLIST.md +355 -355
  233. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CROSS_VALIDATION_GUIDE.md +115 -115
  234. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/DOC_COLLECTION_GUIDE.md +139 -139
  235. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/EXAMPLES.md +586 -586
  236. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/GOTCHAS.md +57 -57
  237. package/vendor/Server/Skills/rn-library-documentation-quality-check/scripts/validate-skill.py +259 -259
  238. package/vendor/Server/Skills/rn-library-interface-analyzer/SKILL.md +301 -301
  239. package/vendor/Server/Skills/rn-library-interface-analyzer/assets/REPORT_TEMPLATE.md +148 -148
  240. package/vendor/Server/Skills/rn-library-interface-analyzer/references/DOC_ANNOTATION_GUIDE.md +118 -118
  241. package/vendor/Server/Skills/rn-library-interface-analyzer/references/SCRIPT_USAGE_GUIDE.md +168 -168
  242. package/vendor/Server/Skills/rn-library-interface-analyzer/references/URL_PARSING_RULES.md +176 -176
  243. package/vendor/Server/Skills/rn-library-issue-generalizer/SKILL.md +274 -274
  244. package/vendor/Server/Skills/rn-library-issue-generalizer/assets/case-template.md +45 -45
  245. package/vendor/Server/Skills/rn-library-issue-generalizer/assets/rule-template.md +25 -25
  246. package/vendor/Server/Skills/rn-library-issue-generalizer/references/PR_FETCH_GUIDE.md +61 -61
  247. package/vendor/Server/Skills/rn-library-issue-generalizer/references/RULE_TEMPLATE_GUIDE.md +165 -165
  248. package/vendor/Server/Skills/rn-library-issue-generalizer/scripts/fetch-pr-info.py +239 -239
  249. package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md +263 -263
  250. package/vendor/Server/Skills/rn-library-known-issue-check/assets/REPORT_TEMPLATE.md +96 -96
  251. package/vendor/Server/Skills/rn-library-known-issue-check/references/COMPLIANCE_CHECKLIST.md +57 -57
  252. package/vendor/Server/Skills/rn-library-known-issue-check/references/INSPECTION_GUIDE.md +99 -99
  253. package/vendor/Server/Skills/rn-library-known-issue-check/references/PRESCREEN_GUIDE.md +64 -64
  254. package/vendor/Server/Skills/rn-library-known-issue-check/references/SOURCE_PREP_GUIDE.md +74 -74
  255. package/vendor/Server/Skills/rn-library-known-issue-check/scripts/validate-known-issue-report.py +164 -164
  256. package/vendor/Server/Skills/rn-library-memory-leak-check/SKILL.md +356 -339
  257. package/vendor/Server/Skills/rn-library-memory-leak-check/assets/REPORT_TEMPLATE.md +85 -83
  258. package/vendor/Server/Skills/rn-library-memory-leak-check/references/CHECKLIST.md +905 -859
  259. package/vendor/Server/Skills/rn-library-memory-leak-check/references/HARMONY_CODE_PATTERNS.md +124 -122
  260. package/vendor/Server/Skills/rn-library-memory-leak-check/scripts/scan_harmony_code.py +287 -279
  261. package/vendor/Server/Skills/rn-library-stability-check/SKILL.md +273 -273
  262. package/vendor/Server/Skills/rn-library-stability-check/assets/REPORT_TEMPLATE.md +129 -129
  263. package/vendor/Server/Skills/rn-library-stability-check/references/CHECKLIST.md +581 -581
  264. package/vendor/Server/Skills/rn-library-stability-check/references/SCORING_RULES.md +138 -138
  265. package/vendor/Server/Skills/rn-library-stability-check/scripts/scan-harmony-code.py +168 -168
  266. package/vendor/Server/Skills/rn-library-test-coverage-check/SKILL.md +526 -506
  267. package/vendor/Server/Skills/rn-library-test-coverage-check/references/CHECKLIST.md +321 -280
  268. package/vendor/Server/Skills/rn-library-test-coverage-check/references/DEMO_LOCATION.md +221 -221
  269. package/vendor/Server/Skills/rn-library-test-coverage-check/references/REPORT_TEMPLATE.md +220 -209
  270. package/vendor/Server/Skills/rn-library-test-coverage-check/references/SCRIPT_USAGE.md +325 -325
  271. package/vendor/Server/Skills/rn-ohos-xts-generator/SKILL.md +279 -279
  272. package/vendor/Server/Skills/rn-ohos-xts-generator/assets/TEST_FILE_TEMPLATES.md +404 -404
  273. package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_TROUBLESHOOTING.md +185 -185
  274. package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_WORKFLOW.md +265 -265
  275. package/vendor/Server/Skills/rn-ohos-xts-generator/references/COMMON_CONFIG.md +189 -189
  276. package/vendor/Server/Skills/rn-ohos-xts-generator/references/CONFIG_GUIDE.md +203 -203
  277. package/vendor/Server/Skills/rn-ohos-xts-generator/references/COVERAGE_ANALYZER.md +147 -147
  278. package/vendor/Server/Skills/rn-ohos-xts-generator/references/DESIGN_DOC_GUIDE.md +148 -148
  279. package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_FLOW.md +165 -165
  280. package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_STRATEGY.md +195 -195
  281. package/vendor/Server/Skills/rn-ohos-xts-generator/references/HARMONY_SCANNER.md +249 -249
  282. package/vendor/Server/Skills/rn-ohos-xts-generator/references/JEST_FRAMEWORK.md +235 -235
  283. package/vendor/Server/Skills/rn-ohos-xts-generator/references/PLATFORM_COMPAT.md +161 -161
  284. package/vendor/Server/Skills/rn-ohos-xts-generator/references/RN_TEST_PATTERNS.md +413 -413
  285. package/vendor/Server/Skills/rn-ohos-xts-generator/references/SOURCE_PARSER.md +235 -235
  286. package/vendor/Server/Skills/rn-ohos-xts-generator/references/TEST_CONVENTIONS.md +245 -245
  287. package/vendor/Server/Skills/rn-ohos-xts-generator/references/TROUBLESHOOTING.md +282 -282
  288. package/vendor/Server/Skills/rn-ohos-xts-generator/references/USAGE_GUIDE.md +251 -251
  289. package/vendor/Server/Skills/rnoh-cptf-api-test/SKILL.md +469 -469
  290. package/vendor/Server/Skills/rnoh-cptf-api-test/assets/CPTF_TEST_TEMPLATE.md +310 -310
  291. package/vendor/Server/Skills/rnoh-cptf-api-test/assets/DEMO_PAGE_TEMPLATE.md +303 -303
  292. package/vendor/Server/Skills/rnoh-cptf-api-test/references/CPTF_TEST_GENERATION_GUIDE.md +421 -421
  293. package/vendor/Server/Skills/rnoh-cptf-api-test/references/DEMO_GENERATION_GUIDE.md +358 -358
  294. package/vendor/Server/Skills/rnoh-cptf-api-test/references/QUALITY_CHECKLIST.md +114 -114
  295. package/vendor/Server/Skills/rnoh-cptf-api-test/references/SPEC_PARSING_GUIDE.md +274 -274
  296. package/vendor/Server/Skills/rnoh-cptf-api-test/scripts/validate-rnoh-cptf-api-test.sh +185 -185
  297. package/vendor/Server/Skills/rnoh-cptf-demo-test/SKILL.md +191 -191
  298. package/vendor/Server/Skills/rnoh-cptf-demo-test/assets/TEST_TEMPLATE.md +216 -216
  299. package/vendor/Server/Skills/rnoh-cptf-demo-test/references/CPTF_SETUP.md +107 -107
  300. package/vendor/Server/Skills/rnoh-cptf-demo-test/references/DEMO_ANALYSIS.md +120 -120
  301. package/vendor/Server/Skills/rnoh-cptf-demo-test/scripts/validate-rnoh-cptf-test.sh +108 -108
  302. package/vendor/Server/Skills/rnoh-cptf-test-run/SKILL.md +237 -237
  303. package/vendor/Server/Skills/rnoh-cptf-test-run/references/DEBUG_PLAYBOOK.md +261 -261
  304. package/vendor/Server/Skills/rnoh-cptf-test-run/scripts/validate-run-env.sh +112 -112
  305. package/vendor/Server/Skills/rnoh-lib-code-adapt/SKILL.md +497 -497
  306. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/adapt-checklist.md +270 -270
  307. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/api-migration-checklist.md +164 -164
  308. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/common-compile-errors.md +556 -556
  309. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/deveco-cli-tools.md +459 -459
  310. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/edge-cases.md +65 -65
  311. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/har-tgz-build.md +512 -512
  312. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/version-compat-matrix.md +132 -132
  313. package/vendor/Server/Skills/rnoh-lib-code-adapt/scripts/auto-integrate.sh +424 -424
  314. package/vendor/Server/Skills/rnoh-lib-demo-coverage/SKILL.md +137 -137
  315. package/vendor/Server/Skills/rnoh-lib-demo-create/SKILL.md +306 -306
  316. package/vendor/Server/Skills/rnoh-lib-demo-create/assets/DEMO_PAGE_TEMPLATE.md +485 -485
  317. package/vendor/Server/Skills/rnoh-lib-demo-create/assets/INDEX_TEMPLATE.md +172 -172
  318. package/vendor/Server/Skills/rnoh-lib-demo-create/references/DEMO_CODE_RULES.md +422 -422
  319. package/vendor/Server/Skills/rnoh-lib-demo-create/references/QUALITY_CHECKLIST.md +95 -95
  320. package/vendor/Server/Skills/rnoh-lib-demo-create/references/SOURCE_EXPLORATION.md +169 -169
  321. package/vendor/Server/Skills/rnoh-lib-demo-doc/SKILL.md +554 -554
  322. package/vendor/Server/Skills/rnoh-lib-demo-doc/assets/DEMO_DOC_TEMPLATE.md +106 -106
  323. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/COVERAGE_INCREMENTAL.md +216 -216
  324. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/DEMO_DESIGN_RULES.md +413 -413
  325. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/OUTPUT_FORMAT.md +269 -269
  326. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/QUALITY_CHECKLIST.md +98 -98
  327. package/vendor/Server/Skills/rnoh-lib-func-test/SKILL.md +337 -337
  328. package/vendor/Server/Skills/rnoh-lib-rnt-search/SKILL.md +722 -722
  329. package/vendor/Server/Skills/rnoh-lib-rnt-search/assets/PORT_REPORT_TEMPLATE.md +219 -219
  330. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/DEMO_PORTING_GUIDE.md +345 -345
  331. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/PORT_VERIFICATION.md +269 -269
  332. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/RNT_PROJECT_STRUCTURE.md +173 -173
  333. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/analyze-demo-deps.cjs +267 -267
  334. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/detect-rnoh-version.cjs +174 -174
  335. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/find-rnt-demo.sh +111 -111
  336. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/port-demo.sh +186 -186
  337. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/read-lib-meta.cjs +150 -150
  338. package/vendor/Server/Skills/rnoh-lib-test-align/SKILL.md +296 -296
  339. package/vendor/Server/Skills/rnoh-lib-test-align/references/jest-troubleshooting.md +371 -371
  340. package/vendor/Server/Skills/rnoh-lib-test-align/references/port-test-demo-guide.md +212 -212
  341. package/vendor/Server/Skills/rnoh-lib-test-align/references/runtime-troubleshooting.md +345 -345
  342. package/vendor/Server/Skills/rnoh-lib-test-align/references/unit-test-template.md +223 -223
  343. package/vendor/Server/Skills/rnoh-lib-test-align/scripts/port-test-demo.sh +1053 -1053
  344. package/vendor/Server/Skills/rnoh-lib-version-diff/SKILL.md +295 -255
  345. package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_ADAPTATION.md +82 -77
  346. package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_API_LOOKUP.md +224 -224
  347. package/vendor/Server/Skills/rnoh-lib-version-diff/references/script-reference.md +175 -174
  348. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/detect-upstream-version.js +967 -967
  349. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/generate-diff.js +1798 -1798
  350. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/package.json +5 -5
  351. package/vendor/Server/Skills/rnoh-lib-version-diff/templates/report-template.md +180 -137
  352. package/vendor/Server/Skills/rnoh-lib-xts-coverage/SKILL.md +145 -145
  353. package/vendor/Server/Skills/skill-generator/SKILL.md +365 -365
  354. package/vendor/Server/Skills/skill-generator/assets/SKILL_TEMPLATE.md +183 -183
  355. package/vendor/Server/Skills/skill-generator/references/COMPLIANCE_CHECKLIST.md +82 -82
  356. package/vendor/Server/Skills/skill-generator/references/KB_QUERY_GUIDE.md +110 -110
  357. package/vendor/Server/Skills/skill-generator/references/MCP_TOOL_DISCOVERY.md +122 -122
  358. package/vendor/Server/Skills/skill-generator/references/SKILL_SPEC.md +121 -121
  359. package/vendor/Server/Skills/skill-generator/scripts/validate-skill.cjs +259 -259
  360. package/vendor/Server/Skills/task-analysis/SKILL.md +234 -234
  361. package/vendor/Server/Skills/task-analysis/assets/OUTPUT_EXAMPLES.md +160 -160
  362. package/vendor/Server/Skills/task-analysis/references/ACCEPTANCE_CRITERIA_GUIDE.md +190 -190
  363. package/vendor/Server/Skills/task-analysis/references/ANALYSIS_SCHEMA.md +224 -224
  364. package/vendor/Server/Skills/task-analysis/references/INTEGRATION_CONTEXT.md +162 -162
  365. package/vendor/Server/Skills/task-analysis/references/LESSONS_LEARNED.md +55 -55
  366. package/vendor/Server/Skills/task-analysis/references/REPLAN_CONTEXT_GUIDE.md +126 -126
  367. package/vendor/Server/Skills/task-analysis/scripts/validate-analysis-output.sh +256 -256
  368. package/vendor/Server/Skills/task-decomposition/SKILL.md +528 -528
  369. package/vendor/Server/Skills/task-decomposition/assets/OUTPUT_EXAMPLES.md +451 -451
  370. package/vendor/Server/Skills/task-decomposition/references/ACCEPTANCE_CRITERIA_GUIDE.md +179 -179
  371. package/vendor/Server/Skills/task-decomposition/references/DEPENDENCY_GRAPH_GUIDE.md +152 -152
  372. package/vendor/Server/Skills/task-decomposition/references/INTEGRATION_CONTEXT.md +175 -175
  373. package/vendor/Server/Skills/task-decomposition/references/REPLAN_CONTEXT_GUIDE.md +195 -195
  374. package/vendor/Server/Skills/task-decomposition/references/TASK_DECOMPOSITION_TEMPLATES.md +226 -226
  375. package/vendor/Server/Skills/task-decomposition/scripts/list-available-skills.cjs +263 -263
  376. package/vendor/Server/Skills/task-decomposition/scripts/skill-blacklist.json +29 -29
  377. package/vendor/Server/Skills/task-decomposition/scripts/validate-decomposition-output.cjs +376 -376
  378. package/vendor/Server/Skills/task-decomposition/scripts/validate-param-consistency.cjs +259 -259
  379. package/vendor/Server/Skills/task-decomposition/scripts/validate-specified-skills.cjs +216 -216
  380. package/vendor/Server/Skills/task-decomposition/scripts/validate-step-graph.cjs +424 -424
  381. package/vendor/Server/Skills/tpc-cpp-check/SKILL.md +427 -427
  382. package/vendor/Server/Skills/tpc-cpp-check/references/CHECKLIST.md +214 -214
  383. package/vendor/Server/Skills/tpc-cpp-check/references/HPKBUILD_GUIDE.md +235 -235
  384. package/vendor/Server/Skills/tpc-cpp-check/references/REPORT_TEMPLATE.md +250 -250
  385. package/vendor/Server/TestCheck/TestCheck.js +775 -775
  386. package/vendor/Server/TestCheck/index.js +11 -11
  387. package/vendor/Server/library/McpToolGuide.js +280 -280
  388. package/vendor/Server/library/StatsService.js +126 -126
  389. package/vendor/Server/library/cstTime.js +16 -16
  390. package/vendor/VERSION +3 -3
  391. package/workflows/pr-check.mjs +105 -105
  392. package/workflows/pr-push.mjs +193 -0
  393. package/vendor/Server/Agent/SkillSelector/types.js +0 -63
@@ -1,856 +1,856 @@
1
- # ArkTS TurboModule 层一致性检视指南
2
-
3
- 本指南定义 RN 鸿蒙化一致性检视中 **ArkTS TurboModule 层**(TurboModule ArkTS 实现类、generated Spec 类型、方法实现、常量导出、回调机制)的检视规范,确保 AI Agent 能系统性地读取和分析 ArkTS TurboModule 代码,检测方法 Stub、方法缺失、常量导出缺失、回调逻辑不一致等问题。
4
-
5
- ---
6
-
7
- ## 1. 适用条件与前置依赖
8
-
9
- ### 1.1 适用条件
10
-
11
- 当 `harmony/<module>/src/main/ets/` 目录存在 TurboModule 实现文件(`*TurboModule.ets`)时,必须执行本指南的检视流程。若不存在,标注"⚠️ 无 ArkTS TurboModule 实现"并跳过。
12
-
13
- 判定条件:
14
-
15
- | 条件 | 判定 |
16
- |------|------|
17
- | `harmony/<module>/src/main/ets/*TurboModule.ets` 存在 | ✅ ArkTS TurboModule 实现(必须检视) |
18
- | `generated/turboModules/TurboModuleName.ts` 存在 | ✅ Codegen Spec 类型定义(必须检视) |
19
- | 以上均不存在 | ⚠️ 无 ArkTS TurboModule 层,跳过本指南 |
20
-
21
- ### 1.2 前置依赖
22
-
23
- - Phase 0 中已定位的 TurboModule 名(从 C++ FactoryDelegate 或 JS Spec 提取)
24
- - C++ TurboModule JSIBinder 方法列表(来自 CPP_TURBOMODULE_CHECK_GUIDE)
25
- - JS 层 TurboModule Spec 定义(`NativeRNCWebViewModule.ts` 等文件)
26
- - C++ TurboModuleFactoryDelegate 注册名列表
27
-
28
- ### 1.3 与其他检视指南的关系
29
-
30
- | 检视指南 | 检视层级 | 本指南关注点 |
31
- |----------|----------|-------------|
32
- | CPP_COMPONENT_CHECK_GUIDE | C++ 组件层 | JSIBinder Props 序列化、NapiBinder 桥接、Package 注册 |
33
- | CPP_TURBOMODULE_CHECK_GUIDE | C++ TurboModule 层 | TurboModuleFactoryDelegate 注册、TurboModule JSIBinder 方法绑定 |
34
- | ARKTS_COMPONENT_CHECK_GUIDE | ArkTS @Component 层 | rawProps 读取、Commands switch、事件 emit、build() 渲染 |
35
- | ARKTS_TURBOMODULE_CHECK_GUIDE(本文件) | ArkTS TurboModule 层 | 方法实现完整性、Stub 检测、常量导出、回调逻辑、行为对比 |
36
-
37
- ---
38
-
39
- ## 2. 文件定位与读取
40
-
41
- ### 2.1 ArkTS TurboModule 实现定位
42
-
43
- **搜索路径**:`harmony/<module>/src/main/ets/`
44
-
45
- | 步骤 | 搜索目标 | 搜索模式 | 目的 |
46
- |------|----------|----------|------|
47
- | 2.1a | TurboModule 实现文件 | `*TurboModule.ets` | 定位 ArkTS TurboModule 实际实现类 |
48
- | 2.1b | TurboModule 继承方式 | `extends AnyThreadTurboModule` / `extends TurboModule` | 确定线程模型 |
49
- | 2.1c | TurboModule Spec 实现 | `implements TM.Xxx.Spec` | 确认是否实现了 generated Spec 接口 |
50
-
51
- **必须读取的文件清单**:
52
-
53
- | # | 文件 | 说明 |
54
- |---|------|------|
55
- | 1 | `*TurboModule.ets`(主实现文件) | 包含 TurboModule 类声明、方法实现、常量导出 |
56
- | 2 | `generated/turboModules/TurboModuleName.ts`(若存在) | Codegen Spec 类型定义(NAME 常量 + Spec 接口) |
57
- | 3 | `generated/turboModules/ts.ts`(若存在) | TurboModule 命名空间导出汇总 |
58
-
59
- ### 2.2 ArkTS TurboModule 必读内容(五个维度)
60
-
61
- #### 维度 A:类声明与 Spec 实现
62
-
63
- ```
64
- 1. 类声明
65
- → class XxxTurboModule extends AnyThreadTurboModule / TurboModule
66
- → 是否 implements TM.Xxx.Spec(Codegen 模式)
67
- → 是否手写 Spec 接口(Legacy 模式)
68
-
69
- 2. NAME 常量
70
- → TurboModule 注册名(TM.Xxx.NAME 或手写常量)
71
- → 与 JS Spec TurboModuleRegistry.getEnforcing<Spec>('XXX') 的模块名对比
72
- → 与 C++ FactoryDelegate 注册名对比
73
-
74
- 3. 构造方法
75
- → constructor(ctx: TurboModuleContext, name: string)
76
- → 是否在构造中初始化了必要的状态变量
77
- ```
78
-
79
- **类声明提取模板**:
80
-
81
- ```markdown
82
- | # | TurboModule 名 | ArkTS 类名 | ArkTS 父类 | implements Spec? | NAME 常量值 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | 状态 |
83
- |---|--------------|-----------|-----------|-----------------|------------|--------------|------------------------|------|
84
- | 1 | `RNCWebViewModule` | `WebViewTurboModule` | `AnyThreadTurboModule` | ✅ TM.RNCWebViewModule.Spec | `RNCWebViewModule` | `RNCWebViewModule` ✅ | `RNCWebViewModule` ✅ | ✅ 全链路一致 |
85
- ```
86
-
87
- #### 维度 B:方法实现完整性
88
-
89
- ```
90
- 1. 方法名列表
91
- → 提取所有 public 方法名
92
- → 与 JS Spec 方法名对比
93
- → 与 generated Spec 接口方法名对比
94
-
95
- 2. 方法签名
96
- → 提取每个方法的参数类型和返回值类型
97
- → 与 JS Spec 签名对比
98
-
99
- 3. 方法实现状态
100
- → 是否为正常实现(调用了 @ohos API 或业务逻辑)
101
- → 是否为 Stub(返回固定值、空方法体、仅日志)
102
- ```
103
-
104
- **方法级对比模板**:
105
-
106
- ```markdown
107
- | # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
108
- |---|--------|-------------|--------------------|----------------------|---------------|----------|------|
109
- | 1 | `isFileUploadSupported` | `(): Promise<boolean>` | `(): Promise<boolean>` | `(): Promise<boolean>` | `WebViewTurboModule.ets:14` | ⚠️ Stub(固定返回 true) | -8 |
110
- | 2 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `WebViewTurboModule.ets:18` | ✅ 正常实现 | 0 |
111
- | 3 | `injectJavaScript` | `(script: string): void` | `(script: string): void` | ⛔ 不存在 | — | ❌ 方法缺失 | -15 |
112
- ```
113
-
114
- #### 维度 C:Stub 检测
115
-
116
- ```
117
- 1. Stub 识别特征
118
- → 方法体仅有 return 语句,返回固定值
119
- → 未调用任何 @ohos 模块 API
120
- → 未执行实际业务操作
121
- → 仅日志输出(console.log)
122
-
123
- 2. Stub 合理性判定
124
- → 与 Android/iOS 同名方法对比行为
125
- → iOS 也返回固定值 → 合理 Stub(不扣分)
126
- → Android 有实际业务逻辑 → 致命 Stub(扣分)
127
- ```
128
-
129
- **Stub 检测模板**:
130
-
131
- ```markdown
132
- | # | 方法名 | ArkTS 文件:行号 | Stub 代码片段 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
133
- |---|--------|---------------|--------------|-------------|---------|------------|---------|--------|------|
134
- | 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
135
- | 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
136
- | 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | ✅ 调用 gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
137
- ```
138
-
139
- #### 维度 D:常量导出
140
-
141
- ```
142
- 1. getConstants() 方法(若有)
143
- → 提取所有导出的常量名和值
144
- → 与 Android/iOS getConstants() 对比
145
-
146
- 2. 常量值一致性
147
- → 各平台导出的常量值是否一致
148
- → 常量名拼写是否一致
149
- ```
150
-
151
- **常量导出对比模板**:
152
-
153
- ```markdown
154
- | # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
155
- |---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
156
- | 1 | `Scale` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `MapsTurboModule.ets:25` | ✅ | ✅ 一致 | 0 |
157
- | 2 | `ConnectionPriority` | `{HIGH: 1, BALANCED: 0, LOW_POWER: -1}` | ⛔ 无 | ⛔ 无 | — | — | ⚠️ 仅 Android 有 | -3 |
158
- ```
159
-
160
- #### 维度 E:回调/事件机制
161
-
162
- ```
163
- 1. 回调方法
164
- → TurboModule 中定义的回调方法(如 shouldStartLoadWithLockIdentifier)
165
- → 回调触发时机和方式
166
-
167
- 2. 事件发送
168
- → TurboModule 是否通过 emitDeviceEvent / sendEvent 发送事件
169
- → 事件名与 payload 是否与 Android/iOS 一致
170
-
171
- 3. 回调参数类型
172
- → 回调方法的参数类型映射是否正确
173
- → 与 JS Spec 回调参数类型对比
174
- ```
175
-
176
- **回调/事件对比模板**:
177
-
178
- ```markdown
179
- | # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
180
- |---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
181
- | 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
182
- | 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -8 |
183
- ```
184
-
185
- ---
186
-
187
- ## 3. 检视项与扣分规则
188
-
189
- > 本指南覆盖 `arktsTM` 类型实体,检视项按三个关键检查点组织:**函数签名、返回值、实现逻辑**。**最关键检查项为实现逻辑一致性**。
190
-
191
- ### 3.0 前置过滤:原生注册缺失检测(优先级最高)
192
-
193
- > ⚠️ **此步骤必须在所有方法级检视(3.1-3.3)之前执行**。未注册的 TM 整体不可达,其内部方法逐项检视会导致重复扣分且无实际意义。
194
-
195
- - **检查项**: 原生注册缺失检测
196
- - **适用场景**: 当 JS/TS Spec 注册的 TurboModule 名在 ArkTS Factory 中未注册时,该 TM 整体不可达(JS 调用 `TurboModuleRegistry.getEnforcing` 将失败),此时应跳过该 TM 内部所有方法的逐项检视。
197
- - **特征检索方式**:
198
- 1. 在 `generated/turboModules/*.ts` 中提取所有 TurboModule `NAME` 常量
199
- 2. 在 `*Package.ets` 中提取 `createTurboModule()` 方法的 `if(name===)` 条件
200
- - **检视步骤**:
201
- 1. 读取 `generated/turboModules/*.ts`,提取所有 TurboModule NAME 常量 → 列表TM_js
202
- 2. 读取 `*Package.ets` 的 `createTurboModule` 方法,提取所有 `if(name===)` 条件中的 TM 名 → 列表TM_registered
203
- 3. 对每个 TM_js 中的名称,检查是否存在于 TM_registered 中
204
- 4. 判定规则:
205
- - **TM 已注册** → ✅ 通过,继续 3.1-3.3 的正常方法级检视
206
- - **TM 未注册** → ❌ 致命,扣 -15/实体名,**跳过该 TM 内部所有方法的逐项检视**(方法存在性、签名一致性、参数类型、返回值、实现逻辑等均不再检查)
207
- 5. 将跳过的 TM 记入输出表,明确标注"⛔ 跳过逐项检查"
208
- - **扣分规则**: 未注册→致命-15/实体名;跳过的方法不计入致命问题计数
209
- - **输出格式**:
210
-
211
- ```markdown
212
- | # | 实体类型 | JS/TS Spec 注册名 | ArkTS Factory 注册 | 状态 | 致命度 | 扣分 | 内部方法检查 |
213
- |---|---------|-----------------|-------------------|------|--------|------|------------|
214
- | 1 | TurboModule | `RNCWebViewModule` | ✅ 已注册 | ✅ 通过 | — | 0 | 继续逐项检视 |
215
- | 2 | TurboModule | `RNCWebView` | ❌ 未注册 | ❌ 致命 | -15 | ⛔ 跳过 |
216
- ```
217
-
218
- **⚠️ 关键说明**:
219
- - 跳过的 TM 内部方法**不计入致命问题计数**,避免因方法级重复扣分触发归零规则
220
- - 此规则仅适用于 TM 整体未注册(无 ArkTS Factory 条件)的场景。若 TM 已注册但部分方法缺失,仍按检查项 3(方法存在性)的正常规则扣分
221
-
222
- ### 3.1 检查点:函数签名(仅对已注册的 TM 执行)
223
-
224
- #### 检查项概要
225
-
226
- | # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
227
- |---|--------|------|----------|----------|--------|
228
- | 1 | NAME常量一致性 | ①契约一致性 | ArkTS NAME vs JS Spec注册名 vs C++ FactoryDelegate注册名 | 不一致→-5分/个 | 中等 |
229
- | 2 | 方法签名一致性 | ①契约一致性 | ArkTS方法签名 vs generated Spec签名 vs JS Spec签名 | 签名不匹配→-8分/个 | 严重 |
230
- | 3 | 方法存在性 | ①契约一致性 | JS Spec方法名 vs ArkTS TurboModule方法名 | 方法缺失→-15分/个 | 致命 |
231
- | 4 | 参数数量 | ①契约一致性 | JS Spec参数数量 vs ArkTS TurboModule参数数量 | 不匹配→-8分 | 致命 |
232
- | 5 | 参数类型 | ①契约一致性 | ArkTS TurboModule参数类型 vs JS Spec参数类型 | 类型致命错误→-10分/个 | 致命 |
233
- | 6 | 参数顺序 | ①契约一致性 | JS Spec参数位置 vs ArkTS TurboModule参数位置 | 顺序错误→-6分 | 中等 |
234
- | 7 | 方法签名vs Android | ②平台实现差异 | ArkTS TurboModule方法签名 vs Android @ReactMethod签名 | 合并至①检查 | — |
235
- | 8 | 方法签名vs iOS | ②平台实现差异 | ArkTS TurboModule方法签名 vs iOS RCT_EXPORT_METHOD签名 | 合并至①检查 | — |
236
- | 9 | Spec接口实现 | ③架构桥接一致性 | ArkTS TurboModule是否implements generated Spec接口 | 未实现→-8分/个 | 严重 |
237
-
238
- > ⚠️ **前置过滤规则(3.0节)优先级最高**:检查项 1-9 仅对**已注册的 TM** 执行。未注册的 TM 整体在 3.0 中已扣致命-15,其内部方法不再逐项检视。
239
-
240
- #### ①契约一致性
241
-
242
- ##### 检查项1:NAME常量一致性
243
-
244
- - **检查项**: NAME常量一致性
245
- - **特征检索方式**: 在 `*TurboModule.ets` 中 grep `NAME = ` 或 `static NAME`;在 JS Spec 中 grep `TurboModuleRegistry.getEnforcing`;在 C++ FactoryDelegate 中 grep `if(name=="`
246
- - **检视步骤**:
247
- 1. 读取 `*TurboModule.ets`,提取 NAME 常量值(格式为 `TM.Xxx.NAME` 或 `static NAME = "xxx"`)
248
- 2. 读取 JS Spec 文件,提取 `TurboModuleRegistry.getEnforcing<Spec>('XXX')` 中的模块注册名
249
- 3. 读取 C++ FactoryDelegate 文件,提取 `if(name=="XXX")` 条件中的注册名
250
- 4. 比较三者:ArkTS NAME值、JS Spec注册名、C++ FactoryDelegate注册名
251
- 5. 判定规则:三者完全一致→通过;任一不一致→标注不一致并扣分
252
- - **扣分规则**: 不一致→中等-5分/个
253
- - **输出格式**:
254
-
255
- ```markdown
256
- | # | NAME来源 | NAME值 | 是否一致 | 扣分 |
257
- |---|---------|--------|---------|------|
258
- | 1 | ArkTS TurboModule NAME常量 | `"RNCWebViewModule"` | — | — |
259
- | 2 | JS Spec TurboModuleRegistry注册名 | `'RNCWebViewModule'` | ✅/❌ | 0/-5 |
260
- | 3 | C++ FactoryDelegate注册名 | `"RNCWebViewModule"` | ✅/❌ | 0/-5 |
261
- ```
262
-
263
- ##### 检查项2:方法签名一致性
264
-
265
- - **检查项**: 方法签名一致性
266
- - **特征检索方式**: 在 `*TurboModule.ets` 中 grep 所有 public 方法声明;在 generated Spec ts 文件中 grep interface 方法签名;在 JS Spec 中 grep 方法签名
267
- - **检视步骤**:
268
- 1. 从 `*TurboModule.ets` 提取所有 public 方法名及完整签名(参数类型+返回值类型)→列表M
269
- 2. 从 generated Spec ts 文件提取所有 interface 方法签名→列表S
270
- 3. 从 JS Spec 提取所有方法签名→列表J
271
- 4. 逐方法对比 M vs S vs J:方法名相同则对比参数类型、参数顺序、返回值类型是否完全匹配
272
- 5. 判定规则:签名完全一致→通过;任一不匹配→标注不匹配项并扣分
273
- - **扣分规则**: 签名不匹配→严重-8分/个
274
- - **输出格式**:
275
-
276
- ```markdown
277
- | # | 方法名 | ArkTS TurboModule签名 | generated Spec签名 | JS Spec签名 | 签名一致性 | 不匹配详情 | 扣分 |
278
- |---|--------|----------------------|--------------------|------------|-----------|-----------|------|
279
- | 1 | `connect` | `(id: string): void` | `(id: string): void` | `(id: string): void` | ✅ | — | 0 |
280
- | 2 | `readRSSI` | `(id: number): Promise<number>` | `(id: string): Promise<number>` | `(id: string): Promise<number>` | ❌ | ArkTS参数类型number vs string | -8 |
281
- ```
282
-
283
- ##### 检查项3:方法存在性
284
-
285
- - **检查项**: 方法存在性
286
- - **特征检索方式**: 在 JS Spec 中提取所有方法名列表;在 `*TurboModule.ets` 中 grep 所有 public 方法名;在文档中搜索不支持标注
287
- - **检视步骤**:
288
- 1. 从 JS Spec 提取所有方法名→列表J
289
- 2. 从 `*TurboModule.ets` 提取所有 public 方法名→列表A
290
- 3. 对每个 JS Spec 方法名,检查是否存在于列表A中
291
- 4. **🟢 豁免检查(优先级高于扣分)**:对每个 ArkTS 缺失的方法,检查文档是否标注不支持:
292
- - 查找 **接口规格说明**(如 `接口规格说明.md`),该方法行是否有 `(Android only)`、`(iOS only)`、`(不支持)` 等标注
293
- - 查找 **OHOS README**(如 `harmony/README.md`),"HarmonyOS Support" 列是否为 "No","Platform" 列是否非 "All" 且非 "HarmonyOS"
294
- - 查找 **源码注释**,是否有 `// not supported`、`// Android only` 等标注
295
- 5. 判定规则:
296
- - 🟢 **文档已标注不支持** → 豁免,0分,标注"🟢 文档标注不支持(来源:文件:行号)"
297
- - ❌ **文档未标注不支持** → 方法缺失→致命-15分/个
298
- - **扣分规则**: 方法缺失→致命-15分/个;文档标注不支持→豁免0分(不计入致命问题计数)
299
- - **输出格式**:
300
-
301
- ```markdown
302
- | # | 方法名 | JS Spec存在 | ArkTS TurboModule存在 | 文档标注不支持 | 文档来源 | 状态 | 扣分 |
303
- |---|--------|------------|----------------------|--------------|---------|------|------|
304
- | 1 | `connect` | ✅ | ✅ | — | — | ✅ 方法存在 | 0 |
305
- | 2 | `clearFormData` | ✅ | ❌ | ✅ Android only, HarmonyOS Support: No | README.md:380 | 🟢 豁免不扣分 | 0 |
306
- | 3 | `injectJavaScript` | ✅ | ❌ | ❌ 无标注 | — | ❌ 方法缺失 | -15 |
307
- ```
308
-
309
- ##### 检查项4:参数数量
310
-
311
- - **检查项**: 参数数量
312
- - **特征检索方式**: 在 JS Spec 中统计每个方法参数数量;在 `*TurboModule.ets` 中统计每个方法参数数量
313
- - **检视步骤**:
314
- 1. 从 JS Spec 逐方法统计参数数量→映射Q_js
315
- 2. 从 `*TurboModule.ets` 逐方法统计参数数量→映射Q_arkts
316
- 3. 对每个共有方法,对比 Q_js[method] vs Q_arkts[method]
317
- 4. 判定规则:数量一致→通过;不匹配→标注差异并扣分
318
- - **扣分规则**: 不匹配→致命-8分
319
- - **输出格式**:
320
-
321
- ```markdown
322
- | # | 方法名 | JS Spec参数数量 | ArkTS TurboModule参数数量 | 是否一致 | 扣分 |
323
- |---|--------|---------------|-------------------------|---------|------|
324
- | 1 | `connect` | 1 | 1 | ✅ | 0 |
325
- | 2 | `startScan` | 3 | 2 | ❌ | -8 |
326
- ```
327
-
328
- ##### 检查项5:参数类型
329
-
330
- - **检查项**: 参数类型
331
- - **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法参数的类型标注;在 JS Spec 中读取对应方法参数类型定义
332
- - **检视步骤**:
333
- 1. 从 `*TurboModule.ets` 逐方法读取每个参数的类型标注→映射T_arkts
334
- 2. 从 JS Spec 逐方法读取每个参数的类型定义→映射T_js
335
- 3. 对每个共有方法的每个参数,对比 T_arkts[method][param] vs T_js[method][param]
336
- 4. 判定规则:类型完全匹配或为合理的跨平台类型映射(如Double→number)→通过;类型致命错误→标注并扣分
337
- - **扣分规则**: 类型致命错误→致命-10分/个
338
- - **输出格式**:
339
-
340
- ```markdown
341
- | # | 方法名 | 参数位置 | JS Spec类型 | ArkTS TurboModule类型 | 类型一致性 | 扣分 |
342
- |---|--------|---------|------------|----------------------|-----------|------|
343
- | 1 | `shouldStartLoadWithLockIdentifier` | 参数1 | `boolean` | `boolean` | ✅ | 0 |
344
- | 2 | `shouldStartLoadWithLockIdentifier` | 参数2 | `Double` | `number` | ✅(合理映射) | 0 |
345
- | 3 | `readRSSI` | 参数1 | `string` | `number` | ❌ | -10 |
346
- ```
347
-
348
- ##### 检查项6:参数顺序
349
-
350
- - **检查项**: 参数顺序
351
- - **特征检索方式**: 在 JS Spec 中提取每个方法参数定义顺序;在 `*TurboModule.ets` 中提取每个方法参数声明顺序
352
- - **检视步骤**:
353
- 1. 从 JS Spec 逐方法提取参数定义顺序→映射O_js
354
- 2. 从 `*TurboModule.ets` 逐方法提取参数声明顺序→映射O_arkts
355
- 3. 对每个共有方法,逐参数位置对比 O_js[method][i] vs O_arkts[method][i] 的参数名
356
- 4. 判定规则:同名参数位置完全一致→通过;顺序错误→标注并扣分
357
- - **扣分规则**: 顺序错误→中等-6分
358
- - **输出格式**:
359
-
360
- ```markdown
361
- | # | 方法名 | JS Spec参数顺序 | ArkTS TurboModule参数顺序 | 顺序一致性 | 扣分 |
362
- |---|--------|----------------|-------------------------|-----------|------|
363
- | 1 | `connect` | `(id, options)` | `(id, options)` | ✅ | 0 |
364
- | 2 | `startScan` | `(filter, options, callback)` | `(options, filter, callback)` | ❌ | -6 |
365
- ```
366
-
367
- #### ②平台实现差异
368
-
369
- ##### 检查项7:方法签名vs Android
370
-
371
- - **检查项**: 方法签名vs Android
372
- - **特征检索方式**: 在 Android Java/Kotlin 文件中 grep `@ReactMethod` 注解的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
373
- - **检视步骤**:
374
- 1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
375
- 2. 从 Android Java/Kotlin TurboModule 文件中读取所有 `@ReactMethod` 标注的方法签名→列表A_android
376
- 3. 对每个共有方法,对比 M[method] vs A_android[method] 的参数数量、参数类型、返回值类型
377
- 4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;Android签名差异视为JS Spec签名差异的补充参考
378
- - **扣分规则**: 差异合并至①检查,不独立扣分
379
- - **输出格式**:
380
-
381
- ```markdown
382
- | # | 方法名 | ArkTS TurboModule签名 | Android @ReactMethod签名 | 差异 | 合并至①检查项 |
383
- |---|--------|----------------------|------------------------|------|-------------|
384
- | 1 | `connect` | `(id: string): void` | `(String id): void` | ✅ 功能一致 | — |
385
- | 2 | `requestPriority` | `(priority: number): void` | `(int priority): void` | ✅ 合理映射 | — |
386
- ```
387
-
388
- ##### 检查项8:方法签名vs iOS
389
-
390
- - **检查项**: 方法签名vs iOS
391
- - **特征检索方式**: 在 iOS 文件中 grep `RCT_EXPORT_METHOD` 宏定义的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
392
- - **检视步骤**:
393
- 1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
394
- 2. 从 iOS TurboModule 文件中读取所有 `RCT_EXPORT_METHOD` 定义的签名→列表A_ios
395
- 3. 对每个共有方法,对比 M[method] vs A_ios[method] 的参数数量、参数类型、返回值类型
396
- 4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;iOS签名差异视为JS Spec签名差异的补充参考
397
- - **扣分规则**: 差异合并至①检查,不独立扣分
398
- - **输出格式**:
399
-
400
- ```markdown
401
- | # | 方法名 | ArkTS TurboModule签名 | iOS RCT_EXPORT_METHOD签名 | 差异 | 合并至①检查项 |
402
- |---|--------|----------------------|--------------------------|------|-------------|
403
- | 1 | `connect` | `(id: string): void` | `(NSString *id)` | ✅ 功能一致 | — |
404
- | 2 | `readRSSI` | `(id: number): Promise<number>` | `(NSString *deviceID)` | 参数名差异 | 参考① |
405
- ```
406
-
407
- #### ③架构桥接一致性
408
-
409
- ##### 检查项9:Spec接口实现
410
-
411
- - **检查项**: Spec接口实现
412
- - **特征检索方式**: 在 `*TurboModule.ets` 中 grep `implements TM.Xxx.Spec` 或类声明中的 implements 关系
413
- - **检视步骤**:
414
- 1. 读取 `*TurboModule.ets` 中 TurboModule 类声明行
415
- 2. 检查类声明是否包含 `implements TM.Xxx.Spec`(Codegen模式)或手写 Spec 接口(Legacy模式)
416
- 3. 判定规则:实现了 generated Spec 接口→通过;未实现→标注并扣分
417
- - **扣分规则**: 未实现→严重-8分/个
418
- - **输出格式**:
419
-
420
- ```markdown
421
- | # | TurboModule名 | ArkTS类声明 | implements Spec? | Spec接口来源 | 状态 | 扣分 |
422
- |---|--------------|------------|-----------------|------------|------|------|
423
- | 1 | `RNCWebViewModule` | `class WebViewTurboModule extends AnyThreadTurboModule implements TM.RNCWebViewModule.Spec` | ✅ | generated Codegen | ✅ 已实现 | 0 |
424
- | 2 | `BleManagerModule` | `class BleTurboModule extends TurboModule` | ❌ | — | ❌ 未实现 | -8 |
425
- ```
426
-
427
- ---
428
-
429
- ### 3.2 检查点:返回值
430
-
431
- #### 检查项概要
432
-
433
- | # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
434
- |---|--------|------|----------|----------|--------|
435
- | 1 | 返回值类型 | ①契约一致性 | ArkTS TurboModule返回值 vs JS Spec期望返回值 | 返回值类型错误→-10分/个 | 致命 |
436
- | 2 | 返回值语义 | ①契约一致性 | ArkTS TurboModule返回内容 vs JS Spec接口语义 | 语义不匹配→视严重度扣分 | 严重/中等 |
437
- | 3 | Promise处理 | ①契约一致性 | ArkTS TurboModule异步方法返回值 vs JS Spec异步声明 | Promise未正确包裹→-8分/个 | 严重 |
438
- | 4 | 常量导出完整性 | ①契约一致性 | ArkTS TurboModule getConstants() vs Android/iOS getConstants() | 失常量→-5分/个 | 中等 |
439
- | 5 | 常量值一致性 | ①契约一致性 | 各平台导出的常量值 | 值不一致→-3分/个 | 轻微 |
440
- | 6 | 返回值vs Android/iOS | ②平台实现差异 | ArkTS TurboModule方法返回值 vs Android/iOS方法返回值 | 合并至①检查 | — |
441
- | — | ③架构桥接一致性 | — | 已由①覆盖 | — | — |
442
-
443
- #### ①契约一致性
444
-
445
- ##### 检查项1:返回值类型
446
-
447
- - **检查项**: 返回值类型
448
- - **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的返回值类型标注;在 JS Spec 中读取对应方法的期望返回值类型
449
- - **检视步骤**:
450
- 1. 从 `*TurboModule.ets` 逐方法读取返回值类型标注→映射R_arkts
451
- 2. 从 JS Spec 逐方法读取期望返回值类型→映射R_js
452
- 3. 对每个共有方法,对比 R_arkts[method] vs R_js[method]
453
- 4. 判定规则:类型完全匹配或为合理跨平台映射→通过;返回值类型错误→标注并扣分
454
- - **扣分规则**: 返回值类型错误→致命-10分/个
455
- - **输出格式**:
456
-
457
- ```markdown
458
- | # | 方法名 | JS Spec期望返回值类型 | ArkTS TurboModule返回值类型 | 类型一致性 | 扣分 |
459
- |---|--------|--------------------|--------------------------|-----------|------|
460
- | 1 | `isFileUploadSupported` | `Promise<boolean>` | `Promise<boolean>` | ✅ | 0 |
461
- | 2 | `connect` | `void` | `Promise<void>` | ❌(多包裹Promise) | -10 |
462
- ```
463
-
464
- ##### 检查项2:返回值语义
465
-
466
- - **检查项**: 返回值语义
467
- - **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的方法体,验证返回值的语义正确性;在 JS Spec 中读取接口语义描述
468
- - **检视步骤**:
469
- 1. 读取 `*TurboModule.ets` 中每个方法的方法体,分析返回内容是否符合接口语义
470
- 2. 读取 JS Spec 中对应方法的语义描述(方法名、注释、类型语义)
471
- 3. 对比 ArkTS 实际返回值语义是否与 JS Spec 接口语义一致
472
- 4. 判定规则:语义一致→通过;语义不匹配→视严重度扣分
473
- - **扣分规则**: 语义严重不匹配→严重扣分;轻微语义偏差→中等扣分
474
- - **输出格式**:
475
-
476
- ```markdown
477
- | # | 方法名 | JS Spec接口语义 | ArkTS TurboModule返回语义 | 语义一致性 | 扣分 |
478
- |---|--------|---------------|--------------------------|-----------|------|
479
- | 1 | `isFileUploadSupported` | 返回当前设备是否支持文件上传 | 固定返回true(语义:始终支持) | ✅ | 0 |
480
- | 2 | `getOpenPeripherals` | 返回已连接的外围设备列表 | 返回空数组[](语义:无设备) | ❌ | -5 |
481
- ```
482
-
483
- ##### 检查项3:Promise处理
484
-
485
- - **检查项**: Promise处理
486
- - **特征检索方式**: 在 JS Spec 中 grep `Promise<` 或标注为异步的方法;在 `*TurboModule.ets` 中 grep `Promise<` 或 `async` 关键字
487
- - **检视步骤**:
488
- 1. 从 `*TurboModule.ets` 检查每个方法是否返回 Promise→映射P_arkts
489
- 2. 从 JS Spec 检查哪些方法声明为异步(返回值类型含 Promise)→映射P_js
490
- 3. 对每个共有方法,对比 P_arkts[method] vs P_js[method]
491
- 4. 验证 ArkTS 异步方法是否正确使用 `Promise.resolve()`/`Promise.reject()` 包裹返回值
492
- 5. 判定规则:JS Spec异步方法在ArkTS也返回Promise且包裹正确→通过;异步未包裹Promise→标注并扣分
493
- - **扣分规则**: Promise未正确包裹→严重-8分/个
494
- - **输出格式**:
495
-
496
- ```markdown
497
- | # | 方法名 | JS Spec是否异步 | ArkTS TurboModule是否返回Promise | Promise包裹正确性 | 扣分 |
498
- |---|--------|---------------|-------------------------------|-----------------|------|
499
- | 1 | `isFileUploadSupported` | ✅ Promise<boolean> | ✅ Promise.resolve(true) | ✅ | 0 |
500
- | 2 | `readRSSI` | ✅ Promise<number> | ❌ 直接返回number | ❌ | -8 |
501
- ```
502
-
503
- ##### 检查项4:常量导出完整性
504
-
505
- - **检查项**: 常量导出完整性
506
- - **特征检索方式**: 在 `*TurboModule.ets` 中 grep `getConstants()` 方法;在 Android Java 中 grep `getConstants()` 方法;在 iOS 中 grep `getConstants()` 或常量导出相关代码
507
- - **检视步骤**:
508
- 1. 从 `*TurboModule.ets` 读取 `getConstants()` 方法,提取所有常量名→列表O
509
- 2. 从 Android Java TurboModule 文件读取 `getConstants()` 方法,提取所有常量名→列表A
510
- 3. 从 iOS TurboModule 文件读取常量导出代码,提取所有常量名→列表I
511
- 4. 对比 O vs A vs I:检查每个常量是否在三平台均有导出
512
- 5. 判定规则:三平台均导出→通过;任一平台失常量→标注并扣分
513
- - **扣分规则**: 失常量→中等-5分/个
514
- - **输出格式**:
515
-
516
- ```markdown
517
- | # | 常量名 | Android导出 | iOS导出 | ArkTS TurboModule导出 | ArkTS文件:行号 | 完整性 | 扣分 |
518
- |---|--------|-----------|---------|----------------------|---------------|--------|------|
519
- | 1 | `Scale` | ✅ | ✅ | ✅ | `MapsTurboModule.ets:25` | ✅ 三平台一致 | 0 |
520
- | 2 | `ConnectionPriority` | ✅ | ⛔ 无 | ⛔ 无 | — | ⚠️ 仅Android有 | -5 |
521
- ```
522
-
523
- ##### 检查项5:常量值一致性
524
-
525
- - **检查项**: 常量值一致性
526
- - **特征检索方式**: 在各平台 TurboModule 文件中读取 `getConstants()` 返回的常量值
527
- - **检视步骤**:
528
- 1. 从各平台 `getConstants()` 方法中提取常量的具体值
529
- 2. 对每个共有常量,对比 Android值 vs iOS值 vs ArkTS TurboModule值
530
- 3. 判定规则:值完全一致→通过;值不一致→标注差异并扣分
531
- - **扣分规则**: 值不一致→轻微-3分/个
532
- - **输出格式**:
533
-
534
- ```markdown
535
- | # | 常量名 | Android值 | iOS值 | ArkTS TurboModule值 | 值一致性 | 扣分 |
536
- |---|--------|---------|-------|--------------------|---------|------|
537
- | 1 | `Scale` | `0.0001` | `0.0001` | `0.0001` | ✅ | 0 |
538
- | 2 | `Timeout` | `30` | `30` | `60` | ❌ | -3 |
539
- ```
540
-
541
- #### ②平台实现差异
542
-
543
- ##### 检查项6:返回值vs Android/iOS
544
-
545
- - **检查项**: 返回值vs Android/iOS
546
- - **特征检索方式**: 在 Android/iOS TurboModule 文件中读取方法返回值;在 `*TurboModule.ets` 中读取方法返回值
547
- - **检视步骤**:
548
- 1. 从 `*TurboModule.ets` 提取每个方法的返回值类型和语义
549
- 2. 从 Android/iOS TurboModule 提取对应方法的返回值类型和语义
550
- 3. 对比 ArkTS返回值 vs Android/iOS返回值
551
- 4. 判定规则:差异合并至①契约一致性检查,不独立扣分;Android/iOS返回值差异视为JS Spec返回值对比的补充参考
552
- - **扣分规则**: 差异合并至①检查,不独立扣分
553
- - **输出格式**:
554
-
555
- ```markdown
556
- | # | 方法名 | ArkTS TurboModule返回值 | Android返回值 | iOS返回值 | 差异 | 合并至①检查项 |
557
- |---|--------|------------------------|-------------|---------|------|-------------|
558
- | 1 | `isFileUploadSupported` | `Promise<boolean>` | `boolean` | `BOOL` | ✅ 功能一致 | — |
559
- ```
560
-
561
- #### ③架构桥接一致性
562
-
563
- > ③架构桥接一致性维度已由①契约一致性检查覆盖(Spec接口实现已在3.1检查点9中完成),此处不再重复。
564
-
565
- ---
566
-
567
- ### 3.3 检查点:实现逻辑 ⚠️ 最关键检查项
568
-
569
- #### 检查项概要
570
-
571
- | # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
572
- |---|--------|------|----------|----------|--------|
573
- | 1 | Stub检测与合理性判定 | ②平台实现差异⚠️核心 | ArkTS方法实现 vs Android/iOS同名方法行为 | 致命Stub→-8分/方法;空方法体→-8分/方法;逻辑Stub→-12分/方法;合理Stub→0分 | 致命/严重/0 |
574
- | 2 | 方法行为跨平台对比 | ②平台实现差异⚠️核心 | Android/iOS/OHOS三平台方法行为 | 行为致命不一致→-15分/方法;行为严重不一致→-12分/方法 | 致命/严重 |
575
- | 3 | 边界处理 | ②平台实现差异 | ArkTS方法边界条件 vs Android/iOS边界处理 | 不一致→-8分 | 中等 |
576
- | 4 | 错误处理 | ②平台实现差异 | ArkTS方法错误处理 vs Android/iOS错误处理 | 不一致→-6分 | 中等 |
577
- | 5 | 回调/事件机制 | ③架构桥接一致性 | ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑 | 触发逻辑不一致→-12分/个 | 严重 |
578
- | — | ①契约一致性 | — | 实现逻辑不属于契约维度,N/A | — | — |
579
-
580
- #### ①契约一致性
581
-
582
- > 实现逻辑不属于契约维度(契约维度仅覆盖签名和返回值声明),①为 N/A。
583
-
584
- #### ②平台实现差异 ⚠️ 核心维度:每个方法与Android/iOS行为级对比
585
-
586
- ##### 检查项1:Stub检测与合理性判定
587
-
588
- - **检查项**: Stub检测与合理性判定
589
- - **特征检索方式**: 在 `*TurboModule.ets` 中查找以下Stub模式:(a) `return true;` / `return false;` / `return null;` 等固定返回值;(b) `return Promise.resolve(true)` / `return Promise.resolve(false)` 等固定Promise返回;(c) 方法体仅有 `console.log` 或注释;(d) 方法体为空或仅有 `{}`;(e) 未调用任何 `@ohos` API 或实际业务操作
590
- - **检视步骤**:
591
- 1. 读取 `*TurboModule.ets` 中每个方法的方法体
592
- 2. 识别Stub模式:(a) 方法体仅有return固定值;(b) 未调用@ohos API;(c) 未执行实际业务操作;(d) 仅console.log输出
593
- 3. 读取 Android Java/Kotlin TurboModule 中同名方法的实际实现
594
- 4. 读取 iOS TurboModule 中同名方法的实际实现
595
- 5. 对比:Android/iOS有实际业务逻辑但ArkTS为Stub→致命Stub;iOS也返回固定值→合理Stub
596
- 6. 判定规则:三平台行为一致(均为固定返回)→合理Stub 0分;Android/iOS有实际逻辑但ArkTS为Stub→致命Stub 扣分
597
- - **扣分规则**:
598
- - 合理固定返回:方法语义本身返回固定值且与Android/iOS一致→0分
599
- - 无条件Stub:返回固定值但Android/iOS有实际业务逻辑→致命-8分/方法
600
- - 空方法体Stub:方法体为空或仅有console.log→致命-8分/方法
601
- - 逻辑Stub:有部分逻辑但缺少核心操作→严重-12分/方法
602
- - **输出格式**:
603
-
604
- ```markdown
605
- | # | 方法名 | ArkTS文件:行号 | Stub代码片段 | Stub类型 | Android实现 | iOS实现 | Stub合理性 | 缺失逻辑 | 严重度 | 扣分 |
606
- |---|--------|---------------|-------------|---------|------------|--------|-----------|---------|--------|------|
607
- | 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | 合理固定返回 | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
608
- | 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | 无条件Stub | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
609
- | 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | 空方法体Stub | ✅ 调用gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
610
- | 4 | `connect` | `BleTurboModule.ets:89` | 仅更新状态变量未调用蓝牙连接 | 逻辑Stub | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ❌ 缺少核心操作 | 蓝牙连接API调用 | ❌ 严重 | -12 |
611
- ```
612
-
613
- ##### 检查项2:方法行为跨平台对比
614
-
615
- - **检查项**: 方法行为跨平台对比
616
- - **特征检索方式**: 在 Android/iOS/ArkTS 三平台 TurboModule 文件中读取每个方法的实现摘要
617
- - **检视步骤**:
618
- 1. 对每个TurboModule方法,读取Android实现并提取行为摘要(调用的API、执行的操作、产生的结果)
619
- 2. 读取iOS实现并提取行为摘要
620
- 3. 读取ArkTS TurboModule实现并提取行为摘要
621
- 4. 对比三平台实际行为:核心业务逻辑是否一致、副作用是否一致、结果是否等效
622
- 5. 判定规则:三平台行为一致或功能等效→通过;行为致命不一致→致命扣分;行为严重不一致→严重扣分
623
- - **扣分规则**:
624
- - 行为致命不一致(核心功能缺失或行为完全不同)→致命-15分/方法
625
- - 行为严重不一致(部分核心逻辑缺失)→严重-12分/方法
626
- - **输出格式**:
627
-
628
- ```markdown
629
- | # | 方法名 | Android实现摘要 | iOS实现摘要 | ArkTS实现摘要 | ArkTS文件:行号 | 行为对比状态 | 扣分 |
630
- |---|--------|---------------|------------|--------------|---------------|------------|------|
631
- | 1 | `isFileUploadSupported` | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 始终返回true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
632
- | 2 | `connect` | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ✅ 调用@ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
633
- | 3 | `removeBond` | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ Stub: return true | `BleTurboModule.ets:278` | ❌ 致命不一致 | -15 |
634
- ```
635
-
636
- ##### 检查项3:边界处理
637
-
638
- - **检查项**: 边界处理
639
- - **特征检索方式**: 在 `*TurboModule.ets` 中查找边界条件处理代码(null/undefined检查、空数组检查、越界检查等);在 Android/iOS TurboModule 中查找同名方法的边界条件处理
640
- - **检视步骤**:
641
- 1. 从 `*TurboModule.ets` 读取每个方法的边界条件处理(null检查、空值检查、参数校验等)
642
- 2. 从 Android/iOS TurboModule 读取同名方法的边界条件处理
643
- 3. 对比 ArkTS边界处理 vs Android/iOS边界处理
644
- 4. 判定规则:边界处理一致或ArkTS有更严格的处理→通过;不一致→标注并扣分
645
- - **扣分规则**: 不一致→中等-8分
646
- - **输出格式**:
647
-
648
- ```markdown
649
- | # | 方法名 | Android/iOS边界处理 | ArkTS TurboModule边界处理 | 一致性 | 扣分 |
650
- |---|--------|-------------------|-------------------------|--------|------|
651
- | 1 | `connect` | ✅ 检查id非null | ✅ 检查id非null和非空字符串 | ✅ ArkTS更严格 | 0 |
652
- | 2 | `startScan` | ✅ 检查filter非null | ❌ 无边界检查 | ❌ | -8 |
653
- ```
654
-
655
- ##### 检查项4:错误处理
656
-
657
- - **检查项**: 错误处理
658
- - **特征检索方式**: 在 `*TurboModule.ets` 中查找 try-catch 块、error回调、Promise.reject 等错误处理模式;在 Android/iOS TurboModule 中查找同名方法的错误处理
659
- - **检视步骤**:
660
- 1. 从 `*TurboModule.ets` 读取每个方法的错误处理(try-catch、error callback、Promise.reject等)
661
- 2. 从 Android/iOS TurboModule 读取同名方法的错误处理
662
- 3. 对比 ArkTS错误处理 vs Android/iOS错误处理
663
- 4. 判定规则:错误处理一致或ArkTS有合理的错误处理→通过;不一致→标注并扣分
664
- - **扣分规则**: 不一致→中等-6分
665
- - **输出格式**:
666
-
667
- ```markdown
668
- | # | 方法名 | Android/iOS错误处理 | ArkTS TurboModule错误处理 | 一致性 | 扣分 |
669
- |---|--------|-------------------|-------------------------|--------|------|
670
- | 1 | `connect` | ✅ try-catch + Promise.reject | ✅ try-catch + Promise.reject | ✅ | 0 |
671
- | 2 | `readRSSI` | ✅ try-catch + 回调error参数 | ❌ 无错误处理 | ❌ | -6 |
672
- ```
673
-
674
- #### ③架构桥接一致性
675
-
676
- ##### 检查项5:回调/事件机制
677
-
678
- - **检查项**: 回调/事件机制
679
- - **特征检索方式**: 在 `*TurboModule.ets` 中 grep 回调调用模式(`this.emitDeviceEvent`、`sendEvent`、回调函数调用);在 Android/iOS TurboModule 中 grep 同名回调触发模式(Android: `sendEvent`/回调接口;iOS: `RCTEventEmitter`/block回调)
680
- - **检视步骤**:
681
- 1. 从 `*TurboModule.ets` 读取每个回调方法的触发逻辑(触发时机、触发方式、回调参数)
682
- 2. 从 Android TurboModule 读取同名回调/事件的触发逻辑
683
- 3. 从 iOS TurboModule 读取同名回调/事件的触发逻辑
684
- 4. 对比 ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑
685
- 5. 判定规则:触发时机、触发方式、回调参数三平台一致→通过;触发逻辑不一致→标注并扣分
686
- - **扣分规则**: 触发逻辑不一致→严重-12分/个
687
- - **输出格式**:
688
-
689
- ```markdown
690
- | # | 回调/事件名 | JS Spec定义 | Android触发逻辑 | iOS触发逻辑 | ArkTS TurboModule触发逻辑 | ArkTS文件:行号 | 触发逻辑一致性 | 扣分 |
691
- |---|------------|-------------|---------------|------------|-------------------------|---------------|--------------|------|
692
- | 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
693
- | 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -12 |
694
- ```
695
-
696
- ---
697
-
698
- ## 4. 方法行为跨平台对比
699
-
700
- ### 4.1 方法行为对比格式
701
-
702
- 对每个 TurboModule 方法,必须与 Android/iOS 的同名方法做行为对比:
703
-
704
- ```markdown
705
- | # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS TurboModule 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
706
- |---|--------|----------------|-------------|--------------------------|---------------|------------|------|
707
- | 1 | `isFileUploadSupported` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 始终返回 true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
708
- | 2 | `connect` | ✅ 调用 BluetoothGatt.connect() | ✅ 调用 CBCentralManager.connect() | ✅ 调用 @ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
709
- | 3 | `removeBond` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ Stub: `return true;` | `BleTurboModule.ets:278` | ❌ 致命不一致 | -8 |
710
- ```
711
-
712
- ### 4.2 行为一致性判定规则
713
-
714
- | 行为对比结果 | 判定 | 扣分 |
715
- |-------------|------|------|
716
- | 三平台行为一致 | ✅ 一致 | 0 |
717
- | OHOS 使用不同机制但功能等效 | ✅ 功能一致 | 0 |
718
- | OHOS 仅缺少非核心差异 | ⚠️ 轻微不一致 | -3~-5 |
719
- | OHOS 缺少部分核心逻辑 | ❌ 严重不一致 | -8~-12 |
720
- | OHOS 为 Stub 或方法缺失 | ❌ 致命 | -8~-15 |
721
-
722
- ---
723
-
724
- ## 5. 跨层一致性检测(ArkTS TurboModule 视角)
725
-
726
- ### 5.1 全链路 TurboModule 对比
727
-
728
- ```markdown
729
- | # | TurboModule 名 | JS Spec 定义 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | C++ JSIBinder | generated Spec 接口 | ArkTS TurboModule 类 | ArkTS 文件 | 状态 | 扣分 |
730
- |---|--------------|------------|--------------|------------------------|-------------|--------------------|--------------------|-----------|------|------|
731
- | 1 | `RNCWebViewModule` | `NativeRNCWebViewModule.ts` | `RNCWebViewModule` | ✅ `RNCWebViewModule` | ✅ JSIBinder | ✅ TM.RNCWebViewModule.Spec | ✅ WebViewTurboModule | `WebViewTurboModule.ets:11` | ✅ 全链路一致 | 0 |
732
- ```
733
-
734
- ### 5.2 断桥类型定义(TurboModule 视角)
735
-
736
- | 断桥位置 | 识别方式 | 影响 | 扣分 |
737
- |---------|----------|------|------|
738
- | JS→C++ 注册断桥 | JS Spec TurboModuleRegistry 注册名在 C++ FactoryDelegate 中无对应 if 条件 | JS 调用 TurboModule 但 C++ 无法创建实例 | -10/个(致命) |
739
- | C++→ArkTS 类映射断桥 | C++ FactoryDelegate 中 `std::make_shared<XxxTurboModule>` 类名在 ArkTS 中无对应实现类 | C++ 创建实例但无法路由到 ArkTS 实现 | -8/个(严重) |
740
- | ArkTS 方法缺失断桥 | JS Spec 方法在 ArkTS TurboModule 中无对应方法实现 | JS 调用方法但 ArkTS 不响应 | -15/个(致命) |
741
- | ArkTS Stub 断桥 | ArkTS TurboModule 方法为 Stub 但 Android/iOS 有实际业务逻辑 | 方法调用成功但行为完全不同 | -8/方法(致命) |
742
- | ArkTS 常量缺失断桥 | Android/iOS getConstants() 导出的常量在 ArkTS TurboModule 中缺失 | JS 读取常量返回 undefined | -5/个(中等) |
743
-
744
- ---
745
-
746
- ## 6. 检视操作流程
747
-
748
- ### 6.1 Phase 0 补充步骤(ArkTS TurboModule 定位)
749
-
750
- ```
751
- TM-ARK-1: 定位 ArkTS TurboModule 实现文件
752
- → 搜索 harmony/<module>/src/main/ets/*TurboModule.ets
753
-
754
- TM-ARK-2: 定位 generated TurboModule Spec 类型
755
- → 搜索 generated/turboModules/TurboModuleName.ts
756
- → 搜索 generated/turboModules/ts.ts
757
-
758
- TM-ARK-3: 读取 ArkTS TurboModule 类声明
759
- → 提取 NAME 常量、父类、implements Spec 接口
760
-
761
- TM-ARK-4: 读取 generated Spec 接口方法列表
762
- → 提取所有方法名和签名
763
- ```
764
-
765
- ### 6.2 Phase 3 补充步骤(ArkTS TurboModule 分析)
766
-
767
- ```
768
- TM-ARK-5: TurboModule NAME 常量对比
769
- → ArkTS NAME 常量 vs JS Spec TurboModuleRegistry 注册名 vs C++ FactoryDelegate 注册名
770
- → 标注注册名不一致
771
-
772
- TM-ARK-6: 方法实现完整性对比
773
- → JS Spec 方法名 vs generated Spec 方法名 vs ArkTS TurboModule 方法名
774
- → 标注方法缺失
775
-
776
- TM-ARK-7: 方法签名对比
777
- → ArkTS TurboModule 方法签名 vs generated Spec 接口方法签名
778
- → 标注签名不匹配、类型映射错误
779
-
780
- TM-ARK-8: Stub 检测与合理性判定
781
- → 对每个 ArkTS TurboModule 方法判断是否为 Stub
782
- → 与 Android/iOS 同名方法行为对比判定 Stub 合理性
783
- → 标注 Stub 方法及其缺失逻辑
784
-
785
- TM-ARK-9: 常量导出对比
786
- → Android/iOS getConstants() vs ArkTS TurboModule getConstants()
787
- → 标注失常量
788
-
789
- TM-ARK-10: 回调/事件对比
790
- → ArkTS TurboModule 回调/事件实现 vs Android/iOS 回调/事件
791
- → 标注回调缺失、事件缺失、Payload 缺失
792
-
793
- TM-ARK-11: 方法行为跨平台对比
794
- → 对每个方法列出 Android/iOS/OHOS 三平台行为
795
- → 标注行为不一致
796
- ```
797
-
798
- ---
799
-
800
- ## 7. 报告输出格式
801
-
802
- 在一致性检视报告的"5.8 RN 架构一致性检视"中增加以下子章节:
803
-
804
- ```markdown
805
- #### ArkTS TurboModule 层一致性(如适用)
806
-
807
- **ArkTS TurboModule 模式**:{Codegen(implements TM.Xxx.Spec)/ Legacy(手写) / ⚠️ 无 ArkTS TurboModule 层}
808
-
809
- **TurboModule 类声明一致性**:
810
-
811
- | # | TurboModule 名 | ArkTS 类名 | NAME 常量 | JS Spec 注册名 | C++ FactoryDelegate | implements Spec? | 状态 | 扣分 |
812
- |---|--------------|-----------|----------|--------------|--------------------|----------------|------|------|
813
- | ... | ... | ... | ... | ... | ... | ... | ... | ... |
814
-
815
- **TurboModule 方法级对比**:
816
-
817
- | # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
818
- |---|--------|-------------|--------------------|----------------------|---------------|----------|------|
819
- | ... | ... | ... | ... | ... | ... | ... | ... |
820
-
821
- **TurboModule Stub 检测**:
822
-
823
- | # | 方法名 | ArkTS 文件:行号 | Stub 代码 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
824
- |---|--------|---------------|----------|-------------|---------|------------|---------|--------|------|
825
- | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
826
-
827
- **TurboModule 常量导出对比**:
828
-
829
- | # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
830
- |---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
831
- | ... | ... | ... | ... | ... | ... | ... | ... | ... |
832
-
833
- **TurboModule 回调/事件对比**:
834
-
835
- | # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
836
- |---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
837
- | ... | ... | ... | ... | ... | ... | ... | ... | ... |
838
-
839
- **TurboModule 方法行为跨平台对比**:
840
-
841
- | # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
842
- |---|--------|----------------|-------------|--------------|---------------|------------|------|
843
- | ... | ... | ... | ... | ... | ... | ... | ... |
844
- ```
845
-
846
- ---
847
-
848
- ## 8. 与 CPP_TURBOMODULE_CHECK_GUIDE 的协同
849
-
850
- 本指南与 CPP_TURBOMODULE_CHECK_GUIDE 共享"TurboModule 全链路对比表"。检视执行顺序建议:
851
-
852
- 1. **先执行 CPP_TURBOMODULE_CHECK_GUIDE** → 获得 C++ FactoryDelegate 注册名、JSIBinder 方法列表
853
- 2. **再执行 ARKTS_TURBOMODULE_CHECK_GUIDE** → 获得 ArkTS TurboModule 类声明、方法实现、Stub 检测、常量导出、回调/事件数据
854
- 3. **合并两张表** → 生成完整 TurboModule 全链路一致性分析
855
-
856
- 若两个指南独立执行,各自的全链路表可能存在重叠列。合并时以 TurboModule 名为主键,将两表的列拼接为完整链路。
1
+ # ArkTS TurboModule 层一致性检视指南
2
+
3
+ 本指南定义 RN 鸿蒙化一致性检视中 **ArkTS TurboModule 层**(TurboModule ArkTS 实现类、generated Spec 类型、方法实现、常量导出、回调机制)的检视规范,确保 AI Agent 能系统性地读取和分析 ArkTS TurboModule 代码,检测方法 Stub、方法缺失、常量导出缺失、回调逻辑不一致等问题。
4
+
5
+ ---
6
+
7
+ ## 1. 适用条件与前置依赖
8
+
9
+ ### 1.1 适用条件
10
+
11
+ 当 `harmony/<module>/src/main/ets/` 目录存在 TurboModule 实现文件(`*TurboModule.ets`)时,必须执行本指南的检视流程。若不存在,标注"⚠️ 无 ArkTS TurboModule 实现"并跳过。
12
+
13
+ 判定条件:
14
+
15
+ | 条件 | 判定 |
16
+ |------|------|
17
+ | `harmony/<module>/src/main/ets/*TurboModule.ets` 存在 | ✅ ArkTS TurboModule 实现(必须检视) |
18
+ | `generated/turboModules/TurboModuleName.ts` 存在 | ✅ Codegen Spec 类型定义(必须检视) |
19
+ | 以上均不存在 | ⚠️ 无 ArkTS TurboModule 层,跳过本指南 |
20
+
21
+ ### 1.2 前置依赖
22
+
23
+ - Phase 0 中已定位的 TurboModule 名(从 C++ FactoryDelegate 或 JS Spec 提取)
24
+ - C++ TurboModule JSIBinder 方法列表(来自 CPP_TURBOMODULE_CHECK_GUIDE)
25
+ - JS 层 TurboModule Spec 定义(`NativeRNCWebViewModule.ts` 等文件)
26
+ - C++ TurboModuleFactoryDelegate 注册名列表
27
+
28
+ ### 1.3 与其他检视指南的关系
29
+
30
+ | 检视指南 | 检视层级 | 本指南关注点 |
31
+ |----------|----------|-------------|
32
+ | CPP_COMPONENT_CHECK_GUIDE | C++ 组件层 | JSIBinder Props 序列化、NapiBinder 桥接、Package 注册 |
33
+ | CPP_TURBOMODULE_CHECK_GUIDE | C++ TurboModule 层 | TurboModuleFactoryDelegate 注册、TurboModule JSIBinder 方法绑定 |
34
+ | ARKTS_COMPONENT_CHECK_GUIDE | ArkTS @Component 层 | rawProps 读取、Commands switch、事件 emit、build() 渲染 |
35
+ | ARKTS_TURBOMODULE_CHECK_GUIDE(本文件) | ArkTS TurboModule 层 | 方法实现完整性、Stub 检测、常量导出、回调逻辑、行为对比 |
36
+
37
+ ---
38
+
39
+ ## 2. 文件定位与读取
40
+
41
+ ### 2.1 ArkTS TurboModule 实现定位
42
+
43
+ **搜索路径**:`harmony/<module>/src/main/ets/`
44
+
45
+ | 步骤 | 搜索目标 | 搜索模式 | 目的 |
46
+ |------|----------|----------|------|
47
+ | 2.1a | TurboModule 实现文件 | `*TurboModule.ets` | 定位 ArkTS TurboModule 实际实现类 |
48
+ | 2.1b | TurboModule 继承方式 | `extends AnyThreadTurboModule` / `extends TurboModule` | 确定线程模型 |
49
+ | 2.1c | TurboModule Spec 实现 | `implements TM.Xxx.Spec` | 确认是否实现了 generated Spec 接口 |
50
+
51
+ **必须读取的文件清单**:
52
+
53
+ | # | 文件 | 说明 |
54
+ |---|------|------|
55
+ | 1 | `*TurboModule.ets`(主实现文件) | 包含 TurboModule 类声明、方法实现、常量导出 |
56
+ | 2 | `generated/turboModules/TurboModuleName.ts`(若存在) | Codegen Spec 类型定义(NAME 常量 + Spec 接口) |
57
+ | 3 | `generated/turboModules/ts.ts`(若存在) | TurboModule 命名空间导出汇总 |
58
+
59
+ ### 2.2 ArkTS TurboModule 必读内容(五个维度)
60
+
61
+ #### 维度 A:类声明与 Spec 实现
62
+
63
+ ```
64
+ 1. 类声明
65
+ → class XxxTurboModule extends AnyThreadTurboModule / TurboModule
66
+ → 是否 implements TM.Xxx.Spec(Codegen 模式)
67
+ → 是否手写 Spec 接口(Legacy 模式)
68
+
69
+ 2. NAME 常量
70
+ → TurboModule 注册名(TM.Xxx.NAME 或手写常量)
71
+ → 与 JS Spec TurboModuleRegistry.getEnforcing<Spec>('XXX') 的模块名对比
72
+ → 与 C++ FactoryDelegate 注册名对比
73
+
74
+ 3. 构造方法
75
+ → constructor(ctx: TurboModuleContext, name: string)
76
+ → 是否在构造中初始化了必要的状态变量
77
+ ```
78
+
79
+ **类声明提取模板**:
80
+
81
+ ```markdown
82
+ | # | TurboModule 名 | ArkTS 类名 | ArkTS 父类 | implements Spec? | NAME 常量值 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | 状态 |
83
+ |---|--------------|-----------|-----------|-----------------|------------|--------------|------------------------|------|
84
+ | 1 | `RNCWebViewModule` | `WebViewTurboModule` | `AnyThreadTurboModule` | ✅ TM.RNCWebViewModule.Spec | `RNCWebViewModule` | `RNCWebViewModule` ✅ | `RNCWebViewModule` ✅ | ✅ 全链路一致 |
85
+ ```
86
+
87
+ #### 维度 B:方法实现完整性
88
+
89
+ ```
90
+ 1. 方法名列表
91
+ → 提取所有 public 方法名
92
+ → 与 JS Spec 方法名对比
93
+ → 与 generated Spec 接口方法名对比
94
+
95
+ 2. 方法签名
96
+ → 提取每个方法的参数类型和返回值类型
97
+ → 与 JS Spec 签名对比
98
+
99
+ 3. 方法实现状态
100
+ → 是否为正常实现(调用了 @ohos API 或业务逻辑)
101
+ → 是否为 Stub(返回固定值、空方法体、仅日志)
102
+ ```
103
+
104
+ **方法级对比模板**:
105
+
106
+ ```markdown
107
+ | # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
108
+ |---|--------|-------------|--------------------|----------------------|---------------|----------|------|
109
+ | 1 | `isFileUploadSupported` | `(): Promise<boolean>` | `(): Promise<boolean>` | `(): Promise<boolean>` | `WebViewTurboModule.ets:14` | ⚠️ Stub(固定返回 true) | -8 |
110
+ | 2 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `WebViewTurboModule.ets:18` | ✅ 正常实现 | 0 |
111
+ | 3 | `injectJavaScript` | `(script: string): void` | `(script: string): void` | ⛔ 不存在 | — | ❌ 方法缺失 | -15 |
112
+ ```
113
+
114
+ #### 维度 C:Stub 检测
115
+
116
+ ```
117
+ 1. Stub 识别特征
118
+ → 方法体仅有 return 语句,返回固定值
119
+ → 未调用任何 @ohos 模块 API
120
+ → 未执行实际业务操作
121
+ → 仅日志输出(console.log)
122
+
123
+ 2. Stub 合理性判定
124
+ → 与 Android/iOS 同名方法对比行为
125
+ → iOS 也返回固定值 → 合理 Stub(不扣分)
126
+ → Android 有实际业务逻辑 → 致命 Stub(扣分)
127
+ ```
128
+
129
+ **Stub 检测模板**:
130
+
131
+ ```markdown
132
+ | # | 方法名 | ArkTS 文件:行号 | Stub 代码片段 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
133
+ |---|--------|---------------|--------------|-------------|---------|------------|---------|--------|------|
134
+ | 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
135
+ | 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
136
+ | 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | ✅ 调用 gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
137
+ ```
138
+
139
+ #### 维度 D:常量导出
140
+
141
+ ```
142
+ 1. getConstants() 方法(若有)
143
+ → 提取所有导出的常量名和值
144
+ → 与 Android/iOS getConstants() 对比
145
+
146
+ 2. 常量值一致性
147
+ → 各平台导出的常量值是否一致
148
+ → 常量名拼写是否一致
149
+ ```
150
+
151
+ **常量导出对比模板**:
152
+
153
+ ```markdown
154
+ | # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
155
+ |---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
156
+ | 1 | `Scale` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `MapsTurboModule.ets:25` | ✅ | ✅ 一致 | 0 |
157
+ | 2 | `ConnectionPriority` | `{HIGH: 1, BALANCED: 0, LOW_POWER: -1}` | ⛔ 无 | ⛔ 无 | — | — | ⚠️ 仅 Android 有 | -3 |
158
+ ```
159
+
160
+ #### 维度 E:回调/事件机制
161
+
162
+ ```
163
+ 1. 回调方法
164
+ → TurboModule 中定义的回调方法(如 shouldStartLoadWithLockIdentifier)
165
+ → 回调触发时机和方式
166
+
167
+ 2. 事件发送
168
+ → TurboModule 是否通过 emitDeviceEvent / sendEvent 发送事件
169
+ → 事件名与 payload 是否与 Android/iOS 一致
170
+
171
+ 3. 回调参数类型
172
+ → 回调方法的参数类型映射是否正确
173
+ → 与 JS Spec 回调参数类型对比
174
+ ```
175
+
176
+ **回调/事件对比模板**:
177
+
178
+ ```markdown
179
+ | # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
180
+ |---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
181
+ | 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
182
+ | 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -8 |
183
+ ```
184
+
185
+ ---
186
+
187
+ ## 3. 检视项与扣分规则
188
+
189
+ > 本指南覆盖 `arktsTM` 类型实体,检视项按三个关键检查点组织:**函数签名、返回值、实现逻辑**。**最关键检查项为实现逻辑一致性**。
190
+
191
+ ### 3.0 前置过滤:原生注册缺失检测(优先级最高)
192
+
193
+ > ⚠️ **此步骤必须在所有方法级检视(3.1-3.3)之前执行**。未注册的 TM 整体不可达,其内部方法逐项检视会导致重复扣分且无实际意义。
194
+
195
+ - **检查项**: 原生注册缺失检测
196
+ - **适用场景**: 当 JS/TS Spec 注册的 TurboModule 名在 ArkTS Factory 中未注册时,该 TM 整体不可达(JS 调用 `TurboModuleRegistry.getEnforcing` 将失败),此时应跳过该 TM 内部所有方法的逐项检视。
197
+ - **特征检索方式**:
198
+ 1. 在 `generated/turboModules/*.ts` 中提取所有 TurboModule `NAME` 常量
199
+ 2. 在 `*Package.ets` 中提取 `createTurboModule()` 方法的 `if(name===)` 条件
200
+ - **检视步骤**:
201
+ 1. 读取 `generated/turboModules/*.ts`,提取所有 TurboModule NAME 常量 → 列表TM_js
202
+ 2. 读取 `*Package.ets` 的 `createTurboModule` 方法,提取所有 `if(name===)` 条件中的 TM 名 → 列表TM_registered
203
+ 3. 对每个 TM_js 中的名称,检查是否存在于 TM_registered 中
204
+ 4. 判定规则:
205
+ - **TM 已注册** → ✅ 通过,继续 3.1-3.3 的正常方法级检视
206
+ - **TM 未注册** → ❌ 致命,扣 -15/实体名,**跳过该 TM 内部所有方法的逐项检视**(方法存在性、签名一致性、参数类型、返回值、实现逻辑等均不再检查)
207
+ 5. 将跳过的 TM 记入输出表,明确标注"⛔ 跳过逐项检查"
208
+ - **扣分规则**: 未注册→致命-15/实体名;跳过的方法不计入致命问题计数
209
+ - **输出格式**:
210
+
211
+ ```markdown
212
+ | # | 实体类型 | JS/TS Spec 注册名 | ArkTS Factory 注册 | 状态 | 致命度 | 扣分 | 内部方法检查 |
213
+ |---|---------|-----------------|-------------------|------|--------|------|------------|
214
+ | 1 | TurboModule | `RNCWebViewModule` | ✅ 已注册 | ✅ 通过 | — | 0 | 继续逐项检视 |
215
+ | 2 | TurboModule | `RNCWebView` | ❌ 未注册 | ❌ 致命 | -15 | ⛔ 跳过 |
216
+ ```
217
+
218
+ **⚠️ 关键说明**:
219
+ - 跳过的 TM 内部方法**不计入致命问题计数**,避免因方法级重复扣分触发归零规则
220
+ - 此规则仅适用于 TM 整体未注册(无 ArkTS Factory 条件)的场景。若 TM 已注册但部分方法缺失,仍按检查项 3(方法存在性)的正常规则扣分
221
+
222
+ ### 3.1 检查点:函数签名(仅对已注册的 TM 执行)
223
+
224
+ #### 检查项概要
225
+
226
+ | # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
227
+ |---|--------|------|----------|----------|--------|
228
+ | 1 | NAME常量一致性 | ①契约一致性 | ArkTS NAME vs JS Spec注册名 vs C++ FactoryDelegate注册名 | 不一致→-5分/个 | 中等 |
229
+ | 2 | 方法签名一致性 | ①契约一致性 | ArkTS方法签名 vs generated Spec签名 vs JS Spec签名 | 签名不匹配→-8分/个 | 严重 |
230
+ | 3 | 方法存在性 | ①契约一致性 | JS Spec方法名 vs ArkTS TurboModule方法名 | 方法缺失→-15分/个 | 致命 |
231
+ | 4 | 参数数量 | ①契约一致性 | JS Spec参数数量 vs ArkTS TurboModule参数数量 | 不匹配→-8分 | 致命 |
232
+ | 5 | 参数类型 | ①契约一致性 | ArkTS TurboModule参数类型 vs JS Spec参数类型 | 类型致命错误→-10分/个 | 致命 |
233
+ | 6 | 参数顺序 | ①契约一致性 | JS Spec参数位置 vs ArkTS TurboModule参数位置 | 顺序错误→-6分 | 中等 |
234
+ | 7 | 方法签名vs Android | ②平台实现差异 | ArkTS TurboModule方法签名 vs Android @ReactMethod签名 | 合并至①检查 | — |
235
+ | 8 | 方法签名vs iOS | ②平台实现差异 | ArkTS TurboModule方法签名 vs iOS RCT_EXPORT_METHOD签名 | 合并至①检查 | — |
236
+ | 9 | Spec接口实现 | ③架构桥接一致性 | ArkTS TurboModule是否implements generated Spec接口 | 未实现→-8分/个 | 严重 |
237
+
238
+ > ⚠️ **前置过滤规则(3.0节)优先级最高**:检查项 1-9 仅对**已注册的 TM** 执行。未注册的 TM 整体在 3.0 中已扣致命-15,其内部方法不再逐项检视。
239
+
240
+ #### ①契约一致性
241
+
242
+ ##### 检查项1:NAME常量一致性
243
+
244
+ - **检查项**: NAME常量一致性
245
+ - **特征检索方式**: 在 `*TurboModule.ets` 中 grep `NAME = ` 或 `static NAME`;在 JS Spec 中 grep `TurboModuleRegistry.getEnforcing`;在 C++ FactoryDelegate 中 grep `if(name=="`
246
+ - **检视步骤**:
247
+ 1. 读取 `*TurboModule.ets`,提取 NAME 常量值(格式为 `TM.Xxx.NAME` 或 `static NAME = "xxx"`)
248
+ 2. 读取 JS Spec 文件,提取 `TurboModuleRegistry.getEnforcing<Spec>('XXX')` 中的模块注册名
249
+ 3. 读取 C++ FactoryDelegate 文件,提取 `if(name=="XXX")` 条件中的注册名
250
+ 4. 比较三者:ArkTS NAME值、JS Spec注册名、C++ FactoryDelegate注册名
251
+ 5. 判定规则:三者完全一致→通过;任一不一致→标注不一致并扣分
252
+ - **扣分规则**: 不一致→中等-5分/个
253
+ - **输出格式**:
254
+
255
+ ```markdown
256
+ | # | NAME来源 | NAME值 | 是否一致 | 扣分 |
257
+ |---|---------|--------|---------|------|
258
+ | 1 | ArkTS TurboModule NAME常量 | `"RNCWebViewModule"` | — | — |
259
+ | 2 | JS Spec TurboModuleRegistry注册名 | `'RNCWebViewModule'` | ✅/❌ | 0/-5 |
260
+ | 3 | C++ FactoryDelegate注册名 | `"RNCWebViewModule"` | ✅/❌ | 0/-5 |
261
+ ```
262
+
263
+ ##### 检查项2:方法签名一致性
264
+
265
+ - **检查项**: 方法签名一致性
266
+ - **特征检索方式**: 在 `*TurboModule.ets` 中 grep 所有 public 方法声明;在 generated Spec ts 文件中 grep interface 方法签名;在 JS Spec 中 grep 方法签名
267
+ - **检视步骤**:
268
+ 1. 从 `*TurboModule.ets` 提取所有 public 方法名及完整签名(参数类型+返回值类型)→列表M
269
+ 2. 从 generated Spec ts 文件提取所有 interface 方法签名→列表S
270
+ 3. 从 JS Spec 提取所有方法签名→列表J
271
+ 4. 逐方法对比 M vs S vs J:方法名相同则对比参数类型、参数顺序、返回值类型是否完全匹配
272
+ 5. 判定规则:签名完全一致→通过;任一不匹配→标注不匹配项并扣分
273
+ - **扣分规则**: 签名不匹配→严重-8分/个
274
+ - **输出格式**:
275
+
276
+ ```markdown
277
+ | # | 方法名 | ArkTS TurboModule签名 | generated Spec签名 | JS Spec签名 | 签名一致性 | 不匹配详情 | 扣分 |
278
+ |---|--------|----------------------|--------------------|------------|-----------|-----------|------|
279
+ | 1 | `connect` | `(id: string): void` | `(id: string): void` | `(id: string): void` | ✅ | — | 0 |
280
+ | 2 | `readRSSI` | `(id: number): Promise<number>` | `(id: string): Promise<number>` | `(id: string): Promise<number>` | ❌ | ArkTS参数类型number vs string | -8 |
281
+ ```
282
+
283
+ ##### 检查项3:方法存在性
284
+
285
+ - **检查项**: 方法存在性
286
+ - **特征检索方式**: 在 JS Spec 中提取所有方法名列表;在 `*TurboModule.ets` 中 grep 所有 public 方法名;在文档中搜索不支持标注
287
+ - **检视步骤**:
288
+ 1. 从 JS Spec 提取所有方法名→列表J
289
+ 2. 从 `*TurboModule.ets` 提取所有 public 方法名→列表A
290
+ 3. 对每个 JS Spec 方法名,检查是否存在于列表A中
291
+ 4. **🟢 豁免检查(优先级高于扣分)**:对每个 ArkTS 缺失的方法,检查文档是否标注不支持:
292
+ - 查找 **接口规格说明**(如 `接口规格说明.md`),该方法行是否有 `(Android only)`、`(iOS only)`、`(不支持)` 等标注
293
+ - 查找 **OHOS README**(如 `harmony/README.md`),"HarmonyOS Support" 列是否为 "No","Platform" 列是否非 "All" 且非 "HarmonyOS"
294
+ - 查找 **源码注释**,是否有 `// not supported`、`// Android only` 等标注
295
+ 5. 判定规则:
296
+ - 🟢 **文档已标注不支持** → 豁免,0分,标注"🟢 文档标注不支持(来源:文件:行号)"
297
+ - ❌ **文档未标注不支持** → 方法缺失→致命-15分/个
298
+ - **扣分规则**: 方法缺失→致命-15分/个;文档标注不支持→豁免0分(不计入致命问题计数)
299
+ - **输出格式**:
300
+
301
+ ```markdown
302
+ | # | 方法名 | JS Spec存在 | ArkTS TurboModule存在 | 文档标注不支持 | 文档来源 | 状态 | 扣分 |
303
+ |---|--------|------------|----------------------|--------------|---------|------|------|
304
+ | 1 | `connect` | ✅ | ✅ | — | — | ✅ 方法存在 | 0 |
305
+ | 2 | `clearFormData` | ✅ | ❌ | ✅ Android only, HarmonyOS Support: No | README.md:380 | 🟢 豁免不扣分 | 0 |
306
+ | 3 | `injectJavaScript` | ✅ | ❌ | ❌ 无标注 | — | ❌ 方法缺失 | -15 |
307
+ ```
308
+
309
+ ##### 检查项4:参数数量
310
+
311
+ - **检查项**: 参数数量
312
+ - **特征检索方式**: 在 JS Spec 中统计每个方法参数数量;在 `*TurboModule.ets` 中统计每个方法参数数量
313
+ - **检视步骤**:
314
+ 1. 从 JS Spec 逐方法统计参数数量→映射Q_js
315
+ 2. 从 `*TurboModule.ets` 逐方法统计参数数量→映射Q_arkts
316
+ 3. 对每个共有方法,对比 Q_js[method] vs Q_arkts[method]
317
+ 4. 判定规则:数量一致→通过;不匹配→标注差异并扣分
318
+ - **扣分规则**: 不匹配→致命-8分
319
+ - **输出格式**:
320
+
321
+ ```markdown
322
+ | # | 方法名 | JS Spec参数数量 | ArkTS TurboModule参数数量 | 是否一致 | 扣分 |
323
+ |---|--------|---------------|-------------------------|---------|------|
324
+ | 1 | `connect` | 1 | 1 | ✅ | 0 |
325
+ | 2 | `startScan` | 3 | 2 | ❌ | -8 |
326
+ ```
327
+
328
+ ##### 检查项5:参数类型
329
+
330
+ - **检查项**: 参数类型
331
+ - **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法参数的类型标注;在 JS Spec 中读取对应方法参数类型定义
332
+ - **检视步骤**:
333
+ 1. 从 `*TurboModule.ets` 逐方法读取每个参数的类型标注→映射T_arkts
334
+ 2. 从 JS Spec 逐方法读取每个参数的类型定义→映射T_js
335
+ 3. 对每个共有方法的每个参数,对比 T_arkts[method][param] vs T_js[method][param]
336
+ 4. 判定规则:类型完全匹配或为合理的跨平台类型映射(如Double→number)→通过;类型致命错误→标注并扣分
337
+ - **扣分规则**: 类型致命错误→致命-10分/个
338
+ - **输出格式**:
339
+
340
+ ```markdown
341
+ | # | 方法名 | 参数位置 | JS Spec类型 | ArkTS TurboModule类型 | 类型一致性 | 扣分 |
342
+ |---|--------|---------|------------|----------------------|-----------|------|
343
+ | 1 | `shouldStartLoadWithLockIdentifier` | 参数1 | `boolean` | `boolean` | ✅ | 0 |
344
+ | 2 | `shouldStartLoadWithLockIdentifier` | 参数2 | `Double` | `number` | ✅(合理映射) | 0 |
345
+ | 3 | `readRSSI` | 参数1 | `string` | `number` | ❌ | -10 |
346
+ ```
347
+
348
+ ##### 检查项6:参数顺序
349
+
350
+ - **检查项**: 参数顺序
351
+ - **特征检索方式**: 在 JS Spec 中提取每个方法参数定义顺序;在 `*TurboModule.ets` 中提取每个方法参数声明顺序
352
+ - **检视步骤**:
353
+ 1. 从 JS Spec 逐方法提取参数定义顺序→映射O_js
354
+ 2. 从 `*TurboModule.ets` 逐方法提取参数声明顺序→映射O_arkts
355
+ 3. 对每个共有方法,逐参数位置对比 O_js[method][i] vs O_arkts[method][i] 的参数名
356
+ 4. 判定规则:同名参数位置完全一致→通过;顺序错误→标注并扣分
357
+ - **扣分规则**: 顺序错误→中等-6分
358
+ - **输出格式**:
359
+
360
+ ```markdown
361
+ | # | 方法名 | JS Spec参数顺序 | ArkTS TurboModule参数顺序 | 顺序一致性 | 扣分 |
362
+ |---|--------|----------------|-------------------------|-----------|------|
363
+ | 1 | `connect` | `(id, options)` | `(id, options)` | ✅ | 0 |
364
+ | 2 | `startScan` | `(filter, options, callback)` | `(options, filter, callback)` | ❌ | -6 |
365
+ ```
366
+
367
+ #### ②平台实现差异
368
+
369
+ ##### 检查项7:方法签名vs Android
370
+
371
+ - **检查项**: 方法签名vs Android
372
+ - **特征检索方式**: 在 Android Java/Kotlin 文件中 grep `@ReactMethod` 注解的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
373
+ - **检视步骤**:
374
+ 1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
375
+ 2. 从 Android Java/Kotlin TurboModule 文件中读取所有 `@ReactMethod` 标注的方法签名→列表A_android
376
+ 3. 对每个共有方法,对比 M[method] vs A_android[method] 的参数数量、参数类型、返回值类型
377
+ 4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;Android签名差异视为JS Spec签名差异的补充参考
378
+ - **扣分规则**: 差异合并至①检查,不独立扣分
379
+ - **输出格式**:
380
+
381
+ ```markdown
382
+ | # | 方法名 | ArkTS TurboModule签名 | Android @ReactMethod签名 | 差异 | 合并至①检查项 |
383
+ |---|--------|----------------------|------------------------|------|-------------|
384
+ | 1 | `connect` | `(id: string): void` | `(String id): void` | ✅ 功能一致 | — |
385
+ | 2 | `requestPriority` | `(priority: number): void` | `(int priority): void` | ✅ 合理映射 | — |
386
+ ```
387
+
388
+ ##### 检查项8:方法签名vs iOS
389
+
390
+ - **检查项**: 方法签名vs iOS
391
+ - **特征检索方式**: 在 iOS 文件中 grep `RCT_EXPORT_METHOD` 宏定义的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
392
+ - **检视步骤**:
393
+ 1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
394
+ 2. 从 iOS TurboModule 文件中读取所有 `RCT_EXPORT_METHOD` 定义的签名→列表A_ios
395
+ 3. 对每个共有方法,对比 M[method] vs A_ios[method] 的参数数量、参数类型、返回值类型
396
+ 4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;iOS签名差异视为JS Spec签名差异的补充参考
397
+ - **扣分规则**: 差异合并至①检查,不独立扣分
398
+ - **输出格式**:
399
+
400
+ ```markdown
401
+ | # | 方法名 | ArkTS TurboModule签名 | iOS RCT_EXPORT_METHOD签名 | 差异 | 合并至①检查项 |
402
+ |---|--------|----------------------|--------------------------|------|-------------|
403
+ | 1 | `connect` | `(id: string): void` | `(NSString *id)` | ✅ 功能一致 | — |
404
+ | 2 | `readRSSI` | `(id: number): Promise<number>` | `(NSString *deviceID)` | 参数名差异 | 参考① |
405
+ ```
406
+
407
+ #### ③架构桥接一致性
408
+
409
+ ##### 检查项9:Spec接口实现
410
+
411
+ - **检查项**: Spec接口实现
412
+ - **特征检索方式**: 在 `*TurboModule.ets` 中 grep `implements TM.Xxx.Spec` 或类声明中的 implements 关系
413
+ - **检视步骤**:
414
+ 1. 读取 `*TurboModule.ets` 中 TurboModule 类声明行
415
+ 2. 检查类声明是否包含 `implements TM.Xxx.Spec`(Codegen模式)或手写 Spec 接口(Legacy模式)
416
+ 3. 判定规则:实现了 generated Spec 接口→通过;未实现→标注并扣分
417
+ - **扣分规则**: 未实现→严重-8分/个
418
+ - **输出格式**:
419
+
420
+ ```markdown
421
+ | # | TurboModule名 | ArkTS类声明 | implements Spec? | Spec接口来源 | 状态 | 扣分 |
422
+ |---|--------------|------------|-----------------|------------|------|------|
423
+ | 1 | `RNCWebViewModule` | `class WebViewTurboModule extends AnyThreadTurboModule implements TM.RNCWebViewModule.Spec` | ✅ | generated Codegen | ✅ 已实现 | 0 |
424
+ | 2 | `BleManagerModule` | `class BleTurboModule extends TurboModule` | ❌ | — | ❌ 未实现 | -8 |
425
+ ```
426
+
427
+ ---
428
+
429
+ ### 3.2 检查点:返回值
430
+
431
+ #### 检查项概要
432
+
433
+ | # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
434
+ |---|--------|------|----------|----------|--------|
435
+ | 1 | 返回值类型 | ①契约一致性 | ArkTS TurboModule返回值 vs JS Spec期望返回值 | 返回值类型错误→-10分/个 | 致命 |
436
+ | 2 | 返回值语义 | ①契约一致性 | ArkTS TurboModule返回内容 vs JS Spec接口语义 | 语义不匹配→视严重度扣分 | 严重/中等 |
437
+ | 3 | Promise处理 | ①契约一致性 | ArkTS TurboModule异步方法返回值 vs JS Spec异步声明 | Promise未正确包裹→-8分/个 | 严重 |
438
+ | 4 | 常量导出完整性 | ①契约一致性 | ArkTS TurboModule getConstants() vs Android/iOS getConstants() | 失常量→-5分/个 | 中等 |
439
+ | 5 | 常量值一致性 | ①契约一致性 | 各平台导出的常量值 | 值不一致→-3分/个 | 轻微 |
440
+ | 6 | 返回值vs Android/iOS | ②平台实现差异 | ArkTS TurboModule方法返回值 vs Android/iOS方法返回值 | 合并至①检查 | — |
441
+ | — | ③架构桥接一致性 | — | 已由①覆盖 | — | — |
442
+
443
+ #### ①契约一致性
444
+
445
+ ##### 检查项1:返回值类型
446
+
447
+ - **检查项**: 返回值类型
448
+ - **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的返回值类型标注;在 JS Spec 中读取对应方法的期望返回值类型
449
+ - **检视步骤**:
450
+ 1. 从 `*TurboModule.ets` 逐方法读取返回值类型标注→映射R_arkts
451
+ 2. 从 JS Spec 逐方法读取期望返回值类型→映射R_js
452
+ 3. 对每个共有方法,对比 R_arkts[method] vs R_js[method]
453
+ 4. 判定规则:类型完全匹配或为合理跨平台映射→通过;返回值类型错误→标注并扣分
454
+ - **扣分规则**: 返回值类型错误→致命-10分/个
455
+ - **输出格式**:
456
+
457
+ ```markdown
458
+ | # | 方法名 | JS Spec期望返回值类型 | ArkTS TurboModule返回值类型 | 类型一致性 | 扣分 |
459
+ |---|--------|--------------------|--------------------------|-----------|------|
460
+ | 1 | `isFileUploadSupported` | `Promise<boolean>` | `Promise<boolean>` | ✅ | 0 |
461
+ | 2 | `connect` | `void` | `Promise<void>` | ❌(多包裹Promise) | -10 |
462
+ ```
463
+
464
+ ##### 检查项2:返回值语义
465
+
466
+ - **检查项**: 返回值语义
467
+ - **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的方法体,验证返回值的语义正确性;在 JS Spec 中读取接口语义描述
468
+ - **检视步骤**:
469
+ 1. 读取 `*TurboModule.ets` 中每个方法的方法体,分析返回内容是否符合接口语义
470
+ 2. 读取 JS Spec 中对应方法的语义描述(方法名、注释、类型语义)
471
+ 3. 对比 ArkTS 实际返回值语义是否与 JS Spec 接口语义一致
472
+ 4. 判定规则:语义一致→通过;语义不匹配→视严重度扣分
473
+ - **扣分规则**: 语义严重不匹配→严重扣分;轻微语义偏差→中等扣分
474
+ - **输出格式**:
475
+
476
+ ```markdown
477
+ | # | 方法名 | JS Spec接口语义 | ArkTS TurboModule返回语义 | 语义一致性 | 扣分 |
478
+ |---|--------|---------------|--------------------------|-----------|------|
479
+ | 1 | `isFileUploadSupported` | 返回当前设备是否支持文件上传 | 固定返回true(语义:始终支持) | ✅ | 0 |
480
+ | 2 | `getOpenPeripherals` | 返回已连接的外围设备列表 | 返回空数组[](语义:无设备) | ❌ | -5 |
481
+ ```
482
+
483
+ ##### 检查项3:Promise处理
484
+
485
+ - **检查项**: Promise处理
486
+ - **特征检索方式**: 在 JS Spec 中 grep `Promise<` 或标注为异步的方法;在 `*TurboModule.ets` 中 grep `Promise<` 或 `async` 关键字
487
+ - **检视步骤**:
488
+ 1. 从 `*TurboModule.ets` 检查每个方法是否返回 Promise→映射P_arkts
489
+ 2. 从 JS Spec 检查哪些方法声明为异步(返回值类型含 Promise)→映射P_js
490
+ 3. 对每个共有方法,对比 P_arkts[method] vs P_js[method]
491
+ 4. 验证 ArkTS 异步方法是否正确使用 `Promise.resolve()`/`Promise.reject()` 包裹返回值
492
+ 5. 判定规则:JS Spec异步方法在ArkTS也返回Promise且包裹正确→通过;异步未包裹Promise→标注并扣分
493
+ - **扣分规则**: Promise未正确包裹→严重-8分/个
494
+ - **输出格式**:
495
+
496
+ ```markdown
497
+ | # | 方法名 | JS Spec是否异步 | ArkTS TurboModule是否返回Promise | Promise包裹正确性 | 扣分 |
498
+ |---|--------|---------------|-------------------------------|-----------------|------|
499
+ | 1 | `isFileUploadSupported` | ✅ Promise<boolean> | ✅ Promise.resolve(true) | ✅ | 0 |
500
+ | 2 | `readRSSI` | ✅ Promise<number> | ❌ 直接返回number | ❌ | -8 |
501
+ ```
502
+
503
+ ##### 检查项4:常量导出完整性
504
+
505
+ - **检查项**: 常量导出完整性
506
+ - **特征检索方式**: 在 `*TurboModule.ets` 中 grep `getConstants()` 方法;在 Android Java 中 grep `getConstants()` 方法;在 iOS 中 grep `getConstants()` 或常量导出相关代码
507
+ - **检视步骤**:
508
+ 1. 从 `*TurboModule.ets` 读取 `getConstants()` 方法,提取所有常量名→列表O
509
+ 2. 从 Android Java TurboModule 文件读取 `getConstants()` 方法,提取所有常量名→列表A
510
+ 3. 从 iOS TurboModule 文件读取常量导出代码,提取所有常量名→列表I
511
+ 4. 对比 O vs A vs I:检查每个常量是否在三平台均有导出
512
+ 5. 判定规则:三平台均导出→通过;任一平台失常量→标注并扣分
513
+ - **扣分规则**: 失常量→中等-5分/个
514
+ - **输出格式**:
515
+
516
+ ```markdown
517
+ | # | 常量名 | Android导出 | iOS导出 | ArkTS TurboModule导出 | ArkTS文件:行号 | 完整性 | 扣分 |
518
+ |---|--------|-----------|---------|----------------------|---------------|--------|------|
519
+ | 1 | `Scale` | ✅ | ✅ | ✅ | `MapsTurboModule.ets:25` | ✅ 三平台一致 | 0 |
520
+ | 2 | `ConnectionPriority` | ✅ | ⛔ 无 | ⛔ 无 | — | ⚠️ 仅Android有 | -5 |
521
+ ```
522
+
523
+ ##### 检查项5:常量值一致性
524
+
525
+ - **检查项**: 常量值一致性
526
+ - **特征检索方式**: 在各平台 TurboModule 文件中读取 `getConstants()` 返回的常量值
527
+ - **检视步骤**:
528
+ 1. 从各平台 `getConstants()` 方法中提取常量的具体值
529
+ 2. 对每个共有常量,对比 Android值 vs iOS值 vs ArkTS TurboModule值
530
+ 3. 判定规则:值完全一致→通过;值不一致→标注差异并扣分
531
+ - **扣分规则**: 值不一致→轻微-3分/个
532
+ - **输出格式**:
533
+
534
+ ```markdown
535
+ | # | 常量名 | Android值 | iOS值 | ArkTS TurboModule值 | 值一致性 | 扣分 |
536
+ |---|--------|---------|-------|--------------------|---------|------|
537
+ | 1 | `Scale` | `0.0001` | `0.0001` | `0.0001` | ✅ | 0 |
538
+ | 2 | `Timeout` | `30` | `30` | `60` | ❌ | -3 |
539
+ ```
540
+
541
+ #### ②平台实现差异
542
+
543
+ ##### 检查项6:返回值vs Android/iOS
544
+
545
+ - **检查项**: 返回值vs Android/iOS
546
+ - **特征检索方式**: 在 Android/iOS TurboModule 文件中读取方法返回值;在 `*TurboModule.ets` 中读取方法返回值
547
+ - **检视步骤**:
548
+ 1. 从 `*TurboModule.ets` 提取每个方法的返回值类型和语义
549
+ 2. 从 Android/iOS TurboModule 提取对应方法的返回值类型和语义
550
+ 3. 对比 ArkTS返回值 vs Android/iOS返回值
551
+ 4. 判定规则:差异合并至①契约一致性检查,不独立扣分;Android/iOS返回值差异视为JS Spec返回值对比的补充参考
552
+ - **扣分规则**: 差异合并至①检查,不独立扣分
553
+ - **输出格式**:
554
+
555
+ ```markdown
556
+ | # | 方法名 | ArkTS TurboModule返回值 | Android返回值 | iOS返回值 | 差异 | 合并至①检查项 |
557
+ |---|--------|------------------------|-------------|---------|------|-------------|
558
+ | 1 | `isFileUploadSupported` | `Promise<boolean>` | `boolean` | `BOOL` | ✅ 功能一致 | — |
559
+ ```
560
+
561
+ #### ③架构桥接一致性
562
+
563
+ > ③架构桥接一致性维度已由①契约一致性检查覆盖(Spec接口实现已在3.1检查点9中完成),此处不再重复。
564
+
565
+ ---
566
+
567
+ ### 3.3 检查点:实现逻辑 ⚠️ 最关键检查项
568
+
569
+ #### 检查项概要
570
+
571
+ | # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
572
+ |---|--------|------|----------|----------|--------|
573
+ | 1 | Stub检测与合理性判定 | ②平台实现差异⚠️核心 | ArkTS方法实现 vs Android/iOS同名方法行为 | 致命Stub→-8分/方法;空方法体→-8分/方法;逻辑Stub→-12分/方法;合理Stub→0分 | 致命/严重/0 |
574
+ | 2 | 方法行为跨平台对比 | ②平台实现差异⚠️核心 | Android/iOS/OHOS三平台方法行为 | 行为致命不一致→-15分/方法;行为严重不一致→-12分/方法 | 致命/严重 |
575
+ | 3 | 边界处理 | ②平台实现差异 | ArkTS方法边界条件 vs Android/iOS边界处理 | 不一致→-8分 | 中等 |
576
+ | 4 | 错误处理 | ②平台实现差异 | ArkTS方法错误处理 vs Android/iOS错误处理 | 不一致→-6分 | 中等 |
577
+ | 5 | 回调/事件机制 | ③架构桥接一致性 | ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑 | 触发逻辑不一致→-12分/个 | 严重 |
578
+ | — | ①契约一致性 | — | 实现逻辑不属于契约维度,N/A | — | — |
579
+
580
+ #### ①契约一致性
581
+
582
+ > 实现逻辑不属于契约维度(契约维度仅覆盖签名和返回值声明),①为 N/A。
583
+
584
+ #### ②平台实现差异 ⚠️ 核心维度:每个方法与Android/iOS行为级对比
585
+
586
+ ##### 检查项1:Stub检测与合理性判定
587
+
588
+ - **检查项**: Stub检测与合理性判定
589
+ - **特征检索方式**: 在 `*TurboModule.ets` 中查找以下Stub模式:(a) `return true;` / `return false;` / `return null;` 等固定返回值;(b) `return Promise.resolve(true)` / `return Promise.resolve(false)` 等固定Promise返回;(c) 方法体仅有 `console.log` 或注释;(d) 方法体为空或仅有 `{}`;(e) 未调用任何 `@ohos` API 或实际业务操作
590
+ - **检视步骤**:
591
+ 1. 读取 `*TurboModule.ets` 中每个方法的方法体
592
+ 2. 识别Stub模式:(a) 方法体仅有return固定值;(b) 未调用@ohos API;(c) 未执行实际业务操作;(d) 仅console.log输出
593
+ 3. 读取 Android Java/Kotlin TurboModule 中同名方法的实际实现
594
+ 4. 读取 iOS TurboModule 中同名方法的实际实现
595
+ 5. 对比:Android/iOS有实际业务逻辑但ArkTS为Stub→致命Stub;iOS也返回固定值→合理Stub
596
+ 6. 判定规则:三平台行为一致(均为固定返回)→合理Stub 0分;Android/iOS有实际逻辑但ArkTS为Stub→致命Stub 扣分
597
+ - **扣分规则**:
598
+ - 合理固定返回:方法语义本身返回固定值且与Android/iOS一致→0分
599
+ - 无条件Stub:返回固定值但Android/iOS有实际业务逻辑→致命-8分/方法
600
+ - 空方法体Stub:方法体为空或仅有console.log→致命-8分/方法
601
+ - 逻辑Stub:有部分逻辑但缺少核心操作→严重-12分/方法
602
+ - **输出格式**:
603
+
604
+ ```markdown
605
+ | # | 方法名 | ArkTS文件:行号 | Stub代码片段 | Stub类型 | Android实现 | iOS实现 | Stub合理性 | 缺失逻辑 | 严重度 | 扣分 |
606
+ |---|--------|---------------|-------------|---------|------------|--------|-----------|---------|--------|------|
607
+ | 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | 合理固定返回 | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
608
+ | 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | 无条件Stub | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
609
+ | 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | 空方法体Stub | ✅ 调用gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
610
+ | 4 | `connect` | `BleTurboModule.ets:89` | 仅更新状态变量未调用蓝牙连接 | 逻辑Stub | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ❌ 缺少核心操作 | 蓝牙连接API调用 | ❌ 严重 | -12 |
611
+ ```
612
+
613
+ ##### 检查项2:方法行为跨平台对比
614
+
615
+ - **检查项**: 方法行为跨平台对比
616
+ - **特征检索方式**: 在 Android/iOS/ArkTS 三平台 TurboModule 文件中读取每个方法的实现摘要
617
+ - **检视步骤**:
618
+ 1. 对每个TurboModule方法,读取Android实现并提取行为摘要(调用的API、执行的操作、产生的结果)
619
+ 2. 读取iOS实现并提取行为摘要
620
+ 3. 读取ArkTS TurboModule实现并提取行为摘要
621
+ 4. 对比三平台实际行为:核心业务逻辑是否一致、副作用是否一致、结果是否等效
622
+ 5. 判定规则:三平台行为一致或功能等效→通过;行为致命不一致→致命扣分;行为严重不一致→严重扣分
623
+ - **扣分规则**:
624
+ - 行为致命不一致(核心功能缺失或行为完全不同)→致命-15分/方法
625
+ - 行为严重不一致(部分核心逻辑缺失)→严重-12分/方法
626
+ - **输出格式**:
627
+
628
+ ```markdown
629
+ | # | 方法名 | Android实现摘要 | iOS实现摘要 | ArkTS实现摘要 | ArkTS文件:行号 | 行为对比状态 | 扣分 |
630
+ |---|--------|---------------|------------|--------------|---------------|------------|------|
631
+ | 1 | `isFileUploadSupported` | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 始终返回true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
632
+ | 2 | `connect` | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ✅ 调用@ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
633
+ | 3 | `removeBond` | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ Stub: return true | `BleTurboModule.ets:278` | ❌ 致命不一致 | -15 |
634
+ ```
635
+
636
+ ##### 检查项3:边界处理
637
+
638
+ - **检查项**: 边界处理
639
+ - **特征检索方式**: 在 `*TurboModule.ets` 中查找边界条件处理代码(null/undefined检查、空数组检查、越界检查等);在 Android/iOS TurboModule 中查找同名方法的边界条件处理
640
+ - **检视步骤**:
641
+ 1. 从 `*TurboModule.ets` 读取每个方法的边界条件处理(null检查、空值检查、参数校验等)
642
+ 2. 从 Android/iOS TurboModule 读取同名方法的边界条件处理
643
+ 3. 对比 ArkTS边界处理 vs Android/iOS边界处理
644
+ 4. 判定规则:边界处理一致或ArkTS有更严格的处理→通过;不一致→标注并扣分
645
+ - **扣分规则**: 不一致→中等-8分
646
+ - **输出格式**:
647
+
648
+ ```markdown
649
+ | # | 方法名 | Android/iOS边界处理 | ArkTS TurboModule边界处理 | 一致性 | 扣分 |
650
+ |---|--------|-------------------|-------------------------|--------|------|
651
+ | 1 | `connect` | ✅ 检查id非null | ✅ 检查id非null和非空字符串 | ✅ ArkTS更严格 | 0 |
652
+ | 2 | `startScan` | ✅ 检查filter非null | ❌ 无边界检查 | ❌ | -8 |
653
+ ```
654
+
655
+ ##### 检查项4:错误处理
656
+
657
+ - **检查项**: 错误处理
658
+ - **特征检索方式**: 在 `*TurboModule.ets` 中查找 try-catch 块、error回调、Promise.reject 等错误处理模式;在 Android/iOS TurboModule 中查找同名方法的错误处理
659
+ - **检视步骤**:
660
+ 1. 从 `*TurboModule.ets` 读取每个方法的错误处理(try-catch、error callback、Promise.reject等)
661
+ 2. 从 Android/iOS TurboModule 读取同名方法的错误处理
662
+ 3. 对比 ArkTS错误处理 vs Android/iOS错误处理
663
+ 4. 判定规则:错误处理一致或ArkTS有合理的错误处理→通过;不一致→标注并扣分
664
+ - **扣分规则**: 不一致→中等-6分
665
+ - **输出格式**:
666
+
667
+ ```markdown
668
+ | # | 方法名 | Android/iOS错误处理 | ArkTS TurboModule错误处理 | 一致性 | 扣分 |
669
+ |---|--------|-------------------|-------------------------|--------|------|
670
+ | 1 | `connect` | ✅ try-catch + Promise.reject | ✅ try-catch + Promise.reject | ✅ | 0 |
671
+ | 2 | `readRSSI` | ✅ try-catch + 回调error参数 | ❌ 无错误处理 | ❌ | -6 |
672
+ ```
673
+
674
+ #### ③架构桥接一致性
675
+
676
+ ##### 检查项5:回调/事件机制
677
+
678
+ - **检查项**: 回调/事件机制
679
+ - **特征检索方式**: 在 `*TurboModule.ets` 中 grep 回调调用模式(`this.emitDeviceEvent`、`sendEvent`、回调函数调用);在 Android/iOS TurboModule 中 grep 同名回调触发模式(Android: `sendEvent`/回调接口;iOS: `RCTEventEmitter`/block回调)
680
+ - **检视步骤**:
681
+ 1. 从 `*TurboModule.ets` 读取每个回调方法的触发逻辑(触发时机、触发方式、回调参数)
682
+ 2. 从 Android TurboModule 读取同名回调/事件的触发逻辑
683
+ 3. 从 iOS TurboModule 读取同名回调/事件的触发逻辑
684
+ 4. 对比 ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑
685
+ 5. 判定规则:触发时机、触发方式、回调参数三平台一致→通过;触发逻辑不一致→标注并扣分
686
+ - **扣分规则**: 触发逻辑不一致→严重-12分/个
687
+ - **输出格式**:
688
+
689
+ ```markdown
690
+ | # | 回调/事件名 | JS Spec定义 | Android触发逻辑 | iOS触发逻辑 | ArkTS TurboModule触发逻辑 | ArkTS文件:行号 | 触发逻辑一致性 | 扣分 |
691
+ |---|------------|-------------|---------------|------------|-------------------------|---------------|--------------|------|
692
+ | 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
693
+ | 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -12 |
694
+ ```
695
+
696
+ ---
697
+
698
+ ## 4. 方法行为跨平台对比
699
+
700
+ ### 4.1 方法行为对比格式
701
+
702
+ 对每个 TurboModule 方法,必须与 Android/iOS 的同名方法做行为对比:
703
+
704
+ ```markdown
705
+ | # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS TurboModule 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
706
+ |---|--------|----------------|-------------|--------------------------|---------------|------------|------|
707
+ | 1 | `isFileUploadSupported` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 始终返回 true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
708
+ | 2 | `connect` | ✅ 调用 BluetoothGatt.connect() | ✅ 调用 CBCentralManager.connect() | ✅ 调用 @ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
709
+ | 3 | `removeBond` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ Stub: `return true;` | `BleTurboModule.ets:278` | ❌ 致命不一致 | -8 |
710
+ ```
711
+
712
+ ### 4.2 行为一致性判定规则
713
+
714
+ | 行为对比结果 | 判定 | 扣分 |
715
+ |-------------|------|------|
716
+ | 三平台行为一致 | ✅ 一致 | 0 |
717
+ | OHOS 使用不同机制但功能等效 | ✅ 功能一致 | 0 |
718
+ | OHOS 仅缺少非核心差异 | ⚠️ 轻微不一致 | -3~-5 |
719
+ | OHOS 缺少部分核心逻辑 | ❌ 严重不一致 | -8~-12 |
720
+ | OHOS 为 Stub 或方法缺失 | ❌ 致命 | -8~-15 |
721
+
722
+ ---
723
+
724
+ ## 5. 跨层一致性检测(ArkTS TurboModule 视角)
725
+
726
+ ### 5.1 全链路 TurboModule 对比
727
+
728
+ ```markdown
729
+ | # | TurboModule 名 | JS Spec 定义 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | C++ JSIBinder | generated Spec 接口 | ArkTS TurboModule 类 | ArkTS 文件 | 状态 | 扣分 |
730
+ |---|--------------|------------|--------------|------------------------|-------------|--------------------|--------------------|-----------|------|------|
731
+ | 1 | `RNCWebViewModule` | `NativeRNCWebViewModule.ts` | `RNCWebViewModule` | ✅ `RNCWebViewModule` | ✅ JSIBinder | ✅ TM.RNCWebViewModule.Spec | ✅ WebViewTurboModule | `WebViewTurboModule.ets:11` | ✅ 全链路一致 | 0 |
732
+ ```
733
+
734
+ ### 5.2 断桥类型定义(TurboModule 视角)
735
+
736
+ | 断桥位置 | 识别方式 | 影响 | 扣分 |
737
+ |---------|----------|------|------|
738
+ | JS→C++ 注册断桥 | JS Spec TurboModuleRegistry 注册名在 C++ FactoryDelegate 中无对应 if 条件 | JS 调用 TurboModule 但 C++ 无法创建实例 | -10/个(致命) |
739
+ | C++→ArkTS 类映射断桥 | C++ FactoryDelegate 中 `std::make_shared<XxxTurboModule>` 类名在 ArkTS 中无对应实现类 | C++ 创建实例但无法路由到 ArkTS 实现 | -8/个(严重) |
740
+ | ArkTS 方法缺失断桥 | JS Spec 方法在 ArkTS TurboModule 中无对应方法实现 | JS 调用方法但 ArkTS 不响应 | -15/个(致命) |
741
+ | ArkTS Stub 断桥 | ArkTS TurboModule 方法为 Stub 但 Android/iOS 有实际业务逻辑 | 方法调用成功但行为完全不同 | -8/方法(致命) |
742
+ | ArkTS 常量缺失断桥 | Android/iOS getConstants() 导出的常量在 ArkTS TurboModule 中缺失 | JS 读取常量返回 undefined | -5/个(中等) |
743
+
744
+ ---
745
+
746
+ ## 6. 检视操作流程
747
+
748
+ ### 6.1 Phase 0 补充步骤(ArkTS TurboModule 定位)
749
+
750
+ ```
751
+ TM-ARK-1: 定位 ArkTS TurboModule 实现文件
752
+ → 搜索 harmony/<module>/src/main/ets/*TurboModule.ets
753
+
754
+ TM-ARK-2: 定位 generated TurboModule Spec 类型
755
+ → 搜索 generated/turboModules/TurboModuleName.ts
756
+ → 搜索 generated/turboModules/ts.ts
757
+
758
+ TM-ARK-3: 读取 ArkTS TurboModule 类声明
759
+ → 提取 NAME 常量、父类、implements Spec 接口
760
+
761
+ TM-ARK-4: 读取 generated Spec 接口方法列表
762
+ → 提取所有方法名和签名
763
+ ```
764
+
765
+ ### 6.2 Phase 3 补充步骤(ArkTS TurboModule 分析)
766
+
767
+ ```
768
+ TM-ARK-5: TurboModule NAME 常量对比
769
+ → ArkTS NAME 常量 vs JS Spec TurboModuleRegistry 注册名 vs C++ FactoryDelegate 注册名
770
+ → 标注注册名不一致
771
+
772
+ TM-ARK-6: 方法实现完整性对比
773
+ → JS Spec 方法名 vs generated Spec 方法名 vs ArkTS TurboModule 方法名
774
+ → 标注方法缺失
775
+
776
+ TM-ARK-7: 方法签名对比
777
+ → ArkTS TurboModule 方法签名 vs generated Spec 接口方法签名
778
+ → 标注签名不匹配、类型映射错误
779
+
780
+ TM-ARK-8: Stub 检测与合理性判定
781
+ → 对每个 ArkTS TurboModule 方法判断是否为 Stub
782
+ → 与 Android/iOS 同名方法行为对比判定 Stub 合理性
783
+ → 标注 Stub 方法及其缺失逻辑
784
+
785
+ TM-ARK-9: 常量导出对比
786
+ → Android/iOS getConstants() vs ArkTS TurboModule getConstants()
787
+ → 标注失常量
788
+
789
+ TM-ARK-10: 回调/事件对比
790
+ → ArkTS TurboModule 回调/事件实现 vs Android/iOS 回调/事件
791
+ → 标注回调缺失、事件缺失、Payload 缺失
792
+
793
+ TM-ARK-11: 方法行为跨平台对比
794
+ → 对每个方法列出 Android/iOS/OHOS 三平台行为
795
+ → 标注行为不一致
796
+ ```
797
+
798
+ ---
799
+
800
+ ## 7. 报告输出格式
801
+
802
+ 在一致性检视报告的"5.8 RN 架构一致性检视"中增加以下子章节:
803
+
804
+ ```markdown
805
+ #### ArkTS TurboModule 层一致性(如适用)
806
+
807
+ **ArkTS TurboModule 模式**:{Codegen(implements TM.Xxx.Spec)/ Legacy(手写) / ⚠️ 无 ArkTS TurboModule 层}
808
+
809
+ **TurboModule 类声明一致性**:
810
+
811
+ | # | TurboModule 名 | ArkTS 类名 | NAME 常量 | JS Spec 注册名 | C++ FactoryDelegate | implements Spec? | 状态 | 扣分 |
812
+ |---|--------------|-----------|----------|--------------|--------------------|----------------|------|------|
813
+ | ... | ... | ... | ... | ... | ... | ... | ... | ... |
814
+
815
+ **TurboModule 方法级对比**:
816
+
817
+ | # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
818
+ |---|--------|-------------|--------------------|----------------------|---------------|----------|------|
819
+ | ... | ... | ... | ... | ... | ... | ... | ... |
820
+
821
+ **TurboModule Stub 检测**:
822
+
823
+ | # | 方法名 | ArkTS 文件:行号 | Stub 代码 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
824
+ |---|--------|---------------|----------|-------------|---------|------------|---------|--------|------|
825
+ | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
826
+
827
+ **TurboModule 常量导出对比**:
828
+
829
+ | # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
830
+ |---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
831
+ | ... | ... | ... | ... | ... | ... | ... | ... | ... |
832
+
833
+ **TurboModule 回调/事件对比**:
834
+
835
+ | # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
836
+ |---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
837
+ | ... | ... | ... | ... | ... | ... | ... | ... | ... |
838
+
839
+ **TurboModule 方法行为跨平台对比**:
840
+
841
+ | # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
842
+ |---|--------|----------------|-------------|--------------|---------------|------------|------|
843
+ | ... | ... | ... | ... | ... | ... | ... | ... |
844
+ ```
845
+
846
+ ---
847
+
848
+ ## 8. 与 CPP_TURBOMODULE_CHECK_GUIDE 的协同
849
+
850
+ 本指南与 CPP_TURBOMODULE_CHECK_GUIDE 共享"TurboModule 全链路对比表"。检视执行顺序建议:
851
+
852
+ 1. **先执行 CPP_TURBOMODULE_CHECK_GUIDE** → 获得 C++ FactoryDelegate 注册名、JSIBinder 方法列表
853
+ 2. **再执行 ARKTS_TURBOMODULE_CHECK_GUIDE** → 获得 ArkTS TurboModule 类声明、方法实现、Stub 检测、常量导出、回调/事件数据
854
+ 3. **合并两张表** → 生成完整 TurboModule 全链路一致性分析
855
+
856
+ 若两个指南独立执行,各自的全链路表可能存在重叠列。合并时以 TurboModule 名为主键,将两表的列拼接为完整链路。