@furongjun1999/dsh-memory 0.9.14 → 0.9.15

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 (1276) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/LICENSE +21 -21
  3. package/README.md +125 -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 +24 -12
  14. package/lib/index.js +3 -44
  15. package/lib/lib/console_web.mjs +96 -0
  16. package/lib/tools.d.ts +2 -2
  17. package/md_cg/__init__.py +7 -7
  18. package/md_cg/auditview.py +248 -248
  19. package/md_cg/backfill.py +1328 -1328
  20. package/md_cg/backfill_bigdomain.py +34 -34
  21. package/md_cg/backfill_bucket_zh.py +35 -35
  22. package/md_cg/bench6_arms.py +414 -414
  23. package/md_cg/bench6_common.py +230 -230
  24. package/md_cg/bench6_competitors.py +212 -212
  25. package/md_cg/bench_axis_domain.py +257 -257
  26. package/md_cg/bench_blind_comp.py +308 -308
  27. package/md_cg/bench_e2e_judge.py +534 -534
  28. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  29. package/md_cg/bench_e2e_qa.py +256 -256
  30. package/md_cg/bench_en_atoms_public.py +230 -230
  31. package/md_cg/bench_governance.py +351 -351
  32. package/md_cg/bench_lme_zh.py +410 -410
  33. package/md_cg/bench_locomo.py +121 -121
  34. package/md_cg/bench_locomo_zh.py +460 -460
  35. package/md_cg/bench_locomo_zh_public.py +147 -147
  36. package/md_cg/bench_longmem.py +112 -112
  37. package/md_cg/bench_membench.py +632 -632
  38. package/md_cg/bench_p0.py +149 -149
  39. package/md_cg/bench_progressive.py +287 -287
  40. package/md_cg/bench_role_views.py +238 -238
  41. package/md_cg/bench_task_ab.py +243 -243
  42. package/md_cg/bench_task_ab_llm.py +408 -408
  43. package/md_cg/bench_unified_en.py +204 -204
  44. package/md_cg/bench_zh_mad.py +611 -611
  45. package/md_cg/blindspot_tickets.py +123 -123
  46. package/md_cg/census.py +133 -133
  47. package/md_cg/codeindex.py +531 -531
  48. package/md_cg/comment_gate.py +337 -337
  49. package/md_cg/cond_compose.py +190 -190
  50. package/md_cg/cond_facts.py +154 -154
  51. package/md_cg/cond_template.json +106 -106
  52. package/md_cg/condition_anchor.py +142 -142
  53. package/md_cg/config_registry_bulk.py +4 -0
  54. package/md_cg/corpus.py +110 -110
  55. package/md_cg/crosscheck.py +1098 -1098
  56. package/md_cg/d_meta.py +310 -310
  57. package/md_cg/docindex.py +496 -488
  58. package/md_cg/evolution.py +493 -493
  59. package/md_cg/freshness.py +21 -1
  60. package/md_cg/generation.py +409 -409
  61. package/md_cg/ghostref.py +130 -130
  62. package/md_cg/hotcache.py +5 -1
  63. package/md_cg/lexicon/RULES.md +32 -32
  64. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  65. package/md_cg/lexicon/build_standard_en.py +171 -171
  66. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  67. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  68. package/md_cg/lexicon/expand_en_zh.py +211 -211
  69. package/md_cg/lexicon/standard_en.json +1262 -1262
  70. package/md_cg/linkref.py +280 -280
  71. package/md_cg/mcp_server.py +9 -2
  72. package/md_cg/md_whitebox.py +345 -345
  73. package/md_cg/mdcg.py +196 -13
  74. package/md_cg/mdcos.py +124 -5
  75. package/md_cg/migrate.py +119 -119
  76. package/md_cg/migrate_aeis.py +221 -221
  77. package/md_cg/migrate_roleplay.py +293 -293
  78. package/md_cg/migrate_wisdom_graph.py +360 -360
  79. package/md_cg/mreview/__init__.py +25 -25
  80. package/md_cg/mreview/__main__.py +110 -110
  81. package/md_cg/mreview/bundle.py +178 -178
  82. package/md_cg/mreview/candidates.py +262 -262
  83. package/md_cg/mreview/govern.py +694 -694
  84. package/md_cg/mreview/locate.py +939 -939
  85. package/md_cg/mreview/pipeline.py +742 -742
  86. package/md_cg/mreview/rules/duplication.json +21 -21
  87. package/md_cg/mreview/rules/field_coverage.json +54 -54
  88. package/md_cg/mreview/rules/source_license.json +21 -21
  89. package/md_cg/mreview/rules/template_flow.json +21 -21
  90. package/md_cg/mreview/ruleset.py +252 -252
  91. package/md_cg/op_table.py +3 -2
  92. package/md_cg/progressive.py +123 -123
  93. package/md_cg/protect.py +29 -6
  94. package/md_cg/protocol/md_cg_gate.proto +33 -33
  95. package/md_cg/qmd_llm.py +334 -334
  96. package/md_cg/roleviews.py +89 -89
  97. package/md_cg/security.py +68 -5
  98. package/md_cg/selfreport.py +161 -161
  99. package/md_cg/semantic/REPRODUCE.md +170 -170
  100. package/md_cg/semantic/SCHEMA.md +33 -33
  101. package/md_cg/semantic/__init__.py +10 -10
  102. package/md_cg/semantic/atoms.json +7348 -7348
  103. package/md_cg/semantic/en_normalizer.py +364 -364
  104. package/md_cg/semantic/search_index.json +6199 -6199
  105. package/md_cg/session5.py +106 -106
  106. package/md_cg/srcindex.py +352 -352
  107. package/md_cg/statushdr.py +179 -179
  108. package/md_cg/tasks.py +26 -0
  109. package/md_cg/test_access_hints.py +147 -147
  110. package/md_cg/test_audit_rotate.py +270 -270
  111. package/md_cg/test_auditview.py +277 -277
  112. package/md_cg/test_autonomy.py +143 -143
  113. package/md_cg/test_autonomy_admission.py +1098 -1098
  114. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  115. package/md_cg/test_b1_foreign_read.py +244 -244
  116. package/md_cg/test_b1b2_write_face.py +424 -424
  117. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  118. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  119. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  120. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  121. package/md_cg/test_bench_governance.py +102 -102
  122. package/md_cg/test_blindspot_tickets.py +166 -166
  123. package/md_cg/test_boundary_hit.py +410 -410
  124. package/md_cg/test_branch_discard_tombstone.py +136 -136
  125. package/md_cg/test_ccg_perturb.py +184 -184
  126. package/md_cg/test_ccgc.py +458 -458
  127. package/md_cg/test_census_prune.py +81 -81
  128. package/md_cg/test_chain_read_isolate.py +168 -168
  129. package/md_cg/test_codeindex.py +338 -338
  130. package/md_cg/test_coldverify_drain.py +127 -127
  131. package/md_cg/test_comment_gate.py +187 -187
  132. package/md_cg/test_cond_compose_anchors.py +76 -76
  133. package/md_cg/test_cond_match.py +165 -165
  134. package/md_cg/test_condition_anchor.py +81 -81
  135. package/md_cg/test_config_registry.py +55 -55
  136. package/md_cg/test_cons200_scan_selection.py +793 -793
  137. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  138. package/md_cg/test_crypto_rotate.py +256 -256
  139. package/md_cg/test_csre_index_import_guard.py +161 -161
  140. package/md_cg/test_curiosity_budget.py +468 -468
  141. package/md_cg/test_d17_autostart_toolface.py +453 -453
  142. package/md_cg/test_d_meta.py +412 -412
  143. package/md_cg/test_datapath_root.py +199 -199
  144. package/md_cg/test_designer_token_coverage.py +184 -0
  145. package/md_cg/test_emit_negtail_cache.py +156 -156
  146. package/md_cg/test_export_default_collision.py +138 -138
  147. package/md_cg/test_gain_gate.py +223 -223
  148. package/md_cg/test_generation_guard.py +361 -361
  149. package/md_cg/test_ghostref.py +182 -182
  150. package/md_cg/test_goal_gen.py +355 -355
  151. package/md_cg/test_govern_directread.py +434 -434
  152. package/md_cg/test_health_scale.py +173 -173
  153. package/md_cg/test_heartbeat_ledger.py +563 -563
  154. package/md_cg/test_hive_ingest.py +285 -285
  155. package/md_cg/test_hot_cold.py +215 -215
  156. package/md_cg/test_hyperedge.py +245 -245
  157. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  158. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  159. package/md_cg/test_i50d_importance_source.py +531 -531
  160. package/md_cg/test_i50e_readside_protection.py +9 -3
  161. package/md_cg/test_identity_contract.py +329 -329
  162. package/md_cg/test_index_crossprocess_reload.py +316 -316
  163. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  164. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  165. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  166. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  167. package/md_cg/test_issue659_r26_batch3.py +38 -0
  168. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  169. package/md_cg/test_issue672_optional_assets.py +49 -0
  170. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  171. package/md_cg/test_issue677_async_index_flush.py +216 -0
  172. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  173. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  174. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  175. package/md_cg/test_issue69_audit_boundary.py +129 -129
  176. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  177. package/md_cg/test_issue78_export_concurrency.py +334 -334
  178. package/md_cg/test_issue80_residual_flush.py +169 -169
  179. package/md_cg/test_issue84_portability.py +95 -95
  180. package/md_cg/test_issue85_export_overwrite.py +113 -113
  181. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  182. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  183. package/md_cg/test_issue88_conclusion_face.py +280 -280
  184. package/md_cg/test_issue89_zero_score.py +169 -169
  185. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  186. package/md_cg/test_issue96_key_fallback.py +102 -102
  187. package/md_cg/test_issue98_tenant_root.py +104 -104
  188. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  189. package/md_cg/test_lifecycle.py +309 -309
  190. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  191. package/md_cg/test_linkref.py +320 -320
  192. package/md_cg/test_links_concurrent_write.py +188 -188
  193. package/md_cg/test_lock.py +52 -52
  194. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  195. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  196. package/md_cg/test_md_writepath.py +345 -345
  197. package/md_cg/test_merge_upsert.py +168 -168
  198. package/md_cg/test_mode_parity.py +23 -0
  199. package/md_cg/test_mr_m2.py +615 -599
  200. package/md_cg/test_mr_m3.py +710 -710
  201. package/md_cg/test_mr_m4.py +485 -485
  202. package/md_cg/test_n131_merge_gate.py +205 -205
  203. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  204. package/md_cg/test_n176_link_trust.py +221 -221
  205. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  206. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  207. package/md_cg/test_n195_writepath_reload.py +283 -283
  208. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  209. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  210. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  211. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  212. package/md_cg/test_n201_proposal_visibility.py +382 -382
  213. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  214. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  215. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  216. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  217. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  218. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  219. package/md_cg/test_n230_dirty_replay.py +18 -5
  220. package/md_cg/test_n238_body_text_parity.py +156 -156
  221. package/md_cg/test_n276_probe_hoist.py +199 -199
  222. package/md_cg/test_neg_condition_hits.py +333 -333
  223. package/md_cg/test_neg_coverage_budget.py +500 -500
  224. package/md_cg/test_none_id_write_guard.py +166 -166
  225. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  226. package/md_cg/test_p0.py +264 -264
  227. package/md_cg/test_p1.py +316 -316
  228. package/md_cg/test_p10_identity.py +173 -173
  229. package/md_cg/test_p11_consistency.py +382 -382
  230. package/md_cg/test_p12_metacognition.py +212 -212
  231. package/md_cg/test_p13_encryption.py +241 -241
  232. package/md_cg/test_p14_root_fallback.py +373 -373
  233. package/md_cg/test_p14_sustain.py +249 -249
  234. package/md_cg/test_p15_scrub.py +280 -280
  235. package/md_cg/test_p16_self_state.py +301 -301
  236. package/md_cg/test_p17_predict.py +354 -354
  237. package/md_cg/test_p18_whitebox.py +171 -171
  238. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  239. package/md_cg/test_p1x_ref_root.py +197 -197
  240. package/md_cg/test_p2.py +216 -216
  241. package/md_cg/test_p20_evolution.py +315 -315
  242. package/md_cg/test_p22_theory.py +175 -175
  243. package/md_cg/test_p23_links.py +311 -311
  244. package/md_cg/test_p25_weights.py +156 -156
  245. package/md_cg/test_p26_refindex.py +433 -433
  246. package/md_cg/test_p29_session_ingest_export.py +360 -360
  247. package/md_cg/test_p30_maintain.py +361 -361
  248. package/md_cg/test_p31_insight.py +535 -535
  249. package/md_cg/test_p34_crosscheck.py +331 -331
  250. package/md_cg/test_p35_conditioned_claim.py +252 -252
  251. package/md_cg/test_p36_kp_align.py +230 -230
  252. package/md_cg/test_p37_condition_space.py +248 -248
  253. package/md_cg/test_p38_contextualize.py +273 -273
  254. package/md_cg/test_p39_vision_evidence.py +369 -369
  255. package/md_cg/test_p41_evolve_patrol.py +224 -224
  256. package/md_cg/test_p42_provenance.py +269 -269
  257. package/md_cg/test_p44_md_whitebox.py +231 -231
  258. package/md_cg/test_p45_session_identity.py +466 -466
  259. package/md_cg/test_p46_unit_scope.py +272 -272
  260. package/md_cg/test_p4_fuzzy.py +223 -223
  261. package/md_cg/test_p5_semantic.py +226 -226
  262. package/md_cg/test_p6_consolidate.py +822 -822
  263. package/md_cg/test_p7_goals_recent.py +202 -202
  264. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  265. package/md_cg/test_p8_subgraph_chain.py +213 -213
  266. package/md_cg/test_p9_forget_protect.py +238 -238
  267. package/md_cg/test_preflight_failclosed.py +100 -100
  268. package/md_cg/test_progressive.py +146 -146
  269. package/md_cg/test_propose_tail_index.py +157 -157
  270. package/md_cg/test_protect_stats_parity.py +141 -0
  271. package/md_cg/test_protocol.py +272 -272
  272. package/md_cg/test_rank_parity_score_mode.py +522 -522
  273. package/md_cg/test_reach_keys.py +201 -201
  274. package/md_cg/test_read_clip.py +141 -141
  275. package/md_cg/test_read_face_input_gates.py +363 -363
  276. package/md_cg/test_read_face_semantics.py +492 -492
  277. package/md_cg/test_read_scope_b27.py +277 -277
  278. package/md_cg/test_readcache_default_on.py +168 -168
  279. package/md_cg/test_readcache_precise_inval.py +270 -270
  280. package/md_cg/test_recall_metadata.py +422 -422
  281. package/md_cg/test_reconcile_v0.py +294 -294
  282. package/md_cg/test_retr_s1.py +344 -344
  283. package/md_cg/test_retr_s1b.py +276 -276
  284. package/md_cg/test_retr_s3.py +194 -194
  285. package/md_cg/test_retr_s4.py +163 -163
  286. package/md_cg/test_retr_s6.py +157 -157
  287. package/md_cg/test_retr_s7.py +392 -392
  288. package/md_cg/test_retr_s8_time.py +369 -369
  289. package/md_cg/test_retr_s9_edges.py +286 -286
  290. package/md_cg/test_retr_score_once.py +220 -220
  291. package/md_cg/test_review_cli_attribution.py +181 -181
  292. package/md_cg/test_review_cli_visibility.py +235 -235
  293. package/md_cg/test_review_conformance.py +385 -385
  294. package/md_cg/test_review_dual_check.py +97 -0
  295. package/md_cg/test_review_onepass.py +170 -170
  296. package/md_cg/test_review_queue_batch.py +123 -123
  297. package/md_cg/test_review_queue_index.py +130 -130
  298. package/md_cg/test_role_views.py +354 -354
  299. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  300. package/md_cg/test_security_audit_v21.py +249 -249
  301. package/md_cg/test_sem_noise.py +242 -242
  302. package/md_cg/test_server_version.py +67 -67
  303. package/md_cg/test_session5_identity.py +93 -93
  304. package/md_cg/test_session_attribution_consistency.py +813 -813
  305. package/md_cg/test_session_identity_tristate.py +486 -486
  306. package/md_cg/test_session_isolation.py +168 -168
  307. package/md_cg/test_sleep.py +668 -668
  308. package/md_cg/test_sleep_gitlock.py +134 -134
  309. package/md_cg/test_snapshot_autoclose.py +187 -187
  310. package/md_cg/test_spatial_coords3d.py +292 -292
  311. package/md_cg/test_srcindex.py +171 -171
  312. package/md_cg/test_state_events.py +178 -178
  313. package/md_cg/test_state_slots.py +691 -691
  314. package/md_cg/test_subproc_encoding.py +192 -192
  315. package/md_cg/test_sustain_mutual.py +153 -153
  316. package/md_cg/test_tail_watermark_race.py +208 -208
  317. package/md_cg/test_tasks.py +409 -409
  318. package/md_cg/test_tenant_env_override_warn.py +152 -152
  319. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  320. package/md_cg/test_time_core_lint.py +9 -0
  321. package/md_cg/test_token_lowercase_form.py +315 -315
  322. package/md_cg/test_transfer.py +180 -180
  323. package/md_cg/test_trust.py +361 -361
  324. package/md_cg/test_twophase.py +286 -286
  325. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  326. package/md_cg/test_unify_default_off.py +701 -701
  327. package/md_cg/test_unify_scope.py +182 -182
  328. package/md_cg/test_units_poll.py +71 -71
  329. package/md_cg/test_v21r1_package_version.py +310 -310
  330. package/md_cg/test_validity_filter.py +280 -280
  331. package/md_cg/test_verify_answer.py +138 -138
  332. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  333. package/md_cg/test_w5_path_fingerprint.py +381 -381
  334. package/md_cg/test_wisdom_md_store.py +292 -292
  335. package/md_cg/test_writegate_tiers.py +111 -0
  336. package/md_cg/test_writelimit.py +224 -224
  337. package/md_cg/test_writepipe.py +4 -2
  338. package/md_cg/tokens.py +114 -8
  339. package/md_cg/units.py +869 -869
  340. package/md_cg/version_anchor.py +160 -160
  341. package/md_cg/vision_evidence.py +667 -667
  342. package/md_cg/whitebox_kb/__init__.py +37 -37
  343. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  344. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  345. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  346. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  347. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  348. package/md_cg/whitebox_kb/engine.py +310 -310
  349. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  350. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  351. 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
  352. 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
  353. 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
  354. 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
  355. 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
  356. 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
  357. 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
  358. 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
  359. 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
  360. 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
  361. 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
  362. 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
  363. 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
  364. 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
  365. 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
  366. 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
  367. 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
  368. 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
  369. 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
  370. 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
  371. 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
  372. 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
  373. 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
  374. 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
  375. 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
  376. 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
  377. 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
  378. 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
  379. 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
  380. 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
  381. 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
  382. 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
  383. 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
  384. 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
  385. 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
  386. 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
  387. 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
  388. 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
  389. 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
  390. 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
  391. 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
  392. 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
  393. 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
  394. 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
  395. 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
  396. 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
  397. 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
  398. 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
  399. 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
  400. 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
  401. 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
  402. 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
  403. 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
  404. 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
  405. 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
  406. 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
  407. 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
  408. 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
  409. 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
  410. 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
  411. 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
  412. 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
  413. 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
  414. 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
  415. 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
  416. 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
  417. 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
  418. 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
  419. 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
  420. 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
  421. 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
  422. 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
  423. 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
  424. 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
  425. 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
  426. 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
  427. 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
  428. 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
  429. 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
  430. 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
  431. 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
  432. 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
  433. 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
  434. 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
  435. 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
  436. 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
  437. 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
  438. 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
  439. 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
  440. 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
  441. 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
  442. 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
  443. 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
  444. 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
  445. 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
  446. 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
  447. 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
  448. 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
  449. 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
  450. 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
  451. 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
  452. 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
  453. 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
  454. 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
  455. 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
  456. 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
  457. 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
  458. 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
  459. 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
  460. 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
  461. 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
  462. 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
  463. 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
  464. 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
  465. 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
  466. 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
  467. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  468. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  469. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  470. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  471. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  472. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  473. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  474. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  475. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  476. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  477. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  478. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  479. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  480. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  481. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  482. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  483. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  484. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  485. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  486. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  487. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  488. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  489. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  490. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  491. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  492. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  493. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  494. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  495. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  496. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  497. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  498. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  499. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  500. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  501. 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
  502. 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
  503. 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
  504. 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
  505. 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
  506. 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
  507. 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
  508. 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
  509. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  510. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  511. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  512. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  513. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  514. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  515. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  516. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  517. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  518. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  519. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  520. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  521. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  522. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  523. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  524. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  525. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  526. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  527. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  528. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  529. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  530. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  531. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  532. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  533. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  534. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  535. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  536. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  537. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  538. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  539. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  540. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  541. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  542. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  543. package/md_cg/writegate.py +146 -0
  544. package/md_cg/writepipe.py +85 -7
  545. package/package.json +20 -6
  546. package/scripts/workspace_index.py +1 -0
  547. package/skills/README.md +121 -121
  548. package/skills/plugin.json +54 -54
  549. package/skills/skills/designer-perspective/SKILL.md +158 -158
  550. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  551. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  552. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  553. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  554. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  555. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  556. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  557. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  558. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  559. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  560. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  561. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  562. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  563. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  564. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  565. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  566. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  567. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  568. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  569. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  570. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  571. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  572. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  573. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  574. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  663. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  664. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  665. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  666. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  667. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  668. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  669. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  670. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  671. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  672. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  673. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  674. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  675. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  676. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  677. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  679. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  780. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  781. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  782. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  783. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  784. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  785. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  786. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  787. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  788. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  789. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  790. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  791. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  792. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  793. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  794. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  796. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  898. package/skills/skills/lingshu-net/SKILL.md +48 -48
  899. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  900. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  901. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  902. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  903. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  904. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  905. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  906. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  907. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  908. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  909. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  910. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  911. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  912. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  914. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1017. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1021. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1032. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1130. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1134. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1145. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1250. package/src/hooks.ts +21 -12
  1251. package/src/index.ts +3 -0
  1252. package/src/lib/console_web.mjs +96 -0
  1253. package/src/lib/python_path.ts +71 -71
  1254. package/src/lib/session_state.ts +127 -127
  1255. package/src/lib/whitebox_llm.ts +311 -311
  1256. package/ui/minimal/LICENSE +21 -0
  1257. package/ui/minimal/install.ps1 +168 -0
  1258. package/ui/minimal/integrity.json +41 -0
  1259. package/ui/minimal/payload/build-ui.mjs +16 -0
  1260. package/ui/minimal/payload/lib/client.js +18 -0
  1261. package/ui/minimal/payload/lib/lib/console_web.mjs +96 -0
  1262. package/ui/minimal/payload/src/lib/console_web.mjs +96 -0
  1263. package/ui/minimal/payload/web/app.js +154 -0
  1264. package/ui/minimal/payload/web/client.js +14 -0
  1265. package/ui/minimal/payload/web/entry.js +1 -0
  1266. package/ui/minimal/payload/web/index.html +3 -0
  1267. package/ui/minimal/payload/web/style.css +3 -0
  1268. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1269. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1270. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1271. package/utf8_boot.py +237 -237
  1272. package/web/app.js +154 -0
  1273. package/web/client.js +14 -0
  1274. package/web/entry.js +1 -0
  1275. package/web/index.html +3 -0
  1276. 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())