@furongjun1999/dsh-memory 0.9.14 → 0.9.16

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