@furongjun1999/dsh-memory 0.9.14 → 0.9.16

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 (1281) hide show
  1. package/CHANGELOG.md +109 -0
  2. package/LICENSE +21 -21
  3. package/README.md +31 -2
  4. package/codebuddy/mcp.json +27 -27
  5. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -45
  6. package/dsh/dsh-web-start.bat +17 -17
  7. package/dsh/hive-mcp-probe.mjs +94 -94
  8. package/dsh/update-lingshu.bat +11 -11
  9. package/dsh/update-lingshu.ps1 +337 -337
  10. package/hive/README.md +705 -705
  11. package/hive/id_charset_blocks.txt +147 -147
  12. package/lib/client.js +18 -0
  13. package/lib/hooks.js +29 -12
  14. package/lib/index.js +3 -44
  15. package/lib/lib/console_web.mjs +104 -0
  16. package/lib/lib/hook_audit.d.ts +15 -0
  17. package/lib/lib/hook_audit.js +28 -0
  18. package/lib/tools.d.ts +2 -2
  19. package/md_cg/__init__.py +7 -7
  20. package/md_cg/auditview.py +248 -248
  21. package/md_cg/backfill.py +1328 -1328
  22. package/md_cg/backfill_bigdomain.py +34 -34
  23. package/md_cg/backfill_bucket_zh.py +35 -35
  24. package/md_cg/bench6_arms.py +414 -414
  25. package/md_cg/bench6_common.py +230 -230
  26. package/md_cg/bench6_competitors.py +212 -212
  27. package/md_cg/bench_axis_domain.py +257 -257
  28. package/md_cg/bench_blind_comp.py +308 -308
  29. package/md_cg/bench_e2e_judge.py +534 -534
  30. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  31. package/md_cg/bench_e2e_qa.py +256 -256
  32. package/md_cg/bench_en_atoms_public.py +230 -230
  33. package/md_cg/bench_governance.py +351 -351
  34. package/md_cg/bench_lme_zh.py +410 -410
  35. package/md_cg/bench_locomo.py +121 -121
  36. package/md_cg/bench_locomo_zh.py +460 -460
  37. package/md_cg/bench_locomo_zh_public.py +147 -147
  38. package/md_cg/bench_longmem.py +112 -112
  39. package/md_cg/bench_membench.py +632 -632
  40. package/md_cg/bench_p0.py +149 -149
  41. package/md_cg/bench_progressive.py +287 -287
  42. package/md_cg/bench_role_views.py +238 -238
  43. package/md_cg/bench_task_ab.py +243 -243
  44. package/md_cg/bench_task_ab_llm.py +408 -408
  45. package/md_cg/bench_unified_en.py +204 -204
  46. package/md_cg/bench_zh_mad.py +611 -611
  47. package/md_cg/blindspot_tickets.py +123 -123
  48. package/md_cg/census.py +133 -133
  49. package/md_cg/codeindex.py +531 -531
  50. package/md_cg/comment_gate.py +337 -337
  51. package/md_cg/cond_compose.py +190 -190
  52. package/md_cg/cond_facts.py +154 -154
  53. package/md_cg/cond_template.json +106 -106
  54. package/md_cg/condition_anchor.py +142 -142
  55. package/md_cg/config_registry.py +28 -0
  56. package/md_cg/config_registry_bulk.py +4 -0
  57. package/md_cg/corpus.py +110 -110
  58. package/md_cg/crosscheck.py +1098 -1098
  59. package/md_cg/d_meta.py +310 -310
  60. package/md_cg/docindex.py +496 -488
  61. package/md_cg/evolution.py +493 -493
  62. package/md_cg/freshness.py +21 -1
  63. package/md_cg/generation.py +409 -409
  64. package/md_cg/ghostref.py +130 -130
  65. package/md_cg/hotcache.py +5 -1
  66. package/md_cg/lexicon/RULES.md +32 -32
  67. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  68. package/md_cg/lexicon/build_standard_en.py +171 -171
  69. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  70. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  71. package/md_cg/lexicon/expand_en_zh.py +211 -211
  72. package/md_cg/lexicon/standard_en.json +1262 -1262
  73. package/md_cg/linkref.py +280 -280
  74. package/md_cg/mcp_server.py +9 -2
  75. package/md_cg/md_whitebox.py +345 -345
  76. package/md_cg/mdcg.py +206 -15
  77. package/md_cg/mdcos.py +124 -5
  78. package/md_cg/migrate.py +119 -119
  79. package/md_cg/migrate_aeis.py +221 -221
  80. package/md_cg/migrate_roleplay.py +293 -293
  81. package/md_cg/migrate_wisdom_graph.py +360 -360
  82. package/md_cg/mreview/__init__.py +25 -25
  83. package/md_cg/mreview/__main__.py +110 -110
  84. package/md_cg/mreview/bundle.py +178 -178
  85. package/md_cg/mreview/candidates.py +262 -262
  86. package/md_cg/mreview/govern.py +694 -694
  87. package/md_cg/mreview/locate.py +939 -939
  88. package/md_cg/mreview/pipeline.py +742 -742
  89. package/md_cg/mreview/rules/duplication.json +21 -21
  90. package/md_cg/mreview/rules/field_coverage.json +54 -54
  91. package/md_cg/mreview/rules/source_license.json +21 -21
  92. package/md_cg/mreview/rules/template_flow.json +21 -21
  93. package/md_cg/mreview/ruleset.py +252 -252
  94. package/md_cg/op_table.py +3 -2
  95. package/md_cg/progressive.py +123 -123
  96. package/md_cg/protect.py +29 -6
  97. package/md_cg/protocol/md_cg_gate.proto +33 -33
  98. package/md_cg/qmd_llm.py +334 -334
  99. package/md_cg/roleviews.py +89 -89
  100. package/md_cg/security.py +68 -5
  101. package/md_cg/selfreport.py +161 -161
  102. package/md_cg/semantic/REPRODUCE.md +170 -170
  103. package/md_cg/semantic/SCHEMA.md +33 -33
  104. package/md_cg/semantic/__init__.py +10 -10
  105. package/md_cg/semantic/atoms.json +7348 -7348
  106. package/md_cg/semantic/en_normalizer.py +364 -364
  107. package/md_cg/semantic/search_index.json +6199 -6199
  108. package/md_cg/session5.py +106 -106
  109. package/md_cg/srcindex.py +352 -352
  110. package/md_cg/statushdr.py +179 -179
  111. package/md_cg/tasks.py +26 -0
  112. package/md_cg/test_access_hints.py +147 -147
  113. package/md_cg/test_audit_rotate.py +270 -270
  114. package/md_cg/test_auditview.py +277 -277
  115. package/md_cg/test_autonomy.py +143 -143
  116. package/md_cg/test_autonomy_admission.py +1098 -1098
  117. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  118. package/md_cg/test_b1_foreign_read.py +244 -244
  119. package/md_cg/test_b1b2_write_face.py +424 -424
  120. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  121. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  122. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  123. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  124. package/md_cg/test_bench_governance.py +102 -102
  125. package/md_cg/test_blindspot_tickets.py +166 -166
  126. package/md_cg/test_boundary_hit.py +410 -410
  127. package/md_cg/test_branch_discard_tombstone.py +136 -136
  128. package/md_cg/test_ccg_perturb.py +184 -184
  129. package/md_cg/test_ccgc.py +458 -458
  130. package/md_cg/test_census_prune.py +81 -81
  131. package/md_cg/test_chain_read_isolate.py +168 -168
  132. package/md_cg/test_codeindex.py +338 -338
  133. package/md_cg/test_coldverify_drain.py +127 -127
  134. package/md_cg/test_comment_gate.py +187 -187
  135. package/md_cg/test_cond_compose_anchors.py +76 -76
  136. package/md_cg/test_cond_match.py +165 -165
  137. package/md_cg/test_condition_anchor.py +81 -81
  138. package/md_cg/test_config_registry.py +55 -55
  139. package/md_cg/test_config_registry_silent_fallback.py +90 -0
  140. package/md_cg/test_cons200_scan_selection.py +793 -793
  141. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  142. package/md_cg/test_crypto_rotate.py +256 -256
  143. package/md_cg/test_csre_index_import_guard.py +161 -161
  144. package/md_cg/test_curiosity_budget.py +468 -468
  145. package/md_cg/test_d17_autostart_toolface.py +453 -453
  146. package/md_cg/test_d_meta.py +412 -412
  147. package/md_cg/test_datapath_root.py +199 -199
  148. package/md_cg/test_designer_token_coverage.py +184 -0
  149. package/md_cg/test_emit_negtail_cache.py +156 -156
  150. package/md_cg/test_export_default_collision.py +138 -138
  151. package/md_cg/test_gain_gate.py +223 -223
  152. package/md_cg/test_generation_guard.py +361 -361
  153. package/md_cg/test_ghostref.py +182 -182
  154. package/md_cg/test_goal_gen.py +355 -355
  155. package/md_cg/test_govern_directread.py +434 -434
  156. package/md_cg/test_health_scale.py +173 -173
  157. package/md_cg/test_heartbeat_ledger.py +563 -563
  158. package/md_cg/test_hive_ingest.py +285 -285
  159. package/md_cg/test_hot_cold.py +215 -215
  160. package/md_cg/test_hyperedge.py +245 -245
  161. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  162. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  163. package/md_cg/test_i50d_importance_source.py +531 -531
  164. package/md_cg/test_i50e_readside_protection.py +9 -3
  165. package/md_cg/test_identity_contract.py +329 -329
  166. package/md_cg/test_index_crossprocess_reload.py +316 -316
  167. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  168. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  169. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  170. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  171. package/md_cg/test_issue659_r26_batch3.py +38 -0
  172. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  173. package/md_cg/test_issue672_optional_assets.py +49 -0
  174. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  175. package/md_cg/test_issue677_async_index_flush.py +216 -0
  176. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  177. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  178. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  179. package/md_cg/test_issue69_audit_boundary.py +129 -129
  180. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  181. package/md_cg/test_issue78_export_concurrency.py +334 -334
  182. package/md_cg/test_issue80_residual_flush.py +169 -169
  183. package/md_cg/test_issue84_portability.py +95 -95
  184. package/md_cg/test_issue85_export_overwrite.py +113 -113
  185. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  186. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  187. package/md_cg/test_issue88_conclusion_face.py +280 -280
  188. package/md_cg/test_issue89_zero_score.py +169 -169
  189. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  190. package/md_cg/test_issue96_key_fallback.py +102 -102
  191. package/md_cg/test_issue98_tenant_root.py +104 -104
  192. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  193. package/md_cg/test_lifecycle.py +309 -309
  194. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  195. package/md_cg/test_linkref.py +320 -320
  196. package/md_cg/test_links_concurrent_write.py +188 -188
  197. package/md_cg/test_lock.py +52 -52
  198. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  199. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  200. package/md_cg/test_md_writepath.py +345 -345
  201. package/md_cg/test_merge_upsert.py +168 -168
  202. package/md_cg/test_mode_parity.py +23 -0
  203. package/md_cg/test_mr_m2.py +615 -599
  204. package/md_cg/test_mr_m3.py +710 -710
  205. package/md_cg/test_mr_m4.py +485 -485
  206. package/md_cg/test_n131_merge_gate.py +205 -205
  207. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  208. package/md_cg/test_n176_link_trust.py +221 -221
  209. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  210. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  211. package/md_cg/test_n195_writepath_reload.py +283 -283
  212. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  213. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  214. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  215. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  216. package/md_cg/test_n201_proposal_visibility.py +382 -382
  217. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  218. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  219. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  220. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  221. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  222. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  223. package/md_cg/test_n230_dirty_replay.py +18 -5
  224. package/md_cg/test_n238_body_text_parity.py +156 -156
  225. package/md_cg/test_n276_probe_hoist.py +199 -199
  226. package/md_cg/test_neg_condition_hits.py +333 -333
  227. package/md_cg/test_neg_coverage_budget.py +500 -500
  228. package/md_cg/test_none_id_write_guard.py +166 -166
  229. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  230. package/md_cg/test_p0.py +264 -264
  231. package/md_cg/test_p1.py +316 -316
  232. package/md_cg/test_p10_identity.py +173 -173
  233. package/md_cg/test_p11_consistency.py +382 -382
  234. package/md_cg/test_p12_metacognition.py +212 -212
  235. package/md_cg/test_p13_encryption.py +241 -241
  236. package/md_cg/test_p14_root_fallback.py +373 -373
  237. package/md_cg/test_p14_sustain.py +249 -249
  238. package/md_cg/test_p15_scrub.py +280 -280
  239. package/md_cg/test_p16_self_state.py +301 -301
  240. package/md_cg/test_p17_predict.py +354 -354
  241. package/md_cg/test_p18_whitebox.py +171 -171
  242. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  243. package/md_cg/test_p1x_ref_root.py +197 -197
  244. package/md_cg/test_p2.py +216 -216
  245. package/md_cg/test_p20_evolution.py +315 -315
  246. package/md_cg/test_p22_theory.py +175 -175
  247. package/md_cg/test_p23_links.py +311 -311
  248. package/md_cg/test_p25_weights.py +156 -156
  249. package/md_cg/test_p26_refindex.py +433 -433
  250. package/md_cg/test_p29_session_ingest_export.py +360 -360
  251. package/md_cg/test_p30_maintain.py +361 -361
  252. package/md_cg/test_p31_insight.py +535 -535
  253. package/md_cg/test_p34_crosscheck.py +331 -331
  254. package/md_cg/test_p35_conditioned_claim.py +252 -252
  255. package/md_cg/test_p36_kp_align.py +230 -230
  256. package/md_cg/test_p37_condition_space.py +248 -248
  257. package/md_cg/test_p38_contextualize.py +273 -273
  258. package/md_cg/test_p39_vision_evidence.py +369 -369
  259. package/md_cg/test_p41_evolve_patrol.py +224 -224
  260. package/md_cg/test_p42_provenance.py +269 -269
  261. package/md_cg/test_p44_md_whitebox.py +231 -231
  262. package/md_cg/test_p45_session_identity.py +466 -466
  263. package/md_cg/test_p46_unit_scope.py +272 -272
  264. package/md_cg/test_p4_fuzzy.py +223 -223
  265. package/md_cg/test_p5_semantic.py +226 -226
  266. package/md_cg/test_p6_consolidate.py +822 -822
  267. package/md_cg/test_p7_goals_recent.py +202 -202
  268. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  269. package/md_cg/test_p8_subgraph_chain.py +213 -213
  270. package/md_cg/test_p9_forget_protect.py +238 -238
  271. package/md_cg/test_preflight_failclosed.py +100 -100
  272. package/md_cg/test_progressive.py +146 -146
  273. package/md_cg/test_propose_tail_index.py +157 -157
  274. package/md_cg/test_protect_stats_parity.py +141 -0
  275. package/md_cg/test_protocol.py +272 -272
  276. package/md_cg/test_rank_parity_score_mode.py +522 -522
  277. package/md_cg/test_reach_keys.py +201 -201
  278. package/md_cg/test_read_clip.py +141 -141
  279. package/md_cg/test_read_face_input_gates.py +363 -363
  280. package/md_cg/test_read_face_semantics.py +492 -492
  281. package/md_cg/test_read_scope_b27.py +277 -277
  282. package/md_cg/test_readcache_default_on.py +168 -168
  283. package/md_cg/test_readcache_precise_inval.py +270 -270
  284. package/md_cg/test_recall_metadata.py +422 -422
  285. package/md_cg/test_reconcile_v0.py +294 -294
  286. package/md_cg/test_retr_s1.py +344 -344
  287. package/md_cg/test_retr_s1b.py +276 -276
  288. package/md_cg/test_retr_s3.py +194 -194
  289. package/md_cg/test_retr_s4.py +163 -163
  290. package/md_cg/test_retr_s6.py +157 -157
  291. package/md_cg/test_retr_s7.py +392 -392
  292. package/md_cg/test_retr_s8_time.py +369 -369
  293. package/md_cg/test_retr_s9_edges.py +286 -286
  294. package/md_cg/test_retr_score_once.py +220 -220
  295. package/md_cg/test_review_cli_attribution.py +181 -181
  296. package/md_cg/test_review_cli_visibility.py +235 -235
  297. package/md_cg/test_review_conformance.py +385 -385
  298. package/md_cg/test_review_dual_check.py +97 -0
  299. package/md_cg/test_review_onepass.py +170 -170
  300. package/md_cg/test_review_queue_batch.py +123 -123
  301. package/md_cg/test_review_queue_index.py +130 -130
  302. package/md_cg/test_role_views.py +354 -354
  303. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  304. package/md_cg/test_security_audit_v21.py +249 -249
  305. package/md_cg/test_sem_noise.py +242 -242
  306. package/md_cg/test_server_version.py +67 -67
  307. package/md_cg/test_session5_identity.py +93 -93
  308. package/md_cg/test_session_attribution_consistency.py +813 -813
  309. package/md_cg/test_session_identity_tristate.py +486 -486
  310. package/md_cg/test_session_isolation.py +168 -168
  311. package/md_cg/test_sleep.py +668 -668
  312. package/md_cg/test_sleep_gitlock.py +134 -134
  313. package/md_cg/test_snapshot_autoclose.py +187 -187
  314. package/md_cg/test_spatial_coords3d.py +292 -292
  315. package/md_cg/test_srcindex.py +171 -171
  316. package/md_cg/test_state_events.py +178 -178
  317. package/md_cg/test_state_slots.py +691 -691
  318. package/md_cg/test_subproc_encoding.py +192 -192
  319. package/md_cg/test_sustain_mutual.py +153 -153
  320. package/md_cg/test_tail_watermark_race.py +208 -208
  321. package/md_cg/test_tasks.py +409 -409
  322. package/md_cg/test_tenant_env_override_warn.py +152 -152
  323. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  324. package/md_cg/test_time_core_lint.py +9 -0
  325. package/md_cg/test_token_lowercase_form.py +315 -315
  326. package/md_cg/test_transfer.py +180 -180
  327. package/md_cg/test_trust.py +361 -361
  328. package/md_cg/test_twophase.py +286 -286
  329. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  330. package/md_cg/test_unify_default_off.py +701 -701
  331. package/md_cg/test_unify_scope.py +182 -182
  332. package/md_cg/test_units_poll.py +71 -71
  333. package/md_cg/test_v21r1_package_version.py +310 -310
  334. package/md_cg/test_validity_filter.py +280 -280
  335. package/md_cg/test_verify_answer.py +138 -138
  336. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  337. package/md_cg/test_w5_path_fingerprint.py +381 -381
  338. package/md_cg/test_wisdom_md_store.py +292 -292
  339. package/md_cg/test_writegate_tiers.py +111 -0
  340. package/md_cg/test_writelimit.py +224 -224
  341. package/md_cg/test_writepipe.py +4 -2
  342. package/md_cg/tokens.py +114 -8
  343. package/md_cg/units.py +869 -869
  344. package/md_cg/version_anchor.py +160 -160
  345. package/md_cg/vision_evidence.py +667 -667
  346. package/md_cg/whitebox_kb/__init__.py +37 -37
  347. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  348. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  349. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  350. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  351. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  352. package/md_cg/whitebox_kb/engine.py +310 -310
  353. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  354. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  355. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/345/217/244/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  356. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/347/216/260/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  357. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/345/267/245/346/231/272/350/203/275/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  358. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/347/261/273/350/247/202/345/257/237/350/200/205/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +161 -161
  359. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/274/232/350/256/241/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  360. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/277/241/346/201/257/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +90 -90
  361. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/345/255/220/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  362. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/346/236/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  363. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  364. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  365. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  366. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  367. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +317 -317
  368. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +261 -261
  369. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  370. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  371. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  372. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/212/250/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  373. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1194 -1194
  374. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/267/245/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  375. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  376. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/206/345/217/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +278 -278
  377. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/237/345/255/220/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  378. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/217/244/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  379. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/223/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  380. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/233/272/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  381. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/237/346/234/250/345/267/245/347/250/213/345/237/272/347/241/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  382. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/260/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +154 -154
  383. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/215/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  384. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/226/345/233/275/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  385. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  386. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/346/200/235/346/224/277/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  387. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +201 -201
  388. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  389. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  390. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +131 -131
  391. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/217/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  392. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/236/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  393. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +333 -333
  394. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1124 -1124
  395. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  396. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  397. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  398. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/210/266/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  399. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +362 -362
  400. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/202/345/234/272/350/220/245/351/224/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +81 -81
  401. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/270/345/276/256/345/210/206/346/226/271/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +153 -153
  402. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/345/210/206/345/207/240/344/275/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  403. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  404. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  405. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/277/203/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +119 -119
  406. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/203/205/346/204/237/346/203/205/347/273/252/344/273/277/347/234/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +186 -186
  407. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/212/275/350/261/241/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  408. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/213/223/346/211/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  409. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/223/215/344/275/234/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  410. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/224/277/346/262/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +234 -234
  411. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/200/274/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  412. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/227/347/224/265/350/267/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  413. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1166 -1166
  414. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +217 -217
  415. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/347/211/251/347/220/206/346/226/271/346/263/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  416. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/345/272/223/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  417. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/347/273/223/346/236/204/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  418. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/226/207/345/255/246/347/220/206/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  419. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/240/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +141 -141
  420. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/266/347/251/272/350/256/260/345/277/206/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +214 -214
  421. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/231/272/350/203/275/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  422. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/234/211/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  423. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/220/346/226/231/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  424. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/241/344/273/266/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  425. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/244/215/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  426. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/246/202/347/216/207/350/256/272/344/270/216/346/225/260/347/220/206/347/273/237/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +149 -149
  427. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/250/241/346/213/237/347/224/265/345/255/220/346/212/200/346/234/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  428. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/263/233/345/207/275/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  429. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/203/255/345/212/233/345/255/246/344/270/216/347/273/237/350/256/241/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  430. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  431. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1302 -1302
  432. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/216/260/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  433. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/220/206/350/256/272/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  434. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/346/200/201/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  435. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  436. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1018 -1018
  437. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  438. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/345/212/250/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  439. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/350/267/257/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  440. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/244/276/344/274/232/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  441. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/250/213/345/272/217/350/256/276/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  442. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/227/346/263/225/350/256/276/350/256/241/344/270/216/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  443. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/241/347/220/206/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  444. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/272/277/346/200/247/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  445. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/206/350/203/236/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  446. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  447. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/223/346/236/204/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  448. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/274/345/220/210/302/267/347/273/264/345/237/272/347/273/274/350/277/260.md +184 -184
  449. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/274/226/350/257/221/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  450. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/207/252/346/210/221/346/204/217/350/257/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +270 -270
  451. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +698 -698
  452. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/273/204/346/210/220/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  453. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/275/221/347/273/234/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  454. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/257/255/350/250/200/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +226 -226
  455. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/275/257/344/273/266/345/267/245/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  456. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/201/227/344/274/240/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  457. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/217/345/255/220/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  458. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/221/350/236/215/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  459. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  460. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  461. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  462. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/200/235/346/203/263/346/224/277/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  463. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  464. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +365 -365
  465. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +269 -269
  466. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  467. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  468. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/345/210/206/345/255/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  469. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +157 -157
  470. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +237 -237
  471. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  472. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  473. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  474. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  475. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  476. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  477. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  478. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  479. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  480. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  481. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  482. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  483. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  484. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  485. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  486. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  487. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  488. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  489. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  490. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  491. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  492. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  493. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  494. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  495. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  496. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  497. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  498. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  499. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  500. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  501. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  502. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  503. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  504. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  505. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/346/235/241/344/273/266/350/267/257/347/224/261/345/233/276_CCG/350/256/276/350/256/241.md +150 -150
  506. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/350/257/255/344/271/211/346/235/241/344/273/266/345/215/217/350/256/256.md +650 -650
  507. package/md_cg/whitebox_kb/wisdom/docs//345/261/200/351/203/250/346/234/200/344/274/230/344/270/216/346/203/205/347/273/252/345/201/217/345/245/275_/347/220/206/350/256/272/345/267/245/347/250/213.md +97 -97
  508. package/md_cg/whitebox_kb/wisdom/docs//346/226/271/345/220/221/346/200/247/346/212/211/346/213/251_/350/207/252/344/270/276vs/350/207/252/350/277/255/344/273/243.md +81 -81
  509. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242AGI/346/236/266/346/236/204/346/216/242/347/264/242_/346/226/207/346/241/243/350/247/204/345/210/222.md +51 -51
  510. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242/346/217/222/344/273/266/345/210/206/347/261/273/345/210/206/346/236/220.md +67 -67
  511. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/346/234/254/345/234/260/346/240/241/351/252/214/345/231/250_ZeroLLM_Verifier.md +276 -276
  512. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/350/207/252/344/270/276/347/254/254/345/205/255/351/230/266/346/256/265_/346/224/266/345/256/230/346/200/273/347/273/223.md +1207 -1207
  513. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  514. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  515. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  516. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  517. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  518. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  519. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  520. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  521. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  522. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  523. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  524. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  525. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  526. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  527. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  528. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  529. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  530. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  531. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  532. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  533. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  534. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  535. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  536. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  537. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  538. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  539. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  540. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  541. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  542. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  543. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  544. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  545. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  546. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  547. package/md_cg/writegate.py +146 -0
  548. package/md_cg/writepipe.py +85 -7
  549. package/package.json +20 -6
  550. package/scripts/workspace_index.py +1 -0
  551. package/skills/README.md +121 -121
  552. package/skills/plugin.json +54 -54
  553. package/skills/skills/designer-perspective/SKILL.md +158 -158
  554. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  555. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  556. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  557. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  558. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  559. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  560. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  561. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  562. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  563. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  564. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  565. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  566. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  567. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  568. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  569. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  570. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  571. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  572. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  573. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  574. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  663. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  664. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  665. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  666. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  667. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  668. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  669. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  670. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  671. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  672. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  673. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  674. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  675. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  676. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  677. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  679. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  780. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  781. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  782. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  783. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  784. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  785. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  786. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  787. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  788. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  789. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  790. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  791. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  792. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  793. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  794. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  796. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  898. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  899. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  900. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  901. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  902. package/skills/skills/lingshu-net/SKILL.md +48 -48
  903. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  904. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  905. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  906. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  907. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  908. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  909. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  910. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  911. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  912. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  914. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1017. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1021. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1032. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1130. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1134. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1145. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1250. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1251. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1252. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1253. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1254. package/src/hooks.ts +26 -12
  1255. package/src/index.ts +3 -0
  1256. package/src/lib/console_web.mjs +104 -0
  1257. package/src/lib/hook_audit.ts +34 -1
  1258. package/src/lib/python_path.ts +71 -71
  1259. package/src/lib/session_state.ts +127 -127
  1260. package/src/lib/whitebox_llm.ts +311 -311
  1261. package/ui/minimal/LICENSE +21 -0
  1262. package/ui/minimal/install.ps1 +168 -0
  1263. package/ui/minimal/integrity.json +41 -0
  1264. package/ui/minimal/payload/build-ui.mjs +16 -0
  1265. package/ui/minimal/payload/lib/client.js +18 -0
  1266. package/ui/minimal/payload/lib/lib/console_web.mjs +104 -0
  1267. package/ui/minimal/payload/src/lib/console_web.mjs +104 -0
  1268. package/ui/minimal/payload/web/app.js +154 -0
  1269. package/ui/minimal/payload/web/client.js +14 -0
  1270. package/ui/minimal/payload/web/entry.js +1 -0
  1271. package/ui/minimal/payload/web/index.html +3 -0
  1272. package/ui/minimal/payload/web/style.css +3 -0
  1273. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1274. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1275. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1276. package/utf8_boot.py +237 -237
  1277. package/web/app.js +154 -0
  1278. package/web/client.js +14 -0
  1279. package/web/entry.js +1 -0
  1280. package/web/index.html +3 -0
  1281. package/web/style.css +3 -0
@@ -1,939 +1,939 @@
1
- # -*- coding: utf-8 -*-
2
- """记忆评审流水线 · M3 定位模块(D1 字段级定位,确定性、零写入)。
3
-
4
- 真源:docs/记忆评审系统_立项设计与施工交接_20260915.md §5 D1。
5
-
6
- D1 契约:
7
-
8
- locate(node_id, issue_hint) -> [{"field", "span", "issue_kind", "evidence"}, ...]
9
-
10
- * **field** —— frontmatter 字段名,或 `"content"`(正文)
11
- * **span** —— 命中处的字符区间 `[start, end)`(半开),**相对正文 content**;
12
- 纯字段级缺失无字符区间可指 → `None`
13
- * **issue_kind** —— dup / missing_field / stale / contradiction / weak_source / template_flow
14
- (`ISSUE_KINDS`=问题面);另有 `ADVISORY_KINDS`(观测面,可显式定位
15
- 但**不进默认全量、不进评审告警面**,见下「stale 与 observation_aged」)
16
- * **evidence** —— 白箱判据:为什么算问题(人可复核、机器可断言)
17
-
18
- 定位的职责边界:M2 的意见说「这一条有问题」,D1 回答「问题在这一条的哪个字段/哪一段」。
19
- 故本模块只做**确定性可判定**的事——语义级矛盾(正文自相矛盾)**不猜**,如实返回
20
- BLINDSPOT 项交回 LLM 意见层(`status="blindspot"`,见 `locate()` 返回值)。
21
-
22
- 口径全部引用既有唯一真源,**不在本模块另立一份**(防「术语双写法」漂移):
23
-
24
- =============== ==================================================================
25
- 字段/正文结构 ``nodefile``(CCG_MARKS / CONDITION_SLOTS / VERIFICATION_BASIS /
26
- loads / content_hash / is_placeholder_text / time_window_text)
27
- 模板骨架 ``writelimit._skeleton`` / ``MIN_SKELETON``
28
- 赛道×基底相容 ``crosscheck``(与 M1 `ruleset._chk_basis_licensed` 同源)
29
- 字段层门限 ``ruleset``(即 `rules/*.json` 的 `matcher.layer`,见
30
- `field_layer_scope`——**派生**,不在此另立一份)
31
- 索引快照 ``conformance.load_index``
32
- =============== ==================================================================
33
-
34
- 与 M1(`ruleset` 机械层)的用词归并:D1 说 `dup`,M1 的 `dup_hash_group` 说
35
- `dup_content`——同一件事两种写法,由 `KIND_ALIASES` 单一归口(`canonical_kind`)。
36
-
37
- 超出 D1 最小契约的**增强键**(供人工核对直接跳文件/跳行,不影响四键契约):
38
- `line`(节点文件原文 1-based 行号)、`sentence`(正文句索引,0 基)、
39
- `snippet`(命中片段)、`rule`(触发定位的判据名,审计用)、`peer`(同组对照节点)、
40
- `cause`(`contradiction` 的**成因**判定,见 `hash_mismatch_cause`——同一条命中
41
- 可能是「真不一致」也可能是「索引快照滞后」,两种成因不分会让复核者误判为数据损坏)。
42
-
43
- **`stale` 与 `observation_aged` 的判据源分工(2026-09-16 修正)**:
44
-
45
- * `stale`(**问题面**)—— **依赖存在性**:`code_ref`/`doc_ref` 指的源文件已不存在
46
- (悬空)或已漂移(区间哈希不符)。判据直接调 `refindex.probe_ref`,**不另立一份**
47
- (防「术语双写法」漂移)。代码知识的真值挂在源文件上,源没了/改了才是适用边界越出。
48
- * `observation_aged`(**观测面**,`ADVISORY_KINDS`,**不进默认全量**)——
49
- `condition_space.time_window` 已过。这是**观测时刻**不是失效声明:写入端
50
- (`mdcg.add`,见其 `OBSERVATION_WINDOW_SEC`)在未给 time_window 时以**写入时刻**
51
- 自动填 1 小时窗,故真库中「已过期」绝大多数是「写入超过 1 小时」,与知识是否失效
52
- 无关——把它当问题投进评审告警面就是系统性误报(实测:全库 1453 条过期里 1434 条
53
- 属默认窗填充)。需要时效判定用 `stale`(依赖存在性),不是这里。
54
- """
55
- from __future__ import annotations
56
-
57
- import argparse
58
- import json
59
- import os
60
- import re
61
- import sys
62
- import time
63
-
64
- from .. import conformance as CF
65
- from .. import crosscheck as CC
66
- from .. import nodefile as NF
67
- from .. import refindex as RI
68
- from .. import writelimit as WL
69
- from . import ruleset as RS
70
-
71
- __all__ = ["ISSUE_KINDS", "ADVISORY_KINDS", "KIND_ALIASES", "canonical_kind", "locate",
72
- "locate_many", "locate_package", "sentence_spans", "mark_spans", "load_node",
73
- "main", "field_layer_scope", "hash_mismatch_cause", "HASH_CAUSES"]
74
-
75
- #: D1 的问题类别(真源:立项文档 §5 D1)——**问题面**:命中即「知识有问题」
76
- ISSUE_KINDS = ("dup", "missing_field", "stale", "contradiction",
77
- "weak_source", "template_flow")
78
-
79
- #: **观测面**(咨询级):可显式定位,但**不进默认全量定位、不进评审告警面**。
80
- #: 判据:本类命中说的是「观测手段的副产品」(如「这条记忆写入超过 1 小时」),
81
- #: 不是「知识有问题」——把它混进 ISSUE_KINDS 会让每一次写入在 1 小时后自动变成
82
- #: 待评审问题(系统性误报)。故与问题面分表,只有显式点名才产出。
83
- ADVISORY_KINDS = ("observation_aged",)
84
-
85
- #: M1(ruleset 机械层)与 D1 的用词归并——两处说的是同一件事,不许各说各话
86
- KIND_ALIASES = {"dup_content": "dup", # M1 `dup_hash_group`
87
- "missing": "missing_field",
88
- "flow": "template_flow",
89
- "template_flow_digits_only": "template_flow"}
90
-
91
- #: 扫描 frontmatter 的字段清单(真源字段名取自 nodefile 口径,不自由发明)
92
- FM_SCAN_FIELDS = ("role", "tags", "importance", "evidence_count",
93
- "verification_basis", "lifecycle_state", "condition_space")
94
-
95
- #: 判为「同模板流水」所需的最少同骨架句数——单句偶合不算流水(防误报)
96
- MIN_FLOW_SENTENCES = 2
97
-
98
- #: 一句话摘要的最大长度
99
- SNIPPET_MAX = 120
100
-
101
- #: 索引快照与节点文件的 mtime 差**小于**此值 → 视为同一批写入,不判「快照滞后」
102
- MTIME_TOLERANCE = 1.0
103
-
104
- #: `content_hash` 不一致的**成因**(确定性判据,不猜;见 `hash_mismatch_cause`)
105
- HASH_CAUSES = ("index_lag", "true_mismatch", "unknown")
106
-
107
- #: `refindex.probe_ref` 的五态里,哪些构成「依赖已失效」(`stale` 判据,见 `_loc_stale`):
108
- #: 只有这两态说明**载体真的没了/改了**;`unresolved`(拿不到 root)与 `error`(读盘失败)
109
- #: 是观测手段不足,按「不猜」纪律不判。
110
- _REF_DEAD_STATUSES = ("dangling", "stale")
111
-
112
- #: 字段层门限缓存(规则库是包内数据文件,进程内不变 → 惰性算一次)
113
- _FIELD_LAYER_CACHE = None
114
-
115
-
116
- # 生效条件:kind 经 str(kind or "").strip() 得 k(None/空串等假值 → 空串 ""),k 命中 KIND_ALIASES 时返回其规范名,否则原样返回 k。
117
- def canonical_kind(kind) -> str:
118
- """M1/D1 用词 → D1 规范名(未知原样返回,不假装认路)。"""
119
- k = str(kind or "").strip()
120
- return KIND_ALIASES.get(k, k)
121
-
122
-
123
- # 生效条件:仅当 rules 与 rules_dir 均为 None 且模块级 _FIELD_LAYER_CACHE 非 None 时直接返回该缓存;否则遍历 rules(dict 取其 "rules" 键的列表、非 dict 直接 list(rules))或 rules_dir 经 RS.load_rules 取得的 rules 列表,从限了 matcher.layer 的 mechanical 规则中收集 field_absent 的 spec["field"] 与 evidence_zero 的 evidence_count,返回 {字段: 排序列},且只在 rules 与 rules_dir 均为 None 时写回 _FIELD_LAYER_CACHE。
124
- def field_layer_scope(rules=None, rules_dir=None) -> dict:
125
- """字段 → 适用层清单(**派生**自 M1 规则库,不在此另立一份)。
126
-
127
- 真源 = `md_cg/mreview/rules/*.json` 的 `matcher.layer`:只收录**限了层**的
128
- 机械规则字段(`field_absent` 取 `spec["field"]`、`evidence_zero` 取
129
- `evidence_count`);未限层的规则 = 全层适用,不入表。
130
-
131
- 理由:字段范围两处各写一份 ⇒ 必然漂移(同「术语双写法」)。派生使 M1 改规则
132
- 时 M3 自动跟随。规则库损坏 → `load_rules` 抛错(fail-closed,不静默降级成全层)。
133
- """
134
- global _FIELD_LAYER_CACHE
135
- if rules is None and rules_dir is None and _FIELD_LAYER_CACHE is not None:
136
- return _FIELD_LAYER_CACHE
137
- if isinstance(rules, dict):
138
- rl = list(rules.get("rules") or [])
139
- elif rules is not None:
140
- rl = list(rules)
141
- else:
142
- rl = list(RS.load_rules(rules_dir)["rules"])
143
- scope = {}
144
- for r in rl:
145
- layers = set((r.get("matcher") or {}).get("layer") or [])
146
- if not layers:
147
- continue
148
- for spec in r.get("mechanical") or []:
149
- chk = spec.get("check")
150
- if chk == "field_absent" and spec.get("field"):
151
- scope.setdefault(str(spec["field"]), set()).update(layers)
152
- elif chk == "evidence_zero":
153
- scope.setdefault("evidence_count", set()).update(layers)
154
- out = {k: sorted(v) for k, v in sorted(scope.items())}
155
- if rules is None and rules_dir is None:
156
- _FIELD_LAYER_CACHE = out
157
- return out
158
-
159
-
160
- # 生效条件:(scope or {}).get(field) 为假值(scope 为 None、空 dict 或 field 不在其中)→ 返回 True;want 为真值时仅当 str((meta or {}).get("layer")) 在 set(want) 内返回 True,否则 False。
161
- def _layer_ok(field, scope, meta) -> bool:
162
- """字段层门限:**限层的字段只在该层的节点上检查**。
163
-
164
- 口径与 M1 `ruleset._scope`(`str(e.get("layer")) in want`)逐字一致——缺层
165
- (`None`)不在任何层清单内 ⇒ 不检查。两处判据同源,防「越层误报」:
166
- M1 不在某层报的问题,M3 也不该报。
167
- """
168
- want = (scope or {}).get(field)
169
- if not want:
170
- return True
171
- return str((meta or {}).get("layer")) in set(want)
172
-
173
-
174
- # 生效条件:os.path.getmtime(path) 成功则返回该 mtime;抛 OSError 或 TypeError → 返回 None。
175
- def _mtime(path):
176
- """文件 mtime(不可读 → `None`,不假装知道)。"""
177
- try:
178
- return os.path.getmtime(path)
179
- except (OSError, TypeError):
180
- return None
181
-
182
-
183
- # 生效条件:root 或 rel(path 为真值时取 path,否则取 meta 的 "path")为空 → 返回 ("unknown", "无 root/path 可用,取不到盘上 mtime,成因未判定");两者都有时取节点文件与 CF.INDEX_FILE 的 mtime,任一为 None → 返回 ("unknown", "节点文件或索引快照不可读,成因未判定"),节点 mtime 减索引 mtime 之差 > MTIME_TOLERANCE → 返回 ("index_lag", …),否则返回 ("true_mismatch", …)。
184
- def hash_mismatch_cause(meta, *, root=None, path=None) -> tuple:
185
- """`content_hash` 声明值 ≠ 正文实算值 → **成因**判定(靠 mtime 证据,不猜)。
186
-
187
- → `(cause, note)`;cause ∈ `HASH_CAUSES`;取不到盘上证据 → `"unknown"`。
188
-
189
- 写路径真源(`md_cg/mdcg.py`):写走 `_stage()` 落**分片日志**,`rebuild_index()`
190
- 才写 `_index.json` 快照——故「节点文件比索引快照新」是**正常写路径现象**
191
- (快照滞后),不是文件被篡改;把两种成因合并成一句「索引与文件不一致」会让
192
- 复核者误判为数据损坏(实测滞后可达 14s 量级)。
193
- """
194
- rel = path if path else (meta or {}).get("path")
195
- if not root or not rel:
196
- return "unknown", "无 root/path 可用,取不到盘上 mtime,成因未判定"
197
- fp = str(rel) if os.path.isabs(str(rel)) else os.path.join(str(root), str(rel))
198
- fm_t = _mtime(fp)
199
- idx_t = _mtime(os.path.join(str(root), CF.INDEX_FILE))
200
- if fm_t is None or idx_t is None:
201
- return "unknown", "节点文件或索引快照不可读,成因未判定"
202
- delta = fm_t - idx_t
203
- if delta > MTIME_TOLERANCE:
204
- return "index_lag", ("节点文件比索引快照新 %.2fs——分片日志已写、_index.json "
205
- "未 rebuild(快照滞后属正常写路径现象)" % delta)
206
- return "true_mismatch", ("节点文件不晚于索引快照(差 %.2fs)——非快照滞后,"
207
- "索引声明与文件真源相抵触" % delta)
208
-
209
-
210
- # ---------------------------- 基础工具(纯函数) ----------------------------
211
-
212
- # 生效条件:v 为 list/tuple/dict 时返回 not v(空容器 → True);其余类型返回 v is None 或 str(v).strip() 为 "" 或 "None"。
213
- def _blank(v) -> bool:
214
- if isinstance(v, (list, tuple, dict)):
215
- return not v
216
- return v is None or str(v).strip() in ("", "None")
217
-
218
-
219
- # 生效条件:int(float(v)) 可算(含数字字符串)则返回该整数;抛 TypeError 或 ValueError(含 v 为 None、非数字串)→ 返回 None。
220
- def _as_int(v):
221
- try:
222
- return int(float(v))
223
- except (TypeError, ValueError):
224
- return None
225
-
226
-
227
- # 生效条件:float(v) 可算则返回该浮点数;抛 TypeError 或 ValueError(含 v 为 None、非数字串)→ 返回 None。
228
- def _as_float(v):
229
- try:
230
- return float(v)
231
- except (TypeError, ValueError):
232
- return None
233
-
234
-
235
- _SENT_END = "。!?;!?;\n"
236
-
237
-
238
- # 生效条件:content 为假值(None/空串)按 "" 处理,逐字符命中 _SENT_END 切出且 seg.strip() 非空的段以 len(out) 为序号追加 (索引, start, i+1, 原文),末尾 tail.strip() 非空亦追加;无合格段 → 返回空列表。
239
- def sentence_spans(content: str) -> list:
240
- """正文 → `[(句索引, start, end, 原文)]`;空句不编号(索引连续,确定性)。"""
241
- text, out, start = content or "", [], 0
242
- for i, ch in enumerate(text):
243
- if ch in _SENT_END:
244
- seg = text[start:i + 1]
245
- if seg.strip():
246
- out.append((len(out), start, i + 1, seg))
247
- start = i + 1
248
- tail = text[start:]
249
- if tail.strip():
250
- out.append((len(out), start, len(text), tail))
251
- return out
252
-
253
-
254
- #: 正文要素行:`# 功能名:…` / `# 生效条件: …`(间隔与分隔符两形态都收)
255
- _RE_MARK = re.compile(r"^#[ \t]*(?P<mark>[^::\n]{1,16})[::][^\n]*", re.M)
256
-
257
-
258
- # 生效条件:在 content(假值 → "")上用模块级 _RE_MARK 迭代匹配,以 m.group("mark").strip() 为键 setdefault 记下首次出现的 [m.start(), m.end());无匹配(含 content 为假值)→ 返回空 dict。
259
- def mark_spans(content: str) -> dict:
260
- """正文 CCG 要素行 → `{要素名: [start, end)}`;同要素取首次出现(确定性)。"""
261
- out = {}
262
- for m in _RE_MARK.finditer(content or ""):
263
- out.setdefault(m.group("mark").strip(), [m.start(), m.end()])
264
- return out
265
-
266
-
267
- # 生效条件:(text or "").split("\n") 的每行 strip 后非空、不以 "#" 开头且含 ":" 时,取首个冒号前的键 k,k 非空且尚未入表则记 (1-based 行号, [该行起始偏移, 起始偏移+len(line)]);text 为假值或无合格行 → 返回空 dict。
268
- def key_line_spans(text: str) -> dict:
269
- """节点文件原文 → `{键: (1-based 行号, [start, end))}`。
270
-
271
- 只认**无 `#` 前缀**且含 `:` 的行——即 frontmatter 行;`---` 分隔线无冒号,
272
- 自然被排除。同键取首次出现。
273
- """
274
- out, pos = {}, 0
275
- for i, line in enumerate((text or "").split("\n")):
276
- s = line.strip()
277
- if s and not s.startswith("#") and ":" in s:
278
- k = s.split(":", 1)[0].strip()
279
- if k and k not in out:
280
- out[k] = (i + 1, [pos, pos + len(line)])
281
- pos += len(line) + 1
282
- return out
283
-
284
-
285
- # 生效条件:index 为 dict 时其 "nodes" 为 dict 则返回 index["nodes"],否则返回 index 本身;index 为 None/非 dict 时调 CF.load_index(root),抛 OSError 或 ValueError → 返回 {},返回值为 dict 且其 "nodes" 为 dict → 返回该 "nodes",是 dict → 原样返回,否则返回 {}。
286
- def _index(root, index=None) -> dict:
287
- """索引节点表 `{node_id: meta}`(兼容 load_index 的 `{"nodes": …}` 形态)。"""
288
- if isinstance(index, dict):
289
- return index.get("nodes") if isinstance(index.get("nodes"), dict) else index
290
- try:
291
- idx = CF.load_index(root)
292
- except (OSError, ValueError):
293
- return {}
294
- if isinstance(idx, dict) and isinstance(idx.get("nodes"), dict):
295
- return idx["nodes"]
296
- return idx if isinstance(idx, dict) else {}
297
-
298
-
299
- # 生效条件:_index(root, index) 中 node_id 对应值非 dict → 返回 None;否则用 meta.get("path")(绝对路径直接用,否则 join(root, str(rel or "")))读文件——OSError 时返回 content/text 为 None、fm 为 {} 的 dict,成功则把 NF.loads(text) 得到的 content 与 fm(假值 → {})连同 meta/path/text 一并返回。
300
- def load_node(node_id, root, *, index=None) -> dict:
301
- """读一个节点(索引 meta + 文件 frontmatter + 正文原文)。
302
-
303
- → `{"node_id","meta","fm","content","text","path"}`;索引无此项 → `None`。
304
- `meta` 是**索引快照**(含索引侧 content_hash,矛盾判定要用),`fm` 是**文件真源**。
305
- """
306
- nodes = _index(root, index)
307
- meta = nodes.get(node_id)
308
- if not isinstance(meta, dict):
309
- return None
310
- rel = meta.get("path")
311
- fp = rel if (rel and os.path.isabs(str(rel))) else os.path.join(root, str(rel or ""))
312
- try:
313
- with open(fp, encoding="utf-8") as f:
314
- text = f.read()
315
- except (OSError, UnicodeDecodeError):
316
- return {"node_id": node_id, "meta": dict(meta), "fm": {}, "content": None,
317
- "text": None, "path": fp}
318
- fm, content = NF.loads(text)
319
- return {"node_id": node_id, "meta": dict(meta), "fm": fm or {}, "content": content,
320
- "text": text, "path": fp}
321
-
322
-
323
- # 生效条件:span 为 None → 返回 "";否则取 (text or "")[span[0]:span[1]] 去空白并把换行替换为 "⏎",长度超 SNIPPET_MAX 时截断并追加 "…"。
324
- def _snippet(text, span) -> str:
325
- """命中片段(供人工核对肉眼确认「指的是不是这一句」)。"""
326
- if span is None:
327
- return ""
328
- seg = (text or "")[span[0]:span[1]].strip().replace("\n", "⏎")
329
- return seg[:SNIPPET_MAX] + ("…" if len(seg) > SNIPPET_MAX else "")
330
-
331
-
332
- # 生效条件:任意 node_id/kind/field/span/evidence 均原样写入返回 dict 的 node_id/issue_kind/field/span/evidence 键,可选 rule/line/sentence/snippet/peer/cause/severity 未传时为 None、status 未传时为 "located",不做任何校验。
333
- def _hit(node_id, kind, field, span, evidence, *, rule=None, line=None,
334
- sentence=None, snippet=None, peer=None, cause=None, status="located",
335
- severity=None) -> dict:
336
- """命中行(四键契约 + 增强键)。
337
-
338
- `severity` 是**观测面专用**的等级标注(`ADVISORY_KINDS` 命中带 `"info"`):
339
- 问题面命中不带(问题即问题,无等级可降);本键让下游一眼分清「这是观测
340
- 副产品」与「这是待修的问题」,不必靠 issue_kind 名字去猜。
341
- """
342
- return {"node_id": node_id, "field": field, "span": span, "issue_kind": kind,
343
- "evidence": evidence, "rule": rule, "line": line, "sentence": sentence,
344
- "snippet": snippet, "peer": peer, "cause": cause, "status": status,
345
- "severity": severity}
346
-
347
-
348
- # 生效条件:text 为真值、span 与 content 均非 None 且 text.find(content)>=0 时,返回 text.count("\n",0,min(off+span[0],len(text)))+1 的 1-based 行号;text 假值或 span/content 为 None 或 content 未找到时返回 None。
349
- def _line_of(text, content, span):
350
- """正文区间 → 节点文件原文的 1-based 行号(供人工核对直接跳文件)。"""
351
- if not text or span is None or content is None:
352
- return None
353
- off = text.find(content)
354
- if off < 0:
355
- return None
356
- return text.count("\n", 0, min(off + span[0], len(text))) + 1
357
-
358
-
359
- # ---------------------------- 定位器注册表 ----------------------------
360
- #
361
- # 每个定位器是**纯函数**:只吃 (node_id, meta, content, ctx),只吐 hits。
362
- # 新增判据 = 加函数 + 注册,不改 locate 主流程(与 M1「引擎冻结、规则可增删」同构)。
363
- # ctx = {"fm", "text", "root", "index", "peers", "now"}
364
-
365
- # 生效条件:在 node_id/meta/content/ctx 下,对 FM_SCAN_FIELDS 中除 verification_basis、condition_space 外且 _layer_ok(f,scope,meta) 为真的字段,若 meta.get(f) 与 ctx.get("fm") 或 {} 中的同名字段皆 _blank 则记 field_absent;对过 _layer_ok 且 _as_int(meta.get("evidence_count"))==0 记 evidence_zero;对 meta.get("importance") 非 None 且 _as_float 为 None 或不在 [0.0,1.0] 记 field_invalid;对 condition_space 经 meta 或回落 ctx.get("fm") 后 NF.condition_space_missing 非空记 condition_slots;对正文缺 NF.CCG_MARKS 行记 ccg_incomplete,返回这些命中列表。
366
- def _loc_missing_field(node_id, meta, content, ctx):
367
- """frontmatter/正文结构字段为空(判据与 M1 `field_absent`/`evidence_zero` 同源)。
368
-
369
- **层门限**:限层的字段(如 `role`/`evidence_count` 限 `knowledge`)只在
370
- 该层节点上检查——与 M1 `_scope` 同口径,否则 M1 不报的问题会被 M3 越层报出。
371
- """
372
- fm = ctx.get("fm") or {}
373
- scope = ctx.get("field_layers")
374
- if scope is None:
375
- scope = field_layer_scope()
376
- lines = key_line_spans(ctx.get("text") or "")
377
- marks = mark_spans(content or "")
378
- hits = []
379
-
380
- for f in FM_SCAN_FIELDS:
381
- if f in ("verification_basis", "condition_space"):
382
- continue # 基底空属 weak_source;四槽缺失单独报(要点名缺哪几槽)
383
- if not _layer_ok(f, scope, meta):
384
- continue # 越层不报(层门限真源 = M1 规则库 matcher.layer)
385
- if _blank(meta.get(f)) and _blank(fm.get(f)):
386
- hits.append(_hit(node_id, "missing_field", f, None,
387
- "字段 %s 为空(索引与文件两处皆空)" % f,
388
- rule="field_absent",
389
- line=(lines.get(f) or (None, None))[0]))
390
-
391
- if _layer_ok("evidence_count", scope, meta) \
392
- and _as_int(meta.get("evidence_count")) == 0:
393
- hits.append(_hit(node_id, "missing_field", "evidence_count", None,
394
- "evidence_count=0(无验证证据计数)", rule="evidence_zero",
395
- line=(lines.get("evidence_count") or (None, None))[0]))
396
-
397
- imp = meta.get("importance")
398
- if imp is not None:
399
- fv = _as_float(imp)
400
- if fv is None or not 0.0 <= fv <= 1.0:
401
- hits.append(_hit(node_id, "missing_field", "importance", None,
402
- "importance=%r 不在 [0,1](字段存在但不可用)"
403
- % (imp,), rule="field_invalid",
404
- line=(lines.get("importance") or (None, None))[0]))
405
-
406
- cs = meta.get("condition_space")
407
- if not isinstance(cs, dict):
408
- cs = fm.get("condition_space")
409
- miss = NF.condition_space_missing(cs)
410
- if miss:
411
- span = marks.get("生效条件")
412
- hits.append(_hit(node_id, "missing_field", "condition_space", span,
413
- "条件空间缺槽 %s(%d/4 已声明)——四槽不全不构成生效条件"
414
- % ("/".join(miss), len(NF.CONDITION_SLOTS) - len(miss)),
415
- rule="condition_slots",
416
- snippet=_snippet(content, span)))
417
-
418
- # 正文 CCG 要素缺行:行不存在 → 无字符区间可指(span=None),点名缺哪几行
419
- missing_marks = [m for m in NF.CCG_MARKS if m not in marks]
420
- if missing_marks:
421
- hits.append(_hit(node_id, "missing_field", "content", None,
422
- "正文缺 CCG 要素行 %s(# 要素名:值)——缺声明即缺证据"
423
- % "/".join(missing_marks), rule="ccg_incomplete"))
424
- return hits
425
-
426
-
427
- # 生效条件:meta.get("verification_basis") 为空时回落 ctx.get("fm") 或 {} 的 verification_basis,若两者皆 _blank 返回 basis_absent 命中;非空但 str(basis) 不在 NF.VERIFICATION_BASIS 返回 basis_enum 命中;在枚举内时按 CC.classify_track 依 meta.get("layer")、meta.get("tags") 与 content 判赛道,若 CC.basis_licensed 为假返回 basis_licensed 命中;否则返回 []。
428
- def _loc_weak_source(node_id, meta, content, ctx):
429
- """验证基底缺失/越枚举/与赛道不相容(与 M1 `basis_licensed` 判据逐字同源)。"""
430
- fm = ctx.get("fm") or {}
431
- basis = meta.get("verification_basis")
432
- if _blank(basis):
433
- basis = fm.get("verification_basis")
434
- _ln = key_line_spans(ctx.get("text") or "").get("verification_basis")
435
- ln = (_ln or (None, None))[0]
436
-
437
- if _blank(basis):
438
- return [_hit(node_id, "weak_source", "verification_basis", None,
439
- "verification_basis 为空——无验证基底的断言不可裁决",
440
- rule="basis_absent", line=ln)]
441
- if str(basis) not in NF.VERIFICATION_BASIS:
442
- return [_hit(node_id, "weak_source", "verification_basis", None,
443
- "基底 %s 不在合法枚举(%s)"
444
- % (basis, "/".join(NF.VERIFICATION_BASIS)),
445
- rule="basis_enum", line=ln)]
446
- track = CC.classify_track({"layer": meta.get("layer"),
447
- "tags": meta.get("tags") or []}, content or "")
448
- if not CC.basis_licensed(track, basis):
449
- allow = "/".join(CC.allowed_basis(track)) or "—"
450
- return [_hit(node_id, "weak_source", "verification_basis", None,
451
- "赛道 %s(政策 %s)不允许基底 %s;允许 %s"
452
- % (track, CC.source_policy(track) or "—", basis, allow),
453
- rule="basis_licensed", line=ln)]
454
- return []
455
-
456
-
457
- # 生效条件:ctx.get("fm") 或 {} 中 code_ref 或 doc_ref 为非空 dict 且 RI.probe_ref(ref) 返回的 status 属于 _REF_DEAD_STATUSES(dangling 或 stale)时,返回对应 stale 命中(dangling 归因载体消失、stale 归因区间哈希不符);否则返回 []。
458
- def _loc_stale(node_id, meta, content, ctx):
459
- """**依赖存在性**——声明的载体(源文件)已不存在 / 已漂移(真正的适用边界越出)。
460
-
461
- 知识的真值挂在它描述的对象上:代码知识挂在源文件的符号上,源没了或改了,
462
- 知识才真的不再成立。判据与 `refindex` **同源**(`probe_ref`,不另立一份):
463
-
464
- ============== ====================================== ==========
465
- probe_ref 态 含义 本判据
466
- ============== ====================================== ==========
467
- ``ok`` 源文件在、区间哈希匹配 不判
468
- ``stale`` 源文件在、区间哈希不符(源被改,漂移) **stale**
469
- ``dangling`` 源文件不存在(载体消失) **stale**
470
- ``unresolved`` 拿不到 root(判不了) 不判(不猜)
471
- ``error`` 读盘失败 不判(不猜)
472
- ============== ====================================== ==========
473
-
474
- 后两态是**观测手段不足**,不是「依赖已失效」——按「不猜」纪律如实不报。
475
-
476
- **时间窗不在此处判**(2026-09-16 修正的原缺陷):`condition_space.time_window`
477
- 是写入端**观测时刻**栏(`mdcg.add` 未给时自动填「写入时刻 +1h」,见其
478
- `OBSERVATION_WINDOW_SEC`),不是知识的有效期——拿它判「适用边界越出」,
479
- 等于把「这条记忆写入超过 1 小时」冒充为「失效」。真实适用前提由知识自己
480
- 声明在 `code_ref`/`doc_ref` 上,故改由依赖存在性裁决;观测时刻本身不丢,
481
- 降级为 `observation_aged`(观测面,见 `ADVISORY_KINDS`)。
482
- """
483
- fm = ctx.get("fm") or {}
484
- hits = []
485
- for key in ("code_ref", "doc_ref"):
486
- ref = fm.get(key)
487
- if not isinstance(ref, dict) or not ref:
488
- continue
489
- # root 基准必须取自 ref 自身(`_code_ref`/`_doc_ref` 落的是**源大域** root,
490
- # path 相对它);`ctx["root"]` 是**认知图** root——拿它去拼会把每一条依赖
491
- # 都误判成悬空。ref 无 root(旧节点)时 probe 返回 `unresolved` → 不判。
492
- probe = RI.probe_ref(ref)
493
- st = str(probe.get("status") or "")
494
- if st not in _REF_DEAD_STATUSES:
495
- continue
496
- rel = str(ref.get("path") or "?")
497
- if st == "dangling":
498
- ev = ("依赖的源文件已不存在(%s:%s)——知识所指的载体消失,适用边界越出"
499
- % (key, rel))
500
- else:
501
- ev = ("依赖的源文件已漂移(%s:%s):索引区间哈希 %s ≠ 现算 %s——"
502
- "源被改动,知识所指的符号可能已不是原物"
503
- % (key, rel, probe.get("hash_expected"), probe.get("hash")))
504
- hits.append(_hit(node_id, "stale", key, None, ev, rule="ref_" + st))
505
- return hits
506
-
507
-
508
- # 生效条件:从 meta.get("condition_space") 或回落 ctx.get("fm") 的 condition_space(须为 dict)取 time_window,缺则取 meta.get("time_window"),若 NF.is_full_time_window(tw) 或 float(tw[1]) 抛 TypeError/ValueError/IndexError/KeyError 或 ctx.get("now") 为 None 或 hi>=float(now) 则返回 [];否则返回一条 severity="info" 的 observation_aged 命中。
509
- def _loc_observation_aged(node_id, meta, content, ctx):
510
- """时间窗已过——**这是观测时刻,不是失效声明**(观测面,不进告警面)。
511
-
512
- 时间窗来源链与 `_loc_missing_field` 的槽检查同构:`meta.condition_space`
513
- (显式注入面)→ `fm.condition_space`(文件真源)→ `meta.time_window`
514
- (索引快照字段)。**索引快照只透传 `time_window`**(`mdcg.py` `_stage` 口径:
515
- 时空字段入快照、condition_space 整块不入),故第三跳必留。
516
-
517
- **不进默认全量**(不在 `ISSUE_KINDS`):写入端未给 time_window 时以写入时刻
518
- 自动填 1 小时窗,故真库「已过期」绝大多数是「写入超过 1 小时」,与知识是否
519
- 失效无关。观测时刻本身仍如实报(审计有用),只是**不冒充问题**——命中带
520
- `severity="info"` 标记它是咨询级。
521
- """
522
- fm = ctx.get("fm") or {}
523
- cs = meta.get("condition_space")
524
- if not isinstance(cs, dict):
525
- csf = fm.get("condition_space")
526
- cs = csf if isinstance(csf, dict) else None
527
- tw = (cs or {}).get("time_window")
528
- if tw is None:
529
- tw = meta.get("time_window")
530
- if NF.is_full_time_window(tw):
531
- return [] # 全时窗是**合法声明**(任意时刻成立),不判
532
- try:
533
- hi = float(tw[1])
534
- except (TypeError, ValueError, IndexError, KeyError):
535
- return []
536
- now = ctx.get("now")
537
- if now is None or hi >= float(now):
538
- return []
539
- span = mark_spans(content or "").get("生效条件")
540
- return [_hit(node_id, "observation_aged", "condition_space", span,
541
- "观测时间窗 %s 已过(hi=%.0f < now=%.0f)——这是**观测时刻**,"
542
- "不是失效声明(知识不因观测过去而失效);时效判定见 stale"
543
- % (NF.time_window_text(tw) or "?", hi, float(now)),
544
- rule="observation_window_passed", severity="info",
545
- line=_line_of(ctx.get("text"), content, span),
546
- snippet=_snippet(content, span))]
547
-
548
-
549
- # 生效条件:h 取 str(meta.get("content_hash") or "").strip(),若 _blank(h) 则 h=NF.content_hash(content 或 "");对 ctx.get("peers") 或 [] 中 node_id 不等于本节点且 ph=str(p.get("hash") or "") 或回落 NF.content_hash(p.get("content") or "") 后非空且等于 h 的 peer 计入 matched;matched 非空时返回一条 dup 命中(span=[0,len(body)]),否则返回 []。
550
- def _loc_dup(node_id, meta, content, ctx):
551
- """同组同内容指纹(与 M1 `dup_hash_group` 同判据;D1 名 `dup`)。"""
552
- body = content if content is not None else ""
553
- h = str(meta.get("content_hash") or "").strip()
554
- if _blank(h):
555
- h = NF.content_hash(body) # 索引无指纹 → 用正文实算(诚实标注来源)
556
- matched = []
557
- for p in ctx.get("peers") or []:
558
- if p.get("node_id") == node_id:
559
- continue
560
- ph = str(p.get("hash") or "") or NF.content_hash(p.get("content") or "")
561
- if ph and ph == h:
562
- matched.append(p)
563
- if not matched:
564
- return []
565
- span = [0, len(body)]
566
- return [_hit(node_id, "dup", "content_hash", span,
567
- "与 %s 同内容指纹 %s(同类共 %d 条),整篇正文重复"
568
- % (matched[0].get("node_id"), h, len(matched) + 1),
569
- rule="dup_hash_group", peer=matched[0].get("node_id"),
570
- snippet=_snippet(body, span))]
571
-
572
-
573
- # 生效条件:对 ctx.get("peers") 或 [] 中每个非自身 peer,按 sentence_spans 对齐 content 与 peer content 的句子,当同一句位上去数字骨架相同(WL._skeleton(seg) 非空、长度 ≥ WL.MIN_SKELETON 且等于 peer 骨架)且 seg.strip() != ptext.strip() 的句子数达到 MIN_FLOW_SENTENCES 时,为这些句各返回一条 template_flow 命中;否则返回 []。
574
- def _loc_template_flow(node_id, meta, content, ctx):
575
- """同模板流水:与同组节点逐句「去数字骨架相同、字面不同」→ 指向那些句。
576
-
577
- 与 M1 `template_flow_digits_only` 同判据(都走 `writelimit._skeleton`),
578
- 差别只在产物:M1 给一条条目级 issue,D1 给出**具体是哪几句**(span + 句索引)。
579
- 单句偶合不算流水 → 需同组至少 `MIN_FLOW_SENTENCES` 句同时成立。
580
- """
581
- tgt = sentence_spans(content or "")
582
- hits = []
583
- for p in ctx.get("peers") or []:
584
- if p.get("node_id") == node_id:
585
- continue
586
- pseg = sentence_spans(p.get("content") or "")
587
- same = []
588
- for (i, s, e, seg) in tgt:
589
- if i >= len(pseg):
590
- break
591
- ptext = pseg[i][3]
592
- sk = WL._skeleton(seg)
593
- if not sk or len(sk) < WL.MIN_SKELETON or sk != WL._skeleton(ptext):
594
- continue
595
- if seg.strip() == ptext.strip():
596
- continue # 字面全同属整篇重复(dup),不是「只换数字」的流水
597
- same.append((i, s, e, seg, sk))
598
- if len(same) < MIN_FLOW_SENTENCES:
599
- continue
600
- for (i, s, e, seg, sk) in same:
601
- hits.append(_hit(node_id, "template_flow", "content", [s, e],
602
- "同模板流水(与 %s 第 %d 句去数字骨架相同、仅字面数值不同):%s"
603
- % (p.get("node_id"), i, sk[:40]),
604
- rule="template_flow_digits_only", sentence=i,
605
- peer=p.get("node_id"),
606
- line=_line_of(ctx.get("text"), content, [s, e]),
607
- snippet=seg.strip()[:SNIPPET_MAX]))
608
- return hits
609
-
610
-
611
- # 生效条件:meta.get("content_hash") 非 _blank 且 content 非 None 且 h != NF.content_hash(content) 时,返回一条 hash_declared_vs_actual 的 contradiction 命中(cause 由 hash_mismatch_cause 依 meta/ctx.get("root")/ctx.get("path") 判);ctx.get("fm") 或 {} 的 id 非 _blank 且 str(fm_id) != str(node_id) 时额外返回一条 id_declared_vs_index 命中;两者皆不成立返回 []。
612
- def _loc_contradiction(node_id, meta, content, ctx):
613
- """**确定性**矛盾:声明与事实不符(指纹 / 标识)。
614
-
615
- 语义级矛盾(正文自相矛盾)不在此处——那是 LLM 的活,D1 不猜(见 `SEMANTIC_ONLY`)。
616
- 指纹不一致**必须带成因**(`cause`):`index_lag`(快照滞后,属正常写路径现象,
617
- 复核者无需修数据)与 `true_mismatch`(真不一致,需查)处置完全不同。
618
- """
619
- hits = []
620
- lines = key_line_spans(ctx.get("text") or "")
621
- h = str(meta.get("content_hash") or "").strip()
622
- if not _blank(h) and content is not None:
623
- actual = NF.content_hash(content)
624
- if h != actual:
625
- cause, note = hash_mismatch_cause(meta, root=ctx.get("root"),
626
- path=ctx.get("path"))
627
- hits.append(_hit(node_id, "contradiction", "content_hash", None,
628
- "索引声明指纹 %s ≠ 正文实算 %s(%s)"
629
- % (h, actual, note), rule="hash_declared_vs_actual",
630
- cause=cause,
631
- line=(lines.get("content_hash") or (None, None))[0]))
632
- fm_id = (ctx.get("fm") or {}).get("id")
633
- if not _blank(fm_id) and str(fm_id) != str(node_id):
634
- hits.append(_hit(node_id, "contradiction", "id", None,
635
- "文件 frontmatter id=%s ≠ 索引键 %s" % (fm_id, node_id),
636
- rule="id_declared_vs_index",
637
- line=(lines.get("id") or (None, None))[0]))
638
- return hits
639
-
640
-
641
- LOCATORS = {
642
- "missing_field": _loc_missing_field,
643
- "weak_source": _loc_weak_source,
644
- "stale": _loc_stale,
645
- "observation_aged": _loc_observation_aged,
646
- "dup": _loc_dup,
647
- "template_flow": _loc_template_flow,
648
- "contradiction": _loc_contradiction,
649
- }
650
-
651
- #: D1 **不定位**的判定:属语义层,交回 LLM 意见(不猜 = 不编造字符区间)
652
- SEMANTIC_ONLY = {
653
- "contradiction_semantic": "正文自相矛盾属语义判定;D1 只做确定性矛盾"
654
- "(索引指纹 / 标识与事实不符)",
655
- }
656
-
657
-
658
- # 生效条件:始终返回 SEMANTIC_ONLY 中以 str(kind or "").strip() 为键查得的值,缺键时返回空串(空串表示可定位)。
659
- def blindspot_reason(kind) -> str:
660
- """D1 拒绝定位的类别 → 理由(空串表示可定位)。"""
661
- return SEMANTIC_ONLY.get(str(kind or "").strip(), "")
662
-
663
-
664
- # ---------------------------- 主入口 ----------------------------
665
-
666
- # 生效条件:items 中每项按 content=it.get("content") or ""、hash=str(it.get("hash") or "").strip() 或回落 NF.content_hash(content)、sk=WL.template_signature(content) or "" 预处理后,返回 {node_id: [同 hash 或同非空 sk 的其他 peer]};items 为空/None 返回空 dict。
667
- def build_peers(items) -> dict:
668
- """`[{node_id, content, hash?, …}]` → `{node_id: [peer, …]}`。
669
-
670
- 只有**同内容指纹**或**同模板骨架**才互为对照——不是「同一批就是一组」。
671
- 组的作用域由调用方给定(批 / 包),与 M1 机械层「组 = 同一个包」的口径一致。
672
- """
673
- prep = []
674
- for it in items or []:
675
- c = it.get("content") or ""
676
- prep.append({"node_id": it.get("node_id"), "content": c, "meta": it.get("meta"),
677
- "text": it.get("text"), "fm": it.get("fm"),
678
- "hash": str(it.get("hash") or "").strip() or NF.content_hash(c),
679
- "sk": WL.template_signature(c) or ""})
680
- by_hash, by_sk = {}, {}
681
- for p in prep:
682
- by_hash.setdefault(p["hash"], []).append(p)
683
- if p["sk"]:
684
- by_sk.setdefault(p["sk"], []).append(p)
685
- out = {}
686
- for p in prep:
687
- grp = {q["node_id"]: q for q in by_hash.get(p["hash"], [])
688
- if q["node_id"] != p["node_id"]}
689
- for q in (by_sk.get(p["sk"], []) if p["sk"] else []):
690
- if q["node_id"] != p["node_id"]:
691
- grp.setdefault(q["node_id"], q)
692
- out[p["node_id"]] = list(grp.values())
693
- return out
694
-
695
-
696
- # 生效条件:对 issue_hint(None/str/dict 或其 list/tuple)逐 hint 分类,返回 (kinds, fields, blind):能 canonical_kind 到 ISSUE_KINDS 或 ADVISORY_KINDS 的入 kinds,blindspot_reason 非空的入 blind,其余非空 kind 与 field 入 fields;issue_hint 为 None 时 kinds/fields 为空集、blind 为空列表。
697
- def _norm_hint(issue_hint):
698
- """issue_hint → `(kinds, fields, blindspot)`。
699
-
700
- 形态:`None`(全量)|str(issue_kind 或 field)|dict(issue_kind/field)
701
- |上述的 list。
702
- """
703
- kinds, fields, blind = set(), set(), []
704
- hints = issue_hint if isinstance(issue_hint, (list, tuple)) else [issue_hint]
705
- for h in hints:
706
- if h is None:
707
- continue
708
- if isinstance(h, dict):
709
- s = h.get("issue_kind") or h.get("kind") or ""
710
- f = h.get("field")
711
- else:
712
- s, f = str(h).strip(), None
713
- if s:
714
- why = blindspot_reason(s)
715
- if why:
716
- blind.append("%s:%s" % (s, why))
717
- else:
718
- ck = canonical_kind(s)
719
- if ck in ISSUE_KINDS or ck in ADVISORY_KINDS:
720
- kinds.add(ck)
721
- else:
722
- fields.add(s) # 不是类别 → 当作字段过滤
723
- if f:
724
- fields.add(str(f).strip())
725
- return kinds, fields, blind
726
-
727
-
728
- # 生效条件:当 meta 与 content 均非 None 时不读盘;否则 root 为 None 抛 ValueError,经 load_node 读不到节点返回 {"hits": [], "blindspot": blind+["节点 %s 不在索引"%node_id], "load": None};读到时补 meta/content/text/fm/path,按 kinds 非空时只跑 sorted(kinds)、否则 fields 非空或 issue_hint 为 None 时跑 sorted(ISSUE_KINDS)、否则 run=[] 执行 LOCATORS,对命中按 fields 过滤、补 line 并排序后返回 {"hits": hits, "blindspot": blind, "load": {...}}。
729
- def locate_ex(node_id, issue_hint=None, *, meta=None, content=None, fm=None, text=None,
730
- root=None, index=None, peers=None, now=None, path=None,
731
- field_layers=None) -> dict:
732
- """D1 定位(完整返回):`{"hits": [...], "blindspot": [...], "load": {...}}`。
733
-
734
- `meta`/`content` 显式给出则**不读盘**(纯函数用法——测试与批量复用都走这条);
735
- 否则 `root` 必填,经 `load_node` 从索引+文件取。返回的 hits 已按
736
- `(issue_kind, field, span起点, peer)` 排序,**确定性可复算**。
737
-
738
- `path`(节点文件绝对路径——供 `contradiction` 判成因)、`field_layers`
739
- (字段层门限,缺省 `field_layer_scope()`)可显式注入,便于纯函数测试。
740
- """
741
- kinds, fields, blind = _norm_hint(issue_hint)
742
- if meta is None or content is None:
743
- if root is None:
744
- raise ValueError("locate 需要 meta+content,或给出 root 以便读节点")
745
- nd = load_node(node_id, root, index=index)
746
- if nd is None:
747
- return {"hits": [], "blindspot": blind + ["节点 %s 不在索引" % node_id],
748
- "load": None}
749
- if meta is None:
750
- meta = nd["meta"]
751
- if content is None:
752
- content = nd["content"]
753
- if text is None:
754
- text = nd["text"]
755
- if fm is None:
756
- fm = nd["fm"]
757
- if path is None:
758
- path = nd.get("path")
759
- meta = meta or {}
760
- ctx = {"fm": fm or {}, "text": text, "root": root, "index": index,
761
- "peers": peers or [], "now": time.time() if now is None else float(now),
762
- "path": path, "field_layers": field_layers}
763
- hits = []
764
- # 定位范围:显式类别 → 只跑该类;给出字段 → 全量再由字段收窄;
765
- # 无提示 → 全量。**提示全部落 blindspot 时范围为空**——不借机报别的类
766
- # (否则「给了语义提示」会顺手退回全量,与「不猜」纪律相悖)。
767
- if kinds:
768
- run = sorted(kinds)
769
- elif fields or issue_hint is None:
770
- run = sorted(ISSUE_KINDS)
771
- else:
772
- run = []
773
- for k in run:
774
- fn = LOCATORS.get(k)
775
- if fn is None:
776
- continue
777
- for h in fn(node_id, meta, content, ctx):
778
- if fields and h.get("field") not in fields:
779
- continue
780
- if h.get("line") is None and h.get("span") is not None:
781
- h["line"] = _line_of(text, content, h["span"])
782
- hits.append(h)
783
- hits.sort(key=lambda h: (h["issue_kind"], str(h.get("field") or ""),
784
- -1 if h.get("span") is None else h["span"][0],
785
- str(h.get("peer") or "")))
786
- return {"hits": hits, "blindspot": blind,
787
- "load": {"node_id": node_id, "meta": meta,
788
- "content_len": len(content or "")}}
789
-
790
-
791
- # 生效条件:给定 node_id(必填)与可选 issue_hint 及 kw 后,直接返回 locate_ex(node_id, issue_hint, **kw) 结果的 "hits" 列表。
792
- def locate(node_id, issue_hint=None, **kw) -> list:
793
- """**D1 契约入口**:`locate(node_id, issue_hint) -> [{field, span, issue_kind, evidence}]`。"""
794
- return locate_ex(node_id, issue_hint, **kw)["hits"]
795
-
796
-
797
- # 生效条件:给定 hits 与 key 后,返回 hits 中每个 h.get(key) 字符串化取值到出现次数的字典(键升序);hits 为 None/空时返回空 dict。
798
- def _counts(hits, key) -> dict:
799
- out = {}
800
- for h in hits or []:
801
- k = h.get(key)
802
- out[str(k)] = out.get(str(k), 0) + 1
803
- return dict(sorted(out.items()))
804
-
805
-
806
- # 生效条件:items 显式给出时不读盘;items 为 None 时 root 为 None 抛 ValueError,否则按 node_ids 逐节点 load_node 组装 items(读不到的记入 missing);随后对每个 item 调 locate_ex 汇总 hits 或 clean,并返回含 nodes/hits/by_kind/by_field/by_rule/clean/missing 的 dict。
807
- def locate_many(node_ids=None, *, root=None, index=None, items=None,
808
- issue_hint=None, now=None) -> dict:
809
- """批量定位:**同一批内**互为对照(`dup` / `template_flow` 的组 = 本批)。
810
-
811
- `items` 显式给出 `[{node_id, content, meta?, text?, fm?, hash?}]` 则不再读盘。
812
- 返回 `{nodes, hits, by_kind, by_field, clean, missing}`;`clean` 是**无命中**的节点、
813
- `missing` 是**读不到**的节点——两者分开报(「没问题」≠「没看」)。
814
- """
815
- missing = []
816
- if items is None:
817
- if root is None:
818
- raise ValueError("locate_many 需要 root(读盘)或 items(显式给出)")
819
- items = []
820
- for nid in node_ids or []:
821
- nd = load_node(nid, root, index=index)
822
- if nd is None:
823
- missing.append(nid)
824
- continue
825
- items.append({"node_id": nid, "content": nd["content"] or "",
826
- "text": nd["text"], "fm": nd["fm"], "meta": nd["meta"],
827
- "path": nd.get("path"),
828
- "hash": nd["meta"].get("content_hash")})
829
- peers = build_peers(items)
830
- now = time.time() if now is None else float(now)
831
- hits, clean = [], []
832
- for it in items:
833
- nid = it["node_id"]
834
- ex = locate_ex(nid, issue_hint, meta=it.get("meta") or {},
835
- content=it.get("content") or "", fm=it.get("fm"),
836
- text=it.get("text"), peers=peers.get(nid) or [], now=now,
837
- root=root, path=it.get("path"))
838
- if ex["hits"]:
839
- hits.extend(ex["hits"])
840
- else:
841
- clean.append(nid)
842
- hits.sort(key=lambda h: (str(h.get("node_id")), h["issue_kind"],
843
- str(h.get("field") or ""),
844
- -1 if h.get("span") is None else h["span"][0]))
845
- return {"nodes": len(items), "hits": hits, "by_kind": _counts(hits, "issue_kind"),
846
- "by_field": _counts(hits, "field"), "by_rule": _counts(hits, "rule"),
847
- "clean": clean, "missing": missing}
848
-
849
-
850
- # 生效条件:从 pkg.get("entries") or [] 取条目并跳过 e.get("node_id") 为空者,root 非 None 时逐个 load_node 取正文,取不到时回落 e.get("excerpt") or "",组装 items 调 locate_many 后返回其结果并附加 bundle_id 与 entries 数量;pkg 为 None 时 entries 为空列表。
851
- def locate_package(pkg, *, root=None, index=None, issue_hint=None, now=None) -> dict:
852
- """M1 包 → 定位汇总(组的作用域 = 本包,与 M1 机械层同口径)。
853
-
854
- 正文优先读盘(准确);文件不可读时退回包内 `excerpt`(可能截断——宁可降级也不
855
- 假装读到了全文,`missing` 会如实记下读不到的节点)。
856
- """
857
- entries = (pkg or {}).get("entries") or []
858
- items = []
859
- for e in entries:
860
- nid = e.get("node_id")
861
- if not nid:
862
- continue
863
- nd = load_node(nid, root, index=index) if root else None
864
- body = (nd or {}).get("content")
865
- items.append({"node_id": nid,
866
- "content": body if body is not None else (e.get("excerpt") or ""),
867
- "text": (nd or {}).get("text"), "fm": (nd or {}).get("fm"),
868
- "meta": (nd or {}).get("meta") or e,
869
- "path": (nd or {}).get("path") or e.get("path"),
870
- "hash": ((nd or {}).get("meta") or {}).get("content_hash")
871
- or e.get("content_hash")})
872
- out = locate_many(items=items, issue_hint=issue_hint, now=now)
873
- out["bundle_id"] = (pkg or {}).get("bundle_id")
874
- out["entries"] = len(entries)
875
- return out
876
-
877
-
878
- # 生效条件:给定 hits 后返回 total=len(hits or [])、去重 node_id 数、排序后的 node_ids、以及 by_kind/by_field/by_rule 计数;hits 为 None/空时 total=0、nodes=0、node_ids=[]。
879
- def summary(hits) -> dict:
880
- """命中汇总(审计留痕用)。"""
881
- nodes = sorted({str(h.get("node_id")) for h in hits or []})
882
- return {"total": len(hits or []), "nodes": len(nodes), "node_ids": nodes,
883
- "by_kind": _counts(hits, "issue_kind"), "by_field": _counts(hits, "field"),
884
- "by_rule": _counts(hits, "rule")}
885
-
886
-
887
- # 生效条件:给定 hits 后逐条生成 Markdown 行并返回表头加各行:field/line/snippet 取 h.get(...) or "—"(假值回落 "—"),span 为 None 时显示 "—" 否则 "起-止",evidence 取 (h.get("evidence") or "").replace("|","\\|")(假值回落空串)。
888
- def markdown_table(hits) -> str:
889
- """人工核对清单:每行一条命中,末列留空供核对者填判定(D1 验收抽样用)。"""
890
- head = ("| # | node_id | issue_kind | field | span | line | 片段 | evidence | 人工判定 |\n"
891
- "|---|---|---|---|---|---|---|---|---|\n")
892
- rows = []
893
- for i, h in enumerate(hits or [], 1):
894
- sp = "—" if h.get("span") is None else "%d-%d" % (h["span"][0], h["span"][1])
895
- rows.append("| %d | %s | %s | %s | %s | %s | %s | %s | |"
896
- % (i, h.get("node_id"), h.get("issue_kind"), h.get("field") or "—",
897
- sp, h.get("line") or "—",
898
- (h.get("snippet") or "—").replace("|", "\\|"),
899
- (h.get("evidence") or "").replace("|", "\\|")))
900
- return head + "\n".join(rows)
901
-
902
-
903
- # 生效条件:解析 argv(缺省 sys.argv)后,--root 为假值(含默认 os.environ.get("MDCG_ROOT") 为 None 或空串)时打印提示并返回 2;--node 追加列表为空时打印提示并返回 2;否则以 --root 与 --node 调 locate_many,并按 --json 或 --markdown 输出后返回 0,两者皆无则逐行打印命中与汇总后返回 0。
904
- def main(argv=None) -> int:
905
- ap = argparse.ArgumentParser(prog="python -m md_cg.mreview.locate",
906
- description="记忆评审 M3 · D1 字段级定位")
907
- ap.add_argument("--root", default=os.environ.get("MDCG_ROOT"),
908
- help="真源根(缺省读环境变量 MDCG_ROOT)")
909
- ap.add_argument("--node", action="append", default=[],
910
- help="节点 id(可多次;同一批内互为对照)")
911
- ap.add_argument("--kind", action="append", default=[], help="只定位该类问题")
912
- ap.add_argument("--field", action="append", default=[], help="只保留该字段的命中")
913
- ap.add_argument("--json", action="store_true", help="输出 JSON(缺省人读表)")
914
- ap.add_argument("--markdown", action="store_true", help="输出人工核对清单")
915
- a = ap.parse_args(argv)
916
- if not a.root:
917
- print("需要 --root 或环境变量 MDCG_ROOT", file=sys.stderr)
918
- return 2
919
- if not a.node:
920
- print("需要 --node <id>(可多次)", file=sys.stderr)
921
- return 2
922
- rep = locate_many(a.node, root=a.root,
923
- issue_hint=(list(a.kind) + list(a.field)) or None)
924
- if a.json:
925
- print(json.dumps(rep, ensure_ascii=False, indent=2))
926
- return 0
927
- if a.markdown:
928
- print(markdown_table(rep["hits"]))
929
- return 0
930
- for h in rep["hits"]:
931
- print("%-14s %-20s %-14s %s" % (h["node_id"], h["field"], h["issue_kind"],
932
- h["evidence"]))
933
- print("-- 命中 %d 条|干净 %d 条|缺项 %d 条"
934
- % (len(rep["hits"]), len(rep["clean"]), len(rep["missing"])))
935
- return 0
936
-
937
-
938
- if __name__ == "__main__":
939
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """记忆评审流水线 · M3 定位模块(D1 字段级定位,确定性、零写入)。
3
+
4
+ 真源:docs/记忆评审系统_立项设计与施工交接_20260915.md §5 D1。
5
+
6
+ D1 契约:
7
+
8
+ locate(node_id, issue_hint) -> [{"field", "span", "issue_kind", "evidence"}, ...]
9
+
10
+ * **field** —— frontmatter 字段名,或 `"content"`(正文)
11
+ * **span** —— 命中处的字符区间 `[start, end)`(半开),**相对正文 content**;
12
+ 纯字段级缺失无字符区间可指 → `None`
13
+ * **issue_kind** —— dup / missing_field / stale / contradiction / weak_source / template_flow
14
+ (`ISSUE_KINDS`=问题面);另有 `ADVISORY_KINDS`(观测面,可显式定位
15
+ 但**不进默认全量、不进评审告警面**,见下「stale 与 observation_aged」)
16
+ * **evidence** —— 白箱判据:为什么算问题(人可复核、机器可断言)
17
+
18
+ 定位的职责边界:M2 的意见说「这一条有问题」,D1 回答「问题在这一条的哪个字段/哪一段」。
19
+ 故本模块只做**确定性可判定**的事——语义级矛盾(正文自相矛盾)**不猜**,如实返回
20
+ BLINDSPOT 项交回 LLM 意见层(`status="blindspot"`,见 `locate()` 返回值)。
21
+
22
+ 口径全部引用既有唯一真源,**不在本模块另立一份**(防「术语双写法」漂移):
23
+
24
+ =============== ==================================================================
25
+ 字段/正文结构 ``nodefile``(CCG_MARKS / CONDITION_SLOTS / VERIFICATION_BASIS /
26
+ loads / content_hash / is_placeholder_text / time_window_text)
27
+ 模板骨架 ``writelimit._skeleton`` / ``MIN_SKELETON``
28
+ 赛道×基底相容 ``crosscheck``(与 M1 `ruleset._chk_basis_licensed` 同源)
29
+ 字段层门限 ``ruleset``(即 `rules/*.json` 的 `matcher.layer`,见
30
+ `field_layer_scope`——**派生**,不在此另立一份)
31
+ 索引快照 ``conformance.load_index``
32
+ =============== ==================================================================
33
+
34
+ 与 M1(`ruleset` 机械层)的用词归并:D1 说 `dup`,M1 的 `dup_hash_group` 说
35
+ `dup_content`——同一件事两种写法,由 `KIND_ALIASES` 单一归口(`canonical_kind`)。
36
+
37
+ 超出 D1 最小契约的**增强键**(供人工核对直接跳文件/跳行,不影响四键契约):
38
+ `line`(节点文件原文 1-based 行号)、`sentence`(正文句索引,0 基)、
39
+ `snippet`(命中片段)、`rule`(触发定位的判据名,审计用)、`peer`(同组对照节点)、
40
+ `cause`(`contradiction` 的**成因**判定,见 `hash_mismatch_cause`——同一条命中
41
+ 可能是「真不一致」也可能是「索引快照滞后」,两种成因不分会让复核者误判为数据损坏)。
42
+
43
+ **`stale` 与 `observation_aged` 的判据源分工(2026-09-16 修正)**:
44
+
45
+ * `stale`(**问题面**)—— **依赖存在性**:`code_ref`/`doc_ref` 指的源文件已不存在
46
+ (悬空)或已漂移(区间哈希不符)。判据直接调 `refindex.probe_ref`,**不另立一份**
47
+ (防「术语双写法」漂移)。代码知识的真值挂在源文件上,源没了/改了才是适用边界越出。
48
+ * `observation_aged`(**观测面**,`ADVISORY_KINDS`,**不进默认全量**)——
49
+ `condition_space.time_window` 已过。这是**观测时刻**不是失效声明:写入端
50
+ (`mdcg.add`,见其 `OBSERVATION_WINDOW_SEC`)在未给 time_window 时以**写入时刻**
51
+ 自动填 1 小时窗,故真库中「已过期」绝大多数是「写入超过 1 小时」,与知识是否失效
52
+ 无关——把它当问题投进评审告警面就是系统性误报(实测:全库 1453 条过期里 1434 条
53
+ 属默认窗填充)。需要时效判定用 `stale`(依赖存在性),不是这里。
54
+ """
55
+ from __future__ import annotations
56
+
57
+ import argparse
58
+ import json
59
+ import os
60
+ import re
61
+ import sys
62
+ import time
63
+
64
+ from .. import conformance as CF
65
+ from .. import crosscheck as CC
66
+ from .. import nodefile as NF
67
+ from .. import refindex as RI
68
+ from .. import writelimit as WL
69
+ from . import ruleset as RS
70
+
71
+ __all__ = ["ISSUE_KINDS", "ADVISORY_KINDS", "KIND_ALIASES", "canonical_kind", "locate",
72
+ "locate_many", "locate_package", "sentence_spans", "mark_spans", "load_node",
73
+ "main", "field_layer_scope", "hash_mismatch_cause", "HASH_CAUSES"]
74
+
75
+ #: D1 的问题类别(真源:立项文档 §5 D1)——**问题面**:命中即「知识有问题」
76
+ ISSUE_KINDS = ("dup", "missing_field", "stale", "contradiction",
77
+ "weak_source", "template_flow")
78
+
79
+ #: **观测面**(咨询级):可显式定位,但**不进默认全量定位、不进评审告警面**。
80
+ #: 判据:本类命中说的是「观测手段的副产品」(如「这条记忆写入超过 1 小时」),
81
+ #: 不是「知识有问题」——把它混进 ISSUE_KINDS 会让每一次写入在 1 小时后自动变成
82
+ #: 待评审问题(系统性误报)。故与问题面分表,只有显式点名才产出。
83
+ ADVISORY_KINDS = ("observation_aged",)
84
+
85
+ #: M1(ruleset 机械层)与 D1 的用词归并——两处说的是同一件事,不许各说各话
86
+ KIND_ALIASES = {"dup_content": "dup", # M1 `dup_hash_group`
87
+ "missing": "missing_field",
88
+ "flow": "template_flow",
89
+ "template_flow_digits_only": "template_flow"}
90
+
91
+ #: 扫描 frontmatter 的字段清单(真源字段名取自 nodefile 口径,不自由发明)
92
+ FM_SCAN_FIELDS = ("role", "tags", "importance", "evidence_count",
93
+ "verification_basis", "lifecycle_state", "condition_space")
94
+
95
+ #: 判为「同模板流水」所需的最少同骨架句数——单句偶合不算流水(防误报)
96
+ MIN_FLOW_SENTENCES = 2
97
+
98
+ #: 一句话摘要的最大长度
99
+ SNIPPET_MAX = 120
100
+
101
+ #: 索引快照与节点文件的 mtime 差**小于**此值 → 视为同一批写入,不判「快照滞后」
102
+ MTIME_TOLERANCE = 1.0
103
+
104
+ #: `content_hash` 不一致的**成因**(确定性判据,不猜;见 `hash_mismatch_cause`)
105
+ HASH_CAUSES = ("index_lag", "true_mismatch", "unknown")
106
+
107
+ #: `refindex.probe_ref` 的五态里,哪些构成「依赖已失效」(`stale` 判据,见 `_loc_stale`):
108
+ #: 只有这两态说明**载体真的没了/改了**;`unresolved`(拿不到 root)与 `error`(读盘失败)
109
+ #: 是观测手段不足,按「不猜」纪律不判。
110
+ _REF_DEAD_STATUSES = ("dangling", "stale")
111
+
112
+ #: 字段层门限缓存(规则库是包内数据文件,进程内不变 → 惰性算一次)
113
+ _FIELD_LAYER_CACHE = None
114
+
115
+
116
+ # 生效条件:kind 经 str(kind or "").strip() 得 k(None/空串等假值 → 空串 ""),k 命中 KIND_ALIASES 时返回其规范名,否则原样返回 k。
117
+ def canonical_kind(kind) -> str:
118
+ """M1/D1 用词 → D1 规范名(未知原样返回,不假装认路)。"""
119
+ k = str(kind or "").strip()
120
+ return KIND_ALIASES.get(k, k)
121
+
122
+
123
+ # 生效条件:仅当 rules 与 rules_dir 均为 None 且模块级 _FIELD_LAYER_CACHE 非 None 时直接返回该缓存;否则遍历 rules(dict 取其 "rules" 键的列表、非 dict 直接 list(rules))或 rules_dir 经 RS.load_rules 取得的 rules 列表,从限了 matcher.layer 的 mechanical 规则中收集 field_absent 的 spec["field"] 与 evidence_zero 的 evidence_count,返回 {字段: 排序列},且只在 rules 与 rules_dir 均为 None 时写回 _FIELD_LAYER_CACHE。
124
+ def field_layer_scope(rules=None, rules_dir=None) -> dict:
125
+ """字段 → 适用层清单(**派生**自 M1 规则库,不在此另立一份)。
126
+
127
+ 真源 = `md_cg/mreview/rules/*.json` 的 `matcher.layer`:只收录**限了层**的
128
+ 机械规则字段(`field_absent` 取 `spec["field"]`、`evidence_zero` 取
129
+ `evidence_count`);未限层的规则 = 全层适用,不入表。
130
+
131
+ 理由:字段范围两处各写一份 ⇒ 必然漂移(同「术语双写法」)。派生使 M1 改规则
132
+ 时 M3 自动跟随。规则库损坏 → `load_rules` 抛错(fail-closed,不静默降级成全层)。
133
+ """
134
+ global _FIELD_LAYER_CACHE
135
+ if rules is None and rules_dir is None and _FIELD_LAYER_CACHE is not None:
136
+ return _FIELD_LAYER_CACHE
137
+ if isinstance(rules, dict):
138
+ rl = list(rules.get("rules") or [])
139
+ elif rules is not None:
140
+ rl = list(rules)
141
+ else:
142
+ rl = list(RS.load_rules(rules_dir)["rules"])
143
+ scope = {}
144
+ for r in rl:
145
+ layers = set((r.get("matcher") or {}).get("layer") or [])
146
+ if not layers:
147
+ continue
148
+ for spec in r.get("mechanical") or []:
149
+ chk = spec.get("check")
150
+ if chk == "field_absent" and spec.get("field"):
151
+ scope.setdefault(str(spec["field"]), set()).update(layers)
152
+ elif chk == "evidence_zero":
153
+ scope.setdefault("evidence_count", set()).update(layers)
154
+ out = {k: sorted(v) for k, v in sorted(scope.items())}
155
+ if rules is None and rules_dir is None:
156
+ _FIELD_LAYER_CACHE = out
157
+ return out
158
+
159
+
160
+ # 生效条件:(scope or {}).get(field) 为假值(scope 为 None、空 dict 或 field 不在其中)→ 返回 True;want 为真值时仅当 str((meta or {}).get("layer")) 在 set(want) 内返回 True,否则 False。
161
+ def _layer_ok(field, scope, meta) -> bool:
162
+ """字段层门限:**限层的字段只在该层的节点上检查**。
163
+
164
+ 口径与 M1 `ruleset._scope`(`str(e.get("layer")) in want`)逐字一致——缺层
165
+ (`None`)不在任何层清单内 ⇒ 不检查。两处判据同源,防「越层误报」:
166
+ M1 不在某层报的问题,M3 也不该报。
167
+ """
168
+ want = (scope or {}).get(field)
169
+ if not want:
170
+ return True
171
+ return str((meta or {}).get("layer")) in set(want)
172
+
173
+
174
+ # 生效条件:os.path.getmtime(path) 成功则返回该 mtime;抛 OSError 或 TypeError → 返回 None。
175
+ def _mtime(path):
176
+ """文件 mtime(不可读 → `None`,不假装知道)。"""
177
+ try:
178
+ return os.path.getmtime(path)
179
+ except (OSError, TypeError):
180
+ return None
181
+
182
+
183
+ # 生效条件:root 或 rel(path 为真值时取 path,否则取 meta 的 "path")为空 → 返回 ("unknown", "无 root/path 可用,取不到盘上 mtime,成因未判定");两者都有时取节点文件与 CF.INDEX_FILE 的 mtime,任一为 None → 返回 ("unknown", "节点文件或索引快照不可读,成因未判定"),节点 mtime 减索引 mtime 之差 > MTIME_TOLERANCE → 返回 ("index_lag", …),否则返回 ("true_mismatch", …)。
184
+ def hash_mismatch_cause(meta, *, root=None, path=None) -> tuple:
185
+ """`content_hash` 声明值 ≠ 正文实算值 → **成因**判定(靠 mtime 证据,不猜)。
186
+
187
+ → `(cause, note)`;cause ∈ `HASH_CAUSES`;取不到盘上证据 → `"unknown"`。
188
+
189
+ 写路径真源(`md_cg/mdcg.py`):写走 `_stage()` 落**分片日志**,`rebuild_index()`
190
+ 才写 `_index.json` 快照——故「节点文件比索引快照新」是**正常写路径现象**
191
+ (快照滞后),不是文件被篡改;把两种成因合并成一句「索引与文件不一致」会让
192
+ 复核者误判为数据损坏(实测滞后可达 14s 量级)。
193
+ """
194
+ rel = path if path else (meta or {}).get("path")
195
+ if not root or not rel:
196
+ return "unknown", "无 root/path 可用,取不到盘上 mtime,成因未判定"
197
+ fp = str(rel) if os.path.isabs(str(rel)) else os.path.join(str(root), str(rel))
198
+ fm_t = _mtime(fp)
199
+ idx_t = _mtime(os.path.join(str(root), CF.INDEX_FILE))
200
+ if fm_t is None or idx_t is None:
201
+ return "unknown", "节点文件或索引快照不可读,成因未判定"
202
+ delta = fm_t - idx_t
203
+ if delta > MTIME_TOLERANCE:
204
+ return "index_lag", ("节点文件比索引快照新 %.2fs——分片日志已写、_index.json "
205
+ "未 rebuild(快照滞后属正常写路径现象)" % delta)
206
+ return "true_mismatch", ("节点文件不晚于索引快照(差 %.2fs)——非快照滞后,"
207
+ "索引声明与文件真源相抵触" % delta)
208
+
209
+
210
+ # ---------------------------- 基础工具(纯函数) ----------------------------
211
+
212
+ # 生效条件:v 为 list/tuple/dict 时返回 not v(空容器 → True);其余类型返回 v is None 或 str(v).strip() 为 "" 或 "None"。
213
+ def _blank(v) -> bool:
214
+ if isinstance(v, (list, tuple, dict)):
215
+ return not v
216
+ return v is None or str(v).strip() in ("", "None")
217
+
218
+
219
+ # 生效条件:int(float(v)) 可算(含数字字符串)则返回该整数;抛 TypeError 或 ValueError(含 v 为 None、非数字串)→ 返回 None。
220
+ def _as_int(v):
221
+ try:
222
+ return int(float(v))
223
+ except (TypeError, ValueError):
224
+ return None
225
+
226
+
227
+ # 生效条件:float(v) 可算则返回该浮点数;抛 TypeError 或 ValueError(含 v 为 None、非数字串)→ 返回 None。
228
+ def _as_float(v):
229
+ try:
230
+ return float(v)
231
+ except (TypeError, ValueError):
232
+ return None
233
+
234
+
235
+ _SENT_END = "。!?;!?;\n"
236
+
237
+
238
+ # 生效条件:content 为假值(None/空串)按 "" 处理,逐字符命中 _SENT_END 切出且 seg.strip() 非空的段以 len(out) 为序号追加 (索引, start, i+1, 原文),末尾 tail.strip() 非空亦追加;无合格段 → 返回空列表。
239
+ def sentence_spans(content: str) -> list:
240
+ """正文 → `[(句索引, start, end, 原文)]`;空句不编号(索引连续,确定性)。"""
241
+ text, out, start = content or "", [], 0
242
+ for i, ch in enumerate(text):
243
+ if ch in _SENT_END:
244
+ seg = text[start:i + 1]
245
+ if seg.strip():
246
+ out.append((len(out), start, i + 1, seg))
247
+ start = i + 1
248
+ tail = text[start:]
249
+ if tail.strip():
250
+ out.append((len(out), start, len(text), tail))
251
+ return out
252
+
253
+
254
+ #: 正文要素行:`# 功能名:…` / `# 生效条件: …`(间隔与分隔符两形态都收)
255
+ _RE_MARK = re.compile(r"^#[ \t]*(?P<mark>[^::\n]{1,16})[::][^\n]*", re.M)
256
+
257
+
258
+ # 生效条件:在 content(假值 → "")上用模块级 _RE_MARK 迭代匹配,以 m.group("mark").strip() 为键 setdefault 记下首次出现的 [m.start(), m.end());无匹配(含 content 为假值)→ 返回空 dict。
259
+ def mark_spans(content: str) -> dict:
260
+ """正文 CCG 要素行 → `{要素名: [start, end)}`;同要素取首次出现(确定性)。"""
261
+ out = {}
262
+ for m in _RE_MARK.finditer(content or ""):
263
+ out.setdefault(m.group("mark").strip(), [m.start(), m.end()])
264
+ return out
265
+
266
+
267
+ # 生效条件:(text or "").split("\n") 的每行 strip 后非空、不以 "#" 开头且含 ":" 时,取首个冒号前的键 k,k 非空且尚未入表则记 (1-based 行号, [该行起始偏移, 起始偏移+len(line)]);text 为假值或无合格行 → 返回空 dict。
268
+ def key_line_spans(text: str) -> dict:
269
+ """节点文件原文 → `{键: (1-based 行号, [start, end))}`。
270
+
271
+ 只认**无 `#` 前缀**且含 `:` 的行——即 frontmatter 行;`---` 分隔线无冒号,
272
+ 自然被排除。同键取首次出现。
273
+ """
274
+ out, pos = {}, 0
275
+ for i, line in enumerate((text or "").split("\n")):
276
+ s = line.strip()
277
+ if s and not s.startswith("#") and ":" in s:
278
+ k = s.split(":", 1)[0].strip()
279
+ if k and k not in out:
280
+ out[k] = (i + 1, [pos, pos + len(line)])
281
+ pos += len(line) + 1
282
+ return out
283
+
284
+
285
+ # 生效条件:index 为 dict 时其 "nodes" 为 dict 则返回 index["nodes"],否则返回 index 本身;index 为 None/非 dict 时调 CF.load_index(root),抛 OSError 或 ValueError → 返回 {},返回值为 dict 且其 "nodes" 为 dict → 返回该 "nodes",是 dict → 原样返回,否则返回 {}。
286
+ def _index(root, index=None) -> dict:
287
+ """索引节点表 `{node_id: meta}`(兼容 load_index 的 `{"nodes": …}` 形态)。"""
288
+ if isinstance(index, dict):
289
+ return index.get("nodes") if isinstance(index.get("nodes"), dict) else index
290
+ try:
291
+ idx = CF.load_index(root)
292
+ except (OSError, ValueError):
293
+ return {}
294
+ if isinstance(idx, dict) and isinstance(idx.get("nodes"), dict):
295
+ return idx["nodes"]
296
+ return idx if isinstance(idx, dict) else {}
297
+
298
+
299
+ # 生效条件:_index(root, index) 中 node_id 对应值非 dict → 返回 None;否则用 meta.get("path")(绝对路径直接用,否则 join(root, str(rel or "")))读文件——OSError 时返回 content/text 为 None、fm 为 {} 的 dict,成功则把 NF.loads(text) 得到的 content 与 fm(假值 → {})连同 meta/path/text 一并返回。
300
+ def load_node(node_id, root, *, index=None) -> dict:
301
+ """读一个节点(索引 meta + 文件 frontmatter + 正文原文)。
302
+
303
+ → `{"node_id","meta","fm","content","text","path"}`;索引无此项 → `None`。
304
+ `meta` 是**索引快照**(含索引侧 content_hash,矛盾判定要用),`fm` 是**文件真源**。
305
+ """
306
+ nodes = _index(root, index)
307
+ meta = nodes.get(node_id)
308
+ if not isinstance(meta, dict):
309
+ return None
310
+ rel = meta.get("path")
311
+ fp = rel if (rel and os.path.isabs(str(rel))) else os.path.join(root, str(rel or ""))
312
+ try:
313
+ with open(fp, encoding="utf-8") as f:
314
+ text = f.read()
315
+ except (OSError, UnicodeDecodeError):
316
+ return {"node_id": node_id, "meta": dict(meta), "fm": {}, "content": None,
317
+ "text": None, "path": fp}
318
+ fm, content = NF.loads(text)
319
+ return {"node_id": node_id, "meta": dict(meta), "fm": fm or {}, "content": content,
320
+ "text": text, "path": fp}
321
+
322
+
323
+ # 生效条件:span 为 None → 返回 "";否则取 (text or "")[span[0]:span[1]] 去空白并把换行替换为 "⏎",长度超 SNIPPET_MAX 时截断并追加 "…"。
324
+ def _snippet(text, span) -> str:
325
+ """命中片段(供人工核对肉眼确认「指的是不是这一句」)。"""
326
+ if span is None:
327
+ return ""
328
+ seg = (text or "")[span[0]:span[1]].strip().replace("\n", "⏎")
329
+ return seg[:SNIPPET_MAX] + ("…" if len(seg) > SNIPPET_MAX else "")
330
+
331
+
332
+ # 生效条件:任意 node_id/kind/field/span/evidence 均原样写入返回 dict 的 node_id/issue_kind/field/span/evidence 键,可选 rule/line/sentence/snippet/peer/cause/severity 未传时为 None、status 未传时为 "located",不做任何校验。
333
+ def _hit(node_id, kind, field, span, evidence, *, rule=None, line=None,
334
+ sentence=None, snippet=None, peer=None, cause=None, status="located",
335
+ severity=None) -> dict:
336
+ """命中行(四键契约 + 增强键)。
337
+
338
+ `severity` 是**观测面专用**的等级标注(`ADVISORY_KINDS` 命中带 `"info"`):
339
+ 问题面命中不带(问题即问题,无等级可降);本键让下游一眼分清「这是观测
340
+ 副产品」与「这是待修的问题」,不必靠 issue_kind 名字去猜。
341
+ """
342
+ return {"node_id": node_id, "field": field, "span": span, "issue_kind": kind,
343
+ "evidence": evidence, "rule": rule, "line": line, "sentence": sentence,
344
+ "snippet": snippet, "peer": peer, "cause": cause, "status": status,
345
+ "severity": severity}
346
+
347
+
348
+ # 生效条件:text 为真值、span 与 content 均非 None 且 text.find(content)>=0 时,返回 text.count("\n",0,min(off+span[0],len(text)))+1 的 1-based 行号;text 假值或 span/content 为 None 或 content 未找到时返回 None。
349
+ def _line_of(text, content, span):
350
+ """正文区间 → 节点文件原文的 1-based 行号(供人工核对直接跳文件)。"""
351
+ if not text or span is None or content is None:
352
+ return None
353
+ off = text.find(content)
354
+ if off < 0:
355
+ return None
356
+ return text.count("\n", 0, min(off + span[0], len(text))) + 1
357
+
358
+
359
+ # ---------------------------- 定位器注册表 ----------------------------
360
+ #
361
+ # 每个定位器是**纯函数**:只吃 (node_id, meta, content, ctx),只吐 hits。
362
+ # 新增判据 = 加函数 + 注册,不改 locate 主流程(与 M1「引擎冻结、规则可增删」同构)。
363
+ # ctx = {"fm", "text", "root", "index", "peers", "now"}
364
+
365
+ # 生效条件:在 node_id/meta/content/ctx 下,对 FM_SCAN_FIELDS 中除 verification_basis、condition_space 外且 _layer_ok(f,scope,meta) 为真的字段,若 meta.get(f) 与 ctx.get("fm") 或 {} 中的同名字段皆 _blank 则记 field_absent;对过 _layer_ok 且 _as_int(meta.get("evidence_count"))==0 记 evidence_zero;对 meta.get("importance") 非 None 且 _as_float 为 None 或不在 [0.0,1.0] 记 field_invalid;对 condition_space 经 meta 或回落 ctx.get("fm") 后 NF.condition_space_missing 非空记 condition_slots;对正文缺 NF.CCG_MARKS 行记 ccg_incomplete,返回这些命中列表。
366
+ def _loc_missing_field(node_id, meta, content, ctx):
367
+ """frontmatter/正文结构字段为空(判据与 M1 `field_absent`/`evidence_zero` 同源)。
368
+
369
+ **层门限**:限层的字段(如 `role`/`evidence_count` 限 `knowledge`)只在
370
+ 该层节点上检查——与 M1 `_scope` 同口径,否则 M1 不报的问题会被 M3 越层报出。
371
+ """
372
+ fm = ctx.get("fm") or {}
373
+ scope = ctx.get("field_layers")
374
+ if scope is None:
375
+ scope = field_layer_scope()
376
+ lines = key_line_spans(ctx.get("text") or "")
377
+ marks = mark_spans(content or "")
378
+ hits = []
379
+
380
+ for f in FM_SCAN_FIELDS:
381
+ if f in ("verification_basis", "condition_space"):
382
+ continue # 基底空属 weak_source;四槽缺失单独报(要点名缺哪几槽)
383
+ if not _layer_ok(f, scope, meta):
384
+ continue # 越层不报(层门限真源 = M1 规则库 matcher.layer)
385
+ if _blank(meta.get(f)) and _blank(fm.get(f)):
386
+ hits.append(_hit(node_id, "missing_field", f, None,
387
+ "字段 %s 为空(索引与文件两处皆空)" % f,
388
+ rule="field_absent",
389
+ line=(lines.get(f) or (None, None))[0]))
390
+
391
+ if _layer_ok("evidence_count", scope, meta) \
392
+ and _as_int(meta.get("evidence_count")) == 0:
393
+ hits.append(_hit(node_id, "missing_field", "evidence_count", None,
394
+ "evidence_count=0(无验证证据计数)", rule="evidence_zero",
395
+ line=(lines.get("evidence_count") or (None, None))[0]))
396
+
397
+ imp = meta.get("importance")
398
+ if imp is not None:
399
+ fv = _as_float(imp)
400
+ if fv is None or not 0.0 <= fv <= 1.0:
401
+ hits.append(_hit(node_id, "missing_field", "importance", None,
402
+ "importance=%r 不在 [0,1](字段存在但不可用)"
403
+ % (imp,), rule="field_invalid",
404
+ line=(lines.get("importance") or (None, None))[0]))
405
+
406
+ cs = meta.get("condition_space")
407
+ if not isinstance(cs, dict):
408
+ cs = fm.get("condition_space")
409
+ miss = NF.condition_space_missing(cs)
410
+ if miss:
411
+ span = marks.get("生效条件")
412
+ hits.append(_hit(node_id, "missing_field", "condition_space", span,
413
+ "条件空间缺槽 %s(%d/4 已声明)——四槽不全不构成生效条件"
414
+ % ("/".join(miss), len(NF.CONDITION_SLOTS) - len(miss)),
415
+ rule="condition_slots",
416
+ snippet=_snippet(content, span)))
417
+
418
+ # 正文 CCG 要素缺行:行不存在 → 无字符区间可指(span=None),点名缺哪几行
419
+ missing_marks = [m for m in NF.CCG_MARKS if m not in marks]
420
+ if missing_marks:
421
+ hits.append(_hit(node_id, "missing_field", "content", None,
422
+ "正文缺 CCG 要素行 %s(# 要素名:值)——缺声明即缺证据"
423
+ % "/".join(missing_marks), rule="ccg_incomplete"))
424
+ return hits
425
+
426
+
427
+ # 生效条件:meta.get("verification_basis") 为空时回落 ctx.get("fm") 或 {} 的 verification_basis,若两者皆 _blank 返回 basis_absent 命中;非空但 str(basis) 不在 NF.VERIFICATION_BASIS 返回 basis_enum 命中;在枚举内时按 CC.classify_track 依 meta.get("layer")、meta.get("tags") 与 content 判赛道,若 CC.basis_licensed 为假返回 basis_licensed 命中;否则返回 []。
428
+ def _loc_weak_source(node_id, meta, content, ctx):
429
+ """验证基底缺失/越枚举/与赛道不相容(与 M1 `basis_licensed` 判据逐字同源)。"""
430
+ fm = ctx.get("fm") or {}
431
+ basis = meta.get("verification_basis")
432
+ if _blank(basis):
433
+ basis = fm.get("verification_basis")
434
+ _ln = key_line_spans(ctx.get("text") or "").get("verification_basis")
435
+ ln = (_ln or (None, None))[0]
436
+
437
+ if _blank(basis):
438
+ return [_hit(node_id, "weak_source", "verification_basis", None,
439
+ "verification_basis 为空——无验证基底的断言不可裁决",
440
+ rule="basis_absent", line=ln)]
441
+ if str(basis) not in NF.VERIFICATION_BASIS:
442
+ return [_hit(node_id, "weak_source", "verification_basis", None,
443
+ "基底 %s 不在合法枚举(%s)"
444
+ % (basis, "/".join(NF.VERIFICATION_BASIS)),
445
+ rule="basis_enum", line=ln)]
446
+ track = CC.classify_track({"layer": meta.get("layer"),
447
+ "tags": meta.get("tags") or []}, content or "")
448
+ if not CC.basis_licensed(track, basis):
449
+ allow = "/".join(CC.allowed_basis(track)) or "—"
450
+ return [_hit(node_id, "weak_source", "verification_basis", None,
451
+ "赛道 %s(政策 %s)不允许基底 %s;允许 %s"
452
+ % (track, CC.source_policy(track) or "—", basis, allow),
453
+ rule="basis_licensed", line=ln)]
454
+ return []
455
+
456
+
457
+ # 生效条件:ctx.get("fm") 或 {} 中 code_ref 或 doc_ref 为非空 dict 且 RI.probe_ref(ref) 返回的 status 属于 _REF_DEAD_STATUSES(dangling 或 stale)时,返回对应 stale 命中(dangling 归因载体消失、stale 归因区间哈希不符);否则返回 []。
458
+ def _loc_stale(node_id, meta, content, ctx):
459
+ """**依赖存在性**——声明的载体(源文件)已不存在 / 已漂移(真正的适用边界越出)。
460
+
461
+ 知识的真值挂在它描述的对象上:代码知识挂在源文件的符号上,源没了或改了,
462
+ 知识才真的不再成立。判据与 `refindex` **同源**(`probe_ref`,不另立一份):
463
+
464
+ ============== ====================================== ==========
465
+ probe_ref 态 含义 本判据
466
+ ============== ====================================== ==========
467
+ ``ok`` 源文件在、区间哈希匹配 不判
468
+ ``stale`` 源文件在、区间哈希不符(源被改,漂移) **stale**
469
+ ``dangling`` 源文件不存在(载体消失) **stale**
470
+ ``unresolved`` 拿不到 root(判不了) 不判(不猜)
471
+ ``error`` 读盘失败 不判(不猜)
472
+ ============== ====================================== ==========
473
+
474
+ 后两态是**观测手段不足**,不是「依赖已失效」——按「不猜」纪律如实不报。
475
+
476
+ **时间窗不在此处判**(2026-09-16 修正的原缺陷):`condition_space.time_window`
477
+ 是写入端**观测时刻**栏(`mdcg.add` 未给时自动填「写入时刻 +1h」,见其
478
+ `OBSERVATION_WINDOW_SEC`),不是知识的有效期——拿它判「适用边界越出」,
479
+ 等于把「这条记忆写入超过 1 小时」冒充为「失效」。真实适用前提由知识自己
480
+ 声明在 `code_ref`/`doc_ref` 上,故改由依赖存在性裁决;观测时刻本身不丢,
481
+ 降级为 `observation_aged`(观测面,见 `ADVISORY_KINDS`)。
482
+ """
483
+ fm = ctx.get("fm") or {}
484
+ hits = []
485
+ for key in ("code_ref", "doc_ref"):
486
+ ref = fm.get(key)
487
+ if not isinstance(ref, dict) or not ref:
488
+ continue
489
+ # root 基准必须取自 ref 自身(`_code_ref`/`_doc_ref` 落的是**源大域** root,
490
+ # path 相对它);`ctx["root"]` 是**认知图** root——拿它去拼会把每一条依赖
491
+ # 都误判成悬空。ref 无 root(旧节点)时 probe 返回 `unresolved` → 不判。
492
+ probe = RI.probe_ref(ref)
493
+ st = str(probe.get("status") or "")
494
+ if st not in _REF_DEAD_STATUSES:
495
+ continue
496
+ rel = str(ref.get("path") or "?")
497
+ if st == "dangling":
498
+ ev = ("依赖的源文件已不存在(%s:%s)——知识所指的载体消失,适用边界越出"
499
+ % (key, rel))
500
+ else:
501
+ ev = ("依赖的源文件已漂移(%s:%s):索引区间哈希 %s ≠ 现算 %s——"
502
+ "源被改动,知识所指的符号可能已不是原物"
503
+ % (key, rel, probe.get("hash_expected"), probe.get("hash")))
504
+ hits.append(_hit(node_id, "stale", key, None, ev, rule="ref_" + st))
505
+ return hits
506
+
507
+
508
+ # 生效条件:从 meta.get("condition_space") 或回落 ctx.get("fm") 的 condition_space(须为 dict)取 time_window,缺则取 meta.get("time_window"),若 NF.is_full_time_window(tw) 或 float(tw[1]) 抛 TypeError/ValueError/IndexError/KeyError 或 ctx.get("now") 为 None 或 hi>=float(now) 则返回 [];否则返回一条 severity="info" 的 observation_aged 命中。
509
+ def _loc_observation_aged(node_id, meta, content, ctx):
510
+ """时间窗已过——**这是观测时刻,不是失效声明**(观测面,不进告警面)。
511
+
512
+ 时间窗来源链与 `_loc_missing_field` 的槽检查同构:`meta.condition_space`
513
+ (显式注入面)→ `fm.condition_space`(文件真源)→ `meta.time_window`
514
+ (索引快照字段)。**索引快照只透传 `time_window`**(`mdcg.py` `_stage` 口径:
515
+ 时空字段入快照、condition_space 整块不入),故第三跳必留。
516
+
517
+ **不进默认全量**(不在 `ISSUE_KINDS`):写入端未给 time_window 时以写入时刻
518
+ 自动填 1 小时窗,故真库「已过期」绝大多数是「写入超过 1 小时」,与知识是否
519
+ 失效无关。观测时刻本身仍如实报(审计有用),只是**不冒充问题**——命中带
520
+ `severity="info"` 标记它是咨询级。
521
+ """
522
+ fm = ctx.get("fm") or {}
523
+ cs = meta.get("condition_space")
524
+ if not isinstance(cs, dict):
525
+ csf = fm.get("condition_space")
526
+ cs = csf if isinstance(csf, dict) else None
527
+ tw = (cs or {}).get("time_window")
528
+ if tw is None:
529
+ tw = meta.get("time_window")
530
+ if NF.is_full_time_window(tw):
531
+ return [] # 全时窗是**合法声明**(任意时刻成立),不判
532
+ try:
533
+ hi = float(tw[1])
534
+ except (TypeError, ValueError, IndexError, KeyError):
535
+ return []
536
+ now = ctx.get("now")
537
+ if now is None or hi >= float(now):
538
+ return []
539
+ span = mark_spans(content or "").get("生效条件")
540
+ return [_hit(node_id, "observation_aged", "condition_space", span,
541
+ "观测时间窗 %s 已过(hi=%.0f < now=%.0f)——这是**观测时刻**,"
542
+ "不是失效声明(知识不因观测过去而失效);时效判定见 stale"
543
+ % (NF.time_window_text(tw) or "?", hi, float(now)),
544
+ rule="observation_window_passed", severity="info",
545
+ line=_line_of(ctx.get("text"), content, span),
546
+ snippet=_snippet(content, span))]
547
+
548
+
549
+ # 生效条件:h 取 str(meta.get("content_hash") or "").strip(),若 _blank(h) 则 h=NF.content_hash(content 或 "");对 ctx.get("peers") 或 [] 中 node_id 不等于本节点且 ph=str(p.get("hash") or "") 或回落 NF.content_hash(p.get("content") or "") 后非空且等于 h 的 peer 计入 matched;matched 非空时返回一条 dup 命中(span=[0,len(body)]),否则返回 []。
550
+ def _loc_dup(node_id, meta, content, ctx):
551
+ """同组同内容指纹(与 M1 `dup_hash_group` 同判据;D1 名 `dup`)。"""
552
+ body = content if content is not None else ""
553
+ h = str(meta.get("content_hash") or "").strip()
554
+ if _blank(h):
555
+ h = NF.content_hash(body) # 索引无指纹 → 用正文实算(诚实标注来源)
556
+ matched = []
557
+ for p in ctx.get("peers") or []:
558
+ if p.get("node_id") == node_id:
559
+ continue
560
+ ph = str(p.get("hash") or "") or NF.content_hash(p.get("content") or "")
561
+ if ph and ph == h:
562
+ matched.append(p)
563
+ if not matched:
564
+ return []
565
+ span = [0, len(body)]
566
+ return [_hit(node_id, "dup", "content_hash", span,
567
+ "与 %s 同内容指纹 %s(同类共 %d 条),整篇正文重复"
568
+ % (matched[0].get("node_id"), h, len(matched) + 1),
569
+ rule="dup_hash_group", peer=matched[0].get("node_id"),
570
+ snippet=_snippet(body, span))]
571
+
572
+
573
+ # 生效条件:对 ctx.get("peers") 或 [] 中每个非自身 peer,按 sentence_spans 对齐 content 与 peer content 的句子,当同一句位上去数字骨架相同(WL._skeleton(seg) 非空、长度 ≥ WL.MIN_SKELETON 且等于 peer 骨架)且 seg.strip() != ptext.strip() 的句子数达到 MIN_FLOW_SENTENCES 时,为这些句各返回一条 template_flow 命中;否则返回 []。
574
+ def _loc_template_flow(node_id, meta, content, ctx):
575
+ """同模板流水:与同组节点逐句「去数字骨架相同、字面不同」→ 指向那些句。
576
+
577
+ 与 M1 `template_flow_digits_only` 同判据(都走 `writelimit._skeleton`),
578
+ 差别只在产物:M1 给一条条目级 issue,D1 给出**具体是哪几句**(span + 句索引)。
579
+ 单句偶合不算流水 → 需同组至少 `MIN_FLOW_SENTENCES` 句同时成立。
580
+ """
581
+ tgt = sentence_spans(content or "")
582
+ hits = []
583
+ for p in ctx.get("peers") or []:
584
+ if p.get("node_id") == node_id:
585
+ continue
586
+ pseg = sentence_spans(p.get("content") or "")
587
+ same = []
588
+ for (i, s, e, seg) in tgt:
589
+ if i >= len(pseg):
590
+ break
591
+ ptext = pseg[i][3]
592
+ sk = WL._skeleton(seg)
593
+ if not sk or len(sk) < WL.MIN_SKELETON or sk != WL._skeleton(ptext):
594
+ continue
595
+ if seg.strip() == ptext.strip():
596
+ continue # 字面全同属整篇重复(dup),不是「只换数字」的流水
597
+ same.append((i, s, e, seg, sk))
598
+ if len(same) < MIN_FLOW_SENTENCES:
599
+ continue
600
+ for (i, s, e, seg, sk) in same:
601
+ hits.append(_hit(node_id, "template_flow", "content", [s, e],
602
+ "同模板流水(与 %s 第 %d 句去数字骨架相同、仅字面数值不同):%s"
603
+ % (p.get("node_id"), i, sk[:40]),
604
+ rule="template_flow_digits_only", sentence=i,
605
+ peer=p.get("node_id"),
606
+ line=_line_of(ctx.get("text"), content, [s, e]),
607
+ snippet=seg.strip()[:SNIPPET_MAX]))
608
+ return hits
609
+
610
+
611
+ # 生效条件:meta.get("content_hash") 非 _blank 且 content 非 None 且 h != NF.content_hash(content) 时,返回一条 hash_declared_vs_actual 的 contradiction 命中(cause 由 hash_mismatch_cause 依 meta/ctx.get("root")/ctx.get("path") 判);ctx.get("fm") 或 {} 的 id 非 _blank 且 str(fm_id) != str(node_id) 时额外返回一条 id_declared_vs_index 命中;两者皆不成立返回 []。
612
+ def _loc_contradiction(node_id, meta, content, ctx):
613
+ """**确定性**矛盾:声明与事实不符(指纹 / 标识)。
614
+
615
+ 语义级矛盾(正文自相矛盾)不在此处——那是 LLM 的活,D1 不猜(见 `SEMANTIC_ONLY`)。
616
+ 指纹不一致**必须带成因**(`cause`):`index_lag`(快照滞后,属正常写路径现象,
617
+ 复核者无需修数据)与 `true_mismatch`(真不一致,需查)处置完全不同。
618
+ """
619
+ hits = []
620
+ lines = key_line_spans(ctx.get("text") or "")
621
+ h = str(meta.get("content_hash") or "").strip()
622
+ if not _blank(h) and content is not None:
623
+ actual = NF.content_hash(content)
624
+ if h != actual:
625
+ cause, note = hash_mismatch_cause(meta, root=ctx.get("root"),
626
+ path=ctx.get("path"))
627
+ hits.append(_hit(node_id, "contradiction", "content_hash", None,
628
+ "索引声明指纹 %s ≠ 正文实算 %s(%s)"
629
+ % (h, actual, note), rule="hash_declared_vs_actual",
630
+ cause=cause,
631
+ line=(lines.get("content_hash") or (None, None))[0]))
632
+ fm_id = (ctx.get("fm") or {}).get("id")
633
+ if not _blank(fm_id) and str(fm_id) != str(node_id):
634
+ hits.append(_hit(node_id, "contradiction", "id", None,
635
+ "文件 frontmatter id=%s ≠ 索引键 %s" % (fm_id, node_id),
636
+ rule="id_declared_vs_index",
637
+ line=(lines.get("id") or (None, None))[0]))
638
+ return hits
639
+
640
+
641
+ LOCATORS = {
642
+ "missing_field": _loc_missing_field,
643
+ "weak_source": _loc_weak_source,
644
+ "stale": _loc_stale,
645
+ "observation_aged": _loc_observation_aged,
646
+ "dup": _loc_dup,
647
+ "template_flow": _loc_template_flow,
648
+ "contradiction": _loc_contradiction,
649
+ }
650
+
651
+ #: D1 **不定位**的判定:属语义层,交回 LLM 意见(不猜 = 不编造字符区间)
652
+ SEMANTIC_ONLY = {
653
+ "contradiction_semantic": "正文自相矛盾属语义判定;D1 只做确定性矛盾"
654
+ "(索引指纹 / 标识与事实不符)",
655
+ }
656
+
657
+
658
+ # 生效条件:始终返回 SEMANTIC_ONLY 中以 str(kind or "").strip() 为键查得的值,缺键时返回空串(空串表示可定位)。
659
+ def blindspot_reason(kind) -> str:
660
+ """D1 拒绝定位的类别 → 理由(空串表示可定位)。"""
661
+ return SEMANTIC_ONLY.get(str(kind or "").strip(), "")
662
+
663
+
664
+ # ---------------------------- 主入口 ----------------------------
665
+
666
+ # 生效条件:items 中每项按 content=it.get("content") or ""、hash=str(it.get("hash") or "").strip() 或回落 NF.content_hash(content)、sk=WL.template_signature(content) or "" 预处理后,返回 {node_id: [同 hash 或同非空 sk 的其他 peer]};items 为空/None 返回空 dict。
667
+ def build_peers(items) -> dict:
668
+ """`[{node_id, content, hash?, …}]` → `{node_id: [peer, …]}`。
669
+
670
+ 只有**同内容指纹**或**同模板骨架**才互为对照——不是「同一批就是一组」。
671
+ 组的作用域由调用方给定(批 / 包),与 M1 机械层「组 = 同一个包」的口径一致。
672
+ """
673
+ prep = []
674
+ for it in items or []:
675
+ c = it.get("content") or ""
676
+ prep.append({"node_id": it.get("node_id"), "content": c, "meta": it.get("meta"),
677
+ "text": it.get("text"), "fm": it.get("fm"),
678
+ "hash": str(it.get("hash") or "").strip() or NF.content_hash(c),
679
+ "sk": WL.template_signature(c) or ""})
680
+ by_hash, by_sk = {}, {}
681
+ for p in prep:
682
+ by_hash.setdefault(p["hash"], []).append(p)
683
+ if p["sk"]:
684
+ by_sk.setdefault(p["sk"], []).append(p)
685
+ out = {}
686
+ for p in prep:
687
+ grp = {q["node_id"]: q for q in by_hash.get(p["hash"], [])
688
+ if q["node_id"] != p["node_id"]}
689
+ for q in (by_sk.get(p["sk"], []) if p["sk"] else []):
690
+ if q["node_id"] != p["node_id"]:
691
+ grp.setdefault(q["node_id"], q)
692
+ out[p["node_id"]] = list(grp.values())
693
+ return out
694
+
695
+
696
+ # 生效条件:对 issue_hint(None/str/dict 或其 list/tuple)逐 hint 分类,返回 (kinds, fields, blind):能 canonical_kind 到 ISSUE_KINDS 或 ADVISORY_KINDS 的入 kinds,blindspot_reason 非空的入 blind,其余非空 kind 与 field 入 fields;issue_hint 为 None 时 kinds/fields 为空集、blind 为空列表。
697
+ def _norm_hint(issue_hint):
698
+ """issue_hint → `(kinds, fields, blindspot)`。
699
+
700
+ 形态:`None`(全量)|str(issue_kind 或 field)|dict(issue_kind/field)
701
+ |上述的 list。
702
+ """
703
+ kinds, fields, blind = set(), set(), []
704
+ hints = issue_hint if isinstance(issue_hint, (list, tuple)) else [issue_hint]
705
+ for h in hints:
706
+ if h is None:
707
+ continue
708
+ if isinstance(h, dict):
709
+ s = h.get("issue_kind") or h.get("kind") or ""
710
+ f = h.get("field")
711
+ else:
712
+ s, f = str(h).strip(), None
713
+ if s:
714
+ why = blindspot_reason(s)
715
+ if why:
716
+ blind.append("%s:%s" % (s, why))
717
+ else:
718
+ ck = canonical_kind(s)
719
+ if ck in ISSUE_KINDS or ck in ADVISORY_KINDS:
720
+ kinds.add(ck)
721
+ else:
722
+ fields.add(s) # 不是类别 → 当作字段过滤
723
+ if f:
724
+ fields.add(str(f).strip())
725
+ return kinds, fields, blind
726
+
727
+
728
+ # 生效条件:当 meta 与 content 均非 None 时不读盘;否则 root 为 None 抛 ValueError,经 load_node 读不到节点返回 {"hits": [], "blindspot": blind+["节点 %s 不在索引"%node_id], "load": None};读到时补 meta/content/text/fm/path,按 kinds 非空时只跑 sorted(kinds)、否则 fields 非空或 issue_hint 为 None 时跑 sorted(ISSUE_KINDS)、否则 run=[] 执行 LOCATORS,对命中按 fields 过滤、补 line 并排序后返回 {"hits": hits, "blindspot": blind, "load": {...}}。
729
+ def locate_ex(node_id, issue_hint=None, *, meta=None, content=None, fm=None, text=None,
730
+ root=None, index=None, peers=None, now=None, path=None,
731
+ field_layers=None) -> dict:
732
+ """D1 定位(完整返回):`{"hits": [...], "blindspot": [...], "load": {...}}`。
733
+
734
+ `meta`/`content` 显式给出则**不读盘**(纯函数用法——测试与批量复用都走这条);
735
+ 否则 `root` 必填,经 `load_node` 从索引+文件取。返回的 hits 已按
736
+ `(issue_kind, field, span起点, peer)` 排序,**确定性可复算**。
737
+
738
+ `path`(节点文件绝对路径——供 `contradiction` 判成因)、`field_layers`
739
+ (字段层门限,缺省 `field_layer_scope()`)可显式注入,便于纯函数测试。
740
+ """
741
+ kinds, fields, blind = _norm_hint(issue_hint)
742
+ if meta is None or content is None:
743
+ if root is None:
744
+ raise ValueError("locate 需要 meta+content,或给出 root 以便读节点")
745
+ nd = load_node(node_id, root, index=index)
746
+ if nd is None:
747
+ return {"hits": [], "blindspot": blind + ["节点 %s 不在索引" % node_id],
748
+ "load": None}
749
+ if meta is None:
750
+ meta = nd["meta"]
751
+ if content is None:
752
+ content = nd["content"]
753
+ if text is None:
754
+ text = nd["text"]
755
+ if fm is None:
756
+ fm = nd["fm"]
757
+ if path is None:
758
+ path = nd.get("path")
759
+ meta = meta or {}
760
+ ctx = {"fm": fm or {}, "text": text, "root": root, "index": index,
761
+ "peers": peers or [], "now": time.time() if now is None else float(now),
762
+ "path": path, "field_layers": field_layers}
763
+ hits = []
764
+ # 定位范围:显式类别 → 只跑该类;给出字段 → 全量再由字段收窄;
765
+ # 无提示 → 全量。**提示全部落 blindspot 时范围为空**——不借机报别的类
766
+ # (否则「给了语义提示」会顺手退回全量,与「不猜」纪律相悖)。
767
+ if kinds:
768
+ run = sorted(kinds)
769
+ elif fields or issue_hint is None:
770
+ run = sorted(ISSUE_KINDS)
771
+ else:
772
+ run = []
773
+ for k in run:
774
+ fn = LOCATORS.get(k)
775
+ if fn is None:
776
+ continue
777
+ for h in fn(node_id, meta, content, ctx):
778
+ if fields and h.get("field") not in fields:
779
+ continue
780
+ if h.get("line") is None and h.get("span") is not None:
781
+ h["line"] = _line_of(text, content, h["span"])
782
+ hits.append(h)
783
+ hits.sort(key=lambda h: (h["issue_kind"], str(h.get("field") or ""),
784
+ -1 if h.get("span") is None else h["span"][0],
785
+ str(h.get("peer") or "")))
786
+ return {"hits": hits, "blindspot": blind,
787
+ "load": {"node_id": node_id, "meta": meta,
788
+ "content_len": len(content or "")}}
789
+
790
+
791
+ # 生效条件:给定 node_id(必填)与可选 issue_hint 及 kw 后,直接返回 locate_ex(node_id, issue_hint, **kw) 结果的 "hits" 列表。
792
+ def locate(node_id, issue_hint=None, **kw) -> list:
793
+ """**D1 契约入口**:`locate(node_id, issue_hint) -> [{field, span, issue_kind, evidence}]`。"""
794
+ return locate_ex(node_id, issue_hint, **kw)["hits"]
795
+
796
+
797
+ # 生效条件:给定 hits 与 key 后,返回 hits 中每个 h.get(key) 字符串化取值到出现次数的字典(键升序);hits 为 None/空时返回空 dict。
798
+ def _counts(hits, key) -> dict:
799
+ out = {}
800
+ for h in hits or []:
801
+ k = h.get(key)
802
+ out[str(k)] = out.get(str(k), 0) + 1
803
+ return dict(sorted(out.items()))
804
+
805
+
806
+ # 生效条件:items 显式给出时不读盘;items 为 None 时 root 为 None 抛 ValueError,否则按 node_ids 逐节点 load_node 组装 items(读不到的记入 missing);随后对每个 item 调 locate_ex 汇总 hits 或 clean,并返回含 nodes/hits/by_kind/by_field/by_rule/clean/missing 的 dict。
807
+ def locate_many(node_ids=None, *, root=None, index=None, items=None,
808
+ issue_hint=None, now=None) -> dict:
809
+ """批量定位:**同一批内**互为对照(`dup` / `template_flow` 的组 = 本批)。
810
+
811
+ `items` 显式给出 `[{node_id, content, meta?, text?, fm?, hash?}]` 则不再读盘。
812
+ 返回 `{nodes, hits, by_kind, by_field, clean, missing}`;`clean` 是**无命中**的节点、
813
+ `missing` 是**读不到**的节点——两者分开报(「没问题」≠「没看」)。
814
+ """
815
+ missing = []
816
+ if items is None:
817
+ if root is None:
818
+ raise ValueError("locate_many 需要 root(读盘)或 items(显式给出)")
819
+ items = []
820
+ for nid in node_ids or []:
821
+ nd = load_node(nid, root, index=index)
822
+ if nd is None:
823
+ missing.append(nid)
824
+ continue
825
+ items.append({"node_id": nid, "content": nd["content"] or "",
826
+ "text": nd["text"], "fm": nd["fm"], "meta": nd["meta"],
827
+ "path": nd.get("path"),
828
+ "hash": nd["meta"].get("content_hash")})
829
+ peers = build_peers(items)
830
+ now = time.time() if now is None else float(now)
831
+ hits, clean = [], []
832
+ for it in items:
833
+ nid = it["node_id"]
834
+ ex = locate_ex(nid, issue_hint, meta=it.get("meta") or {},
835
+ content=it.get("content") or "", fm=it.get("fm"),
836
+ text=it.get("text"), peers=peers.get(nid) or [], now=now,
837
+ root=root, path=it.get("path"))
838
+ if ex["hits"]:
839
+ hits.extend(ex["hits"])
840
+ else:
841
+ clean.append(nid)
842
+ hits.sort(key=lambda h: (str(h.get("node_id")), h["issue_kind"],
843
+ str(h.get("field") or ""),
844
+ -1 if h.get("span") is None else h["span"][0]))
845
+ return {"nodes": len(items), "hits": hits, "by_kind": _counts(hits, "issue_kind"),
846
+ "by_field": _counts(hits, "field"), "by_rule": _counts(hits, "rule"),
847
+ "clean": clean, "missing": missing}
848
+
849
+
850
+ # 生效条件:从 pkg.get("entries") or [] 取条目并跳过 e.get("node_id") 为空者,root 非 None 时逐个 load_node 取正文,取不到时回落 e.get("excerpt") or "",组装 items 调 locate_many 后返回其结果并附加 bundle_id 与 entries 数量;pkg 为 None 时 entries 为空列表。
851
+ def locate_package(pkg, *, root=None, index=None, issue_hint=None, now=None) -> dict:
852
+ """M1 包 → 定位汇总(组的作用域 = 本包,与 M1 机械层同口径)。
853
+
854
+ 正文优先读盘(准确);文件不可读时退回包内 `excerpt`(可能截断——宁可降级也不
855
+ 假装读到了全文,`missing` 会如实记下读不到的节点)。
856
+ """
857
+ entries = (pkg or {}).get("entries") or []
858
+ items = []
859
+ for e in entries:
860
+ nid = e.get("node_id")
861
+ if not nid:
862
+ continue
863
+ nd = load_node(nid, root, index=index) if root else None
864
+ body = (nd or {}).get("content")
865
+ items.append({"node_id": nid,
866
+ "content": body if body is not None else (e.get("excerpt") or ""),
867
+ "text": (nd or {}).get("text"), "fm": (nd or {}).get("fm"),
868
+ "meta": (nd or {}).get("meta") or e,
869
+ "path": (nd or {}).get("path") or e.get("path"),
870
+ "hash": ((nd or {}).get("meta") or {}).get("content_hash")
871
+ or e.get("content_hash")})
872
+ out = locate_many(items=items, issue_hint=issue_hint, now=now)
873
+ out["bundle_id"] = (pkg or {}).get("bundle_id")
874
+ out["entries"] = len(entries)
875
+ return out
876
+
877
+
878
+ # 生效条件:给定 hits 后返回 total=len(hits or [])、去重 node_id 数、排序后的 node_ids、以及 by_kind/by_field/by_rule 计数;hits 为 None/空时 total=0、nodes=0、node_ids=[]。
879
+ def summary(hits) -> dict:
880
+ """命中汇总(审计留痕用)。"""
881
+ nodes = sorted({str(h.get("node_id")) for h in hits or []})
882
+ return {"total": len(hits or []), "nodes": len(nodes), "node_ids": nodes,
883
+ "by_kind": _counts(hits, "issue_kind"), "by_field": _counts(hits, "field"),
884
+ "by_rule": _counts(hits, "rule")}
885
+
886
+
887
+ # 生效条件:给定 hits 后逐条生成 Markdown 行并返回表头加各行:field/line/snippet 取 h.get(...) or "—"(假值回落 "—"),span 为 None 时显示 "—" 否则 "起-止",evidence 取 (h.get("evidence") or "").replace("|","\\|")(假值回落空串)。
888
+ def markdown_table(hits) -> str:
889
+ """人工核对清单:每行一条命中,末列留空供核对者填判定(D1 验收抽样用)。"""
890
+ head = ("| # | node_id | issue_kind | field | span | line | 片段 | evidence | 人工判定 |\n"
891
+ "|---|---|---|---|---|---|---|---|---|\n")
892
+ rows = []
893
+ for i, h in enumerate(hits or [], 1):
894
+ sp = "—" if h.get("span") is None else "%d-%d" % (h["span"][0], h["span"][1])
895
+ rows.append("| %d | %s | %s | %s | %s | %s | %s | %s | |"
896
+ % (i, h.get("node_id"), h.get("issue_kind"), h.get("field") or "—",
897
+ sp, h.get("line") or "—",
898
+ (h.get("snippet") or "—").replace("|", "\\|"),
899
+ (h.get("evidence") or "").replace("|", "\\|")))
900
+ return head + "\n".join(rows)
901
+
902
+
903
+ # 生效条件:解析 argv(缺省 sys.argv)后,--root 为假值(含默认 os.environ.get("MDCG_ROOT") 为 None 或空串)时打印提示并返回 2;--node 追加列表为空时打印提示并返回 2;否则以 --root 与 --node 调 locate_many,并按 --json 或 --markdown 输出后返回 0,两者皆无则逐行打印命中与汇总后返回 0。
904
+ def main(argv=None) -> int:
905
+ ap = argparse.ArgumentParser(prog="python -m md_cg.mreview.locate",
906
+ description="记忆评审 M3 · D1 字段级定位")
907
+ ap.add_argument("--root", default=os.environ.get("MDCG_ROOT"),
908
+ help="真源根(缺省读环境变量 MDCG_ROOT)")
909
+ ap.add_argument("--node", action="append", default=[],
910
+ help="节点 id(可多次;同一批内互为对照)")
911
+ ap.add_argument("--kind", action="append", default=[], help="只定位该类问题")
912
+ ap.add_argument("--field", action="append", default=[], help="只保留该字段的命中")
913
+ ap.add_argument("--json", action="store_true", help="输出 JSON(缺省人读表)")
914
+ ap.add_argument("--markdown", action="store_true", help="输出人工核对清单")
915
+ a = ap.parse_args(argv)
916
+ if not a.root:
917
+ print("需要 --root 或环境变量 MDCG_ROOT", file=sys.stderr)
918
+ return 2
919
+ if not a.node:
920
+ print("需要 --node <id>(可多次)", file=sys.stderr)
921
+ return 2
922
+ rep = locate_many(a.node, root=a.root,
923
+ issue_hint=(list(a.kind) + list(a.field)) or None)
924
+ if a.json:
925
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
926
+ return 0
927
+ if a.markdown:
928
+ print(markdown_table(rep["hits"]))
929
+ return 0
930
+ for h in rep["hits"]:
931
+ print("%-14s %-20s %-14s %s" % (h["node_id"], h["field"], h["issue_kind"],
932
+ h["evidence"]))
933
+ print("-- 命中 %d 条|干净 %d 条|缺项 %d 条"
934
+ % (len(rep["hits"]), len(rep["clean"]), len(rep["missing"])))
935
+ return 0
936
+
937
+
938
+ if __name__ == "__main__":
939
+ sys.exit(main())