@furongjun1999/dsh-memory 0.9.21 → 0.9.23

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