@ohos-cpf/3rdloop 0.0.2 → 0.0.4

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 +290 -244
  2. package/bin/3rdloop.mjs +46 -46
  3. package/lib/cli.js +781 -781
  4. package/lib/config-cmd.js +451 -451
  5. package/lib/config.js +318 -318
  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 +279 -279
  14. package/lib/workflow.js +308 -308
  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 -275
  33. package/vendor/Server/CLI/deveco-code/index.js +71 -71
  34. package/vendor/Server/CLI/deveco-code.js +5 -5
  35. package/vendor/Server/CLI/opencode/index.js +817 -818
  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 -203
  80. package/vendor/Server/Routes/sse/SseHub.js +308 -308
  81. package/vendor/Server/Skills/acceptance-check/SKILL.md +191 -191
  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 -70
  85. package/vendor/Server/Skills/arkts-code-check/SKILL.md +320 -320
  86. package/vendor/Server/Skills/arkts-code-check/references/CODE_CHECK_GUIDE.md +210 -210
  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 -233
  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 +192 -192
  393. package/vendor/Server/Agent/SkillSelector/types.js +0 -63
@@ -1,137 +1,137 @@
1
- # README 模板格式差异与改写要点
2
-
3
- ## 如何判定格式(detect-readme-format.js)
4
-
5
- 按下列信号综合判定,**不符目标模板则进入整改流程**:
6
-
7
- | 信号 | 外链/旧文档 | v0.4.0(usage-docs 常见) | v0.4.1(库内常见) | v0.4.2(目标) |
8
- |------|-------------|---------------------------|--------------------|----------------|
9
- | 首行 | 无 / `# 包名` | `> 模板版本:v0.4.0` 或 `> Template version: v0.4.0` | `> 文档模板:v0.4.1` | `> 文档模板:v0.4.2` |
10
- | 版本表 | 无完整表 | 有表,列名偏旧 | 含 `三方库版本` + **`npm地址`** | 含 **`三方库版本(npm地址)`** + **`源码地址`** |
11
- | 结构 | 常仅有 Documentation URL 外链 | 分节编号如 `## 1. 安装与使用` | `## 简介` / `## 下载安装` / `## 使用示例` 等 | 同 0.4.1 骨架,并强调 **`## 使用说明`** 等 0.4.2 章节 |
12
- | 外链特征 | 含 `Documentation URL` 且正文几乎只有外链 | — | — | — |
13
-
14
- `kind` 输出建议:`external_link` | `v0.4.0` | `v0.4.1` | `v0.4.2` | `unknown`。
15
-
16
- ## 0.4.1 → 0.4.2 主要变更
17
-
18
- 1. 首行版本改为 `v0.4.2`
19
- 2. 版本关系表:
20
- - `三方库版本` → `三方库版本(npm地址)`(单元格内放 npm 版本链接)
21
- - `npm地址` 列改为 **`源码地址`**(指向 Gitcode 分支/源码树)
22
- 3. 保留并理顺:`简介`、`下载安装`、`Link`、`约束与限制`、`使用示例`、`使用说明`、`接口说明`、`遗留问题`、`其他`、`目录结构`、`贡献代码`、`开源协议`
23
- 4. 内容按**当前库**重写:Autolink、API 级别、兼容性矩阵、示例代码(从 example / 源码提取)
24
- 5. **ManualLink 取舍**:若当前分支版本表与 Link 表中 Autolink **全部为是/Yes**,删除 README 中 ManualLink `<details>` 整段;详见下文「ManualLink 章节」
25
-
26
- ## ManualLink 章节(Autolink 全支持时删除)
27
-
28
- 模板 `model-0.4.2.md` 含 ManualLink 作为**多版本混合**时的兜底;**单分支且该分支所有版本均支持 Autolink** 时:
29
-
30
- - **删除** `<details>…ManualLink…</details>` 全部内容
31
- - **删除**「可跳过 ManualLink 配置」一句(全版本已 Autolink 时无意义)
32
- - **保留** Link 版本表、Autolinking 框架文档链接、`### 运行`
33
-
34
- 判定数据源:版本关系表 `Autolink` 列 + `## Link` 小节表格;任一行 `否`/`No`/`partially` 则保留 ManualLink。
35
-
36
- - overview 回写(usage-docs)
37
-
38
- `model-0.4.2-overview.md` 为精简版:标题、基于上游说明、版本表、简介、下载安装。
39
-
40
- - 中英文都 **覆盖** `zh-cn/<alias>.md` 与 `en/<alias>.md`
41
- - 英文由中文 overview 翻译
42
- - 版本表等事实与库内 README 保持一致
43
-
44
- ## 链接与组织(必读)
45
-
46
- ### 根因说明(避免 openharmony-sig 残留)
47
-
48
- | 来源 | 问题 |
49
- |------|------|
50
- | **usage-docs 正文** | 大量文档仍含 `gitcode.com/openharmony-sig/...`,从 usage-docs 迁入库 README 时会**原样复制** |
51
- | **库内 package.json** | `repository.url` 可能仍指向旧组织 |
52
- | **模板 model-0.4.2.md** | 框架/本库链接已用 `CPF-RN`;但勿把 usage-docs 专用相对路径(如 `/zh-cn/link-source-code.md`)留到库 README |
53
-
54
- 技能内置模板(`references/model-0.4.2.md`)的 **Releases / Issue / PR / Autolinking** 已使用 [CPF-RN](https://gitcode.com/CPF-RN) 组织;**不能**假设 usage-docs 与 package.json 已同步。
55
-
56
- ### 组织与仓库解析顺序
57
-
58
- 1. **本库 Gitcode 地址**:优先 `git remote get-url origin` 或 `package.json.repository.url`
59
- 2. 若仍为 `openharmony-sig`,在 [CPF-RN 组织](https://gitcode.com/CPF-RN) 搜索 `rntpc_<alias>` 确认(如 [rntpc_react-native-audio](https://gitcode.com/CPF-RN/rntpc_react-native-audio))
60
- 3. **框架 Autolinking 文档**:`https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md`(框架仓)
61
- 4. **三方库接入指导**(如直接链接源码):在 [usage-docs](https://gitcode.com/CPF-RN/usage-docs) 仓,例如 `zh-cn/link-source-code.md` → `https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md`(**不在** `ohos_react_native`)
62
- 5. **usage-docs 站内相对链接**(`/zh-cn/...`、`./link-source-code.md`):迁入库 README 时必须改为 usage-docs **绝对 URL**(见 [`link-registry.json`](link-registry.json))
63
-
64
- ### Step 3.5 — 链接规范化(从 usage-docs 迁移后**必做**)
65
-
66
- ```bash
67
- node scripts/normalize-readme-links.js --lib-path "$LIB"
68
- node scripts/normalize-readme-links.js --lib-path "$LIB" --write
69
- ```
70
-
71
- 脚本会:
72
-
73
- - 将 `openharmony-sig` URL **仅在 CPF-RN 目标可达时**替换(见 `link-verify.js`;不可达则保留并报告)
74
- - 将 `/zh-cn/link-source-code.md` 等 usage-docs 相对路径改为绝对链接,并对结果 URL **做 HTTP 可达性校验**
75
- - 校验库内相对路径(仅允许 `./README.md` / `./README_EN.md` 等)
76
- - 校验并同步修正 `package.json` 的 `repository.url` / `homepage` / `bugs.url`(验证通过才写回)
77
-
78
- **退出码 2** 表示链接不可达、仓库根 URL 未验证、或仍有失效相对路径/旧组织残留。
79
-
80
- ### 链接可达性(必做,禁止仅改组织名)
81
-
82
- | 步骤 | 说明 |
83
- |------|------|
84
- | 解析仓库 | `resolveVerifiedLibRepoBase` 对多个候选 URL 执行 `curl -L`,选用首个 2xx/3xx |
85
- | 组织迁移 | 每个 `openharmony-sig` 链接触发「替换后 URL 是否可达」探测,失败则不替换 |
86
- | 改写后复检 | README / package 中所有 GitCode / usage-docs / npm 外链汇总校验 |
87
- | 失败处理 | 报告 `linkVerification.failures`;Agent 需修正仓库名、分支或链接后重跑 |
88
-
89
- ```bash
90
- node scripts/normalize-readme-links.js --lib-path "$LIB" # 含可达性检查
91
- node scripts/normalize-readme-links.js --lib-path "$LIB" --write # 仅当 ok=true
92
- node scripts/normalize-package-meta.js --lib-path "$LIB" --write # 同样校验 homepage/issues/LICENSE
93
- ```
94
-
95
- 离线调试可加 `--skip-verify`;**提交交付前必须去掉**。
96
-
97
- ### README 贡献 / 协议链接(CPF-RN 本库)
98
-
99
- | 章节 | 中文 README | 英文 README |
100
- |------|-------------|-------------|
101
- | 贡献代码 / Contributing | Issue → `{libRepo}/issues`;PR → `{libRepo}/pulls` | 同左 |
102
- | 开源协议 / License | `{libRepo}/blob/master/LICENSE` | 同左 |
103
-
104
- `{libRepo}` = `https://gitcode.com/CPF-RN/rntpc_<alias>`(由 `normalize-readme-links.js` 解析)。
105
-
106
- **禁止:**
107
-
108
- - Issue/PR 仍指向 `openharmony-sig`
109
- - LICENSE 仅指向上游 GitHub(如 `github.com/.../LICENSE`),而本库根目录已有 MIT LICENSE
110
-
111
- ### Step 5 — package.json 与 oh-package.json5
112
-
113
- 见 [rn-lib-update-doc SKILL Step 5](../SKILL.md#step-5--规范-packagejson-与-harmony-oh-packagejson5必做)。
114
-
115
- ```bash
116
- node scripts/normalize-package-meta.js --lib-path "$LIB" --write
117
- ```
118
-
119
- ### Step 6 — CHANGELOG
120
-
121
- 见 [changelog-template.md](changelog-template.md) 与 `normalize-changelog.js`。
122
-
123
- ## 英文标题对照(常用)
124
-
125
- | 中文 | English |
126
- |------|---------|
127
- | 简介 | Introduction |
128
- | 下载安装 | Installation |
129
- | 约束与限制 | Constraints and Limitations |
130
- | 使用示例 | Usage Example |
131
- | 使用说明 | Usage Guide |
132
- | 接口说明 | API Reference |
133
- | 遗留问题 | Known Issues |
134
- | 其他 | Others |
135
- | 目录结构 | Directory Structure |
136
- | 贡献代码 | Contributing |
137
- | 开源协议 | License |
1
+ # README 模板格式差异与改写要点
2
+
3
+ ## 如何判定格式(detect-readme-format.js)
4
+
5
+ 按下列信号综合判定,**不符目标模板则进入整改流程**:
6
+
7
+ | 信号 | 外链/旧文档 | v0.4.0(usage-docs 常见) | v0.4.1(库内常见) | v0.4.2(目标) |
8
+ |------|-------------|---------------------------|--------------------|----------------|
9
+ | 首行 | 无 / `# 包名` | `> 模板版本:v0.4.0` 或 `> Template version: v0.4.0` | `> 文档模板:v0.4.1` | `> 文档模板:v0.4.2` |
10
+ | 版本表 | 无完整表 | 有表,列名偏旧 | 含 `三方库版本` + **`npm地址`** | 含 **`三方库版本(npm地址)`** + **`源码地址`** |
11
+ | 结构 | 常仅有 Documentation URL 外链 | 分节编号如 `## 1. 安装与使用` | `## 简介` / `## 下载安装` / `## 使用示例` 等 | 同 0.4.1 骨架,并强调 **`## 使用说明`** 等 0.4.2 章节 |
12
+ | 外链特征 | 含 `Documentation URL` 且正文几乎只有外链 | — | — | — |
13
+
14
+ `kind` 输出建议:`external_link` | `v0.4.0` | `v0.4.1` | `v0.4.2` | `unknown`。
15
+
16
+ ## 0.4.1 → 0.4.2 主要变更
17
+
18
+ 1. 首行版本改为 `v0.4.2`
19
+ 2. 版本关系表:
20
+ - `三方库版本` → `三方库版本(npm地址)`(单元格内放 npm 版本链接)
21
+ - `npm地址` 列改为 **`源码地址`**(指向 Gitcode 分支/源码树)
22
+ 3. 保留并理顺:`简介`、`下载安装`、`Link`、`约束与限制`、`使用示例`、`使用说明`、`接口说明`、`遗留问题`、`其他`、`目录结构`、`贡献代码`、`开源协议`
23
+ 4. 内容按**当前库**重写:Autolink、API 级别、兼容性矩阵、示例代码(从 example / 源码提取)
24
+ 5. **ManualLink 取舍**:若当前分支版本表与 Link 表中 Autolink **全部为是/Yes**,删除 README 中 ManualLink `<details>` 整段;详见下文「ManualLink 章节」
25
+
26
+ ## ManualLink 章节(Autolink 全支持时删除)
27
+
28
+ 模板 `model-0.4.2.md` 含 ManualLink 作为**多版本混合**时的兜底;**单分支且该分支所有版本均支持 Autolink** 时:
29
+
30
+ - **删除** `<details>…ManualLink…</details>` 全部内容
31
+ - **删除**「可跳过 ManualLink 配置」一句(全版本已 Autolink 时无意义)
32
+ - **保留** Link 版本表、Autolinking 框架文档链接、`### 运行`
33
+
34
+ 判定数据源:版本关系表 `Autolink` 列 + `## Link` 小节表格;任一行 `否`/`No`/`partially` 则保留 ManualLink。
35
+
36
+ - overview 回写(usage-docs)
37
+
38
+ `model-0.4.2-overview.md` 为精简版:标题、基于上游说明、版本表、简介、下载安装。
39
+
40
+ - 中英文都 **覆盖** `zh-cn/<alias>.md` 与 `en/<alias>.md`
41
+ - 英文由中文 overview 翻译
42
+ - 版本表等事实与库内 README 保持一致
43
+
44
+ ## 链接与组织(必读)
45
+
46
+ ### 根因说明(避免 openharmony-sig 残留)
47
+
48
+ | 来源 | 问题 |
49
+ |------|------|
50
+ | **usage-docs 正文** | 大量文档仍含 `gitcode.com/openharmony-sig/...`,从 usage-docs 迁入库 README 时会**原样复制** |
51
+ | **库内 package.json** | `repository.url` 可能仍指向旧组织 |
52
+ | **模板 model-0.4.2.md** | 框架/本库链接已用 `CPF-RN`;但勿把 usage-docs 专用相对路径(如 `/zh-cn/link-source-code.md`)留到库 README |
53
+
54
+ 技能内置模板(`references/model-0.4.2.md`)的 **Releases / Issue / PR / Autolinking** 已使用 [CPF-RN](https://gitcode.com/CPF-RN) 组织;**不能**假设 usage-docs 与 package.json 已同步。
55
+
56
+ ### 组织与仓库解析顺序
57
+
58
+ 1. **本库 Gitcode 地址**:优先 `git remote get-url origin` 或 `package.json.repository.url`
59
+ 2. 若仍为 `openharmony-sig`,在 [CPF-RN 组织](https://gitcode.com/CPF-RN) 搜索 `rntpc_<alias>` 确认(如 [rntpc_react-native-audio](https://gitcode.com/CPF-RN/rntpc_react-native-audio))
60
+ 3. **框架 Autolinking 文档**:`https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md`(框架仓)
61
+ 4. **三方库接入指导**(如直接链接源码):在 [usage-docs](https://gitcode.com/CPF-RN/usage-docs) 仓,例如 `zh-cn/link-source-code.md` → `https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md`(**不在** `ohos_react_native`)
62
+ 5. **usage-docs 站内相对链接**(`/zh-cn/...`、`./link-source-code.md`):迁入库 README 时必须改为 usage-docs **绝对 URL**(见 [`link-registry.json`](link-registry.json))
63
+
64
+ ### Step 3.5 — 链接规范化(从 usage-docs 迁移后**必做**)
65
+
66
+ ```bash
67
+ node scripts/normalize-readme-links.js --lib-path "$LIB"
68
+ node scripts/normalize-readme-links.js --lib-path "$LIB" --write
69
+ ```
70
+
71
+ 脚本会:
72
+
73
+ - 将 `openharmony-sig` URL **仅在 CPF-RN 目标可达时**替换(见 `link-verify.js`;不可达则保留并报告)
74
+ - 将 `/zh-cn/link-source-code.md` 等 usage-docs 相对路径改为绝对链接,并对结果 URL **做 HTTP 可达性校验**
75
+ - 校验库内相对路径(仅允许 `./README.md` / `./README_EN.md` 等)
76
+ - 校验并同步修正 `package.json` 的 `repository.url` / `homepage` / `bugs.url`(验证通过才写回)
77
+
78
+ **退出码 2** 表示链接不可达、仓库根 URL 未验证、或仍有失效相对路径/旧组织残留。
79
+
80
+ ### 链接可达性(必做,禁止仅改组织名)
81
+
82
+ | 步骤 | 说明 |
83
+ |------|------|
84
+ | 解析仓库 | `resolveVerifiedLibRepoBase` 对多个候选 URL 执行 `curl -L`,选用首个 2xx/3xx |
85
+ | 组织迁移 | 每个 `openharmony-sig` 链接触发「替换后 URL 是否可达」探测,失败则不替换 |
86
+ | 改写后复检 | README / package 中所有 GitCode / usage-docs / npm 外链汇总校验 |
87
+ | 失败处理 | 报告 `linkVerification.failures`;Agent 需修正仓库名、分支或链接后重跑 |
88
+
89
+ ```bash
90
+ node scripts/normalize-readme-links.js --lib-path "$LIB" # 含可达性检查
91
+ node scripts/normalize-readme-links.js --lib-path "$LIB" --write # 仅当 ok=true
92
+ node scripts/normalize-package-meta.js --lib-path "$LIB" --write # 同样校验 homepage/issues/LICENSE
93
+ ```
94
+
95
+ 离线调试可加 `--skip-verify`;**提交交付前必须去掉**。
96
+
97
+ ### README 贡献 / 协议链接(CPF-RN 本库)
98
+
99
+ | 章节 | 中文 README | 英文 README |
100
+ |------|-------------|-------------|
101
+ | 贡献代码 / Contributing | Issue → `{libRepo}/issues`;PR → `{libRepo}/pulls` | 同左 |
102
+ | 开源协议 / License | `{libRepo}/blob/master/LICENSE` | 同左 |
103
+
104
+ `{libRepo}` = `https://gitcode.com/CPF-RN/rntpc_<alias>`(由 `normalize-readme-links.js` 解析)。
105
+
106
+ **禁止:**
107
+
108
+ - Issue/PR 仍指向 `openharmony-sig`
109
+ - LICENSE 仅指向上游 GitHub(如 `github.com/.../LICENSE`),而本库根目录已有 MIT LICENSE
110
+
111
+ ### Step 5 — package.json 与 oh-package.json5
112
+
113
+ 见 [rn-lib-update-doc SKILL Step 5](../SKILL.md#step-5--规范-packagejson-与-harmony-oh-packagejson5必做)。
114
+
115
+ ```bash
116
+ node scripts/normalize-package-meta.js --lib-path "$LIB" --write
117
+ ```
118
+
119
+ ### Step 6 — CHANGELOG
120
+
121
+ 见 [changelog-template.md](changelog-template.md) 与 `normalize-changelog.js`。
122
+
123
+ ## 英文标题对照(常用)
124
+
125
+ | 中文 | English |
126
+ |------|---------|
127
+ | 简介 | Introduction |
128
+ | 下载安装 | Installation |
129
+ | 约束与限制 | Constraints and Limitations |
130
+ | 使用示例 | Usage Example |
131
+ | 使用说明 | Usage Guide |
132
+ | 接口说明 | API Reference |
133
+ | 遗留问题 | Known Issues |
134
+ | 其他 | Others |
135
+ | 目录结构 | Directory Structure |
136
+ | 贡献代码 | Contributing |
137
+ | 开源协议 | License |
@@ -1,33 +1,33 @@
1
- {
2
- "orgHome": "https://gitcode.com/CPF-RN",
3
- "defaultLibOrg": "CPF-RN",
4
- "deprecatedOrgPatterns": [
5
- "gitcode.com/openharmony-sig/",
6
- "gitcode.com/OpenHarmony-sig/",
7
- "gitee.com/openharmony-sig/"
8
- ],
9
- "frameworkDocs": {
10
- "autolinkingZh": "https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md"
11
- },
12
- "usageDocs": {
13
- "base": "https://gitcode.com/CPF-RN/usage-docs",
14
- "branch": "master",
15
- "linkSourceCodeZh": "https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md",
16
- "linkSourceCodeEn": "https://gitcode.com/CPF-RN/usage-docs/blob/master/en/link-source-code.md"
17
- },
18
- "libRepoNamePattern": "rntpc_{alias}",
19
- "allowedRelativeTargetsInLibReadme": [
20
- "./README.md",
21
- "./README_EN.md",
22
- "README.md",
23
- "README_EN.md"
24
- ],
25
- "linkVerify": {
26
- "method": "curl",
27
- "followRedirects": true,
28
- "timeoutSec": 15,
29
- "acceptStatusMin": 200,
30
- "acceptStatusMax": 399,
31
- "note": "Org migration must pass HTTP check before replacing URLs"
32
- }
33
- }
1
+ {
2
+ "orgHome": "https://gitcode.com/CPF-RN",
3
+ "defaultLibOrg": "CPF-RN",
4
+ "deprecatedOrgPatterns": [
5
+ "gitcode.com/openharmony-sig/",
6
+ "gitcode.com/OpenHarmony-sig/",
7
+ "gitee.com/openharmony-sig/"
8
+ ],
9
+ "frameworkDocs": {
10
+ "autolinkingZh": "https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md"
11
+ },
12
+ "usageDocs": {
13
+ "base": "https://gitcode.com/CPF-RN/usage-docs",
14
+ "branch": "master",
15
+ "linkSourceCodeZh": "https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md",
16
+ "linkSourceCodeEn": "https://gitcode.com/CPF-RN/usage-docs/blob/master/en/link-source-code.md"
17
+ },
18
+ "libRepoNamePattern": "rntpc_{alias}",
19
+ "allowedRelativeTargetsInLibReadme": [
20
+ "./README.md",
21
+ "./README_EN.md",
22
+ "README.md",
23
+ "README_EN.md"
24
+ ],
25
+ "linkVerify": {
26
+ "method": "curl",
27
+ "followRedirects": true,
28
+ "timeoutSec": 15,
29
+ "acceptStatusMin": 200,
30
+ "acceptStatusMax": 399,
31
+ "note": "Org migration must pass HTTP check before replacing URLs"
32
+ }
33
+ }
@@ -1,40 +1,40 @@
1
- > 文档模板:v0.4.2
2
-
3
- <p align="center">
4
- <h1 align="center"> <code>lottie-react-native</code> </h1>
5
- </p>
6
-
7
- 本项目基于 [lottie-react-native](https://github.com/lottie-react-native/lottie-react-native) 开发。
8
-
9
- 该第三方库的仓库已迁移至 Gitcode,且支持直接从 npm 下载,新的包名为:`@react-native-ohos/lottie-react-native` 版本所属关系如下:
10
-
11
- | 三方库名称 | 三方库版本(npm地址) | 发布信息 | 支持RN版本 | Autolink | 编译API版本 | 社区基线版本 | 源码地址 |
12
- | ------------ | ------------ | ------------------------------ | ------------- | ------------- |------------------------ | ------------- | ------------- |
13
- | @react-native-ohos/lottie-react-native | [~ 7.3.0](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.82.* | 否 | API12+ | 7.3.4 | [br_rnoh0.82](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.82) |
14
- | @react-native-ohos/lottie-react-native | [~ 7.2.3](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.77.* | 否 | API12+ | 7.3.4 | [br_rnoh0.77](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.77) |
15
- | @react-native-ohos/lottie-react-native | [~ 6.4.2](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [br_rnoh0.72](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.72) |
16
- | @react-native-oh-tpl/lottie-react-native | [<= 6.4.1-0.1.17@deprecated](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [sig](https://github.com/react-native-oh-library/lottie-react-native) |
17
-
18
- ## 简介
19
-
20
- Lottie 组件用于 React Native。<br/>
21
- Lottie 是一个库生态系统,用于解析 Adobe After Effects 动画导出为 JSON 并带 bodymovin 原生渲染的动画!<br/>
22
- 设计师首次可以在无需工程师手工繁琐重现的情况下,创造并交付精美的动画。
23
-
24
- ## 下载安装
25
-
26
- 进入到工程目录并输入以下命令:
27
-
28
- **npm**
29
-
30
- ```bash
31
- npm install @react-native-ohos/lottie-react-native
32
- ```
33
-
34
- **yarn**
35
-
36
- ```bash
37
- yarn add @react-native-ohos/lottie-react-native
38
- ```
39
-
40
-
1
+ > 文档模板:v0.4.2
2
+
3
+ <p align="center">
4
+ <h1 align="center"> <code>lottie-react-native</code> </h1>
5
+ </p>
6
+
7
+ 本项目基于 [lottie-react-native](https://github.com/lottie-react-native/lottie-react-native) 开发。
8
+
9
+ 该第三方库的仓库已迁移至 Gitcode,且支持直接从 npm 下载,新的包名为:`@react-native-ohos/lottie-react-native` 版本所属关系如下:
10
+
11
+ | 三方库名称 | 三方库版本(npm地址) | 发布信息 | 支持RN版本 | Autolink | 编译API版本 | 社区基线版本 | 源码地址 |
12
+ | ------------ | ------------ | ------------------------------ | ------------- | ------------- |------------------------ | ------------- | ------------- |
13
+ | @react-native-ohos/lottie-react-native | [~ 7.3.0](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.82.* | 否 | API12+ | 7.3.4 | [br_rnoh0.82](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.82) |
14
+ | @react-native-ohos/lottie-react-native | [~ 7.2.3](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.77.* | 否 | API12+ | 7.3.4 | [br_rnoh0.77](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.77) |
15
+ | @react-native-ohos/lottie-react-native | [~ 6.4.2](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [br_rnoh0.72](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.72) |
16
+ | @react-native-oh-tpl/lottie-react-native | [<= 6.4.1-0.1.17@deprecated](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [sig](https://github.com/react-native-oh-library/lottie-react-native) |
17
+
18
+ ## 简介
19
+
20
+ Lottie 组件用于 React Native。<br/>
21
+ Lottie 是一个库生态系统,用于解析 Adobe After Effects 动画导出为 JSON 并带 bodymovin 原生渲染的动画!<br/>
22
+ 设计师首次可以在无需工程师手工繁琐重现的情况下,创造并交付精美的动画。
23
+
24
+ ## 下载安装
25
+
26
+ 进入到工程目录并输入以下命令:
27
+
28
+ **npm**
29
+
30
+ ```bash
31
+ npm install @react-native-ohos/lottie-react-native
32
+ ```
33
+
34
+ **yarn**
35
+
36
+ ```bash
37
+ yarn add @react-native-ohos/lottie-react-native
38
+ ```
39
+
40
+