@furongjun1999/dsh-memory 0.9.13 → 0.9.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1293) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/LICENSE +21 -21
  3. package/README.md +129 -3
  4. package/codebuddy/CODEBUDDY.md +8 -3
  5. package/codebuddy/README.md +92 -92
  6. package/codebuddy/mcp.json +27 -27
  7. package/docs/discipline/templates/zcode-user.md.tmpl +52 -52
  8. package/docs//345/267/245/344/275/234/347/272/252/345/276/213_/350/256/244/347/237/245/345/233/276/346/235/241/347/233/256_v1.1.json +488 -461
  9. package/dsh/README.md +82 -82
  10. package/dsh/dsh-web-start.bat +17 -17
  11. package/dsh/hive-mcp-probe.mjs +94 -94
  12. package/dsh/update-lingshu.bat +11 -11
  13. package/dsh/update-lingshu.ps1 +337 -337
  14. package/hive/README.md +705 -705
  15. package/hive/id_charset_blocks.txt +147 -147
  16. package/lib/client.js +18 -0
  17. package/lib/hooks.js +51 -31
  18. package/lib/index.js +3 -44
  19. package/lib/lib/console_web.mjs +96 -0
  20. package/lib/tools.d.ts +2 -2
  21. package/md_cg/__init__.py +7 -7
  22. package/md_cg/auditview.py +248 -248
  23. package/md_cg/backfill.py +1328 -1328
  24. package/md_cg/backfill_bigdomain.py +34 -34
  25. package/md_cg/backfill_bucket_zh.py +35 -35
  26. package/md_cg/bench6_arms.py +414 -414
  27. package/md_cg/bench6_common.py +230 -230
  28. package/md_cg/bench6_competitors.py +212 -212
  29. package/md_cg/bench_axis_domain.py +257 -257
  30. package/md_cg/bench_blind_comp.py +308 -308
  31. package/md_cg/bench_e2e_judge.py +534 -534
  32. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  33. package/md_cg/bench_e2e_qa.py +256 -256
  34. package/md_cg/bench_en_atoms_public.py +230 -230
  35. package/md_cg/bench_governance.py +351 -351
  36. package/md_cg/bench_lme_zh.py +410 -410
  37. package/md_cg/bench_locomo.py +121 -121
  38. package/md_cg/bench_locomo_zh.py +460 -460
  39. package/md_cg/bench_locomo_zh_public.py +147 -147
  40. package/md_cg/bench_longmem.py +112 -112
  41. package/md_cg/bench_membench.py +632 -632
  42. package/md_cg/bench_p0.py +149 -149
  43. package/md_cg/bench_progressive.py +287 -287
  44. package/md_cg/bench_role_views.py +238 -238
  45. package/md_cg/bench_task_ab.py +243 -243
  46. package/md_cg/bench_task_ab_llm.py +408 -408
  47. package/md_cg/bench_unified_en.py +204 -204
  48. package/md_cg/bench_zh_mad.py +611 -611
  49. package/md_cg/blindspot_tickets.py +123 -123
  50. package/md_cg/census.py +133 -133
  51. package/md_cg/codeindex.py +531 -531
  52. package/md_cg/comment_gate.py +337 -337
  53. package/md_cg/cond_compose.py +190 -190
  54. package/md_cg/cond_facts.py +154 -154
  55. package/md_cg/cond_template.json +106 -106
  56. package/md_cg/condition_anchor.py +142 -142
  57. package/md_cg/config_registry_bulk.py +4 -0
  58. package/md_cg/conformance_core.py +28 -0
  59. package/md_cg/consistency.py +9 -2
  60. package/md_cg/corpus.py +110 -110
  61. package/md_cg/crosscheck.py +1098 -1098
  62. package/md_cg/d_meta.py +310 -310
  63. package/md_cg/docindex.py +496 -488
  64. package/md_cg/evolution.py +493 -493
  65. package/md_cg/freshness.py +21 -1
  66. package/md_cg/generation.py +409 -409
  67. package/md_cg/ghostref.py +130 -130
  68. package/md_cg/hotcache.py +5 -1
  69. package/md_cg/lexicon/RULES.md +32 -32
  70. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  71. package/md_cg/lexicon/build_standard_en.py +171 -171
  72. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  73. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  74. package/md_cg/lexicon/expand_en_zh.py +211 -211
  75. package/md_cg/lexicon/standard_en.json +1262 -1262
  76. package/md_cg/linkref.py +280 -280
  77. package/md_cg/mcp_server.py +95 -11
  78. package/md_cg/md_whitebox.py +345 -345
  79. package/md_cg/mdcg.py +309 -24
  80. package/md_cg/mdcos.py +171 -16
  81. package/md_cg/migrate.py +119 -119
  82. package/md_cg/migrate_aeis.py +221 -221
  83. package/md_cg/migrate_roleplay.py +293 -293
  84. package/md_cg/migrate_wisdom_graph.py +360 -360
  85. package/md_cg/mreview/__init__.py +25 -25
  86. package/md_cg/mreview/__main__.py +110 -110
  87. package/md_cg/mreview/bundle.py +178 -178
  88. package/md_cg/mreview/candidates.py +262 -262
  89. package/md_cg/mreview/govern.py +694 -694
  90. package/md_cg/mreview/locate.py +939 -939
  91. package/md_cg/mreview/pipeline.py +742 -742
  92. package/md_cg/mreview/rules/duplication.json +21 -21
  93. package/md_cg/mreview/rules/field_coverage.json +54 -54
  94. package/md_cg/mreview/rules/source_license.json +21 -21
  95. package/md_cg/mreview/rules/template_flow.json +21 -21
  96. package/md_cg/mreview/ruleset.py +252 -252
  97. package/md_cg/nodefile.py +39 -1
  98. package/md_cg/op_table.py +3 -1
  99. package/md_cg/progressive.py +123 -123
  100. package/md_cg/protect.py +29 -6
  101. package/md_cg/protocol/md_cg_gate.proto +33 -33
  102. package/md_cg/qmd_llm.py +334 -334
  103. package/md_cg/relations.py +91 -0
  104. package/md_cg/roleviews.py +89 -89
  105. package/md_cg/scrub.py +20 -3
  106. package/md_cg/security.py +68 -5
  107. package/md_cg/selfreport.py +161 -161
  108. package/md_cg/semantic/REPRODUCE.md +170 -170
  109. package/md_cg/semantic/SCHEMA.md +33 -33
  110. package/md_cg/semantic/__init__.py +10 -10
  111. package/md_cg/semantic/atoms.json +7348 -7348
  112. package/md_cg/semantic/en_normalizer.py +364 -364
  113. package/md_cg/semantic/search_index.json +6199 -6199
  114. package/md_cg/session5.py +106 -106
  115. package/md_cg/srcindex.py +352 -352
  116. package/md_cg/statushdr.py +179 -179
  117. package/md_cg/tasks.py +26 -0
  118. package/md_cg/test_access_hints.py +147 -147
  119. package/md_cg/test_audit_rotate.py +270 -270
  120. package/md_cg/test_auditview.py +277 -277
  121. package/md_cg/test_autonomy.py +143 -143
  122. package/md_cg/test_autonomy_admission.py +1098 -1098
  123. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  124. package/md_cg/test_b1_foreign_read.py +244 -244
  125. package/md_cg/test_b1b2_write_face.py +424 -424
  126. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  127. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  128. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  129. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  130. package/md_cg/test_bench_governance.py +102 -102
  131. package/md_cg/test_blindspot_tickets.py +166 -166
  132. package/md_cg/test_boundary_hit.py +410 -410
  133. package/md_cg/test_branch_discard_tombstone.py +136 -136
  134. package/md_cg/test_ccg_perturb.py +184 -184
  135. package/md_cg/test_ccgc.py +458 -458
  136. package/md_cg/test_census_prune.py +81 -81
  137. package/md_cg/test_chain_read_isolate.py +168 -168
  138. package/md_cg/test_codeindex.py +338 -338
  139. package/md_cg/test_coldverify_drain.py +127 -127
  140. package/md_cg/test_comment_gate.py +187 -187
  141. package/md_cg/test_cond_compose_anchors.py +76 -76
  142. package/md_cg/test_cond_match.py +165 -165
  143. package/md_cg/test_condition_anchor.py +81 -81
  144. package/md_cg/test_config_registry.py +55 -55
  145. package/md_cg/test_cons200_scan_selection.py +793 -793
  146. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  147. package/md_cg/test_crypto_rotate.py +256 -256
  148. package/md_cg/test_csre_index_import_guard.py +161 -161
  149. package/md_cg/test_curiosity_budget.py +468 -468
  150. package/md_cg/test_d17_autostart_toolface.py +453 -453
  151. package/md_cg/test_d_meta.py +412 -412
  152. package/md_cg/test_datapath_root.py +199 -199
  153. package/md_cg/test_designer_token_coverage.py +184 -0
  154. package/md_cg/test_emit_negtail_cache.py +156 -156
  155. package/md_cg/test_export_default_collision.py +138 -138
  156. package/md_cg/test_gain_gate.py +223 -223
  157. package/md_cg/test_generation_guard.py +361 -361
  158. package/md_cg/test_ghostref.py +182 -182
  159. package/md_cg/test_goal_gen.py +355 -355
  160. package/md_cg/test_govern_directread.py +434 -434
  161. package/md_cg/test_health_scale.py +173 -173
  162. package/md_cg/test_heartbeat_ledger.py +563 -563
  163. package/md_cg/test_hive_ingest.py +285 -285
  164. package/md_cg/test_hot_cold.py +215 -215
  165. package/md_cg/test_hyperedge.py +245 -245
  166. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  167. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  168. package/md_cg/test_i50d_importance_source.py +531 -531
  169. package/md_cg/test_i50e_readside_protection.py +9 -3
  170. package/md_cg/test_identity_contract.py +329 -329
  171. package/md_cg/test_index_crossprocess_reload.py +316 -316
  172. package/md_cg/test_issue218_postcondition_value_blind.py +4 -2
  173. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  174. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  175. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  176. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  177. package/md_cg/test_issue650_658_f26.py +98 -0
  178. package/md_cg/test_issue659_r26_batch2.py +74 -0
  179. package/md_cg/test_issue659_r26_batch3.py +38 -0
  180. package/md_cg/test_issue665_scrub_process_records.py +59 -0
  181. package/md_cg/test_issue669_ccg_empty_colon.py +69 -0
  182. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  183. package/md_cg/test_issue672_optional_assets.py +49 -0
  184. package/md_cg/test_issue672_validity_scope.py +47 -0
  185. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  186. package/md_cg/test_issue677_async_index_flush.py +216 -0
  187. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  188. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  189. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  190. package/md_cg/test_issue69_audit_boundary.py +129 -129
  191. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  192. package/md_cg/test_issue78_export_concurrency.py +334 -334
  193. package/md_cg/test_issue80_residual_flush.py +169 -169
  194. package/md_cg/test_issue84_portability.py +95 -95
  195. package/md_cg/test_issue85_export_overwrite.py +113 -113
  196. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  197. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  198. package/md_cg/test_issue88_conclusion_face.py +280 -280
  199. package/md_cg/test_issue89_zero_score.py +169 -169
  200. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  201. package/md_cg/test_issue96_key_fallback.py +102 -102
  202. package/md_cg/test_issue98_tenant_root.py +104 -104
  203. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  204. package/md_cg/test_lifecycle.py +309 -309
  205. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  206. package/md_cg/test_linkref.py +320 -320
  207. package/md_cg/test_links_concurrent_write.py +188 -188
  208. package/md_cg/test_lock.py +52 -52
  209. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  210. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  211. package/md_cg/test_md_writepath.py +345 -345
  212. package/md_cg/test_merge_upsert.py +168 -168
  213. package/md_cg/test_mode_parity.py +23 -0
  214. package/md_cg/test_mr_m2.py +615 -599
  215. package/md_cg/test_mr_m3.py +710 -710
  216. package/md_cg/test_mr_m4.py +485 -485
  217. package/md_cg/test_n131_merge_gate.py +205 -205
  218. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  219. package/md_cg/test_n176_link_trust.py +221 -221
  220. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  221. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  222. package/md_cg/test_n195_writepath_reload.py +283 -283
  223. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  224. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  225. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  226. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  227. package/md_cg/test_n201_proposal_visibility.py +382 -382
  228. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  229. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  230. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  231. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  232. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  233. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  234. package/md_cg/test_n230_dirty_replay.py +18 -5
  235. package/md_cg/test_n238_body_text_parity.py +156 -156
  236. package/md_cg/test_n276_probe_hoist.py +199 -199
  237. package/md_cg/test_neg_condition_hits.py +333 -333
  238. package/md_cg/test_neg_coverage_budget.py +500 -500
  239. package/md_cg/test_none_id_write_guard.py +166 -166
  240. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  241. package/md_cg/test_p0.py +264 -264
  242. package/md_cg/test_p1.py +316 -316
  243. package/md_cg/test_p10_identity.py +173 -173
  244. package/md_cg/test_p11_consistency.py +382 -382
  245. package/md_cg/test_p12_metacognition.py +212 -212
  246. package/md_cg/test_p13_encryption.py +241 -241
  247. package/md_cg/test_p14_root_fallback.py +373 -373
  248. package/md_cg/test_p14_sustain.py +249 -249
  249. package/md_cg/test_p15_scrub.py +280 -280
  250. package/md_cg/test_p16_self_state.py +301 -301
  251. package/md_cg/test_p17_predict.py +354 -354
  252. package/md_cg/test_p18_whitebox.py +171 -171
  253. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  254. package/md_cg/test_p1x_ref_root.py +197 -197
  255. package/md_cg/test_p2.py +216 -216
  256. package/md_cg/test_p20_evolution.py +315 -315
  257. package/md_cg/test_p22_theory.py +175 -175
  258. package/md_cg/test_p23_links.py +311 -311
  259. package/md_cg/test_p25_weights.py +156 -156
  260. package/md_cg/test_p26_refindex.py +433 -433
  261. package/md_cg/test_p29_session_ingest_export.py +360 -360
  262. package/md_cg/test_p30_maintain.py +361 -361
  263. package/md_cg/test_p31_insight.py +535 -535
  264. package/md_cg/test_p34_crosscheck.py +331 -331
  265. package/md_cg/test_p35_conditioned_claim.py +252 -252
  266. package/md_cg/test_p36_kp_align.py +230 -230
  267. package/md_cg/test_p37_condition_space.py +248 -248
  268. package/md_cg/test_p38_contextualize.py +273 -273
  269. package/md_cg/test_p39_vision_evidence.py +369 -369
  270. package/md_cg/test_p41_evolve_patrol.py +224 -224
  271. package/md_cg/test_p42_provenance.py +269 -269
  272. package/md_cg/test_p44_md_whitebox.py +231 -231
  273. package/md_cg/test_p45_session_identity.py +466 -466
  274. package/md_cg/test_p46_unit_scope.py +272 -272
  275. package/md_cg/test_p4_fuzzy.py +223 -223
  276. package/md_cg/test_p5_semantic.py +226 -226
  277. package/md_cg/test_p6_consolidate.py +822 -822
  278. package/md_cg/test_p7_goals_recent.py +202 -202
  279. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  280. package/md_cg/test_p8_subgraph_chain.py +213 -213
  281. package/md_cg/test_p9_forget_protect.py +238 -238
  282. package/md_cg/test_preflight_failclosed.py +100 -100
  283. package/md_cg/test_progressive.py +146 -146
  284. package/md_cg/test_propose_tail_index.py +157 -157
  285. package/md_cg/test_protect_stats_parity.py +141 -0
  286. package/md_cg/test_protocol.py +272 -272
  287. package/md_cg/test_rank_parity_score_mode.py +522 -522
  288. package/md_cg/test_reach_keys.py +201 -201
  289. package/md_cg/test_read_clip.py +141 -141
  290. package/md_cg/test_read_face_input_gates.py +363 -363
  291. package/md_cg/test_read_face_semantics.py +492 -492
  292. package/md_cg/test_read_scope_b27.py +277 -277
  293. package/md_cg/test_readcache_default_on.py +168 -168
  294. package/md_cg/test_readcache_precise_inval.py +270 -270
  295. package/md_cg/test_recall_metadata.py +422 -422
  296. package/md_cg/test_reconcile_v0.py +294 -294
  297. package/md_cg/test_retr_s1.py +344 -344
  298. package/md_cg/test_retr_s1b.py +276 -276
  299. package/md_cg/test_retr_s3.py +194 -194
  300. package/md_cg/test_retr_s4.py +163 -163
  301. package/md_cg/test_retr_s6.py +157 -157
  302. package/md_cg/test_retr_s7.py +392 -392
  303. package/md_cg/test_retr_s8_time.py +369 -369
  304. package/md_cg/test_retr_s9_edges.py +286 -286
  305. package/md_cg/test_retr_score_once.py +220 -220
  306. package/md_cg/test_review_cli_attribution.py +181 -181
  307. package/md_cg/test_review_cli_visibility.py +235 -235
  308. package/md_cg/test_review_conformance.py +385 -385
  309. package/md_cg/test_review_dual_check.py +97 -0
  310. package/md_cg/test_review_onepass.py +170 -170
  311. package/md_cg/test_review_queue_batch.py +123 -123
  312. package/md_cg/test_review_queue_index.py +130 -130
  313. package/md_cg/test_role_views.py +354 -354
  314. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  315. package/md_cg/test_security_audit_v21.py +249 -249
  316. package/md_cg/test_sem_noise.py +242 -242
  317. package/md_cg/test_server_version.py +67 -67
  318. package/md_cg/test_session5_identity.py +93 -93
  319. package/md_cg/test_session_attribution_consistency.py +813 -813
  320. package/md_cg/test_session_identity_tristate.py +486 -486
  321. package/md_cg/test_session_isolation.py +168 -168
  322. package/md_cg/test_sleep.py +668 -668
  323. package/md_cg/test_sleep_gitlock.py +134 -134
  324. package/md_cg/test_snapshot_autoclose.py +187 -187
  325. package/md_cg/test_spatial_coords3d.py +292 -292
  326. package/md_cg/test_srcindex.py +171 -171
  327. package/md_cg/test_state_events.py +178 -178
  328. package/md_cg/test_state_slots.py +691 -691
  329. package/md_cg/test_subproc_encoding.py +192 -192
  330. package/md_cg/test_sustain_mutual.py +153 -153
  331. package/md_cg/test_tail_watermark_race.py +208 -208
  332. package/md_cg/test_tasks.py +409 -409
  333. package/md_cg/test_tenant_env_override_warn.py +152 -152
  334. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  335. package/md_cg/test_time_core_lint.py +9 -0
  336. package/md_cg/test_token_lowercase_form.py +315 -315
  337. package/md_cg/test_transfer.py +180 -180
  338. package/md_cg/test_trust.py +361 -361
  339. package/md_cg/test_twophase.py +286 -286
  340. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  341. package/md_cg/test_unify_default_off.py +701 -701
  342. package/md_cg/test_unify_scope.py +182 -182
  343. package/md_cg/test_units_poll.py +71 -71
  344. package/md_cg/test_v21r1_package_version.py +310 -310
  345. package/md_cg/test_validity_filter.py +280 -280
  346. package/md_cg/test_verify_answer.py +138 -138
  347. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  348. package/md_cg/test_w5_path_fingerprint.py +381 -381
  349. package/md_cg/test_wisdom_md_store.py +292 -292
  350. package/md_cg/test_writegate_tiers.py +111 -0
  351. package/md_cg/test_writelimit.py +224 -224
  352. package/md_cg/test_writepipe.py +4 -2
  353. package/md_cg/tokens.py +114 -8
  354. package/md_cg/units.py +869 -869
  355. package/md_cg/version_anchor.py +160 -0
  356. package/md_cg/vision_evidence.py +667 -667
  357. package/md_cg/whitebox_kb/__init__.py +37 -37
  358. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  359. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  360. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  361. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  362. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  363. package/md_cg/whitebox_kb/engine.py +310 -310
  364. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  365. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  366. 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
  367. 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
  368. 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
  369. 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
  370. 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
  371. 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
  372. 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
  373. 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
  374. 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
  375. 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
  376. 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
  377. 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
  378. 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
  379. 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
  380. 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
  381. 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
  382. 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
  383. 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
  384. 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
  385. 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
  386. 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
  387. 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
  388. 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
  389. 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
  390. 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
  391. 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
  392. 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
  393. 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
  394. 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
  395. 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
  396. 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
  397. 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
  398. 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
  399. 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
  400. 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
  401. 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
  402. 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
  403. 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
  404. 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
  405. 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
  406. 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
  407. 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
  408. 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
  409. 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
  410. 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
  411. 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
  412. 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
  413. 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
  414. 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
  415. 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
  416. 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
  417. 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
  418. 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
  419. 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
  420. 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
  421. 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
  422. 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
  423. 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
  424. 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
  425. 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
  426. 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
  427. 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
  428. 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
  429. 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
  430. 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
  431. 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
  432. 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
  433. 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
  434. 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
  435. 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
  436. 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
  437. 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
  438. 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
  439. 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
  440. 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
  441. 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
  442. 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
  443. 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
  444. 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
  445. 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
  446. 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
  447. 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
  448. 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
  449. 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
  450. 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
  451. 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
  452. 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
  453. 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
  454. 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
  455. 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
  456. 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
  457. 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
  458. 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
  459. 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
  460. 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
  461. 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
  462. 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
  463. 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
  464. 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
  465. 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
  466. 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
  467. 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
  468. 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
  469. 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
  470. 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
  471. 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
  472. 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
  473. 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
  474. 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
  475. 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
  476. 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
  477. 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
  478. 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
  479. 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
  480. 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
  481. 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
  482. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  483. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  484. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  485. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  486. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  487. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  488. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  489. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  490. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  491. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  492. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  493. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  494. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  495. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  496. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  497. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  498. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  499. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  500. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  501. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  502. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  503. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  504. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  505. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  506. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  507. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  508. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  509. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  510. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  511. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  512. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  513. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  514. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  515. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  516. 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
  517. 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
  518. 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
  519. 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
  520. 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
  521. 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
  522. 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
  523. 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
  524. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  525. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  526. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  527. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  528. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  529. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  530. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  531. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  532. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  533. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  534. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  535. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  536. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  537. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  538. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  539. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  540. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  541. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  542. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  543. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  544. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  545. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  546. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  547. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  548. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  549. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  550. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  551. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  552. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  553. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  554. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  555. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  556. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  557. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  558. package/md_cg/writegate.py +146 -0
  559. package/md_cg/writepipe.py +85 -7
  560. package/package.json +21 -7
  561. package/scripts/workspace_index.py +1 -0
  562. package/skills/README.md +121 -121
  563. package/skills/plugin.json +54 -54
  564. package/skills/skills/designer-perspective/SKILL.md +158 -158
  565. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  566. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  567. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  568. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  569. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  570. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  571. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  572. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  573. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  574. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  663. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  664. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  665. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  666. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  667. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  668. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  669. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  670. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  671. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  672. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  673. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  674. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  675. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  676. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  677. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  679. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  780. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  781. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  782. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  783. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  784. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  785. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  786. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  787. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  788. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  789. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  790. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  791. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  792. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  793. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  794. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  796. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  898. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  899. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  900. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  901. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  902. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  903. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  904. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  905. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  906. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  907. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  908. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  909. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  910. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  911. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  912. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/SKILL.md +48 -48
  914. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1017. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1021. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1032. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1130. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1134. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1145. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1250. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1251. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1252. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1253. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1254. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1255. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1256. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1257. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1258. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1259. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1260. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1261. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1262. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1263. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1264. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1265. package/src/hooks.ts +48 -31
  1266. package/src/index.ts +3 -0
  1267. package/src/lib/console_web.mjs +96 -0
  1268. package/src/lib/python_path.ts +71 -71
  1269. package/src/lib/session_state.ts +127 -127
  1270. package/src/lib/whitebox_llm.ts +311 -311
  1271. package/ui/minimal/LICENSE +21 -0
  1272. package/ui/minimal/install.ps1 +168 -0
  1273. package/ui/minimal/integrity.json +41 -0
  1274. package/ui/minimal/payload/build-ui.mjs +16 -0
  1275. package/ui/minimal/payload/lib/client.js +18 -0
  1276. package/ui/minimal/payload/lib/lib/console_web.mjs +96 -0
  1277. package/ui/minimal/payload/src/lib/console_web.mjs +96 -0
  1278. package/ui/minimal/payload/web/app.js +154 -0
  1279. package/ui/minimal/payload/web/client.js +14 -0
  1280. package/ui/minimal/payload/web/entry.js +1 -0
  1281. package/ui/minimal/payload/web/index.html +3 -0
  1282. package/ui/minimal/payload/web/style.css +3 -0
  1283. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1284. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1285. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1286. package/utf8_boot.py +237 -237
  1287. package/web/app.js +154 -0
  1288. package/web/client.js +14 -0
  1289. package/web/entry.js +1 -0
  1290. package/web/index.html +3 -0
  1291. package/web/style.css +3 -0
  1292. package/zcode/AGENTS.md +8 -3
  1293. package/zcode/README.md +41 -41
package/md_cg/units.py CHANGED
@@ -1,870 +1,870 @@
1
- # -*- coding: utf-8 -*-
2
- """units.py · 复核单元接线层:蜂巢优先 → 提示配置 → harness 端子代理降级。
3
-
4
- 定位(与 audit.py 同一条架构约束):**能力不在认知图内**。本模块不做智能判定,
5
- 只做三件事:选通道(probe/plan)→ 派发请求(submit/wait/run)→ 记账(_units.jsonl)。
6
-
7
- 使用者裁定(2026-09-16,第 17 条精神):编译器(ccgc)的复核**优先使用蜂巢的
8
- 反思单元 / 验证单元**(reflect / verify,与 crosscheck.REFLECT_UNIT/VERIFY_UNIT 同值,
9
- 不新造角色名);蜂巢不可用 → **提示使用者配置**(给出可照做的构建/启动/环境变量命令);
10
- 或经显式 allow_degrade=True 降级到 **harness 端子代理**(宿主 agent 派发,裁决经
11
- crosscheck 同款 verdicts 通道回填)。理由:使用者的复核是昂贵的——重活交给可并行的
12
- 外部单元,agent 本体只做编排与记账。
13
-
14
- 蜂巢契约(真源 hive/README.md + hive/hive_mcp/mcp_server.py;**复制契约不 import**,
15
- 保持 md_cg 对 hive 零依赖,与 ccgc「同款语义就地实现防 import 环」惯例一致):
16
- jobs 目录 = $HIVE_JOBS_DIR | <repo>/hive/jobs
17
- serve 判活 = **三层**:jobs/_serve.json 的 ts(毫秒)距今 < FRESH_S(15s)
18
- ∧ pid 存活 ∧ 该 pid 是本程序
19
- (同 hive/serve_start.serve_alive;四路口径由
20
- hive/test_serve_entry.py 机械守卫)
21
- job 目录 = jobs/<job_id>/{spec.json,status.json,result.json,kill}
22
- job_id = 本模块自造旧形态 h<java_ms>_<uuid6>(`_job_id`,**不是** `_submit` 同款);
23
- hive 提交面自 id 契约 v2(B8)起为四槽 h_<身份>_<任务>_<单元>_<编号>,由
24
- Rust 侧 `hive alloc-id` 分配——两形态都过 job.rs::valid_job_id(存量零迁移)
25
- id 字符判据 = **区块白名单**:唯一真源 hive/id_charset_blocks.txt 的区间并集
26
- ([`_valid_job_id`];本模块**读这份数据文件**、不 import hive,
27
- 与 job.rs / mcp_server.py 三处共读同一份 ⇒ 不查任何 Unicode 属性库,
28
- 两侧版本差结构性不可能)。本闸**有意保留**两处放宽(既有对外契约):
29
- 不要求 h 前缀、允许 `-`;拒收面(零宽/双向控制/控制字符/路径成分/尾点/
30
- 首尾空白/Windows 保留设备名)逐条显式断,不靠「白名单外顺带拒」。
31
- result.json = {"ok":true,"content":...} | {"ok":false,"error":...}
32
- 终态 = done | error | timeout | killed
33
- 拉起 serve = <repo>/hive/target/release/hive serve --jobs <jobs>(detached)
34
-
35
- 边界(诚实声明,不猜测):
36
- · 本模块**不产生裁决**,只搬运;裁决由外部单元负责。
37
- · 契约漂移:hive 侧协议若变更,本模块以「无 result / 超时」如实失败,不假装成功。
38
- · 默认**不自动拉起 serve**(使用者裁定:不可用即提示配置);autostart=True 才拉起。
39
- """
40
- from __future__ import annotations
41
-
42
- import json
43
- import os
44
- import re
45
- import subprocess
46
- import time
47
- import uuid
48
-
49
- HIVE, SUBAGENT, CONFIGURE = "hive", "subagent", "configure"
50
- STATES = (HIVE, SUBAGENT, CONFIGURE)
51
-
52
- REFLECT, VERIFY = "reflect", "verify" # 同 crosscheck.REFLECT_UNIT/VERIFY_UNIT
53
- ROLES = (REFLECT, VERIFY)
54
-
55
- SERVE_FILE, SPEC_FILE = "_serve.json", "spec.json"
56
- STATUS_FILE, RESULT_FILE, KILL_FILE = "status.json", "result.json", "kill"
57
- LOG_NAME = "_units.jsonl"
58
- TERMINAL_STATES = ("done", "error", "timeout", "killed")
59
- #: serve 心跳新鲜窗口(秒)。**须与 hive/serve_start.FRESH_S 同值**——本模块
60
- #: 只持有「判活的第 4 处实现」(复制契约不 import hive),阈值/判据结构若与
61
- #: 权威漂移,会在通道选择面复现 v13 的「假存活」病类(v14 缺陷 E:
62
- #: 旧值 5.0 vs 权威 15,serve 崩溃后 ≤5s 窗口内判「存活」→ 选 hive 通道 →
63
- #: 提交的 job 永远无人处理)。守卫:hive/test_serve_entry.py。
64
- FRESH_S, DEFAULT_TIMEOUT_S, DEFAULT_POLL_S = 15.0, 120, 1.0
65
- #: 复核委派的 completion 预算。**必须对齐统一默认(文档:最大输出 200000)**——
66
- #: 该模型 reasoning 与正文**共享 completion 预算**,小预算会把正文吃光并静默返回空正文:
67
- #: 实测 2048 → reasoning 2048 / content 空;16384 → 时好时坏;200000 → 正常出裁决。
68
- DEFAULT_MAX_TOKENS = 200000
69
-
70
- ENV_JOBS_DIR, ENV_EXE = "HIVE_JOBS_DIR", "HIVE_EXE"
71
- ENV_MODEL, ENV_API_KEY = "MDCG_UNIT_MODEL", "HIVE_API_KEY"
72
-
73
- ACCEPT, REJECT, DEFER, BLINDSPOT = "ACCEPT", "REJECT", "DEFER", "BLINDSPOT"
74
- _VERDICT_MAP = {
75
- "accept": ACCEPT, "accepted": ACCEPT, "keep": ACCEPT, "pass": ACCEPT,
76
- "ok": ACCEPT, "approve": ACCEPT,
77
- "drop": REJECT, "reject": REJECT, "rejected": REJECT, "deny": REJECT, "fail": REJECT,
78
- "defer": DEFER, "deferred": DEFER, "unsure": DEFER, "unclear": DEFER, "skip": DEFER,
79
- "blindspot": BLINDSPOT, "blind": BLINDSPOT,
80
- }
81
-
82
-
83
- # 生效条件:无入参,恒返回模块 `__file__` 绝对路径上溯两级的目录(md_cg 的上一级),与 cwd 无关。
84
- def repo_root() -> str:
85
- """仓库根(md_cg 的上一级);不用 cwd——cwd 由宿主决定,不可作判据。"""
86
- return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
87
-
88
-
89
- # 生效条件:explicit 为真值时 d=explicit;explicit 为空串等假值而 ENV_JOBS_DIR 有真值时 d=该环境变量;两者皆假值时 d=repo_root()/hive/jobs;最终返回 os.path.abspath(d)。
90
- def jobs_dir(explicit: str = "") -> str:
91
- d = explicit or os.environ.get(ENV_JOBS_DIR) or os.path.join(repo_root(), "hive", "jobs")
92
- return os.path.abspath(d)
93
-
94
-
95
- # 生效条件:ENV_EXE 有真值时原样返回该值;ENV_EXE 缺失或为空串时返回 repo_root()/hive/target/release/ 下按 os.name=="nt" 取 hive.exe、否则取 hive 的拼接路径。
96
- def exe_path() -> str:
97
- exe = os.environ.get(ENV_EXE)
98
- if exe:
99
- return exe
100
- return os.path.join(repo_root(), "hive", "target", "release",
101
- "hive.exe" if os.name == "nt" else "hive")
102
-
103
-
104
- # 生效条件:explicit 为真值时取 explicit,否则取 ENV_MODEL,两者皆假值时按空串,返回该结果 strip() 后的字符串(可为空串)。
105
- def model_name(explicit: str = "") -> str:
106
- """复核模型(LLM 委托型执行器的 spec.model 必填)。"""
107
- return (explicit or os.environ.get(ENV_MODEL) or "").strip()
108
-
109
-
110
- # 生效条件:pid 为 int 且大于 0 时(否则 False),os.name 为 "nt" 时返回 _tasklist_row(pid) 是否非 None,非 "nt" 时 os.kill(pid, 0) 不抛 OSError 返回 True、抛 OSError 返回 False。
111
- def pid_alive(pid) -> bool:
112
- """该 pid **号**是否存在(Windows tasklist 精确列比对 / unix `kill -0`)。
113
-
114
- 只回答「这个号有没有进程」——**不足以判定「serve 还在跑」**(见
115
- `pid_is_self_program`)。实现与 hive/serve_start.pid_alive 同口径。
116
- """
117
- if not isinstance(pid, int) or pid <= 0:
118
- return False
119
- if os.name == "nt":
120
- return _tasklist_row(pid) is not None
121
- try:
122
- os.kill(pid, 0)
123
- return True
124
- except OSError:
125
- return False
126
-
127
-
128
- # 生效条件:对传入 pid 执行 tasklist /FO CSV 后,在其 stdout 中遇到的第一个按 '","' 切分、列数≥2 且第 2 列 strip 再 strip('"') 后等于 str(pid) 的行即返回 [映像名, pid 字符串],无此行或 subprocess.run 抛 OSError 时返回 None。
129
- def _tasklist_row(pid):
130
- """Windows:查该 pid 的 tasklist 行 → [映像名, pid 字符串];查不到返回 None。
131
-
132
- 按列精确比对,**不用子串包含**——子串会让 pid=441 被 4410 命中(假存活)。
133
- """
134
- try:
135
- # 显式 utf-8 + replace:只消费 ASCII 的 pid 列,但**不依赖 locale**——
136
- # locale 口径与「后代写 UTF-8」不一致时读线程会崩(见 test_subproc_encoding.py)。
137
- # P2-16(批次 30):timeout=10——tasklist 挂起曾永久阻塞判活路径。
138
- # stdin=subprocess.DEVNULL(issue #63 同批加固):不指定 stdin 时子进程
139
- # 继承父进程 stdin(常驻宿主下是 JSON-RPC 活管道)——判活路径不得因
140
- # 子进程读 stdin 而悬挂;形态对齐 `md_cg/run_tests.py:105`。
141
- r = subprocess.run(["tasklist", "/FI", f"PID eq {pid}", "/NH", "/FO", "CSV"],
142
- capture_output=True, text=True, stdin=subprocess.DEVNULL,
143
- encoding="utf-8", errors="replace", timeout=10)
144
- except (OSError, subprocess.SubprocessError):
145
- return None
146
- for line in (r.stdout or "").splitlines():
147
- cols = line.split('","')
148
- if len(cols) >= 2 and cols[1].strip().strip('"') == str(pid):
149
- return [cols[0].strip().strip('"'), cols[1].strip().strip('"')]
150
- return None
151
-
152
-
153
- # 生效条件:exe_path() 的 basename 小写非空且 pid 为 int 大于 0 时(否则 False),"nt" 下要求 _tasklist_row(pid) 非空且映像名小写等于该 basename,非 "nt" 下要求 /proc/<pid>/cmdline 首个 b"\x00" 前 token 的 basename 小写等于它(读取抛 OSError 则 False)。
154
- def pid_is_self_program(pid) -> bool:
155
- """该 pid 是否**就是本程序**(同映像名)——pid 号会被无关进程复用。
156
-
157
- 与 hive/serve_start.pid_is_self_program 同口径(复制契约)。零依赖边界:
158
- 拿不到映像名返回 False(宁可放行启动,也不误报「已有 serve 在跑」)。
159
- """
160
- want = os.path.basename(exe_path()).lower()
161
- if not want or not isinstance(pid, int) or pid <= 0:
162
- return False
163
- if os.name == "nt":
164
- row = _tasklist_row(pid)
165
- return bool(row) and row[0].lower() == want
166
- try:
167
- with open(f"/proc/{pid}/cmdline", "rb") as f:
168
- first = f.read().split(b"\x00")[0]
169
- except OSError:
170
- return False
171
- return os.path.basename(first.decode("utf-8", "replace")).lower() == want
172
-
173
-
174
- # 生效条件:以 jobs_dir(jobs) 下的 SERVE_FILE 为心跳路径——该路径不被 isfile 命中时返回 exists/alive 均 False 的未启动 reason;命中但 open/json.load 抛 OSError 或 ValueError 时返回不可读 reason;解析成功后按**三层判据**(age < fresh_s ∧ pid_alive(pid) ∧ pid_is_self_program(pid))定 alive,回填 age_s/pid/raw 与逐层明细及失败原因。
175
- def serve_state(jobs: str = "", fresh_s: float = FRESH_S) -> dict:
176
- """serve 判活:**三层**(心跳新鲜 ∧ pid 存活 ∧ 该 pid 是本程序)。
177
-
178
- 与 `hive/serve_start.serve_alive` 同口径(同值 FRESH_S=15s、同三层判据)。
179
- v14 缺陷 E:旧实现只判 ts 新鲜度且阈值 5s——双漂移,serve 崩溃后
180
- ≤5s 内判「存活」会让 `probe()` 选 hive 通道(提交的 job 永远无人处理),
181
- 这正是 v13「假存活」病类从守卫面搬到了**通道选择面**。
182
- """
183
- jd = jobs_dir(jobs)
184
- p = os.path.join(jd, SERVE_FILE)
185
- out = {"jobs_dir": jd, "heartbeat": p, "exists": os.path.isfile(p),
186
- "alive": False, "age_s": None, "pid": None, "reason": ""}
187
- if not out["exists"]:
188
- out["reason"] = "未见 _serve.json 心跳(serve 未启动或 jobs 目录不对)"
189
- return out
190
- try:
191
- with open(p, encoding="utf-8") as f:
192
- hb = json.load(f)
193
- except (OSError, ValueError) as exc:
194
- out["reason"] = "心跳不可读:%s: %s" % (type(exc).__name__, exc)
195
- return out
196
- age = time.time() - ((hb.get("ts") or 0) / 1000.0)
197
- pid = hb.get("pid")
198
- fresh_ok = age < float(fresh_s)
199
- pid_ok = pid_alive(pid)
200
- ident_ok = pid_is_self_program(pid)
201
- out.update({"age_s": round(age, 3), "pid": pid, "raw": hb,
202
- "fresh": bool(fresh_ok), "pid_alive": bool(pid_ok),
203
- "pid_is_self_program": bool(ident_ok)})
204
- out["alive"] = bool(fresh_ok and pid_ok and ident_ok)
205
- if out["alive"]:
206
- out["reason"] = ""
207
- elif not fresh_ok:
208
- out["reason"] = "心跳过期 %.1fs(阈值 %ss)——serve 可能已退出" % (age, fresh_s)
209
- elif not pid_ok:
210
- out["reason"] = "心跳新鲜但 pid=%s 已不存在——serve 已退出" % (pid,)
211
- else:
212
- out["reason"] = ("心跳新鲜且 pid=%s 存活,但该 pid 不属于本程序"
213
- "(非 %s)——pid 号被无关进程复用"
214
- % (pid, os.path.basename(exe_path())))
215
- return out
216
-
217
-
218
- # 生效条件:jobs 仅经 jobs_dir(jobs) 用于填充指引里的 jobs 路径;reason 为假值时文案首行取“serve 未存活”,否则取 reason 原文;返回模板固定嵌入 exe_path() 的目录与路径、ENV_API_KEY、ENV_MODEL、jd、jd 下的 SERVE_FILE 与 int(FRESH_S)。
219
- def setup_hint(jobs: str = "", reason: str = "") -> str:
220
- """不可用时给使用者看的**配置指引**(含降级指引)——提示即责任,须可照着做。"""
221
- jd = jobs_dir(jobs)
222
- return ("蜂巢不可用:%s\n"
223
- " [A 配置蜂巢(推荐,第 17 条)]\n"
224
- " 1) cd %s && cargo build --release\n"
225
- " 2) set %s=<LLM密钥>\n 3) set %s=<复核模型名>\n"
226
- " 4) 启动:%s serve --jobs \"%s\"(或 hive_spawn 自动拉起)\n"
227
- " 判活判据:%s 的 ts 距今 < %ss\n"
228
- " [B 降级 harness 端子代理]\n"
229
- " 重发本请求并带 allow_degrade=true:本模块返回复核请求包(prompt),\n"
230
- " 由宿主子代理执行后经 verdicts 回填裁决。"
231
- % (reason or "serve 未存活", os.path.dirname(exe_path()), ENV_API_KEY,
232
- ENV_MODEL, exe_path(), jd, os.path.join(jd, SERVE_FILE), int(FRESH_S)))
233
-
234
-
235
- # 生效条件:先取 st=serve_state(jobs, fresh_s) 与 mdl=model_name(model);st["alive"] 为真且 mdl 非空时返回 state=HIVE;否则 allow_degrade 为真时返回 state=SUBAGENT 且 channel 取 channel 或 "harness-subagent";否则返回 state=CONFIGURE、transport=None 并附 setup_hint(jobs, why)。
236
- def probe(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
237
- allow_degrade: bool = False, channel: str = "") -> dict:
238
- """三级能力探测:hive(可派发)→ configure(提示配置)→ subagent(显式降级)。
239
-
240
- 判据只认**心跳 + 模型名**两项硬前提;缺任一即如实降级,绝不用相似度
241
- (如「hive 目录存在」)冒充可用(资格由条件证据裁决,不由相似度裁决)。
242
- """
243
- st = serve_state(jobs, fresh_s)
244
- mdl = model_name(model)
245
- if st["alive"] and mdl:
246
- return {"state": HIVE, "transport": HIVE, "model": mdl, "jobs_dir": st["jobs_dir"],
247
- "serve": st, "channel": "", "hint": ""}
248
- why = st["reason"] if not st["alive"] else "serve 存活但未配置复核模型(%s)" % ENV_MODEL
249
- if allow_degrade:
250
- return {"state": SUBAGENT, "transport": SUBAGENT, "model": mdl,
251
- "jobs_dir": st["jobs_dir"], "serve": st,
252
- "channel": channel or "harness-subagent",
253
- "hint": "已按 allow_degrade 降级到 harness 端子代理:请把 prompt 交给宿主子代理,"
254
- "裁决经 verdicts 回填(蜂巢不可用原因:%s)" % why}
255
- return {"state": CONFIGURE, "transport": None, "model": mdl,
256
- "jobs_dir": st["jobs_dir"], "serve": st, "channel": "",
257
- "hint": setup_hint(jobs, why)}
258
-
259
-
260
- # 生效条件:state/transport/model/jobs_dir/serve/channel/hint 全部直接取自 probe(jobs, model, fresh_s, allow_degrade, channel) 的对应键,本函数不另做判活或模型判断,仅在 chain 文案中固定引用 int(FRESH_S) 与 ENV_MODEL。
261
- def plan(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
262
- allow_degrade: bool = False, channel: str = "") -> dict:
263
- """优先级链自描述(供 cg op=ccg action=units 与审计查看)。"""
264
- p = probe(jobs, model, fresh_s, allow_degrade, channel)
265
- return {"state": p["state"], "transport": p["transport"], "model": p["model"],
266
- "jobs_dir": p["jobs_dir"], "serve": p["serve"], "channel": p["channel"],
267
- "chain": [
268
- {"order": 1, "transport": HIVE, "action": "派发 reflect/verify 单元并等待 result.json",
269
- "when": ("jobs/_serve.json 心跳 < %ss 且(%s 已配置 **或调用方显式传 model**)"
270
- % (int(FRESH_S), ENV_MODEL))},
271
- {"order": 2, "transport": CONFIGURE, "action": "返回配置指引(不自动拉起、不假装通过)",
272
- "when": "蜂巢不可用"},
273
- {"order": 3, "transport": SUBAGENT, "action": "返回复核请求包,由 harness 端子代理执行并回填",
274
- "when": "调用方显式 allow_degrade=True"},
275
- ],
276
- "hint": p["hint"]}
277
-
278
-
279
- # ---------------------------------------------------------------- 派发与收取
280
-
281
- # 生效条件:无入参,恒返回 "h"+int(time.time()*1000)+"_"+uuid.uuid4().hex 前 6 位组成的字符串。
282
- def _job_id() -> str:
283
- """本地 id 生成(旧形态 `h<毫秒>_<uuid 前 6 位>`):serve 侧按 'h' 前缀识别任务目录。
284
-
285
- 诚实边界(id 契约 v2 · C2 同类措辞订正):**本函数已不是 `_submit` 的同款实现**
286
- ——`hive/hive_mcp/mcp_server.py::_submit` 自 B8 起调 Rust 侧 `hive alloc-id` 分配
287
- `h_<身份>_<任务>_<单元>_<编号>`,**不再自造 id**;本模块是 md_cg 的复核派发面,
288
- **不在 B8 点名的改动面**(契约只列 CLI / MCP 提交面 / orch 透传),故保留旧形态。
289
- 旧形态 id 在新契约下**仍然合法**(存量零迁移:`job.rs::valid_job_id` 收),故此处
290
- 不闯闸、不破坏 serve 领取;但它绕过了分配器的独占创建与五单元闭集 ⇒ 与「分配器
291
- 唯一实现在 Rust 侧」(契约 §五 裁决 3)不齐,宜单独裁决(牵动 md_cg 派发/等待链
292
- 语义与其守卫 `md_cg/test_units_poll.py`,不在本批「只论证订正」的范围内)。
293
- """
294
- return "h%d_%s" % (int(time.time() * 1000), uuid.uuid4().hex[:6])
295
-
296
-
297
- # ------------------------------------------------ id 字符判据(区块白名单 · 唯一真源)
298
-
299
- #: 区块表数据文件(**唯一真源**,与 `hive/src/job.rs` / `hive/hive_mcp/mcp_server.py`
300
- #: **共读同一份数据**;本模块**读数据文件**而不是 import hive ⇒ 不破零依赖家法)。
301
- _CHARSET_BLOCKS_REL = "hive/id_charset_blocks.txt"
302
- _MAX_CP = 0x10FFFF
303
-
304
-
305
- # 生效条件:text 为表文件全文时返回区间列表 [(起, 止)]——**唯一解析配方**(与 Rust
306
- # `job.rs::parse_id_charset_blocks`、`mcp_server._parse_charset_blocks` 同一条,不许各写
307
- # 一套):每行取 `#` 之前部分后 strip;空行跳过;余下 split('-') 两段 int(x, 16)。
308
- # 任一行不合形态 / 越界 / 逆序 / 未归并到最小 / 空表 → 抛 ValueError(fail-closed:
309
- # 绝不静默跳过坏行——跳过一行的表是另一张表,三处读者随即不同判)。
310
- def _parse_charset_blocks(text: str) -> list:
311
- """区块表解析(唯一配方)。"""
312
- out: list = []
313
- for lineno, line in enumerate(text.split("\n"), 1):
314
- body = line.split("#", 1)[0].strip()
315
- if not body:
316
- continue
317
- parts = body.split("-")
318
- if len(parts) != 2:
319
- raise ValueError("区块表第 %d 行不是 LO-HI 形态:%r" % (lineno, line))
320
- lo, hi = int(parts[0], 16), int(parts[1], 16)
321
- if not (0 <= lo <= hi <= _MAX_CP):
322
- raise ValueError("区块表第 %d 行区间非法:%r" % (lineno, line))
323
- if out and lo <= out[-1][1] + 1:
324
- raise ValueError("区块表第 %d 行未归并到最小(相邻/相交/乱序):%r"
325
- % (lineno, line))
326
- out.append((lo, hi))
327
- if not out:
328
- raise ValueError("区块表解析出空区间集(fail-closed:空表绝不放行)")
329
- return out
330
-
331
-
332
- # 生效条件:无入参,返回 (区间表, 错误说明)——文件可读且解析通过 → (tuple 区间表, None);
333
- # 表缺失 / 不可读 / 解析失败 → ((), 原因)。后两者让判据 fail-closed(对一切字符 False)。
334
- def _load_charset_blocks() -> tuple:
335
- """**模块导入时读一次**(不做每调用 I/O);路径基准 = 本文件上溯两级(= 仓根)。"""
336
- path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
337
- "hive", "id_charset_blocks.txt")
338
- try:
339
- with open(path, encoding="utf-8") as fh:
340
- text = fh.read()
341
- except OSError as exc:
342
- return (), "%s 不可读:%s" % (_CHARSET_BLOCKS_REL, exc)
343
- try:
344
- return tuple(_parse_charset_blocks(text)), None
345
- except ValueError as exc:
346
- return (), "%s 解析失败:%s" % (_CHARSET_BLOCKS_REL, exc)
347
-
348
-
349
- #: 判据数据(模块导入时求值一次):区间表 + 读取/解析错误(错误非 None ⇒ 判据一律 False)。
350
- CHARSET_BLOCKS, CHARSET_BLOCKS_ERROR = _load_charset_blocks()
351
-
352
-
353
- # 生效条件:c 为单字符且其码点落在区间表内 → True;表缺失 / 坏行 / 空表 → False
354
- # (fail-closed:绝不放行)。
355
- def _charset_member(c: str) -> bool:
356
- u = ord(c)
357
- return any(lo <= u <= hi for lo, hi in CHARSET_BLOCKS)
358
-
359
-
360
- # Windows 保留设备名(B4 拒收项;与 `job.rs::RESERVED_DEVICE_NAMES`、
361
- # `mcp_server.RESERVED_DEVICE_NAMES` 逐项同集——md_cg 只复制这 22 个常量,**还是读数据
362
- # 而不是 import hive**)。Win32 对**单个路径分量**做设备名解析且**忽略扩展名**
363
- # (`CON.txt` 与 `CON` 同指设备),故比对的是「首个 `.` 之前」部分;比对**ASCII 大小写
364
- # 不敏感**(不用 str.upper():它的 Unicode 折叠面比 Rust 的 eq_ignore_ascii_case 宽,
365
- # 会让两侧分叉)。
366
- RESERVED_DEVICE_NAMES = (
367
- "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6",
368
- "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6",
369
- "LPT7", "LPT8", "LPT9",
370
- )
371
- _ASCII_UPPER = str.maketrans("abcdefghijklmnopqrstuvwxyz",
372
- "ABCDEFGHIJKLMNOPQRSTUVWXYZ")
373
-
374
-
375
- # 生效条件:s 的「首个 `.` 之前」部分与任一保留设备名 **ASCII 大小写不敏感**相等 → True
376
- # (含 `CON.txt` 这类带扩展名形态)——与 rust `job::is_reserved_device_name` 同判。
377
- def _is_reserved_device_name(s: str) -> bool:
378
- base = s.split(".")[0].translate(_ASCII_UPPER)
379
- return base in RESERVED_DEVICE_NAMES
380
-
381
-
382
- # 生效条件:jid 为 str、长度 1..128、strip() 前后无差异(首尾无空白)、首尾字符都不是
383
- # "."(拒 "."/".."/"..." 与 Win32 会剥尾点的 "abc." 形态)、逐字符过显式拒收集合后落在
384
- # **区块白名单**([`_charset_member`],唯一真源 `hive/id_charset_blocks.txt`,与 hive 两侧
385
- # 共读同一份数据)或属结构字符 `_` `-` `.`,且整 id 与其按 `_` 分段的任一段都不是
386
- # Windows 保留设备名、且按 `_` 分段的**任一段都不等于** `.` 或 `..`(c7 段级)时返回 True,
387
- # 否则 False。
388
- def _valid_job_id(jid) -> bool:
389
- r"""job_id 结构闸(N178,2026-09-28;2026-09-30 字符集判据换面为**区块白名单**)。
390
-
391
- 同族家法:`hive/hive_mcp/mcp_server.py::_valid_job_id`、
392
- `hive/src/job.rs::valid_job_id`(三处**共读同一份区块表**,不是三套常量)。
393
- 本闸**保留**的既有放宽(都是既有对外契约,**不得**为「同口径」收紧):
394
- · **不要求 "h" 前缀**——`md_cg/test_units_poll.py` 的 "j_empty"/"j_good"/
395
- "j_fail" 是本模块对外契约(poll 面向任意宿主派发器写出的 job 目录),前缀
396
- 收紧会误杀;
397
- · 允许 `-`(hive 侧拒它:不在区块表内、也不是它的结构字符);
398
- · 长度上限 128、首尾无空白、首尾非点(拒 "."/".."/"..." 与 "x." 尾点形态)
399
- 一并保留。
400
- 非 str 一律拒(**不** str() 归一:与 legacy P3 同纪律,未校验的强制转换会把对象
401
- 形态洗成合法路径成分)。
402
- 字符类判据 = **区块白名单**(与 hive 两侧同源)——白名单外的一切字符一律拒。
403
- 放宽带来的静默风险**逐条显式挡住**(c9:「isalpha」类判据下 Cf/Cc 天然不入,但
404
- **不能靠这个**):零宽 U+200B..U+200F/U+2060/U+FEFF、双向控制
405
- U+202A..U+202E/U+2066..U+2069、控制字符(C0/DEL/C1)**逐条显式判**;`/` `\` `:`
406
- 与 NUL 同样显式拒(路径成分:相对父段 "../outside"、分隔符、盘符/ADS、绝对路径
407
- 会被 os.path.join 吸附);Windows 保留设备名(CON/PRN/AUX/NUL/COM1..9/LPT1..9,
408
- 含 `CON.txt` 带扩展名形态与 ASCII 大小写变体)**整 id 与按 `_` 分段的任一段**逐名
409
- 显式拒——旧 ASCII 白名单下 `CON` 这类全字母 id 是**放行**的,故这是本闸换面时
410
- **收紧**的那一面(与 hive 两侧同集同判,语料 80-84 行逐例钉死)。
411
- 表缺失 / 坏表 ⇒ 判据一律 False(fail-closed,绝不放行)。
412
- 本闸本批**新增收紧**(c7,2026-09-30):按 `_` 分段的**任一段**等于 `.` 或 `..` 即拒
413
- ——整串口径下 `h_.._x` / `h_a_.._b` 是被收的;段级是面向重构的纵深加固(段可能被当
414
- 父目录段用),与 hive 两侧同判。范围只加这一条:空段(`h__x`)等形态不动。
415
- """
416
- if not isinstance(jid, str) or not jid or len(jid) > 128:
417
- return False
418
- if jid != jid.strip():
419
- return False
420
- if jid[0] == "." or jid[-1] == ".":
421
- return False
422
- for c in jid:
423
- u = ord(c)
424
- if u <= 0x1F or 0x7F <= u <= 0x9F or c in "/\\:":
425
- return False # 控制字符(C0/DEL/C1,含 NUL)与路径成分(显式判,c9)
426
- if "\u200b" <= c <= "\u200f" or c in ("\u2060", "\ufeff"):
427
- return False # 零宽/不可见注入载体(显式判,c9)
428
- if "\u202a" <= c <= "\u202e" or "\u2066" <= c <= "\u2069":
429
- return False # 双向控制(显式判,c9)
430
- if c in "_.-":
431
- continue # 结构字符:槽分隔符 / 点(首尾点已在上方拒)/ 既有放宽的 `-`
432
- if not _charset_member(c):
433
- return False
434
- # Windows 保留设备名(显式判,c7/c9):整 id(首个 `.` 之前部分,Win32 忽略扩展名)
435
- # 与按 `_` 分段的**任一段**(Win32 的设备名解析是按路径分量做的)——与
436
- # `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` 同集同判。
437
- if _is_reserved_device_name(jid):
438
- return False
439
- if any(_is_reserved_device_name(seg) for seg in jid.split("_")):
440
- return False
441
- # 「. / ..」的**段级**判据(c7,2026-09-30 加固):按 `_` 分段,任一段等于 `.` 或 `..`
442
- # 即拒——与 `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` **三处同判**。
443
- # 段级而非整串(本面原有的「首尾非点」只挡整串与尾点形态):id 的段可能被宿主当
444
- # **目录名**或**父目录段**用(契约 §四.4「目录可作它的父段」)。现场定性:`h_.._x` /
445
- # `h_a_.._b` 这类「含 `..` 段但不以点结尾」的 id 拼出的路径停在池内、不构成穿越 ⇒
446
- # 面向重构的纵深加固。范围**只加这一条**:不拒空段(`h__x`)等未被裁定的形态。
447
- if any(seg in (".", "..") for seg in jid.split("_")):
448
- return False
449
- return True
450
-
451
-
452
- # 生效条件:无入参,返回 job_id 非法的结构化拒绝 dict(ok=False、state="invalid_job_id"、terminal=False、job_dir/content/status 均为 None、error 含非法 id 与本闸口径),字段集与 poll 的返回同构。
453
- def _bad_job_id(job_id, *, where: str) -> dict:
454
- """非法 job_id 的统一拒答(poll/wait/submit 同构,便于调用方机械判别)。"""
455
- return {"job_id": job_id, "job_dir": None, "state": "invalid_job_id",
456
- "terminal": False, "ok": False, "content": None, "status": None,
457
- "error": ("job_id 非法:%r(%s)——job_id 须为**单个路径分量**:区块白名单"
458
- "(hive/id_charset_blocks.txt)内的字母/数字,或结构字符 `_` `-` `.`;"
459
- "首尾非点,不含 / \\ : 与控制/零宽/双向控制字符/NUL,"
460
- "且整 id 与按 `_` 分段的任一段都不得是 Windows 保留设备名"
461
- "(CON/PRN/AUX/NUL/COM1..9/LPT1..9,含 CON.txt 形态)"
462
- "(N178:拒 ../victim 型越池读 result.json、"
463
- "拒任意目录建目录写 spec.json)" % (job_id, where))}
464
-
465
-
466
- # 生效条件:cg.root 与 cg.cg.root 都取不到真值时不写、直接返回 None;取到 root 时向 root/LOG_NAME 追加一行 rec(副本,setdefault ts)的 JSON,写入抛 OSError 时被吞掉静默返回 None。
467
- def _log(cg, rec: dict) -> None:
468
- """留痕 _units.jsonl(对齐 _crosscheck.jsonl / _backfill.jsonl 纪律)。"""
469
- root = getattr(cg, "root", None) or getattr(getattr(cg, "cg", None), "root", None)
470
- if not root:
471
- return
472
- try:
473
- rec = dict(rec)
474
- rec.setdefault("ts", int(time.time() * 1000))
475
- with open(os.path.join(str(root), LOG_NAME), "a", encoding="utf-8") as f:
476
- f.write(json.dumps(rec, ensure_ascii=False) + "\n")
477
- except OSError:
478
- pass
479
-
480
-
481
- # 生效条件:role 不在 ROLES 时返回 ok=False 的未知角色 error;否则 model_name(model) 为空时返回 ok=False 的未配置复核模型;否则 str(prompt or "").strip() 为空时返回 ok=False 的 prompt 为空;否则落盘前先过 _valid_job_id 结构闸(未过返回 ok=False 的 job_id 非法,**不建目录不写文件**——N178:job_id 来源一旦不是 _job_id(),join 后就是「任意目录 + 生成名」的建目录/写文件原语);闸过则在 jobs_dir(jobs)/job_id 下写 spec.json 与 status.json(context_files 为真、temperature 非 None、extra 为真时才并入 spec),OSError 时返回 ok=False 的写入失败,全部成功返回 ok=True 与 job_id/job_dir/spec/model。
482
- def submit(*, prompt: str, role: str = REFLECT, model: str = "", system_prompt: str = "",
483
- context_files=None, timeout_s: int = DEFAULT_TIMEOUT_S,
484
- max_tokens: int = DEFAULT_MAX_TOKENS, temperature=None, jobs: str = "",
485
- actor: str = "", extra: dict = None, cg=None) -> dict:
486
- """写一条 LLM 委托型 job(spec.json + status.json,形态同 _submit);只写文件不起进程。"""
487
- if role not in ROLES:
488
- return {"ok": False, "error": "未知复核角色:%r(可选 %s)" % (role, list(ROLES))}
489
- mdl = model_name(model)
490
- if not mdl:
491
- return {"ok": False, "error": "未配置复核模型:请设 %s 或显式传 model" % ENV_MODEL}
492
- if not str(prompt or "").strip():
493
- return {"ok": False, "error": "prompt 为空"}
494
- jd, job_id = jobs_dir(jobs), _job_id()
495
- # N178(2026-09-28):**落盘前**过闸——makedirs 之后再过就等于已经建了目录。
496
- if not _valid_job_id(job_id):
497
- return {"ok": False, "job_dir": None, "job_id": job_id,
498
- "error": _bad_job_id(job_id, where="submit 落点")["error"]}
499
- d = os.path.join(jd, job_id)
500
- spec = {"model": mdl, "user_prompt": str(prompt), "system_prompt": str(system_prompt or ""),
501
- "timeout_s": int(timeout_s), "max_tokens": int(max_tokens),
502
- "role": role, "unit_role": role}
503
- if context_files:
504
- spec["context_files"] = list(context_files)
505
- if temperature is not None:
506
- spec["temperature"] = temperature
507
- if extra:
508
- spec.update(extra)
509
- try:
510
- os.makedirs(d, exist_ok=True)
511
- with open(os.path.join(d, SPEC_FILE), "w", encoding="utf-8") as f:
512
- json.dump(spec, f, ensure_ascii=False)
513
- with open(os.path.join(d, STATUS_FILE), "w", encoding="utf-8") as f:
514
- json.dump({"job_id": job_id, "state": "pending",
515
- "created_ts": int(time.time() * 1000), "started_ts": None,
516
- "heartbeat_ts": None, "elapsed_s": 0.0, "timeout_s": int(timeout_s),
517
- "model": mdl, "pid": None, "error": None}, f, ensure_ascii=False)
518
- except OSError as exc:
519
- return {"ok": False, "job_dir": d,
520
- "error": "job 写入失败:%s: %s" % (type(exc).__name__, exc)}
521
- _log(cg, {"action": "submit", "job_id": job_id, "role": role, "model": mdl,
522
- "timeout_s": int(timeout_s), "actor": actor, "prompt_head": str(prompt)[:200]})
523
- return {"ok": True, "job_id": job_id, "job_dir": d, "spec": spec,
524
- "unit_role": role, "model": mdl}
525
-
526
-
527
- # 生效条件:job_id 先过 _valid_job_id 结构闸(未过返回 state="invalid_job_id" 的结构化拒绝,**不触盘**——N178:修前 "../victim" 会被 join 成池外目录并读出其 result.json 全文);闸过时 jobs_dir(jobs)/job_id 不是目录返回 state=missing、terminal=False 的目录不存在 error;是目录时读 STATUS_FILE(读失败则 status 置 None)并用其 state 覆盖 state/terminal(state 属 TERMINAL_STATES 才 terminal=True);RESULT_FILE 被 isfile 命中则 terminal=True、state=st or "done",解析抛 OSError/ValueError 时提前返回该 error;解析为 dict 时取 ok/content/error/usage/model,且 ok 为真而 content 去空白为空时把 ok 改 False 并写空正文 error,解析为非 dict 时 ok=True 且 content 为原值。
528
- def poll(job_id: str, jobs: str = "") -> dict:
529
- """读 job 终态视图:**以 result.json 出现为终态主判据**,status.json 仅作辅助。"""
530
- # N178(2026-09-28):调用方给的 job_id 是路径成分,**先过闸再 join**。
531
- # 修前此处无闸,且 `str(job_id or "")` 还会把非 str 洗成合法成分。
532
- if not _valid_job_id(job_id):
533
- return _bad_job_id(job_id, where="poll 池路径成分")
534
- d = os.path.join(jobs_dir(jobs), job_id)
535
- out = {"job_id": job_id, "job_dir": d, "state": "missing", "terminal": False,
536
- "ok": False, "content": None, "error": None, "status": None}
537
- if not os.path.isdir(d):
538
- out["error"] = "job 目录不存在:%s" % d
539
- return out
540
- sp = os.path.join(d, STATUS_FILE)
541
- if os.path.isfile(sp):
542
- try:
543
- with open(sp, encoding="utf-8") as f:
544
- out["status"] = json.load(f)
545
- except (OSError, ValueError):
546
- out["status"] = None
547
- st = (out["status"] or {}).get("state")
548
- if st:
549
- out.update({"state": st, "terminal": st in TERMINAL_STATES})
550
- rp = os.path.join(d, RESULT_FILE)
551
- if os.path.isfile(rp):
552
- out["state"] = st or "done"
553
- out["terminal"] = True
554
- try:
555
- with open(rp, encoding="utf-8") as f:
556
- res = json.load(f)
557
- except (OSError, ValueError) as exc:
558
- out["error"] = "result.json 不可读:%s" % type(exc).__name__
559
- return out
560
- if isinstance(res, dict):
561
- out["ok"] = bool(res.get("ok"))
562
- out["content"] = res.get("content")
563
- out["error"] = res.get("error") or out["error"]
564
- out["usage"] = res.get("usage")
565
- out["model"] = res.get("model")
566
- # 空正文**不得报成功**:reasoning 与正文共享 completion 预算,预算不足时
567
- # job 仍自称 ok 但 content 为空 → 若不拦,会被误读成「复核单元无答复」
568
- # (假死锁)。run() 早已有同等校验,此处补齐,消除两处口径不一致。
569
- if out["ok"] and not str(out["content"] or "").strip():
570
- out["ok"] = False
571
- out["error"] = ("空正文:job 自称 ok 但 content 为空(多为 reasoning 吃尽"
572
- "完成预算;提高 max_tokens,勿把预算不足当通道不可用)")
573
- else:
574
- out["ok"], out["content"] = True, res
575
- return out
576
-
577
-
578
- # 生效条件:job_id 未过 _valid_job_id 结构闸时**立即**返回 poll 的同一拒绝结构(N178:否则非法 id 会空转满 timeout_s 才超时返回——拒绝不该以等待为代价);闸过时循环 poll(job_id, jobs),结果 terminal 为真即补 waited_s 后返回;否则 time.time()-t0 >= float(timeout_s) 时返回 terminal=False、timeout=True 与超时 error;两者皆不满足则 sleep(float(poll_s)) 后重试(timeout_s=0 时首次 poll 非终态即超时返回)。
579
- def wait(job_id: str, *, jobs: str = "", timeout_s: float = DEFAULT_TIMEOUT_S,
580
- poll_s: float = DEFAULT_POLL_S) -> dict:
581
- """阻塞等终态;超时如实返回(不假装成功、不强杀 job)。"""
582
- if not _valid_job_id(job_id):
583
- # N178(2026-09-28):fail-fast——复用 poll 的拒绝结构,绝不进轮询。
584
- return poll(job_id, jobs)
585
- t0 = time.time()
586
- while True:
587
- cur = poll(job_id, jobs)
588
- if cur.get("terminal"):
589
- cur["waited_s"] = round(time.time() - t0, 3)
590
- return cur
591
- if (time.time() - t0) >= float(timeout_s):
592
- cur.update({"terminal": False, "timeout": True, "waited_s": round(time.time() - t0, 3),
593
- "error": "等待超时 %.0fs(job 仍在 %s)" % (float(timeout_s),
594
- cur.get("state"))})
595
- return cur
596
- time.sleep(float(poll_s))
597
-
598
-
599
- # 生效条件:submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw) 的 ok 为假时返回 stage="submit" 的失败 dict(含 **sub);ok 为真时 wait(sub["job_id"], jobs=kw.get("jobs",""), timeout_s=wait_s),补 stage="wait"/job_id/unit_role/model,并把 ok 改为 res 的 ok 与 content 同时为真。
600
- def run(*, prompt: str, role: str = REFLECT, cg=None, actor: str = "",
601
- wait_s: float = DEFAULT_TIMEOUT_S, **kw) -> dict:
602
- """submit + wait 组合(阻塞式复核,MCP action=review 主路径)。"""
603
- sub = submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw)
604
- if not sub.get("ok"):
605
- return {"ok": False, "stage": "submit", "error": sub.get("error"), **sub}
606
- res = wait(sub["job_id"], jobs=kw.get("jobs", ""), timeout_s=wait_s)
607
- res.update({"stage": "wait", "job_id": sub["job_id"], "unit_role": role,
608
- "model": sub.get("model")})
609
- res["ok"] = bool(res.get("ok")) and bool(res.get("content"))
610
- return res
611
-
612
-
613
- # ---------------------------------------------------------------- 裁决解析与搬运
614
-
615
- _FENCE_RE = re.compile(r"```(?:json)?\s*(.+?)\s*```", re.S)
616
-
617
-
618
- # 生效条件:raw 是 dict/list 时原样返回;否则取 str(raw or "").strip(),为空串(含 0/False/None 等假值)返回 None;否则依次尝试 _FENCE_RE 第 1 组、整段文本、首个 "{" 到末个 "}" 及首个 "[" 到末个 "]" 的切片,返回首个能 json.loads 成 dict 或 list 的候选;全部失败返回 None。
619
- def _json_of(raw):
620
- """从单元输出抽第一个 JSON 对象/数组(容忍 ```json 围栏与前后噪声)。"""
621
- if isinstance(raw, (dict, list)):
622
- return raw
623
- text = str(raw or "").strip()
624
- if not text:
625
- return None
626
- cands = []
627
- m = _FENCE_RE.search(text)
628
- if m:
629
- cands.append(m.group(1))
630
- cands.append(text)
631
- for opener, closer in (("{", "}"), ("[", "]")):
632
- i, j = text.find(opener), text.rfind(closer)
633
- if 0 <= i < j:
634
- cands.append(text[i:j + 1])
635
- for c in cands:
636
- try:
637
- v = json.loads(c)
638
- except ValueError:
639
- continue
640
- if isinstance(v, (dict, list)):
641
- return v
642
- return None
643
-
644
-
645
- # 生效条件:data=_json_of(raw) 为 list 时取 data[0](仅当它是 dict,否则 None);非 dict 时返回 verdict=DEFER、parsed=False;dict 时 word 取 verdict/decision/state/result 中首个真值后 strip().lower(),_VERDICT_MAP.get(word) 为 None 时返回 DEFER、parsed=True 并带 corr 与 reason,命中时返回该裁决及 reason、slot_corrections(取自 slot_corrections/corrections,非 dict 则置 {})、checks、raw 前 500 字符。
646
- def verdict_of(raw) -> dict:
647
- """单元输出 → 裁决四态;解析不出 → DEFER(不猜测、不当通过)。"""
648
- data = _json_of(raw)
649
- if isinstance(data, list):
650
- data = data[0] if data and isinstance(data[0], dict) else None
651
- if not isinstance(data, dict):
652
- return {"verdict": DEFER, "reason": "单元输出无法解析为裁决 JSON",
653
- "slot_corrections": {}, "raw": str(raw)[:500], "parsed": False}
654
- word = str(data.get("verdict") or data.get("decision") or data.get("state")
655
- or data.get("result") or "").strip().lower()
656
- reason = str(data.get("reason") or data.get("why") or data.get("detail") or "").strip()
657
- corr = data.get("slot_corrections") or data.get("corrections") or {}
658
- corr = corr if isinstance(corr, dict) else {}
659
- got = _VERDICT_MAP.get(word)
660
- if got is None:
661
- return {"verdict": DEFER, "slot_corrections": corr, "parsed": True, "raw": str(raw)[:500],
662
- "reason": "单元未给出可识别的裁决(%r)%s" % (word, (":" + reason) if reason else "")}
663
- return {"verdict": got, "reason": reason, "slot_corrections": corr,
664
- "checks": data.get("checks"), "raw": str(raw)[:500], "parsed": True}
665
-
666
-
667
- # 生效条件:state==HIVE 时返回 "hive:<role>:<job_id 或 'unknown'>";state==SUBAGENT 时返回 "subagent:<role>:<channel 或 'harness'>";其余 state 返回空串。
668
- def transport_name(state: str, role: str, job_id: str = "", channel: str = "") -> str:
669
- """裁决来源标识:**结构上不可能等于编译者**,保证 A 裁定「不得自证」不被误伤。"""
670
- if state == HIVE:
671
- return "hive:%s:%s" % (role, job_id or "unknown")
672
- if state == SUBAGENT:
673
- return "subagent:%s:%s" % (role, channel or "harness")
674
- return ""
675
-
676
-
677
- # 生效条件:unit 为假值时按 {} 处理;verdict=unit.get("verdict") or DEFER,verifier=transport_name(state, role, job_id, channel),evidence 取 unit 的 reason,为空则退回 str(unit["raw"])[:300],job_id 为真时再追加“(job=<job_id>)”;仅当 unit 的 slot_corrections 为真才带该键,仅当 compiled_by 与 verifier 皆非空且相等才置 self_verify=True。
678
- def to_attest_args(unit: dict, *, state: str = "", role: str = REFLECT, job_id: str = "",
679
- channel: str = "", compiled_by: str = "") -> dict:
680
- """单元裁决 → ccgc.attest(...) 入参(纯函数,离线可测)。
681
-
682
- 诚实边界:只做搬运与命名;裁决正确性由外部单元负责,本模块不为其背书。
683
- """
684
- unit = unit or {}
685
- verdict = unit.get("verdict") or DEFER
686
- verifier = transport_name(state, role, job_id, channel)
687
- evidence = str(unit.get("reason") or "")
688
- if unit.get("raw") and not evidence:
689
- evidence = str(unit["raw"])[:300]
690
- if job_id:
691
- evidence = "%s(job=%s)" % (evidence, job_id)
692
- args = {"verdict": verdict, "verifier": verifier, "evidence": evidence}
693
- if unit.get("slot_corrections"):
694
- args["slot_corrections"] = unit["slot_corrections"]
695
- if compiled_by and verifier and verifier == compiled_by:
696
- args["self_verify"] = True
697
- return args
698
-
699
-
700
- # ---------------------------------------------------------------- 复核请求包
701
-
702
- _REFLECT_TPL = """你是认知图记忆节点的**反思单元**(reflect)。下面是一份由 ccgc 编译出的
703
- CCG 六要素候选(功能名/生效条件/子功能/执行/验证方式/不适用条件)。请逐项反思:
704
-
705
- 1) 六要素是否齐备,是否都能在「对话记录」里找到字面依据;
706
- 2) 「生效条件」四槽(场景/时窗/对象/前置)是否与实际适用范围一致,有无过度泛化;
707
- 3) 「不适用条件」(拒绝域)是否漏掉了明显该拒的情形;
708
- 4) 若有问题,给出**最小修正**(只改该字段,不重写)。
709
-
710
- 编译产物(JSON):
711
- {digest}
712
-
713
- 原始对话记录(真源,引用必须出自此处):
714
- {dialog}
715
-
716
- 只输出一个 JSON 对象,不要任何解释文字:
717
- {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}},
718
- "checks":[{{"element":"功能名","ok":true,"note":""}}]}}"""
719
-
720
- _VERIFY_TPL = """你是独立**验证单元**(verify)。对下面这份 CCG 六要素候选与反思单元的结论
721
- 逐条复核:来源是否真实可追溯、结论是否被对话记录支持、修正是否越权(不得新增事实)。
722
-
723
- **你只能否决或存疑,不得新增主张、不得改写事实**(可给出 slot_corrections 修正已有槽位)。
724
-
725
- 候选(JSON):
726
- {digest}
727
-
728
- 反思单元结论:
729
- {reflect_rows}
730
-
731
- 对话记录(真源):
732
- {dialog}
733
-
734
- 只输出一个 JSON 对象:
735
- {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}}}}"""
736
-
737
-
738
- # 生效条件:digest is None 时返回 "{}";digest 是 str 时原样返回;否则先试 to_dict/as_dict 可调用方法并 json.dumps 其返回值(抛异常即跳出改走后续分支);是 dict 时 json.dumps(digest);其余取 vars(digest) 中不以 "_" 开头的属性 json.dumps(default=str)。
739
- def _digest_of(digest) -> str:
740
- if digest is None:
741
- return "{}"
742
- if isinstance(digest, str):
743
- return digest
744
- for attr in ("to_dict", "as_dict"):
745
- fn = getattr(digest, attr, None)
746
- if callable(fn):
747
- try:
748
- return json.dumps(fn(), ensure_ascii=False, indent=1)
749
- except Exception: # noqa: BLE001
750
- break
751
- if isinstance(digest, dict):
752
- return json.dumps(digest, ensure_ascii=False, indent=1)
753
- return json.dumps({k: v for k, v in vars(digest).items() if not k.startswith("_")},
754
- ensure_ascii=False, indent=1, default=str)
755
-
756
-
757
- # 生效条件:role==VERIFY 选 _VERIFY_TPL,否则选 _REFLECT_TPL;reflect_rows 是 str 时直接作为 rows,否则 json.dumps(reflect_rows or [], ensure_ascii=False, indent=1);最终返回 tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000], reflect_rows=rows[:3000])。
758
- def prompt_for(role: str, digest=None, *, dialog: str = "", reflect_rows="") -> str:
759
- """按角色生成复核请求包正文(reflect/verify 共用一处模板真源)。"""
760
- tpl = _VERIFY_TPL if role == VERIFY else _REFLECT_TPL
761
- rows = reflect_rows if isinstance(reflect_rows, str) else json.dumps(
762
- reflect_rows or [], ensure_ascii=False, indent=1)
763
- return tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000],
764
- reflect_rows=rows[:3000])
765
-
766
-
767
- # 生效条件:text 取 prompt 真值或 prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows);pr=probe(jobs, model, allow_degrade=allow_degrade, channel=channel) 为 SUBAGENT 时原样返回未派发的 SUBAGENT 包、为 CONFIGURE 时返回未派发的 CONFIGURE 包;为 HIVE 时若 autostart 为真且 serve_state(jobs) 非 alive 先 autostart_serve(jobs),再 submit(...),submit 失败回 CONFIGURE 且把 error 拼进 hint,成功则给出 job_id,blocking=False 直接返回;blocking=True 时 wait(sub["job_id"], jobs=jobs, timeout_s=wait_s),res.ok 为假则 unit 记 DEFER 并附未产出有效结果的 hint,为真则 unit=verdict_of(res.get("content")),随后填 transport/attest/result_ok/waited_s 并 _log。
768
- def review(*, prompt: str = "", role: str = REFLECT, digest=None, dialog: str = "",
769
- reflect_rows="", node_id: str = "", jobs: str = "", model: str = "",
770
- timeout_s: int = DEFAULT_TIMEOUT_S, allow_degrade: bool = False,
771
- channel: str = "", wait_s: float = DEFAULT_TIMEOUT_S, blocking: bool = True,
772
- cg=None, actor: str = "", autostart: bool = False) -> dict:
773
- """复核主入口:**蜂巢优先 → 提示配置 → 端子代理降级**(三态各自如实返回)。
774
-
775
- 返回统一形态:{state, role, node_id, transport, unit, attest, prompt, job_id, hint}
776
- - state=hive :已派发;blocking=True 时等终态并给出 unit/attest;否则只给 job_id
777
- - state=configure:**未派发**,hint 为配置指引(使用者裁定:不可用即提示配置)
778
- - state=subagent :**未派发**,返回 prompt 包供宿主子代理执行并回填
779
- """
780
- text = prompt or prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows)
781
- pr = probe(jobs, model, allow_degrade=allow_degrade, channel=channel)
782
- base = {"role": role, "node_id": node_id, "prompt": text,
783
- "transport": None, "unit": None, "attest": None,
784
- "job_id": None, "hint": pr.get("hint") or "", "channel": pr.get("channel") or "",
785
- "degrade": {"channel": channel or "harness-subagent",
786
- "how": "宿主子代理执行 prompt → 裁决经 verdicts 回填 attest"}}
787
- if pr["state"] == SUBAGENT:
788
- return {"state": SUBAGENT, **base,
789
- "degrade": {"available": True, "channel": channel or "harness-subagent",
790
- "how": "把 prompt 交给宿主子代理,取其 JSON 裁决后调 "
791
- "cg(op=ccg, action=attest, verdict=<accept|drop|defer>, "
792
- "verifier=subagent:<role>:<channel>)"}}
793
- if pr["state"] == CONFIGURE:
794
- return {"state": CONFIGURE, **base,
795
- "degrade": {"available": True, "channel": channel or "harness-subagent",
796
- "how": "① 按 hint 配置蜂巢后重试;② 或带 allow_degrade=true 降级子代理"}}
797
- if autostart and not serve_state(jobs)["alive"]:
798
- pr["autostart"] = autostart_serve(jobs)
799
- sub = submit(prompt=text, role=role, jobs=jobs, model=model, timeout_s=timeout_s,
800
- cg=cg, actor=actor)
801
- if not sub.get("ok"):
802
- return {"state": CONFIGURE, **base, "hint": (pr.get("hint") or "") + "\n" + str(sub.get("error"))}
803
- out = {"state": HIVE, **base, "job_id": sub["job_id"], "unit_role": role,
804
- "model": sub.get("model")}
805
- if not blocking:
806
- return out
807
- res = wait(sub["job_id"], jobs=jobs, timeout_s=wait_s)
808
- unit = verdict_of(res.get("content")) if res.get("ok") else {
809
- "verdict": DEFER, "reason": res.get("error") or "单元未返回可用结果",
810
- "slot_corrections": {}, "parsed": False}
811
- out["unit"] = unit
812
- out["transport"] = transport_name(HIVE, role, sub["job_id"])
813
- out["attest"] = to_attest_args(unit, state=HIVE, role=role, job_id=sub["job_id"])
814
- out["result_ok"] = bool(res.get("ok"))
815
- out["waited_s"] = res.get("waited_s")
816
- if not res.get("ok"):
817
- out["hint"] = "蜂巢 job 未产出有效结果:%s(裁决按 DEFER 处理,未假装通过)" % res.get("error")
818
- _log(cg, {"action": "review", "job_id": sub["job_id"], "role": role,
819
- "node_id": node_id, "actor": actor, "unit_verdict": unit.get("verdict"),
820
- "result_ok": bool(res.get("ok"))})
821
- return out
822
-
823
-
824
- # ---------------------------------------------------------------- serve 拉起(显式)
825
-
826
- # 生效条件:serve_state(jobs_dir(jobs)) 已 alive 时返回 started=False 的“serve 存活”;否则 exe_path() 未被 isfile 命中时返回 started=False 并提示先 cargo build --release;否则以 detached/新会话 Popen 拉起 exe serve --jobs jd 并把 stdout/stderr 写入 jd/_serve.log,Popen 抛 OSError 时返回 started=False 的拉起失败;拉起后在 float(wait_s) 内轮询到 alive 返回 started=True 的“serve 已拉起”,轮询超时仍返回 started=True 但标注心跳未就绪。
827
- def autostart_serve(jobs: str = "", wait_s: float = 5.0) -> dict:
828
- """**显式**拉起 serve(默认不启用;使用者裁定:不可用即提示配置)。
829
-
830
- 形态同 hive_mcp._ensure_serve:detached + 独立日志,不阻塞调用方。
831
- """
832
- jd = jobs_dir(jobs)
833
- if serve_state(jd)["alive"]:
834
- return {"started": False, "note": "serve 存活"}
835
- exe = exe_path()
836
- if not os.path.isfile(exe):
837
- return {"started": False, "note": "未找到可执行文件 %s——先 cargo build --release" % exe}
838
- kwargs = {}
839
- if os.name == "nt":
840
- kwargs["creationflags"] = subprocess.DETACHED_PROCESS | subprocess.CREATE_NO_WINDOW
841
- else:
842
- kwargs["start_new_session"] = True
843
- try:
844
- os.makedirs(jd, exist_ok=True)
845
- with open(os.path.join(jd, "_serve.log"), "ab") as logf:
846
- subprocess.Popen([exe, "serve", "--jobs", jd], stdout=logf, stderr=logf,
847
- stdin=subprocess.DEVNULL, **kwargs)
848
- except OSError as exc:
849
- return {"started": False, "note": "拉起失败:%s: %s" % (type(exc).__name__, exc)}
850
- t0 = time.time()
851
- while time.time() - t0 < float(wait_s):
852
- if serve_state(jd)["alive"]:
853
- return {"started": True, "note": "serve 已拉起"}
854
- time.sleep(0.1)
855
- return {"started": True, "note": "serve 已拉起(心跳未就绪,稍后自愈)"}
856
-
857
-
858
- # 生效条件:返回 dict 的 ok=p["state"]==HIVE,其中 p=plan(jobs)(model/fresh_s/allow_degrade/channel 全走默认),state/serve_alive/serve_age_s/chain/hint/model 取自该 p;jobs_dir 取 jobs_dir(jobs),exe_found 与 exe_path 取 exe_path() 是否被 isfile 命中,model_set=bool(model_name())(无参,读 ENV_MODEL),api_key_set=bool(os.environ.get(ENV_API_KEY)),env 记录 ENV_JOBS_DIR 与 ENV_MODEL 的原值。
859
- def doctor(jobs: str = "") -> dict:
860
- """能力体检(形态对齐 hive_doctor):判活 + exe + 模型 + 优先级链。"""
861
- jd = jobs_dir(jobs)
862
- p = plan(jobs)
863
- return {"ok": p["state"] == HIVE, "state": p["state"], "jobs_dir": jd,
864
- "serve_alive": p["serve"]["alive"], "serve_age_s": p["serve"]["age_s"],
865
- "exe_found": os.path.isfile(exe_path()), "exe_path": exe_path(),
866
- "model_set": bool(model_name()), "model": p["model"],
867
- "api_key_set": bool(os.environ.get(ENV_API_KEY)),
868
- "env": {"HIVE_JOBS_DIR": os.environ.get(ENV_JOBS_DIR, ""),
869
- "MDCG_UNIT_MODEL": os.environ.get(ENV_MODEL, "")},
1
+ # -*- coding: utf-8 -*-
2
+ """units.py · 复核单元接线层:蜂巢优先 → 提示配置 → harness 端子代理降级。
3
+
4
+ 定位(与 audit.py 同一条架构约束):**能力不在认知图内**。本模块不做智能判定,
5
+ 只做三件事:选通道(probe/plan)→ 派发请求(submit/wait/run)→ 记账(_units.jsonl)。
6
+
7
+ 使用者裁定(2026-09-16,第 17 条精神):编译器(ccgc)的复核**优先使用蜂巢的
8
+ 反思单元 / 验证单元**(reflect / verify,与 crosscheck.REFLECT_UNIT/VERIFY_UNIT 同值,
9
+ 不新造角色名);蜂巢不可用 → **提示使用者配置**(给出可照做的构建/启动/环境变量命令);
10
+ 或经显式 allow_degrade=True 降级到 **harness 端子代理**(宿主 agent 派发,裁决经
11
+ crosscheck 同款 verdicts 通道回填)。理由:使用者的复核是昂贵的——重活交给可并行的
12
+ 外部单元,agent 本体只做编排与记账。
13
+
14
+ 蜂巢契约(真源 hive/README.md + hive/hive_mcp/mcp_server.py;**复制契约不 import**,
15
+ 保持 md_cg 对 hive 零依赖,与 ccgc「同款语义就地实现防 import 环」惯例一致):
16
+ jobs 目录 = $HIVE_JOBS_DIR | <repo>/hive/jobs
17
+ serve 判活 = **三层**:jobs/_serve.json 的 ts(毫秒)距今 < FRESH_S(15s)
18
+ ∧ pid 存活 ∧ 该 pid 是本程序
19
+ (同 hive/serve_start.serve_alive;四路口径由
20
+ hive/test_serve_entry.py 机械守卫)
21
+ job 目录 = jobs/<job_id>/{spec.json,status.json,result.json,kill}
22
+ job_id = 本模块自造旧形态 h<java_ms>_<uuid6>(`_job_id`,**不是** `_submit` 同款);
23
+ hive 提交面自 id 契约 v2(B8)起为四槽 h_<身份>_<任务>_<单元>_<编号>,由
24
+ Rust 侧 `hive alloc-id` 分配——两形态都过 job.rs::valid_job_id(存量零迁移)
25
+ id 字符判据 = **区块白名单**:唯一真源 hive/id_charset_blocks.txt 的区间并集
26
+ ([`_valid_job_id`];本模块**读这份数据文件**、不 import hive,
27
+ 与 job.rs / mcp_server.py 三处共读同一份 ⇒ 不查任何 Unicode 属性库,
28
+ 两侧版本差结构性不可能)。本闸**有意保留**两处放宽(既有对外契约):
29
+ 不要求 h 前缀、允许 `-`;拒收面(零宽/双向控制/控制字符/路径成分/尾点/
30
+ 首尾空白/Windows 保留设备名)逐条显式断,不靠「白名单外顺带拒」。
31
+ result.json = {"ok":true,"content":...} | {"ok":false,"error":...}
32
+ 终态 = done | error | timeout | killed
33
+ 拉起 serve = <repo>/hive/target/release/hive serve --jobs <jobs>(detached)
34
+
35
+ 边界(诚实声明,不猜测):
36
+ · 本模块**不产生裁决**,只搬运;裁决由外部单元负责。
37
+ · 契约漂移:hive 侧协议若变更,本模块以「无 result / 超时」如实失败,不假装成功。
38
+ · 默认**不自动拉起 serve**(使用者裁定:不可用即提示配置);autostart=True 才拉起。
39
+ """
40
+ from __future__ import annotations
41
+
42
+ import json
43
+ import os
44
+ import re
45
+ import subprocess
46
+ import time
47
+ import uuid
48
+
49
+ HIVE, SUBAGENT, CONFIGURE = "hive", "subagent", "configure"
50
+ STATES = (HIVE, SUBAGENT, CONFIGURE)
51
+
52
+ REFLECT, VERIFY = "reflect", "verify" # 同 crosscheck.REFLECT_UNIT/VERIFY_UNIT
53
+ ROLES = (REFLECT, VERIFY)
54
+
55
+ SERVE_FILE, SPEC_FILE = "_serve.json", "spec.json"
56
+ STATUS_FILE, RESULT_FILE, KILL_FILE = "status.json", "result.json", "kill"
57
+ LOG_NAME = "_units.jsonl"
58
+ TERMINAL_STATES = ("done", "error", "timeout", "killed")
59
+ #: serve 心跳新鲜窗口(秒)。**须与 hive/serve_start.FRESH_S 同值**——本模块
60
+ #: 只持有「判活的第 4 处实现」(复制契约不 import hive),阈值/判据结构若与
61
+ #: 权威漂移,会在通道选择面复现 v13 的「假存活」病类(v14 缺陷 E:
62
+ #: 旧值 5.0 vs 权威 15,serve 崩溃后 ≤5s 窗口内判「存活」→ 选 hive 通道 →
63
+ #: 提交的 job 永远无人处理)。守卫:hive/test_serve_entry.py。
64
+ FRESH_S, DEFAULT_TIMEOUT_S, DEFAULT_POLL_S = 15.0, 120, 1.0
65
+ #: 复核委派的 completion 预算。**必须对齐统一默认(文档:最大输出 200000)**——
66
+ #: 该模型 reasoning 与正文**共享 completion 预算**,小预算会把正文吃光并静默返回空正文:
67
+ #: 实测 2048 → reasoning 2048 / content 空;16384 → 时好时坏;200000 → 正常出裁决。
68
+ DEFAULT_MAX_TOKENS = 200000
69
+
70
+ ENV_JOBS_DIR, ENV_EXE = "HIVE_JOBS_DIR", "HIVE_EXE"
71
+ ENV_MODEL, ENV_API_KEY = "MDCG_UNIT_MODEL", "HIVE_API_KEY"
72
+
73
+ ACCEPT, REJECT, DEFER, BLINDSPOT = "ACCEPT", "REJECT", "DEFER", "BLINDSPOT"
74
+ _VERDICT_MAP = {
75
+ "accept": ACCEPT, "accepted": ACCEPT, "keep": ACCEPT, "pass": ACCEPT,
76
+ "ok": ACCEPT, "approve": ACCEPT,
77
+ "drop": REJECT, "reject": REJECT, "rejected": REJECT, "deny": REJECT, "fail": REJECT,
78
+ "defer": DEFER, "deferred": DEFER, "unsure": DEFER, "unclear": DEFER, "skip": DEFER,
79
+ "blindspot": BLINDSPOT, "blind": BLINDSPOT,
80
+ }
81
+
82
+
83
+ # 生效条件:无入参,恒返回模块 `__file__` 绝对路径上溯两级的目录(md_cg 的上一级),与 cwd 无关。
84
+ def repo_root() -> str:
85
+ """仓库根(md_cg 的上一级);不用 cwd——cwd 由宿主决定,不可作判据。"""
86
+ return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
87
+
88
+
89
+ # 生效条件:explicit 为真值时 d=explicit;explicit 为空串等假值而 ENV_JOBS_DIR 有真值时 d=该环境变量;两者皆假值时 d=repo_root()/hive/jobs;最终返回 os.path.abspath(d)。
90
+ def jobs_dir(explicit: str = "") -> str:
91
+ d = explicit or os.environ.get(ENV_JOBS_DIR) or os.path.join(repo_root(), "hive", "jobs")
92
+ return os.path.abspath(d)
93
+
94
+
95
+ # 生效条件:ENV_EXE 有真值时原样返回该值;ENV_EXE 缺失或为空串时返回 repo_root()/hive/target/release/ 下按 os.name=="nt" 取 hive.exe、否则取 hive 的拼接路径。
96
+ def exe_path() -> str:
97
+ exe = os.environ.get(ENV_EXE)
98
+ if exe:
99
+ return exe
100
+ return os.path.join(repo_root(), "hive", "target", "release",
101
+ "hive.exe" if os.name == "nt" else "hive")
102
+
103
+
104
+ # 生效条件:explicit 为真值时取 explicit,否则取 ENV_MODEL,两者皆假值时按空串,返回该结果 strip() 后的字符串(可为空串)。
105
+ def model_name(explicit: str = "") -> str:
106
+ """复核模型(LLM 委托型执行器的 spec.model 必填)。"""
107
+ return (explicit or os.environ.get(ENV_MODEL) or "").strip()
108
+
109
+
110
+ # 生效条件:pid 为 int 且大于 0 时(否则 False),os.name 为 "nt" 时返回 _tasklist_row(pid) 是否非 None,非 "nt" 时 os.kill(pid, 0) 不抛 OSError 返回 True、抛 OSError 返回 False。
111
+ def pid_alive(pid) -> bool:
112
+ """该 pid **号**是否存在(Windows tasklist 精确列比对 / unix `kill -0`)。
113
+
114
+ 只回答「这个号有没有进程」——**不足以判定「serve 还在跑」**(见
115
+ `pid_is_self_program`)。实现与 hive/serve_start.pid_alive 同口径。
116
+ """
117
+ if not isinstance(pid, int) or pid <= 0:
118
+ return False
119
+ if os.name == "nt":
120
+ return _tasklist_row(pid) is not None
121
+ try:
122
+ os.kill(pid, 0)
123
+ return True
124
+ except OSError:
125
+ return False
126
+
127
+
128
+ # 生效条件:对传入 pid 执行 tasklist /FO CSV 后,在其 stdout 中遇到的第一个按 '","' 切分、列数≥2 且第 2 列 strip 再 strip('"') 后等于 str(pid) 的行即返回 [映像名, pid 字符串],无此行或 subprocess.run 抛 OSError 时返回 None。
129
+ def _tasklist_row(pid):
130
+ """Windows:查该 pid 的 tasklist 行 → [映像名, pid 字符串];查不到返回 None。
131
+
132
+ 按列精确比对,**不用子串包含**——子串会让 pid=441 被 4410 命中(假存活)。
133
+ """
134
+ try:
135
+ # 显式 utf-8 + replace:只消费 ASCII 的 pid 列,但**不依赖 locale**——
136
+ # locale 口径与「后代写 UTF-8」不一致时读线程会崩(见 test_subproc_encoding.py)。
137
+ # P2-16(批次 30):timeout=10——tasklist 挂起曾永久阻塞判活路径。
138
+ # stdin=subprocess.DEVNULL(issue #63 同批加固):不指定 stdin 时子进程
139
+ # 继承父进程 stdin(常驻宿主下是 JSON-RPC 活管道)——判活路径不得因
140
+ # 子进程读 stdin 而悬挂;形态对齐 `md_cg/run_tests.py:105`。
141
+ r = subprocess.run(["tasklist", "/FI", f"PID eq {pid}", "/NH", "/FO", "CSV"],
142
+ capture_output=True, text=True, stdin=subprocess.DEVNULL,
143
+ encoding="utf-8", errors="replace", timeout=10)
144
+ except (OSError, subprocess.SubprocessError):
145
+ return None
146
+ for line in (r.stdout or "").splitlines():
147
+ cols = line.split('","')
148
+ if len(cols) >= 2 and cols[1].strip().strip('"') == str(pid):
149
+ return [cols[0].strip().strip('"'), cols[1].strip().strip('"')]
150
+ return None
151
+
152
+
153
+ # 生效条件:exe_path() 的 basename 小写非空且 pid 为 int 大于 0 时(否则 False),"nt" 下要求 _tasklist_row(pid) 非空且映像名小写等于该 basename,非 "nt" 下要求 /proc/<pid>/cmdline 首个 b"\x00" 前 token 的 basename 小写等于它(读取抛 OSError 则 False)。
154
+ def pid_is_self_program(pid) -> bool:
155
+ """该 pid 是否**就是本程序**(同映像名)——pid 号会被无关进程复用。
156
+
157
+ 与 hive/serve_start.pid_is_self_program 同口径(复制契约)。零依赖边界:
158
+ 拿不到映像名返回 False(宁可放行启动,也不误报「已有 serve 在跑」)。
159
+ """
160
+ want = os.path.basename(exe_path()).lower()
161
+ if not want or not isinstance(pid, int) or pid <= 0:
162
+ return False
163
+ if os.name == "nt":
164
+ row = _tasklist_row(pid)
165
+ return bool(row) and row[0].lower() == want
166
+ try:
167
+ with open(f"/proc/{pid}/cmdline", "rb") as f:
168
+ first = f.read().split(b"\x00")[0]
169
+ except OSError:
170
+ return False
171
+ return os.path.basename(first.decode("utf-8", "replace")).lower() == want
172
+
173
+
174
+ # 生效条件:以 jobs_dir(jobs) 下的 SERVE_FILE 为心跳路径——该路径不被 isfile 命中时返回 exists/alive 均 False 的未启动 reason;命中但 open/json.load 抛 OSError 或 ValueError 时返回不可读 reason;解析成功后按**三层判据**(age < fresh_s ∧ pid_alive(pid) ∧ pid_is_self_program(pid))定 alive,回填 age_s/pid/raw 与逐层明细及失败原因。
175
+ def serve_state(jobs: str = "", fresh_s: float = FRESH_S) -> dict:
176
+ """serve 判活:**三层**(心跳新鲜 ∧ pid 存活 ∧ 该 pid 是本程序)。
177
+
178
+ 与 `hive/serve_start.serve_alive` 同口径(同值 FRESH_S=15s、同三层判据)。
179
+ v14 缺陷 E:旧实现只判 ts 新鲜度且阈值 5s——双漂移,serve 崩溃后
180
+ ≤5s 内判「存活」会让 `probe()` 选 hive 通道(提交的 job 永远无人处理),
181
+ 这正是 v13「假存活」病类从守卫面搬到了**通道选择面**。
182
+ """
183
+ jd = jobs_dir(jobs)
184
+ p = os.path.join(jd, SERVE_FILE)
185
+ out = {"jobs_dir": jd, "heartbeat": p, "exists": os.path.isfile(p),
186
+ "alive": False, "age_s": None, "pid": None, "reason": ""}
187
+ if not out["exists"]:
188
+ out["reason"] = "未见 _serve.json 心跳(serve 未启动或 jobs 目录不对)"
189
+ return out
190
+ try:
191
+ with open(p, encoding="utf-8") as f:
192
+ hb = json.load(f)
193
+ except (OSError, ValueError) as exc:
194
+ out["reason"] = "心跳不可读:%s: %s" % (type(exc).__name__, exc)
195
+ return out
196
+ age = time.time() - ((hb.get("ts") or 0) / 1000.0)
197
+ pid = hb.get("pid")
198
+ fresh_ok = age < float(fresh_s)
199
+ pid_ok = pid_alive(pid)
200
+ ident_ok = pid_is_self_program(pid)
201
+ out.update({"age_s": round(age, 3), "pid": pid, "raw": hb,
202
+ "fresh": bool(fresh_ok), "pid_alive": bool(pid_ok),
203
+ "pid_is_self_program": bool(ident_ok)})
204
+ out["alive"] = bool(fresh_ok and pid_ok and ident_ok)
205
+ if out["alive"]:
206
+ out["reason"] = ""
207
+ elif not fresh_ok:
208
+ out["reason"] = "心跳过期 %.1fs(阈值 %ss)——serve 可能已退出" % (age, fresh_s)
209
+ elif not pid_ok:
210
+ out["reason"] = "心跳新鲜但 pid=%s 已不存在——serve 已退出" % (pid,)
211
+ else:
212
+ out["reason"] = ("心跳新鲜且 pid=%s 存活,但该 pid 不属于本程序"
213
+ "(非 %s)——pid 号被无关进程复用"
214
+ % (pid, os.path.basename(exe_path())))
215
+ return out
216
+
217
+
218
+ # 生效条件:jobs 仅经 jobs_dir(jobs) 用于填充指引里的 jobs 路径;reason 为假值时文案首行取“serve 未存活”,否则取 reason 原文;返回模板固定嵌入 exe_path() 的目录与路径、ENV_API_KEY、ENV_MODEL、jd、jd 下的 SERVE_FILE 与 int(FRESH_S)。
219
+ def setup_hint(jobs: str = "", reason: str = "") -> str:
220
+ """不可用时给使用者看的**配置指引**(含降级指引)——提示即责任,须可照着做。"""
221
+ jd = jobs_dir(jobs)
222
+ return ("蜂巢不可用:%s\n"
223
+ " [A 配置蜂巢(推荐,第 17 条)]\n"
224
+ " 1) cd %s && cargo build --release\n"
225
+ " 2) set %s=<LLM密钥>\n 3) set %s=<复核模型名>\n"
226
+ " 4) 启动:%s serve --jobs \"%s\"(或 hive_spawn 自动拉起)\n"
227
+ " 判活判据:%s 的 ts 距今 < %ss\n"
228
+ " [B 降级 harness 端子代理]\n"
229
+ " 重发本请求并带 allow_degrade=true:本模块返回复核请求包(prompt),\n"
230
+ " 由宿主子代理执行后经 verdicts 回填裁决。"
231
+ % (reason or "serve 未存活", os.path.dirname(exe_path()), ENV_API_KEY,
232
+ ENV_MODEL, exe_path(), jd, os.path.join(jd, SERVE_FILE), int(FRESH_S)))
233
+
234
+
235
+ # 生效条件:先取 st=serve_state(jobs, fresh_s) 与 mdl=model_name(model);st["alive"] 为真且 mdl 非空时返回 state=HIVE;否则 allow_degrade 为真时返回 state=SUBAGENT 且 channel 取 channel 或 "harness-subagent";否则返回 state=CONFIGURE、transport=None 并附 setup_hint(jobs, why)。
236
+ def probe(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
237
+ allow_degrade: bool = False, channel: str = "") -> dict:
238
+ """三级能力探测:hive(可派发)→ configure(提示配置)→ subagent(显式降级)。
239
+
240
+ 判据只认**心跳 + 模型名**两项硬前提;缺任一即如实降级,绝不用相似度
241
+ (如「hive 目录存在」)冒充可用(资格由条件证据裁决,不由相似度裁决)。
242
+ """
243
+ st = serve_state(jobs, fresh_s)
244
+ mdl = model_name(model)
245
+ if st["alive"] and mdl:
246
+ return {"state": HIVE, "transport": HIVE, "model": mdl, "jobs_dir": st["jobs_dir"],
247
+ "serve": st, "channel": "", "hint": ""}
248
+ why = st["reason"] if not st["alive"] else "serve 存活但未配置复核模型(%s)" % ENV_MODEL
249
+ if allow_degrade:
250
+ return {"state": SUBAGENT, "transport": SUBAGENT, "model": mdl,
251
+ "jobs_dir": st["jobs_dir"], "serve": st,
252
+ "channel": channel or "harness-subagent",
253
+ "hint": "已按 allow_degrade 降级到 harness 端子代理:请把 prompt 交给宿主子代理,"
254
+ "裁决经 verdicts 回填(蜂巢不可用原因:%s)" % why}
255
+ return {"state": CONFIGURE, "transport": None, "model": mdl,
256
+ "jobs_dir": st["jobs_dir"], "serve": st, "channel": "",
257
+ "hint": setup_hint(jobs, why)}
258
+
259
+
260
+ # 生效条件:state/transport/model/jobs_dir/serve/channel/hint 全部直接取自 probe(jobs, model, fresh_s, allow_degrade, channel) 的对应键,本函数不另做判活或模型判断,仅在 chain 文案中固定引用 int(FRESH_S) 与 ENV_MODEL。
261
+ def plan(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
262
+ allow_degrade: bool = False, channel: str = "") -> dict:
263
+ """优先级链自描述(供 cg op=ccg action=units 与审计查看)。"""
264
+ p = probe(jobs, model, fresh_s, allow_degrade, channel)
265
+ return {"state": p["state"], "transport": p["transport"], "model": p["model"],
266
+ "jobs_dir": p["jobs_dir"], "serve": p["serve"], "channel": p["channel"],
267
+ "chain": [
268
+ {"order": 1, "transport": HIVE, "action": "派发 reflect/verify 单元并等待 result.json",
269
+ "when": ("jobs/_serve.json 心跳 < %ss 且(%s 已配置 **或调用方显式传 model**)"
270
+ % (int(FRESH_S), ENV_MODEL))},
271
+ {"order": 2, "transport": CONFIGURE, "action": "返回配置指引(不自动拉起、不假装通过)",
272
+ "when": "蜂巢不可用"},
273
+ {"order": 3, "transport": SUBAGENT, "action": "返回复核请求包,由 harness 端子代理执行并回填",
274
+ "when": "调用方显式 allow_degrade=True"},
275
+ ],
276
+ "hint": p["hint"]}
277
+
278
+
279
+ # ---------------------------------------------------------------- 派发与收取
280
+
281
+ # 生效条件:无入参,恒返回 "h"+int(time.time()*1000)+"_"+uuid.uuid4().hex 前 6 位组成的字符串。
282
+ def _job_id() -> str:
283
+ """本地 id 生成(旧形态 `h<毫秒>_<uuid 前 6 位>`):serve 侧按 'h' 前缀识别任务目录。
284
+
285
+ 诚实边界(id 契约 v2 · C2 同类措辞订正):**本函数已不是 `_submit` 的同款实现**
286
+ ——`hive/hive_mcp/mcp_server.py::_submit` 自 B8 起调 Rust 侧 `hive alloc-id` 分配
287
+ `h_<身份>_<任务>_<单元>_<编号>`,**不再自造 id**;本模块是 md_cg 的复核派发面,
288
+ **不在 B8 点名的改动面**(契约只列 CLI / MCP 提交面 / orch 透传),故保留旧形态。
289
+ 旧形态 id 在新契约下**仍然合法**(存量零迁移:`job.rs::valid_job_id` 收),故此处
290
+ 不闯闸、不破坏 serve 领取;但它绕过了分配器的独占创建与五单元闭集 ⇒ 与「分配器
291
+ 唯一实现在 Rust 侧」(契约 §五 裁决 3)不齐,宜单独裁决(牵动 md_cg 派发/等待链
292
+ 语义与其守卫 `md_cg/test_units_poll.py`,不在本批「只论证订正」的范围内)。
293
+ """
294
+ return "h%d_%s" % (int(time.time() * 1000), uuid.uuid4().hex[:6])
295
+
296
+
297
+ # ------------------------------------------------ id 字符判据(区块白名单 · 唯一真源)
298
+
299
+ #: 区块表数据文件(**唯一真源**,与 `hive/src/job.rs` / `hive/hive_mcp/mcp_server.py`
300
+ #: **共读同一份数据**;本模块**读数据文件**而不是 import hive ⇒ 不破零依赖家法)。
301
+ _CHARSET_BLOCKS_REL = "hive/id_charset_blocks.txt"
302
+ _MAX_CP = 0x10FFFF
303
+
304
+
305
+ # 生效条件:text 为表文件全文时返回区间列表 [(起, 止)]——**唯一解析配方**(与 Rust
306
+ # `job.rs::parse_id_charset_blocks`、`mcp_server._parse_charset_blocks` 同一条,不许各写
307
+ # 一套):每行取 `#` 之前部分后 strip;空行跳过;余下 split('-') 两段 int(x, 16)。
308
+ # 任一行不合形态 / 越界 / 逆序 / 未归并到最小 / 空表 → 抛 ValueError(fail-closed:
309
+ # 绝不静默跳过坏行——跳过一行的表是另一张表,三处读者随即不同判)。
310
+ def _parse_charset_blocks(text: str) -> list:
311
+ """区块表解析(唯一配方)。"""
312
+ out: list = []
313
+ for lineno, line in enumerate(text.split("\n"), 1):
314
+ body = line.split("#", 1)[0].strip()
315
+ if not body:
316
+ continue
317
+ parts = body.split("-")
318
+ if len(parts) != 2:
319
+ raise ValueError("区块表第 %d 行不是 LO-HI 形态:%r" % (lineno, line))
320
+ lo, hi = int(parts[0], 16), int(parts[1], 16)
321
+ if not (0 <= lo <= hi <= _MAX_CP):
322
+ raise ValueError("区块表第 %d 行区间非法:%r" % (lineno, line))
323
+ if out and lo <= out[-1][1] + 1:
324
+ raise ValueError("区块表第 %d 行未归并到最小(相邻/相交/乱序):%r"
325
+ % (lineno, line))
326
+ out.append((lo, hi))
327
+ if not out:
328
+ raise ValueError("区块表解析出空区间集(fail-closed:空表绝不放行)")
329
+ return out
330
+
331
+
332
+ # 生效条件:无入参,返回 (区间表, 错误说明)——文件可读且解析通过 → (tuple 区间表, None);
333
+ # 表缺失 / 不可读 / 解析失败 → ((), 原因)。后两者让判据 fail-closed(对一切字符 False)。
334
+ def _load_charset_blocks() -> tuple:
335
+ """**模块导入时读一次**(不做每调用 I/O);路径基准 = 本文件上溯两级(= 仓根)。"""
336
+ path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
337
+ "hive", "id_charset_blocks.txt")
338
+ try:
339
+ with open(path, encoding="utf-8") as fh:
340
+ text = fh.read()
341
+ except OSError as exc:
342
+ return (), "%s 不可读:%s" % (_CHARSET_BLOCKS_REL, exc)
343
+ try:
344
+ return tuple(_parse_charset_blocks(text)), None
345
+ except ValueError as exc:
346
+ return (), "%s 解析失败:%s" % (_CHARSET_BLOCKS_REL, exc)
347
+
348
+
349
+ #: 判据数据(模块导入时求值一次):区间表 + 读取/解析错误(错误非 None ⇒ 判据一律 False)。
350
+ CHARSET_BLOCKS, CHARSET_BLOCKS_ERROR = _load_charset_blocks()
351
+
352
+
353
+ # 生效条件:c 为单字符且其码点落在区间表内 → True;表缺失 / 坏行 / 空表 → False
354
+ # (fail-closed:绝不放行)。
355
+ def _charset_member(c: str) -> bool:
356
+ u = ord(c)
357
+ return any(lo <= u <= hi for lo, hi in CHARSET_BLOCKS)
358
+
359
+
360
+ # Windows 保留设备名(B4 拒收项;与 `job.rs::RESERVED_DEVICE_NAMES`、
361
+ # `mcp_server.RESERVED_DEVICE_NAMES` 逐项同集——md_cg 只复制这 22 个常量,**还是读数据
362
+ # 而不是 import hive**)。Win32 对**单个路径分量**做设备名解析且**忽略扩展名**
363
+ # (`CON.txt` 与 `CON` 同指设备),故比对的是「首个 `.` 之前」部分;比对**ASCII 大小写
364
+ # 不敏感**(不用 str.upper():它的 Unicode 折叠面比 Rust 的 eq_ignore_ascii_case 宽,
365
+ # 会让两侧分叉)。
366
+ RESERVED_DEVICE_NAMES = (
367
+ "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6",
368
+ "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6",
369
+ "LPT7", "LPT8", "LPT9",
370
+ )
371
+ _ASCII_UPPER = str.maketrans("abcdefghijklmnopqrstuvwxyz",
372
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZ")
373
+
374
+
375
+ # 生效条件:s 的「首个 `.` 之前」部分与任一保留设备名 **ASCII 大小写不敏感**相等 → True
376
+ # (含 `CON.txt` 这类带扩展名形态)——与 rust `job::is_reserved_device_name` 同判。
377
+ def _is_reserved_device_name(s: str) -> bool:
378
+ base = s.split(".")[0].translate(_ASCII_UPPER)
379
+ return base in RESERVED_DEVICE_NAMES
380
+
381
+
382
+ # 生效条件:jid 为 str、长度 1..128、strip() 前后无差异(首尾无空白)、首尾字符都不是
383
+ # "."(拒 "."/".."/"..." 与 Win32 会剥尾点的 "abc." 形态)、逐字符过显式拒收集合后落在
384
+ # **区块白名单**([`_charset_member`],唯一真源 `hive/id_charset_blocks.txt`,与 hive 两侧
385
+ # 共读同一份数据)或属结构字符 `_` `-` `.`,且整 id 与其按 `_` 分段的任一段都不是
386
+ # Windows 保留设备名、且按 `_` 分段的**任一段都不等于** `.` 或 `..`(c7 段级)时返回 True,
387
+ # 否则 False。
388
+ def _valid_job_id(jid) -> bool:
389
+ r"""job_id 结构闸(N178,2026-09-28;2026-09-30 字符集判据换面为**区块白名单**)。
390
+
391
+ 同族家法:`hive/hive_mcp/mcp_server.py::_valid_job_id`、
392
+ `hive/src/job.rs::valid_job_id`(三处**共读同一份区块表**,不是三套常量)。
393
+ 本闸**保留**的既有放宽(都是既有对外契约,**不得**为「同口径」收紧):
394
+ · **不要求 "h" 前缀**——`md_cg/test_units_poll.py` 的 "j_empty"/"j_good"/
395
+ "j_fail" 是本模块对外契约(poll 面向任意宿主派发器写出的 job 目录),前缀
396
+ 收紧会误杀;
397
+ · 允许 `-`(hive 侧拒它:不在区块表内、也不是它的结构字符);
398
+ · 长度上限 128、首尾无空白、首尾非点(拒 "."/".."/"..." 与 "x." 尾点形态)
399
+ 一并保留。
400
+ 非 str 一律拒(**不** str() 归一:与 legacy P3 同纪律,未校验的强制转换会把对象
401
+ 形态洗成合法路径成分)。
402
+ 字符类判据 = **区块白名单**(与 hive 两侧同源)——白名单外的一切字符一律拒。
403
+ 放宽带来的静默风险**逐条显式挡住**(c9:「isalpha」类判据下 Cf/Cc 天然不入,但
404
+ **不能靠这个**):零宽 U+200B..U+200F/U+2060/U+FEFF、双向控制
405
+ U+202A..U+202E/U+2066..U+2069、控制字符(C0/DEL/C1)**逐条显式判**;`/` `\` `:`
406
+ 与 NUL 同样显式拒(路径成分:相对父段 "../outside"、分隔符、盘符/ADS、绝对路径
407
+ 会被 os.path.join 吸附);Windows 保留设备名(CON/PRN/AUX/NUL/COM1..9/LPT1..9,
408
+ 含 `CON.txt` 带扩展名形态与 ASCII 大小写变体)**整 id 与按 `_` 分段的任一段**逐名
409
+ 显式拒——旧 ASCII 白名单下 `CON` 这类全字母 id 是**放行**的,故这是本闸换面时
410
+ **收紧**的那一面(与 hive 两侧同集同判,语料 80-84 行逐例钉死)。
411
+ 表缺失 / 坏表 ⇒ 判据一律 False(fail-closed,绝不放行)。
412
+ 本闸本批**新增收紧**(c7,2026-09-30):按 `_` 分段的**任一段**等于 `.` 或 `..` 即拒
413
+ ——整串口径下 `h_.._x` / `h_a_.._b` 是被收的;段级是面向重构的纵深加固(段可能被当
414
+ 父目录段用),与 hive 两侧同判。范围只加这一条:空段(`h__x`)等形态不动。
415
+ """
416
+ if not isinstance(jid, str) or not jid or len(jid) > 128:
417
+ return False
418
+ if jid != jid.strip():
419
+ return False
420
+ if jid[0] == "." or jid[-1] == ".":
421
+ return False
422
+ for c in jid:
423
+ u = ord(c)
424
+ if u <= 0x1F or 0x7F <= u <= 0x9F or c in "/\\:":
425
+ return False # 控制字符(C0/DEL/C1,含 NUL)与路径成分(显式判,c9)
426
+ if "\u200b" <= c <= "\u200f" or c in ("\u2060", "\ufeff"):
427
+ return False # 零宽/不可见注入载体(显式判,c9)
428
+ if "\u202a" <= c <= "\u202e" or "\u2066" <= c <= "\u2069":
429
+ return False # 双向控制(显式判,c9)
430
+ if c in "_.-":
431
+ continue # 结构字符:槽分隔符 / 点(首尾点已在上方拒)/ 既有放宽的 `-`
432
+ if not _charset_member(c):
433
+ return False
434
+ # Windows 保留设备名(显式判,c7/c9):整 id(首个 `.` 之前部分,Win32 忽略扩展名)
435
+ # 与按 `_` 分段的**任一段**(Win32 的设备名解析是按路径分量做的)——与
436
+ # `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` 同集同判。
437
+ if _is_reserved_device_name(jid):
438
+ return False
439
+ if any(_is_reserved_device_name(seg) for seg in jid.split("_")):
440
+ return False
441
+ # 「. / ..」的**段级**判据(c7,2026-09-30 加固):按 `_` 分段,任一段等于 `.` 或 `..`
442
+ # 即拒——与 `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` **三处同判**。
443
+ # 段级而非整串(本面原有的「首尾非点」只挡整串与尾点形态):id 的段可能被宿主当
444
+ # **目录名**或**父目录段**用(契约 §四.4「目录可作它的父段」)。现场定性:`h_.._x` /
445
+ # `h_a_.._b` 这类「含 `..` 段但不以点结尾」的 id 拼出的路径停在池内、不构成穿越 ⇒
446
+ # 面向重构的纵深加固。范围**只加这一条**:不拒空段(`h__x`)等未被裁定的形态。
447
+ if any(seg in (".", "..") for seg in jid.split("_")):
448
+ return False
449
+ return True
450
+
451
+
452
+ # 生效条件:无入参,返回 job_id 非法的结构化拒绝 dict(ok=False、state="invalid_job_id"、terminal=False、job_dir/content/status 均为 None、error 含非法 id 与本闸口径),字段集与 poll 的返回同构。
453
+ def _bad_job_id(job_id, *, where: str) -> dict:
454
+ """非法 job_id 的统一拒答(poll/wait/submit 同构,便于调用方机械判别)。"""
455
+ return {"job_id": job_id, "job_dir": None, "state": "invalid_job_id",
456
+ "terminal": False, "ok": False, "content": None, "status": None,
457
+ "error": ("job_id 非法:%r(%s)——job_id 须为**单个路径分量**:区块白名单"
458
+ "(hive/id_charset_blocks.txt)内的字母/数字,或结构字符 `_` `-` `.`;"
459
+ "首尾非点,不含 / \\ : 与控制/零宽/双向控制字符/NUL,"
460
+ "且整 id 与按 `_` 分段的任一段都不得是 Windows 保留设备名"
461
+ "(CON/PRN/AUX/NUL/COM1..9/LPT1..9,含 CON.txt 形态)"
462
+ "(N178:拒 ../victim 型越池读 result.json、"
463
+ "拒任意目录建目录写 spec.json)" % (job_id, where))}
464
+
465
+
466
+ # 生效条件:cg.root 与 cg.cg.root 都取不到真值时不写、直接返回 None;取到 root 时向 root/LOG_NAME 追加一行 rec(副本,setdefault ts)的 JSON,写入抛 OSError 时被吞掉静默返回 None。
467
+ def _log(cg, rec: dict) -> None:
468
+ """留痕 _units.jsonl(对齐 _crosscheck.jsonl / _backfill.jsonl 纪律)。"""
469
+ root = getattr(cg, "root", None) or getattr(getattr(cg, "cg", None), "root", None)
470
+ if not root:
471
+ return
472
+ try:
473
+ rec = dict(rec)
474
+ rec.setdefault("ts", int(time.time() * 1000))
475
+ with open(os.path.join(str(root), LOG_NAME), "a", encoding="utf-8") as f:
476
+ f.write(json.dumps(rec, ensure_ascii=False) + "\n")
477
+ except OSError:
478
+ pass
479
+
480
+
481
+ # 生效条件:role 不在 ROLES 时返回 ok=False 的未知角色 error;否则 model_name(model) 为空时返回 ok=False 的未配置复核模型;否则 str(prompt or "").strip() 为空时返回 ok=False 的 prompt 为空;否则落盘前先过 _valid_job_id 结构闸(未过返回 ok=False 的 job_id 非法,**不建目录不写文件**——N178:job_id 来源一旦不是 _job_id(),join 后就是「任意目录 + 生成名」的建目录/写文件原语);闸过则在 jobs_dir(jobs)/job_id 下写 spec.json 与 status.json(context_files 为真、temperature 非 None、extra 为真时才并入 spec),OSError 时返回 ok=False 的写入失败,全部成功返回 ok=True 与 job_id/job_dir/spec/model。
482
+ def submit(*, prompt: str, role: str = REFLECT, model: str = "", system_prompt: str = "",
483
+ context_files=None, timeout_s: int = DEFAULT_TIMEOUT_S,
484
+ max_tokens: int = DEFAULT_MAX_TOKENS, temperature=None, jobs: str = "",
485
+ actor: str = "", extra: dict = None, cg=None) -> dict:
486
+ """写一条 LLM 委托型 job(spec.json + status.json,形态同 _submit);只写文件不起进程。"""
487
+ if role not in ROLES:
488
+ return {"ok": False, "error": "未知复核角色:%r(可选 %s)" % (role, list(ROLES))}
489
+ mdl = model_name(model)
490
+ if not mdl:
491
+ return {"ok": False, "error": "未配置复核模型:请设 %s 或显式传 model" % ENV_MODEL}
492
+ if not str(prompt or "").strip():
493
+ return {"ok": False, "error": "prompt 为空"}
494
+ jd, job_id = jobs_dir(jobs), _job_id()
495
+ # N178(2026-09-28):**落盘前**过闸——makedirs 之后再过就等于已经建了目录。
496
+ if not _valid_job_id(job_id):
497
+ return {"ok": False, "job_dir": None, "job_id": job_id,
498
+ "error": _bad_job_id(job_id, where="submit 落点")["error"]}
499
+ d = os.path.join(jd, job_id)
500
+ spec = {"model": mdl, "user_prompt": str(prompt), "system_prompt": str(system_prompt or ""),
501
+ "timeout_s": int(timeout_s), "max_tokens": int(max_tokens),
502
+ "role": role, "unit_role": role}
503
+ if context_files:
504
+ spec["context_files"] = list(context_files)
505
+ if temperature is not None:
506
+ spec["temperature"] = temperature
507
+ if extra:
508
+ spec.update(extra)
509
+ try:
510
+ os.makedirs(d, exist_ok=True)
511
+ with open(os.path.join(d, SPEC_FILE), "w", encoding="utf-8") as f:
512
+ json.dump(spec, f, ensure_ascii=False)
513
+ with open(os.path.join(d, STATUS_FILE), "w", encoding="utf-8") as f:
514
+ json.dump({"job_id": job_id, "state": "pending",
515
+ "created_ts": int(time.time() * 1000), "started_ts": None,
516
+ "heartbeat_ts": None, "elapsed_s": 0.0, "timeout_s": int(timeout_s),
517
+ "model": mdl, "pid": None, "error": None}, f, ensure_ascii=False)
518
+ except OSError as exc:
519
+ return {"ok": False, "job_dir": d,
520
+ "error": "job 写入失败:%s: %s" % (type(exc).__name__, exc)}
521
+ _log(cg, {"action": "submit", "job_id": job_id, "role": role, "model": mdl,
522
+ "timeout_s": int(timeout_s), "actor": actor, "prompt_head": str(prompt)[:200]})
523
+ return {"ok": True, "job_id": job_id, "job_dir": d, "spec": spec,
524
+ "unit_role": role, "model": mdl}
525
+
526
+
527
+ # 生效条件:job_id 先过 _valid_job_id 结构闸(未过返回 state="invalid_job_id" 的结构化拒绝,**不触盘**——N178:修前 "../victim" 会被 join 成池外目录并读出其 result.json 全文);闸过时 jobs_dir(jobs)/job_id 不是目录返回 state=missing、terminal=False 的目录不存在 error;是目录时读 STATUS_FILE(读失败则 status 置 None)并用其 state 覆盖 state/terminal(state 属 TERMINAL_STATES 才 terminal=True);RESULT_FILE 被 isfile 命中则 terminal=True、state=st or "done",解析抛 OSError/ValueError 时提前返回该 error;解析为 dict 时取 ok/content/error/usage/model,且 ok 为真而 content 去空白为空时把 ok 改 False 并写空正文 error,解析为非 dict 时 ok=True 且 content 为原值。
528
+ def poll(job_id: str, jobs: str = "") -> dict:
529
+ """读 job 终态视图:**以 result.json 出现为终态主判据**,status.json 仅作辅助。"""
530
+ # N178(2026-09-28):调用方给的 job_id 是路径成分,**先过闸再 join**。
531
+ # 修前此处无闸,且 `str(job_id or "")` 还会把非 str 洗成合法成分。
532
+ if not _valid_job_id(job_id):
533
+ return _bad_job_id(job_id, where="poll 池路径成分")
534
+ d = os.path.join(jobs_dir(jobs), job_id)
535
+ out = {"job_id": job_id, "job_dir": d, "state": "missing", "terminal": False,
536
+ "ok": False, "content": None, "error": None, "status": None}
537
+ if not os.path.isdir(d):
538
+ out["error"] = "job 目录不存在:%s" % d
539
+ return out
540
+ sp = os.path.join(d, STATUS_FILE)
541
+ if os.path.isfile(sp):
542
+ try:
543
+ with open(sp, encoding="utf-8") as f:
544
+ out["status"] = json.load(f)
545
+ except (OSError, ValueError):
546
+ out["status"] = None
547
+ st = (out["status"] or {}).get("state")
548
+ if st:
549
+ out.update({"state": st, "terminal": st in TERMINAL_STATES})
550
+ rp = os.path.join(d, RESULT_FILE)
551
+ if os.path.isfile(rp):
552
+ out["state"] = st or "done"
553
+ out["terminal"] = True
554
+ try:
555
+ with open(rp, encoding="utf-8") as f:
556
+ res = json.load(f)
557
+ except (OSError, ValueError) as exc:
558
+ out["error"] = "result.json 不可读:%s" % type(exc).__name__
559
+ return out
560
+ if isinstance(res, dict):
561
+ out["ok"] = bool(res.get("ok"))
562
+ out["content"] = res.get("content")
563
+ out["error"] = res.get("error") or out["error"]
564
+ out["usage"] = res.get("usage")
565
+ out["model"] = res.get("model")
566
+ # 空正文**不得报成功**:reasoning 与正文共享 completion 预算,预算不足时
567
+ # job 仍自称 ok 但 content 为空 → 若不拦,会被误读成「复核单元无答复」
568
+ # (假死锁)。run() 早已有同等校验,此处补齐,消除两处口径不一致。
569
+ if out["ok"] and not str(out["content"] or "").strip():
570
+ out["ok"] = False
571
+ out["error"] = ("空正文:job 自称 ok 但 content 为空(多为 reasoning 吃尽"
572
+ "完成预算;提高 max_tokens,勿把预算不足当通道不可用)")
573
+ else:
574
+ out["ok"], out["content"] = True, res
575
+ return out
576
+
577
+
578
+ # 生效条件:job_id 未过 _valid_job_id 结构闸时**立即**返回 poll 的同一拒绝结构(N178:否则非法 id 会空转满 timeout_s 才超时返回——拒绝不该以等待为代价);闸过时循环 poll(job_id, jobs),结果 terminal 为真即补 waited_s 后返回;否则 time.time()-t0 >= float(timeout_s) 时返回 terminal=False、timeout=True 与超时 error;两者皆不满足则 sleep(float(poll_s)) 后重试(timeout_s=0 时首次 poll 非终态即超时返回)。
579
+ def wait(job_id: str, *, jobs: str = "", timeout_s: float = DEFAULT_TIMEOUT_S,
580
+ poll_s: float = DEFAULT_POLL_S) -> dict:
581
+ """阻塞等终态;超时如实返回(不假装成功、不强杀 job)。"""
582
+ if not _valid_job_id(job_id):
583
+ # N178(2026-09-28):fail-fast——复用 poll 的拒绝结构,绝不进轮询。
584
+ return poll(job_id, jobs)
585
+ t0 = time.time()
586
+ while True:
587
+ cur = poll(job_id, jobs)
588
+ if cur.get("terminal"):
589
+ cur["waited_s"] = round(time.time() - t0, 3)
590
+ return cur
591
+ if (time.time() - t0) >= float(timeout_s):
592
+ cur.update({"terminal": False, "timeout": True, "waited_s": round(time.time() - t0, 3),
593
+ "error": "等待超时 %.0fs(job 仍在 %s)" % (float(timeout_s),
594
+ cur.get("state"))})
595
+ return cur
596
+ time.sleep(float(poll_s))
597
+
598
+
599
+ # 生效条件:submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw) 的 ok 为假时返回 stage="submit" 的失败 dict(含 **sub);ok 为真时 wait(sub["job_id"], jobs=kw.get("jobs",""), timeout_s=wait_s),补 stage="wait"/job_id/unit_role/model,并把 ok 改为 res 的 ok 与 content 同时为真。
600
+ def run(*, prompt: str, role: str = REFLECT, cg=None, actor: str = "",
601
+ wait_s: float = DEFAULT_TIMEOUT_S, **kw) -> dict:
602
+ """submit + wait 组合(阻塞式复核,MCP action=review 主路径)。"""
603
+ sub = submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw)
604
+ if not sub.get("ok"):
605
+ return {"ok": False, "stage": "submit", "error": sub.get("error"), **sub}
606
+ res = wait(sub["job_id"], jobs=kw.get("jobs", ""), timeout_s=wait_s)
607
+ res.update({"stage": "wait", "job_id": sub["job_id"], "unit_role": role,
608
+ "model": sub.get("model")})
609
+ res["ok"] = bool(res.get("ok")) and bool(res.get("content"))
610
+ return res
611
+
612
+
613
+ # ---------------------------------------------------------------- 裁决解析与搬运
614
+
615
+ _FENCE_RE = re.compile(r"```(?:json)?\s*(.+?)\s*```", re.S)
616
+
617
+
618
+ # 生效条件:raw 是 dict/list 时原样返回;否则取 str(raw or "").strip(),为空串(含 0/False/None 等假值)返回 None;否则依次尝试 _FENCE_RE 第 1 组、整段文本、首个 "{" 到末个 "}" 及首个 "[" 到末个 "]" 的切片,返回首个能 json.loads 成 dict 或 list 的候选;全部失败返回 None。
619
+ def _json_of(raw):
620
+ """从单元输出抽第一个 JSON 对象/数组(容忍 ```json 围栏与前后噪声)。"""
621
+ if isinstance(raw, (dict, list)):
622
+ return raw
623
+ text = str(raw or "").strip()
624
+ if not text:
625
+ return None
626
+ cands = []
627
+ m = _FENCE_RE.search(text)
628
+ if m:
629
+ cands.append(m.group(1))
630
+ cands.append(text)
631
+ for opener, closer in (("{", "}"), ("[", "]")):
632
+ i, j = text.find(opener), text.rfind(closer)
633
+ if 0 <= i < j:
634
+ cands.append(text[i:j + 1])
635
+ for c in cands:
636
+ try:
637
+ v = json.loads(c)
638
+ except ValueError:
639
+ continue
640
+ if isinstance(v, (dict, list)):
641
+ return v
642
+ return None
643
+
644
+
645
+ # 生效条件:data=_json_of(raw) 为 list 时取 data[0](仅当它是 dict,否则 None);非 dict 时返回 verdict=DEFER、parsed=False;dict 时 word 取 verdict/decision/state/result 中首个真值后 strip().lower(),_VERDICT_MAP.get(word) 为 None 时返回 DEFER、parsed=True 并带 corr 与 reason,命中时返回该裁决及 reason、slot_corrections(取自 slot_corrections/corrections,非 dict 则置 {})、checks、raw 前 500 字符。
646
+ def verdict_of(raw) -> dict:
647
+ """单元输出 → 裁决四态;解析不出 → DEFER(不猜测、不当通过)。"""
648
+ data = _json_of(raw)
649
+ if isinstance(data, list):
650
+ data = data[0] if data and isinstance(data[0], dict) else None
651
+ if not isinstance(data, dict):
652
+ return {"verdict": DEFER, "reason": "单元输出无法解析为裁决 JSON",
653
+ "slot_corrections": {}, "raw": str(raw)[:500], "parsed": False}
654
+ word = str(data.get("verdict") or data.get("decision") or data.get("state")
655
+ or data.get("result") or "").strip().lower()
656
+ reason = str(data.get("reason") or data.get("why") or data.get("detail") or "").strip()
657
+ corr = data.get("slot_corrections") or data.get("corrections") or {}
658
+ corr = corr if isinstance(corr, dict) else {}
659
+ got = _VERDICT_MAP.get(word)
660
+ if got is None:
661
+ return {"verdict": DEFER, "slot_corrections": corr, "parsed": True, "raw": str(raw)[:500],
662
+ "reason": "单元未给出可识别的裁决(%r)%s" % (word, (":" + reason) if reason else "")}
663
+ return {"verdict": got, "reason": reason, "slot_corrections": corr,
664
+ "checks": data.get("checks"), "raw": str(raw)[:500], "parsed": True}
665
+
666
+
667
+ # 生效条件:state==HIVE 时返回 "hive:<role>:<job_id 或 'unknown'>";state==SUBAGENT 时返回 "subagent:<role>:<channel 或 'harness'>";其余 state 返回空串。
668
+ def transport_name(state: str, role: str, job_id: str = "", channel: str = "") -> str:
669
+ """裁决来源标识:**结构上不可能等于编译者**,保证 A 裁定「不得自证」不被误伤。"""
670
+ if state == HIVE:
671
+ return "hive:%s:%s" % (role, job_id or "unknown")
672
+ if state == SUBAGENT:
673
+ return "subagent:%s:%s" % (role, channel or "harness")
674
+ return ""
675
+
676
+
677
+ # 生效条件:unit 为假值时按 {} 处理;verdict=unit.get("verdict") or DEFER,verifier=transport_name(state, role, job_id, channel),evidence 取 unit 的 reason,为空则退回 str(unit["raw"])[:300],job_id 为真时再追加“(job=<job_id>)”;仅当 unit 的 slot_corrections 为真才带该键,仅当 compiled_by 与 verifier 皆非空且相等才置 self_verify=True。
678
+ def to_attest_args(unit: dict, *, state: str = "", role: str = REFLECT, job_id: str = "",
679
+ channel: str = "", compiled_by: str = "") -> dict:
680
+ """单元裁决 → ccgc.attest(...) 入参(纯函数,离线可测)。
681
+
682
+ 诚实边界:只做搬运与命名;裁决正确性由外部单元负责,本模块不为其背书。
683
+ """
684
+ unit = unit or {}
685
+ verdict = unit.get("verdict") or DEFER
686
+ verifier = transport_name(state, role, job_id, channel)
687
+ evidence = str(unit.get("reason") or "")
688
+ if unit.get("raw") and not evidence:
689
+ evidence = str(unit["raw"])[:300]
690
+ if job_id:
691
+ evidence = "%s(job=%s)" % (evidence, job_id)
692
+ args = {"verdict": verdict, "verifier": verifier, "evidence": evidence}
693
+ if unit.get("slot_corrections"):
694
+ args["slot_corrections"] = unit["slot_corrections"]
695
+ if compiled_by and verifier and verifier == compiled_by:
696
+ args["self_verify"] = True
697
+ return args
698
+
699
+
700
+ # ---------------------------------------------------------------- 复核请求包
701
+
702
+ _REFLECT_TPL = """你是认知图记忆节点的**反思单元**(reflect)。下面是一份由 ccgc 编译出的
703
+ CCG 六要素候选(功能名/生效条件/子功能/执行/验证方式/不适用条件)。请逐项反思:
704
+
705
+ 1) 六要素是否齐备,是否都能在「对话记录」里找到字面依据;
706
+ 2) 「生效条件」四槽(场景/时窗/对象/前置)是否与实际适用范围一致,有无过度泛化;
707
+ 3) 「不适用条件」(拒绝域)是否漏掉了明显该拒的情形;
708
+ 4) 若有问题,给出**最小修正**(只改该字段,不重写)。
709
+
710
+ 编译产物(JSON):
711
+ {digest}
712
+
713
+ 原始对话记录(真源,引用必须出自此处):
714
+ {dialog}
715
+
716
+ 只输出一个 JSON 对象,不要任何解释文字:
717
+ {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}},
718
+ "checks":[{{"element":"功能名","ok":true,"note":""}}]}}"""
719
+
720
+ _VERIFY_TPL = """你是独立**验证单元**(verify)。对下面这份 CCG 六要素候选与反思单元的结论
721
+ 逐条复核:来源是否真实可追溯、结论是否被对话记录支持、修正是否越权(不得新增事实)。
722
+
723
+ **你只能否决或存疑,不得新增主张、不得改写事实**(可给出 slot_corrections 修正已有槽位)。
724
+
725
+ 候选(JSON):
726
+ {digest}
727
+
728
+ 反思单元结论:
729
+ {reflect_rows}
730
+
731
+ 对话记录(真源):
732
+ {dialog}
733
+
734
+ 只输出一个 JSON 对象:
735
+ {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}}}}"""
736
+
737
+
738
+ # 生效条件:digest is None 时返回 "{}";digest 是 str 时原样返回;否则先试 to_dict/as_dict 可调用方法并 json.dumps 其返回值(抛异常即跳出改走后续分支);是 dict 时 json.dumps(digest);其余取 vars(digest) 中不以 "_" 开头的属性 json.dumps(default=str)。
739
+ def _digest_of(digest) -> str:
740
+ if digest is None:
741
+ return "{}"
742
+ if isinstance(digest, str):
743
+ return digest
744
+ for attr in ("to_dict", "as_dict"):
745
+ fn = getattr(digest, attr, None)
746
+ if callable(fn):
747
+ try:
748
+ return json.dumps(fn(), ensure_ascii=False, indent=1)
749
+ except Exception: # noqa: BLE001
750
+ break
751
+ if isinstance(digest, dict):
752
+ return json.dumps(digest, ensure_ascii=False, indent=1)
753
+ return json.dumps({k: v for k, v in vars(digest).items() if not k.startswith("_")},
754
+ ensure_ascii=False, indent=1, default=str)
755
+
756
+
757
+ # 生效条件:role==VERIFY 选 _VERIFY_TPL,否则选 _REFLECT_TPL;reflect_rows 是 str 时直接作为 rows,否则 json.dumps(reflect_rows or [], ensure_ascii=False, indent=1);最终返回 tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000], reflect_rows=rows[:3000])。
758
+ def prompt_for(role: str, digest=None, *, dialog: str = "", reflect_rows="") -> str:
759
+ """按角色生成复核请求包正文(reflect/verify 共用一处模板真源)。"""
760
+ tpl = _VERIFY_TPL if role == VERIFY else _REFLECT_TPL
761
+ rows = reflect_rows if isinstance(reflect_rows, str) else json.dumps(
762
+ reflect_rows or [], ensure_ascii=False, indent=1)
763
+ return tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000],
764
+ reflect_rows=rows[:3000])
765
+
766
+
767
+ # 生效条件:text 取 prompt 真值或 prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows);pr=probe(jobs, model, allow_degrade=allow_degrade, channel=channel) 为 SUBAGENT 时原样返回未派发的 SUBAGENT 包、为 CONFIGURE 时返回未派发的 CONFIGURE 包;为 HIVE 时若 autostart 为真且 serve_state(jobs) 非 alive 先 autostart_serve(jobs),再 submit(...),submit 失败回 CONFIGURE 且把 error 拼进 hint,成功则给出 job_id,blocking=False 直接返回;blocking=True 时 wait(sub["job_id"], jobs=jobs, timeout_s=wait_s),res.ok 为假则 unit 记 DEFER 并附未产出有效结果的 hint,为真则 unit=verdict_of(res.get("content")),随后填 transport/attest/result_ok/waited_s 并 _log。
768
+ def review(*, prompt: str = "", role: str = REFLECT, digest=None, dialog: str = "",
769
+ reflect_rows="", node_id: str = "", jobs: str = "", model: str = "",
770
+ timeout_s: int = DEFAULT_TIMEOUT_S, allow_degrade: bool = False,
771
+ channel: str = "", wait_s: float = DEFAULT_TIMEOUT_S, blocking: bool = True,
772
+ cg=None, actor: str = "", autostart: bool = False) -> dict:
773
+ """复核主入口:**蜂巢优先 → 提示配置 → 端子代理降级**(三态各自如实返回)。
774
+
775
+ 返回统一形态:{state, role, node_id, transport, unit, attest, prompt, job_id, hint}
776
+ - state=hive :已派发;blocking=True 时等终态并给出 unit/attest;否则只给 job_id
777
+ - state=configure:**未派发**,hint 为配置指引(使用者裁定:不可用即提示配置)
778
+ - state=subagent :**未派发**,返回 prompt 包供宿主子代理执行并回填
779
+ """
780
+ text = prompt or prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows)
781
+ pr = probe(jobs, model, allow_degrade=allow_degrade, channel=channel)
782
+ base = {"role": role, "node_id": node_id, "prompt": text,
783
+ "transport": None, "unit": None, "attest": None,
784
+ "job_id": None, "hint": pr.get("hint") or "", "channel": pr.get("channel") or "",
785
+ "degrade": {"channel": channel or "harness-subagent",
786
+ "how": "宿主子代理执行 prompt → 裁决经 verdicts 回填 attest"}}
787
+ if pr["state"] == SUBAGENT:
788
+ return {"state": SUBAGENT, **base,
789
+ "degrade": {"available": True, "channel": channel or "harness-subagent",
790
+ "how": "把 prompt 交给宿主子代理,取其 JSON 裁决后调 "
791
+ "cg(op=ccg, action=attest, verdict=<accept|drop|defer>, "
792
+ "verifier=subagent:<role>:<channel>)"}}
793
+ if pr["state"] == CONFIGURE:
794
+ return {"state": CONFIGURE, **base,
795
+ "degrade": {"available": True, "channel": channel or "harness-subagent",
796
+ "how": "① 按 hint 配置蜂巢后重试;② 或带 allow_degrade=true 降级子代理"}}
797
+ if autostart and not serve_state(jobs)["alive"]:
798
+ pr["autostart"] = autostart_serve(jobs)
799
+ sub = submit(prompt=text, role=role, jobs=jobs, model=model, timeout_s=timeout_s,
800
+ cg=cg, actor=actor)
801
+ if not sub.get("ok"):
802
+ return {"state": CONFIGURE, **base, "hint": (pr.get("hint") or "") + "\n" + str(sub.get("error"))}
803
+ out = {"state": HIVE, **base, "job_id": sub["job_id"], "unit_role": role,
804
+ "model": sub.get("model")}
805
+ if not blocking:
806
+ return out
807
+ res = wait(sub["job_id"], jobs=jobs, timeout_s=wait_s)
808
+ unit = verdict_of(res.get("content")) if res.get("ok") else {
809
+ "verdict": DEFER, "reason": res.get("error") or "单元未返回可用结果",
810
+ "slot_corrections": {}, "parsed": False}
811
+ out["unit"] = unit
812
+ out["transport"] = transport_name(HIVE, role, sub["job_id"])
813
+ out["attest"] = to_attest_args(unit, state=HIVE, role=role, job_id=sub["job_id"])
814
+ out["result_ok"] = bool(res.get("ok"))
815
+ out["waited_s"] = res.get("waited_s")
816
+ if not res.get("ok"):
817
+ out["hint"] = "蜂巢 job 未产出有效结果:%s(裁决按 DEFER 处理,未假装通过)" % res.get("error")
818
+ _log(cg, {"action": "review", "job_id": sub["job_id"], "role": role,
819
+ "node_id": node_id, "actor": actor, "unit_verdict": unit.get("verdict"),
820
+ "result_ok": bool(res.get("ok"))})
821
+ return out
822
+
823
+
824
+ # ---------------------------------------------------------------- serve 拉起(显式)
825
+
826
+ # 生效条件:serve_state(jobs_dir(jobs)) 已 alive 时返回 started=False 的“serve 存活”;否则 exe_path() 未被 isfile 命中时返回 started=False 并提示先 cargo build --release;否则以 detached/新会话 Popen 拉起 exe serve --jobs jd 并把 stdout/stderr 写入 jd/_serve.log,Popen 抛 OSError 时返回 started=False 的拉起失败;拉起后在 float(wait_s) 内轮询到 alive 返回 started=True 的“serve 已拉起”,轮询超时仍返回 started=True 但标注心跳未就绪。
827
+ def autostart_serve(jobs: str = "", wait_s: float = 5.0) -> dict:
828
+ """**显式**拉起 serve(默认不启用;使用者裁定:不可用即提示配置)。
829
+
830
+ 形态同 hive_mcp._ensure_serve:detached + 独立日志,不阻塞调用方。
831
+ """
832
+ jd = jobs_dir(jobs)
833
+ if serve_state(jd)["alive"]:
834
+ return {"started": False, "note": "serve 存活"}
835
+ exe = exe_path()
836
+ if not os.path.isfile(exe):
837
+ return {"started": False, "note": "未找到可执行文件 %s——先 cargo build --release" % exe}
838
+ kwargs = {}
839
+ if os.name == "nt":
840
+ kwargs["creationflags"] = subprocess.DETACHED_PROCESS | subprocess.CREATE_NO_WINDOW
841
+ else:
842
+ kwargs["start_new_session"] = True
843
+ try:
844
+ os.makedirs(jd, exist_ok=True)
845
+ with open(os.path.join(jd, "_serve.log"), "ab") as logf:
846
+ subprocess.Popen([exe, "serve", "--jobs", jd], stdout=logf, stderr=logf,
847
+ stdin=subprocess.DEVNULL, **kwargs)
848
+ except OSError as exc:
849
+ return {"started": False, "note": "拉起失败:%s: %s" % (type(exc).__name__, exc)}
850
+ t0 = time.time()
851
+ while time.time() - t0 < float(wait_s):
852
+ if serve_state(jd)["alive"]:
853
+ return {"started": True, "note": "serve 已拉起"}
854
+ time.sleep(0.1)
855
+ return {"started": True, "note": "serve 已拉起(心跳未就绪,稍后自愈)"}
856
+
857
+
858
+ # 生效条件:返回 dict 的 ok=p["state"]==HIVE,其中 p=plan(jobs)(model/fresh_s/allow_degrade/channel 全走默认),state/serve_alive/serve_age_s/chain/hint/model 取自该 p;jobs_dir 取 jobs_dir(jobs),exe_found 与 exe_path 取 exe_path() 是否被 isfile 命中,model_set=bool(model_name())(无参,读 ENV_MODEL),api_key_set=bool(os.environ.get(ENV_API_KEY)),env 记录 ENV_JOBS_DIR 与 ENV_MODEL 的原值。
859
+ def doctor(jobs: str = "") -> dict:
860
+ """能力体检(形态对齐 hive_doctor):判活 + exe + 模型 + 优先级链。"""
861
+ jd = jobs_dir(jobs)
862
+ p = plan(jobs)
863
+ return {"ok": p["state"] == HIVE, "state": p["state"], "jobs_dir": jd,
864
+ "serve_alive": p["serve"]["alive"], "serve_age_s": p["serve"]["age_s"],
865
+ "exe_found": os.path.isfile(exe_path()), "exe_path": exe_path(),
866
+ "model_set": bool(model_name()), "model": p["model"],
867
+ "api_key_set": bool(os.environ.get(ENV_API_KEY)),
868
+ "env": {"HIVE_JOBS_DIR": os.environ.get(ENV_JOBS_DIR, ""),
869
+ "MDCG_UNIT_MODEL": os.environ.get(ENV_MODEL, "")},
870
870
  "chain": p["chain"], "hint": p["hint"]}