@furongjun1999/dsh-memory 0.8.1 → 0.9.7
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.
- package/README.md +662 -659
- package/codebuddy/README.md +1 -1
- package/data/policy.json +38 -27
- package/docs/README.md +18 -2
- package/docs/discipline/harnesses.yaml +1 -1
- package/docs/discipline/templates/spec.txt.tmpl +23 -0
- package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
- package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
- package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
- package/dsh/README.md +1 -1
- package/dsh/cordis.yml.example +139 -139
- package/hive/README.md +705 -0
- package/hive/id_charset_blocks.txt +147 -0
- package/lib/bridge.d.ts +3 -0
- package/lib/bridge.js +32 -11
- package/lib/cli.js +14 -17
- package/lib/hooks.d.ts +37 -3
- package/lib/hooks.js +176 -24
- package/lib/index.d.ts +2 -2
- package/lib/index.js +29 -6
- package/lib/init.js +21 -21
- package/lib/lib/datapath.d.ts +56 -0
- package/lib/lib/datapath.js +102 -9
- package/lib/lib/hook_audit.d.ts +0 -1
- package/lib/lib/hook_audit.js +51 -3
- package/lib/lib/mdcg_client.d.ts +4 -1
- package/lib/lib/mdcg_client.js +10 -2
- package/lib/lib/mutual.js +61 -15
- package/lib/lib/prompt_safety.js +28 -2
- package/lib/lib/roleplay_web.js +30 -2
- package/lib/lib/token_store.d.ts +25 -6
- package/lib/lib/token_store.js +224 -33
- package/lib/tools.d.ts +15 -2
- package/lib/tools.js +44 -4
- package/md_cg/_guard_kit.py +121 -0
- package/md_cg/admission.py +718 -718
- package/md_cg/anchor.py +114 -0
- package/md_cg/audit.py +37 -7
- package/md_cg/autonomy.py +433 -288
- package/md_cg/autonomy_modes.py +781 -642
- package/md_cg/bench_beir_bm25.py +154 -0
- package/md_cg/bench_beir_scifact.py +170 -0
- package/md_cg/bench_bm25_blockmax.py +134 -0
- package/md_cg/bench_bm25_incremental.py +246 -0
- package/md_cg/bench_ccg_heading.py +118 -0
- package/md_cg/bench_csre_correctness.py +145 -0
- package/md_cg/bench_excerpt_budget.py +94 -0
- package/md_cg/bench_fuzzy_substrings.py +299 -0
- package/md_cg/bench_memory_rsi.py +358 -0
- package/md_cg/bench_memory_rsi_latency.py +82 -0
- package/md_cg/bench_memory_rsi_public.py +116 -0
- package/md_cg/bench_memory_rsi_tools.py +229 -0
- package/md_cg/bench_rrf_candidates.py +212 -0
- package/md_cg/bench_rrf_public.py +100 -0
- package/md_cg/bench_text_projections.py +221 -0
- package/md_cg/bench_timeanchor.py +357 -0
- package/md_cg/bm25.py +601 -0
- package/md_cg/branches.py +404 -327
- package/md_cg/build_postings.py +74 -73
- package/md_cg/ccgc.py +4 -2
- package/md_cg/chain.py +573 -379
- package/md_cg/coldverify.py +531 -292
- package/md_cg/condaccept.py +263 -0
- package/md_cg/condgate.py +308 -0
- package/md_cg/config_registry.py +329 -0
- package/md_cg/config_registry_bulk.py +482 -0
- package/md_cg/config_registry_guard.py +487 -0
- package/md_cg/config_render.py +354 -0
- package/md_cg/config_validate.py +455 -0
- package/md_cg/conformance.py +747 -726
- package/md_cg/conformance_core.py +753 -0
- package/md_cg/consistency.py +1278 -955
- package/md_cg/consolidate.py +1793 -1633
- package/md_cg/crypto.py +346 -24
- package/md_cg/datapath.py +137 -12
- package/md_cg/eval_common.py +522 -575
- package/md_cg/evidence.py +946 -585
- package/md_cg/evidence_delivery.py +101 -0
- package/md_cg/experience_consolidation.py +317 -0
- package/md_cg/export.py +329 -222
- package/md_cg/forgetting.py +1050 -922
- package/md_cg/freshness.py +601 -548
- package/md_cg/fsutil.py +1120 -824
- package/md_cg/goal_gen.py +458 -0
- package/md_cg/hotcache.py +107 -9
- package/md_cg/hyperedge.py +262 -251
- package/md_cg/identity.py +573 -391
- package/md_cg/imgskill.py +1712 -0
- package/md_cg/insight.py +540 -521
- package/md_cg/interface_schema.py +146 -0
- package/md_cg/interop.py +20 -0
- package/md_cg/judgment_manifest.py +24 -1
- package/md_cg/lifecycle.py +426 -345
- package/md_cg/links.py +27 -6
- package/md_cg/logref.py +332 -327
- package/md_cg/mcp_server.py +5227 -4449
- package/md_cg/mdcg.py +1301 -203
- package/md_cg/mdcos.py +7108 -5440
- package/md_cg/memory_rsi.py +308 -0
- package/md_cg/metacognition.py +726 -591
- package/md_cg/nodefile.py +151 -3
- package/md_cg/op_table.py +1128 -0
- package/md_cg/postings.py +524 -300
- package/md_cg/predict.py +1103 -1100
- package/md_cg/probe_memory_rsi.py +95 -0
- package/md_cg/probe_memory_rsi_mcp.py +66 -0
- package/md_cg/protect.py +654 -494
- package/md_cg/protocol.py +492 -411
- package/md_cg/provenance.py +606 -600
- package/md_cg/qmd.py +477 -0
- package/md_cg/qmd_llm.py +334 -0
- package/md_cg/query_excerpt.py +171 -0
- package/md_cg/queue_health.py +130 -0
- package/md_cg/reach.py +470 -453
- package/md_cg/readcache.py +115 -3
- package/md_cg/reconcile.py +239 -228
- package/md_cg/refindex.py +1191 -1042
- package/md_cg/refine.py +613 -604
- package/md_cg/retrieve.py +128 -0
- package/md_cg/review_cli.py +204 -26
- package/md_cg/revise.py +140 -0
- package/md_cg/rollback.py +657 -420
- package/md_cg/rollback_cli.py +124 -104
- package/md_cg/rotate.py +347 -0
- package/md_cg/routing.py +490 -429
- package/md_cg/rrf_candidates.py +204 -0
- package/md_cg/run_tests.py +19 -1
- package/md_cg/scrub.py +177 -23
- package/md_cg/security.py +269 -17
- package/md_cg/self_state.py +1053 -1029
- package/md_cg/self_surface.py +50 -0
- package/md_cg/semantic/canonical.py +144 -144
- package/md_cg/semantic/export_en_zh_map.py +2 -2
- package/md_cg/semantic/zh_en_atoms.py +141 -139
- package/md_cg/session5.py +106 -0
- package/md_cg/signer.py +76 -2
- package/md_cg/sleep.py +1779 -1583
- package/md_cg/sources.py +1091 -833
- package/md_cg/state_events.py +75 -10
- package/md_cg/state_slots.py +312 -221
- package/md_cg/stg.py +85 -18
- package/md_cg/stgidx.py +537 -281
- package/md_cg/subgraph.py +851 -729
- package/md_cg/sustain.py +458 -19
- package/md_cg/task_memory.py +367 -0
- package/md_cg/test_action_derive.py +210 -203
- package/md_cg/test_audit_heartbeat_20261015.py +417 -0
- package/md_cg/test_audit_protection_20261015.py +483 -0
- package/md_cg/test_audit_rotate_parity.py +280 -0
- package/md_cg/test_audit_state_20261015.py +253 -0
- package/md_cg/test_audit_write_20261015.py +161 -0
- package/md_cg/test_auto_defaults.py +43 -4
- package/md_cg/test_autonomy_emotion.py +328 -0
- package/md_cg/test_autonomy_modes.py +2013 -1973
- package/md_cg/test_b1_foreign_read.py +245 -0
- package/md_cg/test_bm25.py +438 -0
- package/md_cg/test_bm25_hydration_refill.py +265 -0
- package/md_cg/test_bm25_incremental.py +241 -0
- package/md_cg/test_bm25_incremental_mutations.py +160 -0
- package/md_cg/test_bm25_mutations.py +205 -0
- package/md_cg/test_bm25_pool_view.py +196 -0
- package/md_cg/test_boot_openblas_guard.py +218 -197
- package/md_cg/test_boundary_hit.py +1 -1
- package/md_cg/test_branches_sensitivity.py +375 -0
- package/md_cg/test_c8_search_rrf_gates.py +1 -1
- package/md_cg/test_canonical_timezones.py +211 -0
- package/md_cg/test_ccg_heading_parser.py +73 -0
- package/md_cg/test_chain_best_first.py +403 -0
- package/md_cg/test_chain_candidate_scope.py +227 -0
- package/md_cg/test_cn_recall_grams.py +206 -0
- package/md_cg/test_code_kind_forbidden.py +101 -0
- package/md_cg/test_coldverify_drain.py +127 -0
- package/md_cg/test_condaccept.py +156 -0
- package/md_cg/test_condgate.py +141 -0
- package/md_cg/test_config_registry.py +55 -0
- package/md_cg/test_crypto_rotate.py +257 -0
- package/md_cg/test_csre_correctness.py +297 -0
- package/md_cg/test_csre_index_import_guard.py +161 -0
- package/md_cg/test_csre_mutations.py +34 -0
- package/md_cg/test_csre_session.py +69 -0
- package/md_cg/test_curiosity_budget.py +468 -0
- package/md_cg/test_d17_autostart_toolface.py +453 -0
- package/md_cg/test_datapath_tilde_home.py +271 -0
- package/md_cg/test_derived_cache_generations.py +256 -0
- package/md_cg/test_evidence_delivery_compact.py +54 -0
- package/md_cg/test_exact_text_cache.py +191 -0
- package/md_cg/test_excerpt_budget.py +188 -0
- package/md_cg/test_experience_consolidation.py +112 -0
- package/md_cg/test_export_default_collision.py +138 -0
- package/md_cg/test_export_snapshots.py +322 -0
- package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
- package/md_cg/test_gain_gate.py +16 -5
- package/md_cg/test_goal_gen.py +355 -0
- package/md_cg/test_h2_session_view_norm.py +251 -233
- package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
- package/md_cg/test_heartbeat_ledger.py +557 -0
- package/md_cg/test_hierarchy_audit_graph.py +237 -0
- package/md_cg/test_i50c_meta_passthrough.py +628 -608
- package/md_cg/test_i50e_readside_protection.py +658 -656
- package/md_cg/test_identity_attribution.py +96 -2
- package/md_cg/test_identity_contract.py +329 -0
- package/md_cg/test_imgskill.py +1444 -0
- package/md_cg/test_index_snapshot_shape.py +240 -0
- package/md_cg/test_interop_judgment.py +258 -228
- package/md_cg/test_issue111_gate_order.py +77 -0
- package/md_cg/test_issue111_scoring_contract.py +87 -0
- package/md_cg/test_issue121_calibration_bounds.py +293 -0
- package/md_cg/test_issue128_session_env_authority.py +246 -0
- package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
- package/md_cg/test_issue131_postings_content_staleness.py +424 -0
- package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
- package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
- package/md_cg/test_issue147_pack_id_escape.py +378 -0
- package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
- package/md_cg/test_issue149_accel_default_face.py +249 -0
- package/md_cg/test_issue150_empty_query_terms.py +328 -0
- package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
- package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
- package/md_cg/test_issue152_sealed_postings.py +309 -0
- package/md_cg/test_issue152b_decrypt_cache.py +218 -0
- package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
- package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
- package/md_cg/test_issue157b_index_remainder.py +344 -0
- package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
- package/md_cg/test_issue190_tidy_idempotent.py +806 -0
- package/md_cg/test_issue191_import_trust.py +382 -0
- package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
- package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
- package/md_cg/test_issue193_write_scope.py +378 -0
- package/md_cg/test_issue197_rank_credibility_property.py +201 -0
- package/md_cg/test_issue211_export_target.py +325 -0
- package/md_cg/test_issue212_writeface_gaps.py +349 -0
- package/md_cg/test_issue214_reject_sensitivity.py +267 -0
- package/md_cg/test_issue215_condition_source_gap.py +272 -0
- package/md_cg/test_issue216_clash_routes.py +214 -0
- package/md_cg/test_issue217_slot_routes.py +248 -0
- package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
- package/md_cg/test_issue225_consistency_torn_log.py +433 -0
- package/md_cg/test_issue245_swarm_traversal.py +366 -0
- package/md_cg/test_issue258_pack_sensitivity.py +468 -0
- package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
- package/md_cg/test_issue274_read_node_id_none.py +341 -0
- package/md_cg/test_issue275_layer_param.py +250 -0
- package/md_cg/test_issue277_node_id_traversal.py +384 -0
- package/md_cg/test_issue278_neg_separated_tension.py +271 -0
- package/md_cg/test_issue278_neg_window.py +294 -0
- package/md_cg/test_issue278_negative_layering.py +83 -0
- package/md_cg/test_issue279_signers_path_guard.py +652 -0
- package/md_cg/test_issue284_skip_not_pass.py +291 -0
- package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
- package/md_cg/test_issue295_sleep_root_binding.py +589 -0
- package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
- package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
- package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
- package/md_cg/test_issue303_design_boundaries.py +262 -0
- package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
- package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
- package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
- package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
- package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
- package/md_cg/test_issue321_mcp_deep_json.py +305 -0
- package/md_cg/test_issue322_node_write_lock.py +727 -0
- package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
- package/md_cg/test_issue324_write_size_fields.py +215 -0
- package/md_cg/test_issue325_audit_poison.py +230 -0
- package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
- package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
- package/md_cg/test_issue326_key_perms.py +355 -0
- package/md_cg/test_issue326_twin_parser_parity.py +323 -0
- package/md_cg/test_issue326_vm_call_frame.py +569 -0
- package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
- package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
- package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
- package/md_cg/test_issue348_insight_verify_op.py +200 -0
- package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
- package/md_cg/test_issue350_casefold_collision.py +236 -0
- package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
- package/md_cg/test_issue352_imgaudit.py +418 -0
- package/md_cg/test_issue352_pathsjson.py +537 -0
- package/md_cg/test_issue352_refindex.py +412 -0
- package/md_cg/test_issue352_rollback.py +604 -0
- package/md_cg/test_issue352_vstateinherit.py +196 -0
- package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
- package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
- package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
- package/md_cg/test_issue354_rust_index_containment.py +571 -0
- package/md_cg/test_issue354_rust_wal_containment.py +606 -0
- package/md_cg/test_issue358_truncation_observable.py +247 -0
- package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
- package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
- package/md_cg/test_issue362_neg_condition.py +468 -0
- package/md_cg/test_issue363_lexical_idf.py +275 -0
- package/md_cg/test_issue370_readcache_assembly.py +488 -0
- package/md_cg/test_issue375_state_slot_retire.py +325 -0
- package/md_cg/test_issue376_heartbeat_failed.py +293 -0
- package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
- package/md_cg/test_issue378_protected_floor.py +310 -0
- package/md_cg/test_issue383_state_event_write_gate.py +462 -0
- package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
- package/md_cg/test_issue398_toolface_op_parity.py +511 -0
- package/md_cg/test_issue399_hive_json_shape.py +317 -0
- package/md_cg/test_issue400_hive_dirty_args.py +450 -0
- package/md_cg/test_issue401_wisdom_codegen.py +295 -0
- package/md_cg/test_issue404_heal_receipt.py +390 -0
- package/md_cg/test_issue405_git_pathspec.py +333 -0
- package/md_cg/test_issue408_eface_registry.py +291 -0
- package/md_cg/test_issue409_compact_index_completeness.py +509 -0
- package/md_cg/test_issue410_verify_demote_write.py +366 -0
- package/md_cg/test_issue411_scrub_idempotence.py +575 -0
- package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
- package/md_cg/test_issue413_preimage_failclosed.py +239 -0
- package/md_cg/test_issue413_preimage_twin.py +340 -0
- package/md_cg/test_issue414_write_args_parity.py +613 -0
- package/md_cg/test_issue415_deps_gate_probe.py +358 -0
- package/md_cg/test_issue416_entry_key_subset.py +525 -0
- package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
- package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
- package/md_cg/test_issue418_role_type_gate.py +265 -0
- package/md_cg/test_issue419_pii_redaction.py +642 -0
- package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
- package/md_cg/test_issue425_ingest_library_path.py +331 -0
- package/md_cg/test_issue426a_dedup_receipt.py +242 -0
- package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
- package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
- package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
- package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
- package/md_cg/test_issue427_serve_status_shape.py +191 -0
- package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
- package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
- package/md_cg/test_issue434_435_float_gate.py +90 -0
- package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
- package/md_cg/test_issue43_default_policy.py +874 -865
- package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
- package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
- package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
- package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
- package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
- package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
- package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
- package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
- package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
- package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
- package/md_cg/test_issue451_audit_actor.py +313 -0
- package/md_cg/test_issue452_ingest_root_hint.py +238 -0
- package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
- package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
- package/md_cg/test_issue466_basis_registry.py +469 -0
- package/md_cg/test_issue467_identity_sensitivity.py +204 -0
- package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
- package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
- package/md_cg/test_issue470_wal_event_durable.py +427 -0
- package/md_cg/test_issue471_identity_readable.py +137 -0
- package/md_cg/test_issue472_audit_chain.py +91 -0
- package/md_cg/test_issue472_prune_ledger.py +106 -0
- package/md_cg/test_issue472_rollback_degraded.py +82 -0
- package/md_cg/test_issue491_compose_sandbox.py +460 -0
- package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
- package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
- package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
- package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
- package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
- package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
- package/md_cg/test_issue525_read_null_semantics.py +52 -0
- package/md_cg/test_issue538_hook_condition_space.py +97 -0
- package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
- package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
- package/md_cg/test_issue542_tenant_root_same.py +153 -0
- package/md_cg/test_issue543_issue_authorization.py +147 -0
- package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
- package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
- package/md_cg/test_issue546_ledger_concurrency.py +81 -0
- package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
- package/md_cg/test_issue547_audit_durable.py +96 -0
- package/md_cg/test_issue549_durable_append.py +143 -0
- package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
- package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
- package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
- package/md_cg/test_issue559_refine_prefix.py +70 -0
- package/md_cg/test_issue561_pending_review.py +109 -0
- package/md_cg/test_issue562_retired_faces.py +150 -0
- package/md_cg/test_issue66_scrub_semantics.py +107 -0
- package/md_cg/test_issue67_scrub_control_pool.py +233 -0
- package/md_cg/test_issue69_audit_boundary.py +129 -0
- package/md_cg/test_issue71_queue_backlog.py +377 -0
- package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
- package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
- package/md_cg/test_issue75_neural_failure.py +582 -0
- package/md_cg/test_issue78_export_concurrency.py +334 -0
- package/md_cg/test_issue80_residual_flush.py +169 -0
- package/md_cg/test_issue82_credential_rules.py +271 -0
- package/md_cg/test_issue82_layer_and_size.py +120 -0
- package/md_cg/test_issue84_portability.py +95 -0
- package/md_cg/test_issue85_export_overwrite.py +113 -0
- package/md_cg/test_issue86_runtime_revoke.py +110 -0
- package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
- package/md_cg/test_issue88_conclusion_face.py +280 -0
- package/md_cg/test_issue88_execution_conflicts.py +87 -0
- package/md_cg/test_issue89_zero_score.py +169 -0
- package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
- package/md_cg/test_issue91_verifier_sandbox.py +314 -0
- package/md_cg/test_issue91_verifier_timeout.py +528 -0
- package/md_cg/test_issue93_remember_redaction.py +282 -0
- package/md_cg/test_issue96_key_fallback.py +102 -0
- package/md_cg/test_issue98_tenant_root.py +104 -0
- package/md_cg/test_jsonl_commit_watermark.py +221 -0
- package/md_cg/test_live_validity_cache.py +256 -0
- package/md_cg/test_logref.py +1141 -1109
- package/md_cg/test_mcp_call_argument_types.py +99 -0
- package/md_cg/test_md_access_parity.py +330 -255
- package/md_cg/test_md_cg_no_hive_dep.py +140 -0
- package/md_cg/test_memory_rsi.py +215 -0
- package/md_cg/test_memory_rsi_adversarial.py +91 -0
- package/md_cg/test_mode_parity.py +1413 -1393
- package/md_cg/test_mutation_residue.py +120 -0
- package/md_cg/test_mutation_rollback.py +835 -805
- package/md_cg/test_n123_derive_expiry_chain.py +210 -205
- package/md_cg/test_n130_verify_falsified_protect.py +185 -185
- package/md_cg/test_n209_verify_write_face_gates.py +466 -461
- package/md_cg/test_n230_dirty_replay.py +52 -9
- package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
- package/md_cg/test_neg_coverage_budget.py +500 -0
- package/md_cg/test_neg_tail_honesty.py +733 -663
- package/md_cg/test_p0.py +16 -2
- package/md_cg/test_p14_root_fallback.py +373 -0
- package/md_cg/test_p1x_ref_root.py +47 -10
- package/md_cg/test_p21_tokens.py +294 -293
- package/md_cg/test_p24_evidence.py +232 -227
- package/md_cg/test_p26_refindex.py +20 -3
- package/md_cg/test_p27_docindex.py +792 -777
- package/md_cg/test_p28_refcheck.py +1053 -1032
- package/md_cg/test_p29_session_ingest_export.py +6 -0
- package/md_cg/test_p2_mcp.py +474 -453
- package/md_cg/test_p2_six_elements.py +476 -463
- package/md_cg/test_p3.py +370 -261
- package/md_cg/test_p33_ccg_wiring.py +300 -293
- package/md_cg/test_p3_legacy_closure.py +438 -433
- package/md_cg/test_p40_refine_worklist.py +244 -241
- package/md_cg/test_p47_session_view.py +25 -9
- package/md_cg/test_p4_freshness.py +781 -774
- package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
- package/md_cg/test_p9c_dedup_hints.py +288 -283
- package/md_cg/test_policy_required_ccg.py +444 -432
- package/md_cg/test_postings_digest_memo.py +139 -0
- package/md_cg/test_predict_beta.py +138 -135
- package/md_cg/test_qmd.py +500 -0
- package/md_cg/test_query_excerpt.py +209 -0
- package/md_cg/test_reach.py +456 -378
- package/md_cg/test_reach_snapshot_admission.py +218 -0
- package/md_cg/test_readcache_prodpath.py +4 -0
- package/md_cg/test_recall_face_guards.py +854 -812
- package/md_cg/test_recall_metadata.py +422 -0
- package/md_cg/test_retr_s5.py +312 -213
- package/md_cg/test_retr_score_once.py +14 -2
- package/md_cg/test_review_cli_attribution.py +11 -7
- package/md_cg/test_review_queue_batch.py +123 -0
- package/md_cg/test_review_queue_index.py +130 -0
- package/md_cg/test_rrf_candidates.py +292 -0
- package/md_cg/test_rrf_qualified_topk.py +214 -0
- package/md_cg/test_rrf_unique_votes.py +218 -0
- package/md_cg/test_s1_ast_judge.py +110 -0
- package/md_cg/test_scrub_ledger.py +413 -0
- package/md_cg/test_security_audit_b26.py +34 -3
- package/md_cg/test_security_audit_v21.py +1 -2
- package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
- package/md_cg/test_session5_identity.py +93 -0
- package/md_cg/test_session_attribution_consistency.py +813 -0
- package/md_cg/test_session_identity_tristate.py +486 -0
- package/md_cg/test_sleep_p1.py +35 -3
- package/md_cg/test_state_event_op.py +521 -514
- package/md_cg/test_state_projection_streaming.py +136 -0
- package/md_cg/test_stg_interval_candidates.py +280 -0
- package/md_cg/test_stg_time_blocks.py +239 -0
- package/md_cg/test_stgidx_index_parity.py +1024 -1020
- package/md_cg/test_subgraph_bounded_bfs.py +227 -0
- package/md_cg/test_sustain_bounded.py +652 -624
- package/md_cg/test_task_memory.py +394 -0
- package/md_cg/test_text_projection_mutations.py +101 -0
- package/md_cg/test_time_anchor.py +421 -0
- package/md_cg/test_time_core_lint.py +1024 -975
- package/md_cg/test_tool_face.py +200 -189
- package/md_cg/test_trust_bounded_frontier.py +248 -0
- package/md_cg/test_trust_edge_reachability.py +405 -0
- package/md_cg/test_w5_path_fingerprint.py +381 -0
- package/md_cg/test_w7_redlines.py +659 -0
- package/md_cg/test_write_return_shape.py +919 -0
- package/md_cg/test_writepipe.py +228 -226
- package/md_cg/timeanchor.py +534 -0
- package/md_cg/tokens.py +68 -5
- package/md_cg/tool_face.py +273 -260
- package/md_cg/trust.py +1114 -1030
- package/md_cg/twophase.py +303 -231
- package/md_cg/weights.py +642 -638
- package/md_cg/whitebox.py +536 -527
- package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
- package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
- package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
- package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
- package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
- package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
- package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
- package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
- package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
- package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
- package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
- package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
- package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
- package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
- package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
- package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
- package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
- package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
- package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
- package/md_cg/writelimit.py +584 -390
- package/md_cg/writepipe.py +1337 -826
- package/package.json +14 -9
- package/scripts/workspace_index.py +328 -0
- package/src/bridge.ts +34 -11
- package/src/cli.ts +75 -65
- package/src/hooks.ts +932 -776
- package/src/index.ts +30 -7
- package/src/init.ts +362 -361
- package/src/lib/datapath.ts +419 -326
- package/src/lib/hook_audit.ts +42 -3
- package/src/lib/mdcg_client.ts +469 -461
- package/src/lib/mutual.ts +481 -432
- package/src/lib/prompt_safety.ts +178 -149
- package/src/lib/roleplay_web.ts +30 -2
- package/src/lib/token_store.ts +274 -52
- package/src/tools.ts +271 -223
- package/zcode/README.md +1 -1
- package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
- package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
- package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
- package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
- package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
- package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
- package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
- package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
- package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
- package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
- package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
- package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
- package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
- package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
- package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
- package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
- package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
- package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
- package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
- package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
- package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
- package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
- package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
- package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
- package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
- package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
- package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
- package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
- package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
- package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
- package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
- package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
- package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
- package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
- package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
- package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
- package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
- package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
- package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
- package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
- package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
- package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
- package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
- package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
- package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
- package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
- package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
- package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
- package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
- package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
- package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
- package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
- package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
- package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
- package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
- package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
- package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
- package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
- package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
- package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
- package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
- package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
- package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
- package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
- package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
- package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
- package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
- package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
- package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
- package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
- package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
- package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
- package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
- package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
- package/docs/mdcg/guardrail-charter.md +0 -164
- package/docs/mdcg/lingshu_tutorial.html +0 -14956
- package/docs/mdcg/memory-assessment.html +0 -923
- package/docs/mdcg/memory_score.html +0 -213
- package/docs/mdcg/memory_score.png +0 -0
- package/docs/mdcg/release_v0.3.0.md +0 -36
- package/docs/mdcg/release_v0.4.11.md +0 -49
- package/docs/mdcg/release_v0.4.5.md +0 -55
- package/docs/mdcg/tool_table_v0.3.0.md +0 -117
- package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
- package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
- package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
- package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
- package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
- package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
- package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
- package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
- package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
- package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
- package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
- package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
- package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
- package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
- package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
- package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
- package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
- package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
- package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
- package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
- package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
- package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
- package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
- package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
- package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
- package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
- package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
- package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
- package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
- package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
- package/docs/promo/bilibili-cover.jpg +0 -0
- package/docs/promo/promo-visual-1.png +0 -0
- package/docs/promo/promo-visual-2.png +0 -0
- package/docs/promo/promo-visual-3.png +0 -0
- package/docs/promo/promo-visual-4.png +0 -0
- package/docs/promo/promo-visual-5.png +0 -0
- package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
- package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
- package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
- package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
- package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
- package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
- package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
- package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
- package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
- package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
- package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
- package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
- package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
- package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
- package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
- package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
- package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
- package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
- package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
- package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
- package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
- package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
- package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
- package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
- package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
- package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
- package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
- package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
- package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
|
@@ -0,0 +1,1712 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
r"""图像 Skill(Image Skill)· L1 能力子系统 · **本版实现 13 op**。
|
|
3
|
+
|
|
4
|
+
契约真源:`docs/eval/图像Skill_接口契约_设计_v0.1.md` §九 定稿(2026-10-07,十项裁定)。
|
|
5
|
+
本模块按该定稿实现;凡定稿未逐字给出、需本实现自补之处,一律在 docstring 内标
|
|
6
|
+
「**本版解释**」,并列入交付说明的「待核实」清单——不自作主张改判契约。
|
|
7
|
+
|
|
8
|
+
本版范围(**13 个 op**,契约 §五 表内全部落成):
|
|
9
|
+
|
|
10
|
+
**已实现集**(`OPS_IMPL`,13 件):
|
|
11
|
+
* `inspect` 读元数据(format/width/height/bytes/mode/bit_depth/sha256)
|
|
12
|
+
* `resize` 改尺寸(`width`/`height`/`filter`)
|
|
13
|
+
* `convert` 转格式(`format`)
|
|
14
|
+
* `thumbnail` 长边缩到 `max_edge`(保持纵横比;**可放大**,与 magick `-thumbnail` 同语义)
|
|
15
|
+
* `crop` 裁窗(`x`/`y`/`width`/`height`;窗口须整幅落在源内)
|
|
16
|
+
* `rotate` 旋转(`degrees`;**本版约定正角 = 顺时针**)
|
|
17
|
+
* `flip` 上下镜像(`axis` 选填,须与 op 同轴)
|
|
18
|
+
* `flop` 左右镜像(`axis` 选填,须与 op 同轴)
|
|
19
|
+
* `adjust` 亮度/对比度/伽马(`brightness`/`contrast`/`gamma`)
|
|
20
|
+
* `blur` 高斯模糊(`sigma`)
|
|
21
|
+
* `sharpen` 反锐化(`sigma`)
|
|
22
|
+
* `composite` 叠图(`over_path`/`gravity`/`opacity`)
|
|
23
|
+
* `mask` 用 mask 设 alpha(`mask_path`/`mode`;本版只落 `mode="set"`)
|
|
24
|
+
|
|
25
|
+
**仍范围外集**(命中即 `E_UNSUPPORTED_OP`——**「范围外」不是出错**):
|
|
26
|
+
* `export`(批量/多规格导出)与 `extract`(视频抽帧):契约 §五「不做的操作」表
|
|
27
|
+
(触发条件:出现「一源多规格」需求 / 本线涉视频且 `ffmpeg` 在场);
|
|
28
|
+
* L1 检测类 `detect`/`segment`/`ocr`/`bg_remove`:需模型 + `model_version`(本版无模型);
|
|
29
|
+
* L2 生成类 `generate`/`inpaint`/`outpaint`/`style_transfer`/`i2i`:走云(步 3);
|
|
30
|
+
* 任何不在 `LEVEL_MAP` 的 op 名(未知 op)。
|
|
31
|
+
* 另:`mask.mode` 的非 `set` 取值(见 `MASK_MODE_UNIMPL`)也走此码——见下「本版解释」。
|
|
32
|
+
|
|
33
|
+
**本版解释(定稿未逐字给出的取值,一律在此显式声明,交编排侧裁定,不静默偏移)**:
|
|
34
|
+
|
|
35
|
+
1. `thumbnail` 的放大语义:契约 §五 的判据是「最长边 == `max_edge`」,而其「Pillow
|
|
36
|
+
兜底」栏写 `thumbnail()`——**实测 Pillow `thumbnail()` 只缩不放**(40×30 要 60 →
|
|
37
|
+
仍是 40×30),与判据冲突;magick `-thumbnail 60x60` 则放大到 60×45。故 Pillow 侧
|
|
38
|
+
本版**改用等比 `resize`**(缩放系数 `max_edge / 长边`),使两后端同语义、判据可判。
|
|
39
|
+
2. `rotate` 的方向与背景:**实测 magick `-rotate` 正角 = 顺时针,Pillow `rotate()` 正角 =
|
|
40
|
+
逆时针**(4×3 角标记像素落点:(0,0)→(2,0) vs (0,3)),契约 §五 两栏因而互斥。本版
|
|
41
|
+
取 **正角 = 顺时针**(magick 原生方向,magick 为主后端;Pillow 侧传 `-degrees`)。
|
|
42
|
+
背景:magick 默认背景为**不透明白**(实测 RGBA 源亦为 `(255,255,255,255)`),
|
|
43
|
+
Pillow 默认不透明黑/透明 → 本版显式给白(`_ROT_BG`)对齐 magick。
|
|
44
|
+
3. `crop` 越界:magick 对越窗**静默裁剪**(`100x100+30+20` on 40×30 → 10×10),Pillow 则
|
|
45
|
+
补黑——两者不判齐。故本版**先验窗口整幅落在源内**,越窗即 `E_BAD_PARAM`。
|
|
46
|
+
4. `composite`:契约 §五 的 `-geometry +X+Y` 与 `axis` 同类(表里留了但参数栏未列),
|
|
47
|
+
故本版只取 `over_path`/`gravity`/`opacity` 三参;位置由 `gravity` 定,偏移恒 `+0+0`。
|
|
48
|
+
`opacity` 取 **0..1 浮点**(magick 侧转 `-evaluate multiply` 的 alpha 缩放);
|
|
49
|
+
并**要求 over 不大于 base**(越界时两后端行为不一致,fail-closed 拒绝)。
|
|
50
|
+
输出 mode 随 base(base 无 alpha → 输出涂成 RGB),与 magick 实测一致。
|
|
51
|
+
5. `mask`:写面**收窄为 `png`/`tif`/`tiff`**(`_ALPHA_FMT`)——因为 `webp`/`bmp` 编码器在
|
|
52
|
+
alpha 恒不透明时会**丢弃该通道**,那会直接违反判据「alpha 通道存在且可读回」。
|
|
53
|
+
`mode` 本版只落 `"set"`(= `CopyOpacity` / `putalpha`,实测两后端**逐像素相等**);
|
|
54
|
+
`"mul"`(alpha := 原 alpha × mask)**未落**:magick 单命令无确定等价(实测
|
|
55
|
+
`-compose Multiply -channel A` 乘的是**两图各自的 alpha**(mask 恒不透明 → 恒 255),
|
|
56
|
+
`-fx "u.a*v.a"` 只取 `u.a`,`-alpha copy` 亦不改 alpha)——须多步中间件或 `-fx` 语义
|
|
57
|
+
裁定,故列入 `MASK_MODE_UNIMPL` 走 `E_UNSUPPORTED_OP`。mask 尺寸须与源一致。
|
|
58
|
+
6. `adjust`:Pillow 侧用**逐通道 8-bit LUT** 按「亮度(加性百分比)→ 对比度(绕 128 缩放)
|
|
59
|
+
→ 伽马(`v^(1/g)`)」实现(不经 `ImageEnhance`,避免其 alpha 语义不透明);
|
|
60
|
+
magick 侧用 `-brightness-contrast BxC -gamma G`。两后端数学不同源(magick 走 16-bit),
|
|
61
|
+
判据仅取契约 §五 的「参数入台账 + 同参幂等」,**不设跨后端逐位相等**。
|
|
62
|
+
7. `sharpen`:magick `-sharpen 0xσ` ↔ Pillow `UnsharpMask(radius=σ, percent=150,
|
|
63
|
+
threshold=0)`(固定 percent/threshold,**近似等价**,非逐位相等)。
|
|
64
|
+
8. 非直角 `rotate` 的尺寸:**两后端取值本就不同**(40×30 转 45°:magick 52×52、
|
|
65
|
+
Pillow 50×50,解析外接矩形 49.50)——故本版只做**容差 3px 的内部门**,
|
|
66
|
+
不设跨后端逐位门。
|
|
67
|
+
|
|
68
|
+
设计边界(沿定稿「实现边界」与 G5/G6/G7):
|
|
69
|
+
* **不碰资格/信任/写入面**——本模块**零 md_cg import**(连 `.fsutil` 也不引),
|
|
70
|
+
只依赖标准库 + 后端(`magick` CLI / Pillow)。结构断言见 `test_imgskill.py` G5①。
|
|
71
|
+
* **产物一律落调用方显式给的沙箱根**:无隐式默认根,未给即拒(§九-#8)。
|
|
72
|
+
* **禁用裸 `convert`**:Windows 上 `convert` 恒解析到系统盘卷转换工具,不是
|
|
73
|
+
ImageMagick;ImageMagick 侧一律走 `magick`(§3.5 + §六-G6 硬门)。
|
|
74
|
+
* **错误一律 fail-closed**:环境/探测/参数错误都落明确错误码,绝不返回 `ok=true`。
|
|
75
|
+
|
|
76
|
+
错误码(定稿 §九-#9 八码 + 本版两个自补码):
|
|
77
|
+
`E_NOINPUT`|`E_UNSUPPORTED_FORMAT`|`E_TOOL_MISSING`|`E_PERM`|
|
|
78
|
+
`E_PATH_OUT_OF_SCOPE`|`E_BAD_PARAM`|`E_BACKEND_FAIL`|`E_DECODE`
|
|
79
|
+
+ `E_LEVEL_DOWNGRADE`(定稿 §3.1「等级不可降级」点名,E7 面)
|
|
80
|
+
+ `E_UNSUPPORTED_OP`(**本版新增**:op 属「本版范围外」,非出错)
|
|
81
|
+
|
|
82
|
+
幂等口径(定稿 §九-#6):**像素级必达、位级可选**——同输入同参 → **像素相等**即判
|
|
83
|
+
幂等;位级恒等**不设为门**。实现手段仍用 `-strip`(magick)/ 不写 exif(Pillow),
|
|
84
|
+
故位级在本机**通常也相等**,但那不是门。
|
|
85
|
+
|
|
86
|
+
审计(定稿 §四):每次操作(成功/失败皆然)往 `<根>/.imgskill/audit.jsonl` 追一行,
|
|
87
|
+
公共字段逐项在场;降级换后端时额外落 `backend_note`(§九-#11「降级必须落审计字段」)。
|
|
88
|
+
|
|
89
|
+
**CLI(本版新增,契约 §十二——暴露面落地,不得与库分叉)**:本模块既是库、也是一个
|
|
90
|
+
显式命令行入口——`python -X utf8 -m md_cg.imgskill <op> [参数]`。CLI **只把命令行搬运
|
|
91
|
+
成 `run(req)` 的入参**:参数校验、执行、审计**全在同一份 `run()` 内**,CLI 侧不另写一份
|
|
92
|
+
逻辑(否则「库调用」与「CLI 调用」会漂移成两条实现路径)。`--help` 列全部 op 与参数。
|
|
93
|
+
**仍不新增 MCP op**(沿 §九-#5:不扩大协议面);入口给的是「人/脚本显式调用」面。
|
|
94
|
+
"""
|
|
95
|
+
from __future__ import annotations
|
|
96
|
+
|
|
97
|
+
import argparse
|
|
98
|
+
import hashlib
|
|
99
|
+
import json
|
|
100
|
+
import math
|
|
101
|
+
import os
|
|
102
|
+
import platform
|
|
103
|
+
import shutil
|
|
104
|
+
import subprocess
|
|
105
|
+
import sys
|
|
106
|
+
import time
|
|
107
|
+
|
|
108
|
+
__all__ = [
|
|
109
|
+
"run", "OPS_IMPL", "OPS_KNOWN", "OPS_OUT_OF_SCOPE", "MASK_MODE_UNIMPL",
|
|
110
|
+
"LEVEL_MAP", "ERROR_CODES", "GRAVITIES",
|
|
111
|
+
"derive_level", "resolve_magick", "resolve_backend", "read_audit",
|
|
112
|
+
"AUDIT_REL", "audit_path",
|
|
113
|
+
"build_parser", "cli_main",
|
|
114
|
+
]
|
|
115
|
+
|
|
116
|
+
# ---------------------------------------------------------------- 常量
|
|
117
|
+
|
|
118
|
+
L0, L1, L2 = "L0", "L1", "L2"
|
|
119
|
+
_LEVEL_ORDER = {L0: 0, L1: 1, L2: 2}
|
|
120
|
+
|
|
121
|
+
#: 本版**实际实现**的 op(契约 §五 表内的确定性、无模型子集,13 件全落)
|
|
122
|
+
OPS_IMPL = ("inspect", "resize", "convert", "thumbnail", "crop", "rotate",
|
|
123
|
+
"flip", "flop", "adjust", "blur", "sharpen", "composite", "mask")
|
|
124
|
+
|
|
125
|
+
#: 本版**仍范围外**的 op 名(命中 → `E_UNSUPPORTED_OP`;「范围外」非出错)。
|
|
126
|
+
#: 与 `LEVEL_MAP` 的差集(除已实现者)等价;此处显式列出以便核对。
|
|
127
|
+
OPS_OUT_OF_SCOPE = ("extract", "export",
|
|
128
|
+
"detect", "segment", "ocr", "bg_remove",
|
|
129
|
+
"generate", "inpaint", "outpaint", "style_transfer", "i2i")
|
|
130
|
+
|
|
131
|
+
#: `mask.mode` 里**已知但未落**的取值 → `E_UNSUPPORTED_OP`(理由见模块 docstring 本版解释 5)
|
|
132
|
+
MASK_MODE_UNIMPL = ("mul", "multiply", "combine")
|
|
133
|
+
|
|
134
|
+
#: op → 派生等级(定稿 §五 表 + 其「不做的操作」表的 L1/L2 类,逐条照抄)。
|
|
135
|
+
#: 命中即「本版范围外」:L0 的其余 edit op 与 L1/L2 类在本版都返回 E_UNSUPPORTED_OP,
|
|
136
|
+
#: 但**等级映射先于实现面判定**(见 run 的校验次序注释)——否则「等级降级」无从判别。
|
|
137
|
+
LEVEL_MAP = {
|
|
138
|
+
# —— 定稿 §五 表(edit 子集,全 L0)——
|
|
139
|
+
"inspect": L0, "resize": L0, "thumbnail": L0, "crop": L0, "rotate": L0,
|
|
140
|
+
"flip": L0, "flop": L0, "convert": L0, "adjust": L0, "blur": L0,
|
|
141
|
+
"sharpen": L0, "composite": L0, "mask": L0, "export": L0, "extract": L0,
|
|
142
|
+
# —— 定稿 §五「不做的操作」表的 L1 类(需模型 + model_version)——
|
|
143
|
+
"detect": L1, "segment": L1, "ocr": L1, "bg_remove": L1,
|
|
144
|
+
# —— 定稿 §五「不做的操作」表的 L2 类(生成式,走云)——
|
|
145
|
+
"generate": L2, "inpaint": L2, "outpaint": L2, "style_transfer": L2,
|
|
146
|
+
"i2i": L2,
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
#: 本版已知的全部 op 名(实现面 + 留白面);不在此表 = 未知 op → E_UNSUPPORTED_OP
|
|
150
|
+
OPS_KNOWN = tuple(LEVEL_MAP)
|
|
151
|
+
|
|
152
|
+
E_NOINPUT = "E_NOINPUT"
|
|
153
|
+
E_UNSUPPORTED_FORMAT = "E_UNSUPPORTED_FORMAT"
|
|
154
|
+
E_TOOL_MISSING = "E_TOOL_MISSING"
|
|
155
|
+
E_PERM = "E_PERM"
|
|
156
|
+
E_PATH_OUT_OF_SCOPE = "E_PATH_OUT_OF_SCOPE"
|
|
157
|
+
E_BAD_PARAM = "E_BAD_PARAM"
|
|
158
|
+
E_BACKEND_FAIL = "E_BACKEND_FAIL"
|
|
159
|
+
E_DECODE = "E_DECODE"
|
|
160
|
+
E_LEVEL_DOWNGRADE = "E_LEVEL_DOWNGRADE" # 定稿 §3.1
|
|
161
|
+
E_UNSUPPORTED_OP = "E_UNSUPPORTED_OP" # 本版自补(范围外)
|
|
162
|
+
|
|
163
|
+
ERROR_CODES = (
|
|
164
|
+
E_NOINPUT, E_UNSUPPORTED_FORMAT, E_TOOL_MISSING, E_PERM,
|
|
165
|
+
E_PATH_OUT_OF_SCOPE, E_BAD_PARAM, E_BACKEND_FAIL, E_DECODE,
|
|
166
|
+
E_LEVEL_DOWNGRADE, E_UNSUPPORTED_OP,
|
|
167
|
+
)
|
|
168
|
+
|
|
169
|
+
#: 审计台账相对沙箱根的落点(**本版解释**:定稿 §四只说「审计台账」,未给路径;
|
|
170
|
+
#: 沙箱根是调用方所有,台账随之落根内,不另开全局面)
|
|
171
|
+
AUDIT_REL = os.path.join(".imgskill", "audit.jsonl")
|
|
172
|
+
|
|
173
|
+
#: 后端可读写面(**本版解释**:定稿 §3.3 E_UNSUPPORTED_FORMAT 说「后端 identify -list
|
|
174
|
+
#: format 不含」;本版先以显式白名单实现该判据,等价且可复跑,避免每次探测子进程)
|
|
175
|
+
FMT_READ = ("png", "jpg", "jpeg", "webp", "gif", "bmp", "tif", "tiff")
|
|
176
|
+
FMT_WRITE = ("png", "jpg", "jpeg", "webp", "gif", "bmp", "tif", "tiff")
|
|
177
|
+
|
|
178
|
+
#: 扩展名 → 规范格式名(写面)
|
|
179
|
+
_EXT2FMT = {
|
|
180
|
+
"png": "PNG", "jpg": "JPEG", "jpeg": "JPEG", "webp": "WEBP",
|
|
181
|
+
"gif": "GIF", "bmp": "BMP", "tif": "TIFF", "tiff": "TIFF",
|
|
182
|
+
}
|
|
183
|
+
#: 规范格式名 → 扩展名(convert 派生 dst 用)
|
|
184
|
+
_FMT2EXT = {"PNG": "png", "JPEG": "jpg", "WEBP": "webp",
|
|
185
|
+
"GIF": "gif", "BMP": "bmp", "TIFF": "tif"}
|
|
186
|
+
|
|
187
|
+
#: resize 滤波器 → magick `-filter` 名 / Pillow 重采样名(定稿 §五:参数 `filter`)
|
|
188
|
+
_FILTERS = {
|
|
189
|
+
"lanczos": ("Lanczos", "LANCZOS"),
|
|
190
|
+
"nearest": ("Point", "NEAREST"),
|
|
191
|
+
"bilinear": ("Triangle", "BILINEAR"),
|
|
192
|
+
"bicubic": ("Catrom", "BICUBIC"),
|
|
193
|
+
"box": ("Box", "BOX"),
|
|
194
|
+
"hamming": ("Hamming", "HAMMING"),
|
|
195
|
+
}
|
|
196
|
+
DEFAULT_FILTER = "lanczos" # 定稿 §3.1 示例即 lanczos
|
|
197
|
+
|
|
198
|
+
#: magick `%[channels]` → 规范 mode(**本版解释**:定稿只给 mode 字段名,未给归一表)
|
|
199
|
+
_CH2MODE = {
|
|
200
|
+
"srgb": "RGB", "srgba": "RGBA", "rgb": "RGB", "rgba": "RGBA",
|
|
201
|
+
"gray": "L", "graya": "LA", "cmyk": "CMYK", "cmyka": "CMYKA",
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
#: Pillow mode → 位深(**本版解释**;非常规 mode 回落 8 并留痕,见 _pillow_bit_depth)
|
|
205
|
+
_MODE_BITS = {
|
|
206
|
+
"1": 1, "L": 8, "P": 8, "LA": 8, "RGB": 8, "RGBA": 8, "CMYK": 8,
|
|
207
|
+
"YCbCr": 8, "LAB": 8, "HSV": 8, "I": 32, "I;16": 16, "F": 32,
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
#: 镜像 op 的轴:`axis` 参数是同义确认项(**本版解释**:契约 §五 两件 op 合成一行、
|
|
211
|
+
#: 参数栏写 `axis`,但 op 名本身已编码了轴——故本版把 `axis` 设为选填且须与 op 同轴)
|
|
212
|
+
_AXIS = {
|
|
213
|
+
"flip": ("vertical", "v", "updown", "ud", "上下"),
|
|
214
|
+
"flop": ("horizontal", "h", "leftright", "lr", "左右"),
|
|
215
|
+
}
|
|
216
|
+
#: 镜像 op → (magick 旗标, Pillow Transpose 常量名, 中文标签)
|
|
217
|
+
_MIRROR = {
|
|
218
|
+
"flip": ("-flip", "FLIP_TOP_BOTTOM", "上下"),
|
|
219
|
+
"flop": ("-flop", "FLIP_LEFT_RIGHT", "左右"),
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
#: composite `gravity`:别名 → 规范名(IM `-gravity` 取值)
|
|
223
|
+
_GRAVITY_ALIAS = {
|
|
224
|
+
"center": "center", "centre": "center", "c": "center",
|
|
225
|
+
"north": "north", "n": "north",
|
|
226
|
+
"south": "south", "s": "south",
|
|
227
|
+
"east": "east", "e": "east",
|
|
228
|
+
"west": "west", "w": "west",
|
|
229
|
+
"northwest": "northwest", "nw": "northwest",
|
|
230
|
+
"northeast": "northeast", "ne": "northeast",
|
|
231
|
+
"southwest": "southwest", "sw": "southwest",
|
|
232
|
+
"southeast": "southeast", "se": "southeast",
|
|
233
|
+
}
|
|
234
|
+
#: 规范 gravity → (横向系数, 纵向系数):0=左/上,0.5=中,1=右/下
|
|
235
|
+
_GRAVITY_F = {
|
|
236
|
+
"center": (0.5, 0.5), "north": (0.5, 0.0), "south": (0.5, 1.0),
|
|
237
|
+
"east": (1.0, 0.5), "west": (0.0, 0.5),
|
|
238
|
+
"northwest": (0.0, 0.0), "northeast": (1.0, 0.0),
|
|
239
|
+
"southwest": (0.0, 1.0), "southeast": (1.0, 1.0),
|
|
240
|
+
}
|
|
241
|
+
GRAVITIES = tuple(sorted(_GRAVITY_F))
|
|
242
|
+
|
|
243
|
+
#: mask 的目标写面(**本版解释 5**:须支持 alpha 通道;webp/bmp 会在 alpha 恒不透明时丢通道)
|
|
244
|
+
_ALPHA_FMT = ("png", "tif", "tiff")
|
|
245
|
+
|
|
246
|
+
#: rotate 非直角时空白处填色(**本版解释 2**:对齐 magick 的不透明白默认背景)
|
|
247
|
+
_ROT_BG = {"1": 1, "L": 255, "LA": (255, 255), "P": 255, "I": 255, "F": 255.0,
|
|
248
|
+
"RGB": (255, 255, 255), "RGBA": (255, 255, 255, 255)}
|
|
249
|
+
|
|
250
|
+
#: 参数域(越界即 `E_BAD_PARAM`);`sigma` 上限对齐 Pillow `GaussianBlur`/`UnsharpMask` 可接受面
|
|
251
|
+
_ADJ_RANGE = 100.0 # brightness/contrast 百分比绝对值上限
|
|
252
|
+
_GAMMA_RANGE = (0.0, 10.0) # gamma 开区间下界 / 闭区间上界
|
|
253
|
+
_SIGMA_MAX = 100.0 # blur/sharpen 的 sigma 上限
|
|
254
|
+
|
|
255
|
+
_ENV_MAGICK = "IMGSKILL_MAGICK" # 显式 magick 可执行体路径(或安装目录)
|
|
256
|
+
_ENV_HOMES = ("MAGICK_HOME", "ImageMagick_HOME")
|
|
257
|
+
_ENV_BACKEND = "IMGSKILL_BACKEND" # auto(缺省) | magick | pillow
|
|
258
|
+
_ENV_PILLOW_OFF = "IMGSKILL_PILLOW" # "0" → 禁用 Pillow 后端(守卫造 E_TOOL_MISSING 用)
|
|
259
|
+
_MAGICK_TIMEOUT = 120.0
|
|
260
|
+
|
|
261
|
+
|
|
262
|
+
# ---------------------------------------------------------------- 错误
|
|
263
|
+
|
|
264
|
+
class SkillError(Exception):
|
|
265
|
+
"""带可判别错误码的内部异常;run() 顶层一网打成结构化出参。"""
|
|
266
|
+
|
|
267
|
+
def __init__(self, code, message, detail=None):
|
|
268
|
+
super().__init__(message)
|
|
269
|
+
self.code = code
|
|
270
|
+
self.message = message
|
|
271
|
+
self.detail = detail
|
|
272
|
+
|
|
273
|
+
|
|
274
|
+
def _bad(msg, detail=None):
|
|
275
|
+
return SkillError(E_BAD_PARAM, msg, detail)
|
|
276
|
+
|
|
277
|
+
|
|
278
|
+
# ---------------------------------------------------------------- 路径
|
|
279
|
+
|
|
280
|
+
def _norm(p):
|
|
281
|
+
return os.path.normcase(os.path.realpath(p))
|
|
282
|
+
|
|
283
|
+
|
|
284
|
+
def _rel(p):
|
|
285
|
+
"""相对路径统一回 `/` 分隔(定稿 §3.2 示例写法;UTF-8 文本面跨平台一致)。"""
|
|
286
|
+
return p.replace(os.sep, "/") if isinstance(p, str) else p
|
|
287
|
+
|
|
288
|
+
|
|
289
|
+
def safe_join(root, rel, *, what):
|
|
290
|
+
"""把 `rel`(相对沙箱根,UTF-8)解析到根内绝对路径;越界即拒(fail-closed)。
|
|
291
|
+
|
|
292
|
+
`rel` 为绝对路径、含 `..`、或经符号链接逃出 → `E_PATH_OUT_OF_SCOPE`
|
|
293
|
+
(定稿 §3.3 + §六-G5③)。
|
|
294
|
+
"""
|
|
295
|
+
if not isinstance(rel, str) or not rel.strip():
|
|
296
|
+
raise _bad(f"{what} 必填且须为非空字符串(相对沙箱根)", {"got": repr(rel)})
|
|
297
|
+
root_abs = os.path.realpath(root)
|
|
298
|
+
cand = os.path.realpath(os.path.join(root_abs, rel))
|
|
299
|
+
rn, cn = _norm(root_abs), _norm(cand)
|
|
300
|
+
inside = (cn == rn)
|
|
301
|
+
if not inside:
|
|
302
|
+
try:
|
|
303
|
+
inside = (os.path.commonpath([cn, rn]) == rn)
|
|
304
|
+
except ValueError: # 异盘 → commonpath 抛错 → 判越界
|
|
305
|
+
inside = False
|
|
306
|
+
if not inside:
|
|
307
|
+
raise SkillError(
|
|
308
|
+
E_PATH_OUT_OF_SCOPE,
|
|
309
|
+
f"{what} 越出沙箱根(规范化后前缀不在根内)",
|
|
310
|
+
{"rel": rel, "resolved": cand})
|
|
311
|
+
return cand
|
|
312
|
+
|
|
313
|
+
|
|
314
|
+
def _check_root(root):
|
|
315
|
+
"""沙箱根必须由调用方显式给、且已存在(**不设隐式默认根**,定稿 §九-#8)。"""
|
|
316
|
+
if root is None or (isinstance(root, str) and not root.strip()):
|
|
317
|
+
raise _bad("sandbox_root 必填:不设隐式默认根(定稿 §九-#8 fail-closed)",
|
|
318
|
+
{"got": repr(root)})
|
|
319
|
+
if not isinstance(root, str):
|
|
320
|
+
raise _bad("sandbox_root 须为字符串路径", {"got": type(root).__name__})
|
|
321
|
+
if not os.path.isdir(root):
|
|
322
|
+
# 不隐式创建、不隐式回落到 %TEMP%——一律拒
|
|
323
|
+
raise SkillError(E_PATH_OUT_OF_SCOPE,
|
|
324
|
+
"sandbox_root 不存在或不是目录(fail-closed,不隐式创建)",
|
|
325
|
+
{"root": root})
|
|
326
|
+
return os.path.realpath(root)
|
|
327
|
+
|
|
328
|
+
|
|
329
|
+
# 生效条件:root 为沙箱根时返回台账落点的**规范化绝对路径**——判定链依次为「.imgskill 目录本身是符号链接 ⇒ 拒」「AUDIT_REL 末段是符号链接 ⇒ 拒」「safe_join(root, AUDIT_REL) 判越界 ⇒ 拒」,三条皆过才返回 realpath;strict 为真(默认)时拒即抛 SkillError(E_PATH_OUT_OF_SCOPE),为假时返回 None(写面据此降级为「不写台账 + 告警」);
|
|
330
|
+
def audit_path(root, *, strict=True):
|
|
331
|
+
"""台账落点的**唯一解析口径**(#352-C,2026-10-15)。
|
|
332
|
+
|
|
333
|
+
改前本函数只有一句 `os.path.join(root, AUDIT_REL)`——既不 realpath、也不判
|
|
334
|
+
是否在根内,而 `_audit_write` 用 `open(p, "a")` **跟随符号链接**。沙箱根内
|
|
335
|
+
可写者只要把 `.imgskill`(目录)或 `.imgskill/audit.jsonl`(文件)换成符号
|
|
336
|
+
链接,受害者下一次**合法**调用就会把一行审计 JSON 追加到根外任意可写文件
|
|
337
|
+
(零次 imgskill 调用即可布置)。目标是 `json.dump` 写出的整文件 JSON 时,
|
|
338
|
+
追加行直接粘在原内容后面,该文件从此解析失败——实测把 `MDCG_TOKEN_FILE`
|
|
339
|
+
设为目标后,MCP 服务重启即 rc=3 退出,签发/吊销全被拒。
|
|
340
|
+
|
|
341
|
+
**真源复用**(不新造第二份路径校验):路径面一律走本文件既有的
|
|
342
|
+
`safe_join`(realpath + commonpath,与 src/dst 同一份实现)。上一级目录是
|
|
343
|
+
链接时 safe_join 的 realpath 会把它解析到根外并被 commonpath 拒掉;末段
|
|
344
|
+
本身是链接时 realpath 会**把它一起解掉**(只看 realpath 会漏判),故末段与
|
|
345
|
+
上段各补一次 `os.path.islink` 显式判。
|
|
346
|
+
|
|
347
|
+
strict=False 的用途(**刻意不把可信边界问题升级成拒服务面**):台账落点被
|
|
348
|
+
链接时,让本次 `run()` 照常返回结果、只是不写台账并在返回体里带
|
|
349
|
+
`audit_warning`——imgskill 不经 MCP 暴露,把它变成新的拒服务面得不偿失。
|
|
350
|
+
读面(`read_audit` / `_audit_seq`)走同一条判定,判不安全即按「空表」计,
|
|
351
|
+
绝不读根外文件。
|
|
352
|
+
"""
|
|
353
|
+
rel = _rel(AUDIT_REL)
|
|
354
|
+
d = os.path.join(root, os.path.dirname(AUDIT_REL))
|
|
355
|
+
p = os.path.join(root, AUDIT_REL)
|
|
356
|
+
why = None
|
|
357
|
+
cand = None
|
|
358
|
+
if os.path.islink(d):
|
|
359
|
+
why = "%s 是符号链接(台账落点不得经链接指向沙箱根外)" % os.path.dirname(rel)
|
|
360
|
+
elif os.path.islink(p):
|
|
361
|
+
why = "%s 是符号链接(台账落点不得经链接指向沙箱根外)" % rel
|
|
362
|
+
else:
|
|
363
|
+
try:
|
|
364
|
+
cand = safe_join(root, AUDIT_REL, what="audit_path")
|
|
365
|
+
except SkillError as exc:
|
|
366
|
+
why = exc.message
|
|
367
|
+
if why is None:
|
|
368
|
+
return cand
|
|
369
|
+
if strict:
|
|
370
|
+
raise SkillError(E_PATH_OUT_OF_SCOPE, why,
|
|
371
|
+
{"root": root, "audit_rel": rel,
|
|
372
|
+
"resolved": os.path.realpath(p)})
|
|
373
|
+
return None
|
|
374
|
+
|
|
375
|
+
|
|
376
|
+
def read_audit(root):
|
|
377
|
+
"""读回台账(守卫/复跑用)。返回 dict 列表;文件不存在返回 []。
|
|
378
|
+
|
|
379
|
+
#352-C:台账落点不可信(`.imgskill`/`audit.jsonl` 是符号链接、或规范化后
|
|
380
|
+
在根外)时按**空表**计——读面绝不跟随链接去读根外文件(改前会读,且内容
|
|
381
|
+
参与条目匹配与计数)。
|
|
382
|
+
"""
|
|
383
|
+
p = audit_path(root, strict=False)
|
|
384
|
+
if p is None or not os.path.exists(p):
|
|
385
|
+
return []
|
|
386
|
+
out = []
|
|
387
|
+
with open(p, "r", encoding="utf-8") as f:
|
|
388
|
+
for line in f:
|
|
389
|
+
line = line.strip()
|
|
390
|
+
if line:
|
|
391
|
+
try:
|
|
392
|
+
out.append(json.loads(line))
|
|
393
|
+
except ValueError:
|
|
394
|
+
out.append({"_unparsable": line})
|
|
395
|
+
return out
|
|
396
|
+
|
|
397
|
+
|
|
398
|
+
# ---------------------------------------------------------------- 哈希 / 元数据
|
|
399
|
+
|
|
400
|
+
def _sha256_file(path):
|
|
401
|
+
h = hashlib.sha256()
|
|
402
|
+
with open(path, "rb") as f:
|
|
403
|
+
for chunk in iter(lambda: f.read(1 << 20), b""):
|
|
404
|
+
h.update(chunk)
|
|
405
|
+
return h.hexdigest()
|
|
406
|
+
|
|
407
|
+
|
|
408
|
+
def _pillow():
|
|
409
|
+
"""惰性取 Pillow(缺失 → E_TOOL_MISSING;不进模块 import 面,G5①)。"""
|
|
410
|
+
if os.environ.get(_ENV_PILLOW_OFF) == "0":
|
|
411
|
+
raise SkillError(E_TOOL_MISSING, "Pillow 后端被 IMGSKILL_PILLOW=0 显式禁用")
|
|
412
|
+
try:
|
|
413
|
+
import PIL
|
|
414
|
+
from PIL import Image
|
|
415
|
+
except Exception as e: # pragma: no cover
|
|
416
|
+
raise SkillError(E_TOOL_MISSING, "Pillow 不可用", {"err": repr(e)})
|
|
417
|
+
return PIL, Image
|
|
418
|
+
|
|
419
|
+
|
|
420
|
+
def _pillow_bit_depth(img):
|
|
421
|
+
b = _MODE_BITS.get(img.mode)
|
|
422
|
+
if b is not None:
|
|
423
|
+
return b
|
|
424
|
+
try:
|
|
425
|
+
from PIL import Image as _I
|
|
426
|
+
base = _I.getmodebase(img.mode)
|
|
427
|
+
return {"1": 1, "L": 8, "I": 32, "F": 32}.get(base, 8)
|
|
428
|
+
except Exception:
|
|
429
|
+
return 8
|
|
430
|
+
|
|
431
|
+
|
|
432
|
+
# ---------------------------------------------------------------- 后端探测
|
|
433
|
+
|
|
434
|
+
def resolve_magick():
|
|
435
|
+
"""解析 `magick` 可执行体(**不得假定它在 PATH**,定稿 §3.5)。
|
|
436
|
+
|
|
437
|
+
次序:① env `IMGSKILL_MAGICK`(可执行体或安装目录)→ ② env `MAGICK_HOME` /
|
|
438
|
+
`ImageMagick_HOME` 目录 → ③ `shutil.which("magick")`。皆无 → None。
|
|
439
|
+
**绝不解析 `convert`**(Windows 上那是系统盘卷转换工具,定稿 §3.5)。
|
|
440
|
+
"""
|
|
441
|
+
cand = os.environ.get(_ENV_MAGICK)
|
|
442
|
+
if cand:
|
|
443
|
+
p = cand
|
|
444
|
+
if os.path.isdir(p):
|
|
445
|
+
for name in ("magick.exe", "magick"):
|
|
446
|
+
if os.path.isfile(os.path.join(p, name)):
|
|
447
|
+
return os.path.join(p, name)
|
|
448
|
+
if os.path.isfile(p):
|
|
449
|
+
return p
|
|
450
|
+
return None # 显式给了但不在 → 视为不可用(不静默回落)
|
|
451
|
+
for home in _ENV_HOMES:
|
|
452
|
+
d = os.environ.get(home)
|
|
453
|
+
if d and os.path.isdir(d):
|
|
454
|
+
for name in ("magick.exe", "magick"):
|
|
455
|
+
p = os.path.join(d, name)
|
|
456
|
+
if os.path.isfile(p):
|
|
457
|
+
return p
|
|
458
|
+
return shutil.which("magick")
|
|
459
|
+
|
|
460
|
+
|
|
461
|
+
def _magick_version(exe):
|
|
462
|
+
rc, out, err = _spawn([exe, "-version"])
|
|
463
|
+
txt = (out or "") + (err or "")
|
|
464
|
+
for tok in txt.replace("\n", " ").split():
|
|
465
|
+
# 首个形如 7.1.2-31 / 7.1.2 的串
|
|
466
|
+
if tok[:1].isdigit() and tok.count(".") >= 1:
|
|
467
|
+
return tok.strip(",")
|
|
468
|
+
return "unknown"
|
|
469
|
+
|
|
470
|
+
|
|
471
|
+
def resolve_backend():
|
|
472
|
+
"""后端路由:`magick` 优先、Pillow 兜底;降级必须留痕(定稿 §九-#11)。
|
|
473
|
+
|
|
474
|
+
返回 `(name, exe, version, note)`;`note` 为降级留痕(None 表示未降级)。
|
|
475
|
+
两后端皆不可用 → `E_TOOL_MISSING`(fail-closed)。
|
|
476
|
+
"""
|
|
477
|
+
pin = (os.environ.get(_ENV_BACKEND) or "auto").strip().lower()
|
|
478
|
+
exe = resolve_magick()
|
|
479
|
+
|
|
480
|
+
def pillow_ok():
|
|
481
|
+
try:
|
|
482
|
+
_pillow()
|
|
483
|
+
import PIL
|
|
484
|
+
return PIL.__version__
|
|
485
|
+
except SkillError:
|
|
486
|
+
return None
|
|
487
|
+
except Exception:
|
|
488
|
+
return None
|
|
489
|
+
|
|
490
|
+
if pin == "magick":
|
|
491
|
+
if exe is None:
|
|
492
|
+
raise SkillError(E_TOOL_MISSING,
|
|
493
|
+
"后端被钉为 magick 但 magick 不可解析",
|
|
494
|
+
{"hint": _ENV_MAGICK})
|
|
495
|
+
return "magick", exe, _magick_version(exe), None
|
|
496
|
+
if pin == "pillow":
|
|
497
|
+
v = pillow_ok()
|
|
498
|
+
if v is None:
|
|
499
|
+
raise SkillError(E_TOOL_MISSING, "后端被钉为 pillow 但 Pillow 不可用")
|
|
500
|
+
return "pillow", None, v, None
|
|
501
|
+
if pin != "auto":
|
|
502
|
+
raise _bad(f"{_ENV_BACKEND} 取值非法(auto|magick|pillow)", {"got": pin})
|
|
503
|
+
|
|
504
|
+
if exe is not None:
|
|
505
|
+
return "magick", exe, _magick_version(exe), None
|
|
506
|
+
v = pillow_ok()
|
|
507
|
+
if v is None:
|
|
508
|
+
raise SkillError(E_TOOL_MISSING,
|
|
509
|
+
"magick 与 Pillow 皆不可用(fail-closed)",
|
|
510
|
+
{"magick": None, "pillow": None})
|
|
511
|
+
return "pillow", None, v, {"from": "magick", "to": "pillow",
|
|
512
|
+
"reason": E_TOOL_MISSING}
|
|
513
|
+
|
|
514
|
+
|
|
515
|
+
def _spawn(argv):
|
|
516
|
+
"""子进程统一走 argv 列表 + 显式 UTF-8(纪律 15;不拼 shell 串)。"""
|
|
517
|
+
env = dict(os.environ)
|
|
518
|
+
env["PYTHONUTF8"] = "1"
|
|
519
|
+
try:
|
|
520
|
+
cp = subprocess.run(argv, shell=False, capture_output=True,
|
|
521
|
+
encoding="utf-8", errors="replace",
|
|
522
|
+
timeout=_MAGICK_TIMEOUT, env=env)
|
|
523
|
+
except FileNotFoundError as e:
|
|
524
|
+
raise SkillError(E_TOOL_MISSING, "后端可执行体不在", {"argv0": argv[0], "err": str(e)})
|
|
525
|
+
except PermissionError as e:
|
|
526
|
+
raise SkillError(E_PERM, "后端可执行体无执行权限", {"argv0": argv[0], "err": str(e)})
|
|
527
|
+
except subprocess.TimeoutExpired:
|
|
528
|
+
raise SkillError(E_BACKEND_FAIL, "后端超时", {"argv": argv[:2]})
|
|
529
|
+
return cp.returncode, cp.stdout, cp.stderr
|
|
530
|
+
|
|
531
|
+
|
|
532
|
+
def _classify_backend_err(err, default=E_BACKEND_FAIL):
|
|
533
|
+
e = (err or "").lower()
|
|
534
|
+
for key in ("no decode delegate", "improper image header",
|
|
535
|
+
"unrecognized image format", "unable to read image",
|
|
536
|
+
"not a valid", "crop/tile"):
|
|
537
|
+
if key in e:
|
|
538
|
+
return E_DECODE
|
|
539
|
+
if "permission denied" in e:
|
|
540
|
+
return E_PERM
|
|
541
|
+
return default
|
|
542
|
+
|
|
543
|
+
|
|
544
|
+
# ---------------------------------------------------------------- magick 后端
|
|
545
|
+
|
|
546
|
+
_MAGICK_FMT = "%m|%w|%h|%z|%[channels]|%[bit-depth]"
|
|
547
|
+
|
|
548
|
+
|
|
549
|
+
def _magick_identify(exe, path):
|
|
550
|
+
rc, out, err = _spawn([exe, "identify", "-format", _MAGICK_FMT, path])
|
|
551
|
+
if rc != 0:
|
|
552
|
+
raise SkillError(_classify_backend_err(err),
|
|
553
|
+
"magick identify 失败", {"rc": rc, "stderr": (err or "")[:400]})
|
|
554
|
+
line = (out or "").strip().splitlines()
|
|
555
|
+
if not line:
|
|
556
|
+
raise SkillError(E_DECODE, "magick identify 无输出", {"path": path})
|
|
557
|
+
parts = line[0].split("|")
|
|
558
|
+
if len(parts) < 6:
|
|
559
|
+
raise SkillError(E_DECODE, "magick identify 输出不可解析",
|
|
560
|
+
{"raw": line[0][:200]})
|
|
561
|
+
fmt, w, h, depth, chans, _bd = parts[:6]
|
|
562
|
+
try:
|
|
563
|
+
width, height, bit_depth = int(w), int(h), int(depth)
|
|
564
|
+
except ValueError:
|
|
565
|
+
raise SkillError(E_DECODE, "magick identify 尺寸/位深不可解析",
|
|
566
|
+
{"raw": line[0][:200]})
|
|
567
|
+
# `%[channels]` 实测形如 "srgb 4.0"(通道名 + 浮点),取首 token(本机实测)
|
|
568
|
+
ch = chans.strip().split()[0].lower() if chans.strip() else ""
|
|
569
|
+
return {
|
|
570
|
+
"format": fmt.upper(),
|
|
571
|
+
"width": width, "height": height,
|
|
572
|
+
"mode": _CH2MODE.get(ch, ch or "unknown"),
|
|
573
|
+
"bit_depth": bit_depth,
|
|
574
|
+
}
|
|
575
|
+
|
|
576
|
+
|
|
577
|
+
def _magick_meta(exe, path):
|
|
578
|
+
m = _magick_identify(exe, path)
|
|
579
|
+
m["bytes"] = os.path.getsize(path)
|
|
580
|
+
m["sha256"] = _sha256_file(path)
|
|
581
|
+
return m
|
|
582
|
+
|
|
583
|
+
|
|
584
|
+
# ---------------------------------------------------------------- pillow 后端
|
|
585
|
+
|
|
586
|
+
def _open_pillow(path):
|
|
587
|
+
_PIL, Image = _pillow()
|
|
588
|
+
try:
|
|
589
|
+
img = Image.open(path)
|
|
590
|
+
img.load()
|
|
591
|
+
return img
|
|
592
|
+
except FileNotFoundError as e:
|
|
593
|
+
raise SkillError(E_NOINPUT, "源文件不存在", {"err": str(e)})
|
|
594
|
+
except PermissionError as e:
|
|
595
|
+
raise SkillError(E_PERM, "读源文件无权限", {"err": str(e)})
|
|
596
|
+
except Image.UnidentifiedImageError as e:
|
|
597
|
+
raise SkillError(E_DECODE, "Pillow 解不出(损坏/非图像)", {"err": str(e)})
|
|
598
|
+
except OSError as e:
|
|
599
|
+
msg = str(e).lower()
|
|
600
|
+
code = E_DECODE if ("truncated" in msg or "cannot identify" in msg
|
|
601
|
+
or "image file is truncated" in msg) else E_BACKEND_FAIL
|
|
602
|
+
raise SkillError(code, "Pillow 打开失败", {"err": str(e)})
|
|
603
|
+
|
|
604
|
+
|
|
605
|
+
def _pillow_meta(path):
|
|
606
|
+
img = _open_pillow(path)
|
|
607
|
+
fmt = (img.format or "").upper()
|
|
608
|
+
if not fmt:
|
|
609
|
+
ext = os.path.splitext(path)[1].lstrip(".").lower()
|
|
610
|
+
fmt = _EXT2FMT.get(ext, "UNKNOWN")
|
|
611
|
+
return {
|
|
612
|
+
"format": fmt, "width": img.size[0], "height": img.size[1],
|
|
613
|
+
"mode": img.mode, "bit_depth": _pillow_bit_depth(img),
|
|
614
|
+
"bytes": os.path.getsize(path), "sha256": _sha256_file(path),
|
|
615
|
+
}
|
|
616
|
+
|
|
617
|
+
|
|
618
|
+
def _pillow_resize(src, dst, width, height, flt_name):
|
|
619
|
+
_PIL, Image = _pillow()
|
|
620
|
+
img = _open_pillow(src)
|
|
621
|
+
if width is None and height is None:
|
|
622
|
+
raise _bad("resize 需要 width 与/或 height")
|
|
623
|
+
w0, h0 = img.size
|
|
624
|
+
if width is not None and height is None:
|
|
625
|
+
height = max(1, round(h0 * width / float(w0))) # 保持纵横比
|
|
626
|
+
if height is not None and width is None:
|
|
627
|
+
width = max(1, round(w0 * height / float(h0)))
|
|
628
|
+
resample = getattr(Image.Resampling, _FILTERS[flt_name][1])
|
|
629
|
+
out = img.resize((int(width), int(height)), resample)
|
|
630
|
+
_pillow_save(out, dst)
|
|
631
|
+
|
|
632
|
+
|
|
633
|
+
def _pillow_save(img, dst):
|
|
634
|
+
ext = os.path.splitext(dst)[1].lstrip(".").lower()
|
|
635
|
+
fmt = _EXT2FMT.get(ext)
|
|
636
|
+
if fmt is None:
|
|
637
|
+
raise SkillError(E_UNSUPPORTED_FORMAT, "目标扩展名不在写面", {"ext": ext})
|
|
638
|
+
if fmt == "JPEG" and img.mode in ("RGBA", "LA", "P"):
|
|
639
|
+
img = img.convert("RGB")
|
|
640
|
+
try:
|
|
641
|
+
img.save(dst, format=fmt) # 不写 exif/时间戳(幂等口径:像素级门)
|
|
642
|
+
except PermissionError as e:
|
|
643
|
+
raise SkillError(E_PERM, "写目标无权限", {"err": str(e)})
|
|
644
|
+
except OSError as e:
|
|
645
|
+
raise SkillError(E_BACKEND_FAIL, "Pillow 保存失败", {"err": str(e)})
|
|
646
|
+
|
|
647
|
+
|
|
648
|
+
# ---------------------------------------------------------------- 参数/几何小工具
|
|
649
|
+
|
|
650
|
+
def _is_int(v):
|
|
651
|
+
return isinstance(v, int) and not isinstance(v, bool)
|
|
652
|
+
|
|
653
|
+
|
|
654
|
+
def _is_num(v):
|
|
655
|
+
return isinstance(v, (int, float)) and not isinstance(v, bool) \
|
|
656
|
+
and math.isfinite(float(v))
|
|
657
|
+
|
|
658
|
+
|
|
659
|
+
def _fmt_num(x):
|
|
660
|
+
"""数值 → CLI 参数串(整值不带小数点;不依赖 locale)。"""
|
|
661
|
+
f = float(x)
|
|
662
|
+
return str(int(f)) if f == int(f) else repr(f)
|
|
663
|
+
|
|
664
|
+
|
|
665
|
+
def _resample(Image, flt_name):
|
|
666
|
+
return getattr(Image.Resampling, _FILTERS[flt_name][1])
|
|
667
|
+
|
|
668
|
+
|
|
669
|
+
def _size_of(ctx, path):
|
|
670
|
+
"""取任意沙箱内文件的像素尺寸(crop/rotate/mirror/composite/mask 的验收判据要用)。"""
|
|
671
|
+
b = ctx["backend"]
|
|
672
|
+
if b["name"] == "magick":
|
|
673
|
+
m = _magick_identify(b["exe"], path)
|
|
674
|
+
return m["width"], m["height"]
|
|
675
|
+
return _open_pillow(path).size
|
|
676
|
+
|
|
677
|
+
|
|
678
|
+
def _src_size(ctx):
|
|
679
|
+
return _size_of(ctx, ctx["src_abs"])
|
|
680
|
+
|
|
681
|
+
|
|
682
|
+
def _rot_bg(mode):
|
|
683
|
+
"""rotate 空白填色(本版解释 2:对齐 magick 的不透明白默认背景)。"""
|
|
684
|
+
return _ROT_BG.get(mode, (255, 255, 255))
|
|
685
|
+
|
|
686
|
+
|
|
687
|
+
def _adj_lut(brightness, contrast, gamma):
|
|
688
|
+
"""单通道 8-bit LUT:亮度(加性百分比)→ 对比度(绕 128 缩放)→ 伽马(v^(1/g))。"""
|
|
689
|
+
out = []
|
|
690
|
+
for v in range(256):
|
|
691
|
+
f = v + brightness * 255.0 / 100.0
|
|
692
|
+
f = 128.0 + (f - 128.0) * (100.0 + contrast) / 100.0
|
|
693
|
+
f = max(0.0, min(255.0, f))
|
|
694
|
+
if gamma != 1.0:
|
|
695
|
+
f = 255.0 * ((f / 255.0) ** (1.0 / gamma))
|
|
696
|
+
out.append(max(0, min(255, int(round(f)))))
|
|
697
|
+
return out
|
|
698
|
+
|
|
699
|
+
|
|
700
|
+
def _adj_lut_for(img, lut):
|
|
701
|
+
"""按 band 数铺开 LUT(带 alpha 的 mode:alpha band 用恒等 LUT,不动 alpha)。"""
|
|
702
|
+
n = len(img.getbands())
|
|
703
|
+
if img.mode in ("LA", "RGBA"):
|
|
704
|
+
return list(lut) * (n - 1) + list(range(256))
|
|
705
|
+
return list(lut) * n
|
|
706
|
+
|
|
707
|
+
|
|
708
|
+
def _pillow_filter_mod():
|
|
709
|
+
"""惰性取 `PIL.ImageFilter`(不进模块 import 面;缺失 → E_TOOL_MISSING)。"""
|
|
710
|
+
_pillow() # 先确认 Pillow 在场(含 IMGSKILL_PILLOW=0 否决)
|
|
711
|
+
try:
|
|
712
|
+
from PIL import ImageFilter
|
|
713
|
+
except Exception as e: # pragma: no cover
|
|
714
|
+
raise SkillError(E_TOOL_MISSING, "Pillow ImageFilter 不可用", {"err": repr(e)})
|
|
715
|
+
return ImageFilter
|
|
716
|
+
|
|
717
|
+
|
|
718
|
+
# ---------------------------------------------------------------- op 校验
|
|
719
|
+
|
|
720
|
+
def derive_level(op):
|
|
721
|
+
return LEVEL_MAP.get(op)
|
|
722
|
+
|
|
723
|
+
|
|
724
|
+
def _norm_params(op, params):
|
|
725
|
+
"""按 op 规范化/校验参数;返回 (台账参数, 执行参数) 两字典。
|
|
726
|
+
|
|
727
|
+
台账参数只放**已归一的值**(默认值补齐、别名解析、路径统一 `/`)——它同时是
|
|
728
|
+
幂等复用的比对键(`_find_reuse` 拿它逐字比对),故取值必须稳定、可复跑。
|
|
729
|
+
"""
|
|
730
|
+
if params is None:
|
|
731
|
+
params = {}
|
|
732
|
+
if not isinstance(params, dict):
|
|
733
|
+
raise _bad("params 须为对象", {"got": type(params).__name__})
|
|
734
|
+
|
|
735
|
+
def extra_keys(allowed, label):
|
|
736
|
+
ex = set(params) - set(allowed)
|
|
737
|
+
if ex:
|
|
738
|
+
raise _bad(f"{label} 参数仅 {'/'.join(sorted(allowed))}", {"extra": sorted(ex)})
|
|
739
|
+
|
|
740
|
+
if op == "inspect":
|
|
741
|
+
extra_keys({"note"}, "inspect")
|
|
742
|
+
return {}, {}
|
|
743
|
+
if op == "resize":
|
|
744
|
+
extra_keys({"width", "height", "filter"}, "resize")
|
|
745
|
+
w, h = params.get("width"), params.get("height")
|
|
746
|
+
for k, v in (("width", w), ("height", h)):
|
|
747
|
+
if v is not None and (not isinstance(v, int) or isinstance(v, bool) or v <= 0):
|
|
748
|
+
raise _bad(f"resize.{k} 须为正整数或 null", {"got": repr(v)})
|
|
749
|
+
if w is None and h is None:
|
|
750
|
+
raise _bad("resize 需要 width 与/或 height(不得皆缺)")
|
|
751
|
+
flt = params.get("filter", DEFAULT_FILTER)
|
|
752
|
+
if not isinstance(flt, str) or flt.lower() not in _FILTERS:
|
|
753
|
+
raise _bad("resize.filter 不在支持面", {"supported": sorted(_FILTERS)})
|
|
754
|
+
flt = flt.lower()
|
|
755
|
+
return ({"width": w, "height": h, "filter": flt},
|
|
756
|
+
{"width": w, "height": h, "filter": flt})
|
|
757
|
+
if op == "convert":
|
|
758
|
+
extra_keys({"format"}, "convert")
|
|
759
|
+
fmt = params.get("format")
|
|
760
|
+
if fmt is not None:
|
|
761
|
+
if not isinstance(fmt, str):
|
|
762
|
+
raise _bad("convert.format 须为字符串", {"got": type(fmt).__name__})
|
|
763
|
+
key = fmt.strip().lower()
|
|
764
|
+
if key not in FMT_WRITE:
|
|
765
|
+
raise SkillError(E_UNSUPPORTED_FORMAT, "目标格式不在后端写面",
|
|
766
|
+
{"format": fmt, "write_face": list(FMT_WRITE)})
|
|
767
|
+
return {"format": _EXT2FMT[key]}, {"format": _EXT2FMT[key]}
|
|
768
|
+
return {}, {}
|
|
769
|
+
if op == "thumbnail":
|
|
770
|
+
extra_keys({"max_edge"}, "thumbnail")
|
|
771
|
+
m = params.get("max_edge")
|
|
772
|
+
if not _is_int(m) or m <= 0:
|
|
773
|
+
raise _bad("thumbnail.max_edge 须为正整数", {"got": repr(m)})
|
|
774
|
+
n = {"max_edge": int(m)}
|
|
775
|
+
return dict(n), dict(n)
|
|
776
|
+
if op == "crop":
|
|
777
|
+
extra_keys({"x", "y", "width", "height"}, "crop")
|
|
778
|
+
x, y = params.get("x", 0), params.get("y", 0)
|
|
779
|
+
w, h = params.get("width"), params.get("height")
|
|
780
|
+
for k, v in (("x", x), ("y", y)):
|
|
781
|
+
if not _is_int(v) or v < 0:
|
|
782
|
+
raise _bad(f"crop.{k} 须为非负整数(负数在 magick 里是「从右/下起算」的另一语义)",
|
|
783
|
+
{"got": repr(v)})
|
|
784
|
+
for k, v in (("width", w), ("height", h)):
|
|
785
|
+
if not _is_int(v) or v <= 0:
|
|
786
|
+
raise _bad(f"crop.{k} 必填且须为正整数", {"got": repr(v)})
|
|
787
|
+
n = {"x": int(x), "y": int(y), "width": int(w), "height": int(h)}
|
|
788
|
+
return dict(n), dict(n)
|
|
789
|
+
if op == "rotate":
|
|
790
|
+
extra_keys({"degrees"}, "rotate")
|
|
791
|
+
deg = params.get("degrees")
|
|
792
|
+
if not _is_num(deg):
|
|
793
|
+
raise _bad("rotate.degrees 必填且须为有限数值", {"got": repr(deg)})
|
|
794
|
+
if abs(float(deg)) > 3600.0:
|
|
795
|
+
raise _bad("rotate.degrees 超出 ±3600(防误传弧度/毫弧度)", {"got": repr(deg)})
|
|
796
|
+
n = {"degrees": float(deg)}
|
|
797
|
+
return dict(n), dict(n)
|
|
798
|
+
if op in ("flip", "flop"):
|
|
799
|
+
extra_keys({"axis"}, op)
|
|
800
|
+
ax = params.get("axis")
|
|
801
|
+
if ax is None:
|
|
802
|
+
return {}, {}
|
|
803
|
+
if not isinstance(ax, str) or ax.strip().lower() not in _AXIS[op]:
|
|
804
|
+
raise _bad(f"{op}.axis 须与 op 同轴(或整参省略)",
|
|
805
|
+
{"got": repr(ax), "op_axis": _AXIS[op][0],
|
|
806
|
+
"accepted": list(_AXIS[op])})
|
|
807
|
+
n = {"axis": _AXIS[op][0]}
|
|
808
|
+
return dict(n), dict(n)
|
|
809
|
+
if op == "adjust":
|
|
810
|
+
extra_keys({"brightness", "contrast", "gamma"}, "adjust")
|
|
811
|
+
if not params: # 全缺 → 无操作,拒
|
|
812
|
+
raise _bad("adjust 需要 brightness/contrast/gamma 至少其一")
|
|
813
|
+
br, ct = params.get("brightness", 0), params.get("contrast", 0)
|
|
814
|
+
for k, v in (("brightness", br), ("contrast", ct)):
|
|
815
|
+
if not _is_int(v) or abs(v) > _ADJ_RANGE:
|
|
816
|
+
raise _bad(f"adjust.{k} 须为 ±{int(_ADJ_RANGE)} 内整数", {"got": repr(v)})
|
|
817
|
+
gm = params.get("gamma", 1.0)
|
|
818
|
+
if not _is_num(gm) or not (_GAMMA_RANGE[0] < float(gm) <= _GAMMA_RANGE[1]):
|
|
819
|
+
raise _bad("adjust.gamma 须在 (0, 10] 内",
|
|
820
|
+
{"got": repr(gm), "range": list(_GAMMA_RANGE)})
|
|
821
|
+
n = {"brightness": int(br), "contrast": int(ct), "gamma": float(gm)}
|
|
822
|
+
return dict(n), dict(n)
|
|
823
|
+
if op in ("blur", "sharpen"):
|
|
824
|
+
extra_keys({"sigma"}, op)
|
|
825
|
+
s = params.get("sigma")
|
|
826
|
+
if not _is_num(s) or not (0.0 < float(s) <= _SIGMA_MAX):
|
|
827
|
+
raise _bad(f"{op}.sigma 须在 (0, {int(_SIGMA_MAX)}] 内",
|
|
828
|
+
{"got": repr(s)})
|
|
829
|
+
n = {"sigma": float(s)}
|
|
830
|
+
return dict(n), dict(n)
|
|
831
|
+
if op == "composite":
|
|
832
|
+
extra_keys({"over_path", "gravity", "opacity"}, "composite")
|
|
833
|
+
over = params.get("over_path")
|
|
834
|
+
if not isinstance(over, str) or not over.strip():
|
|
835
|
+
raise _bad("composite.over_path 必填且须为非空字符串(相对沙箱根)",
|
|
836
|
+
{"got": repr(over)})
|
|
837
|
+
g = params.get("gravity", "center")
|
|
838
|
+
if not isinstance(g, str) or g.strip().lower() not in _GRAVITY_ALIAS:
|
|
839
|
+
raise _bad("composite.gravity 不在支持面",
|
|
840
|
+
{"got": repr(g), "supported": list(GRAVITIES)})
|
|
841
|
+
op_v = params.get("opacity", 1.0)
|
|
842
|
+
if not _is_num(op_v) or not (0.0 <= float(op_v) <= 1.0):
|
|
843
|
+
raise _bad("composite.opacity 须在 [0, 1] 内", {"got": repr(op_v)})
|
|
844
|
+
n = {"over_path": _rel(over), "gravity": _GRAVITY_ALIAS[g.strip().lower()],
|
|
845
|
+
"opacity": float(op_v)}
|
|
846
|
+
return dict(n), dict(n)
|
|
847
|
+
if op == "mask":
|
|
848
|
+
extra_keys({"mask_path", "mode"}, "mask")
|
|
849
|
+
mp = params.get("mask_path")
|
|
850
|
+
if not isinstance(mp, str) or not mp.strip():
|
|
851
|
+
raise _bad("mask.mask_path 必填且须为非空字符串(相对沙箱根)",
|
|
852
|
+
{"got": repr(mp)})
|
|
853
|
+
mode = params.get("mode", "set")
|
|
854
|
+
if not isinstance(mode, str):
|
|
855
|
+
raise _bad("mask.mode 须为字符串", {"got": type(mode).__name__})
|
|
856
|
+
key = mode.strip().lower()
|
|
857
|
+
if key in MASK_MODE_UNIMPL:
|
|
858
|
+
# 「已知但未落」→ 范围外(非出错):magick 无单命令确定等价,见模块 docstring
|
|
859
|
+
raise SkillError(E_UNSUPPORTED_OP,
|
|
860
|
+
"mask.mode 该取值属本版范围外",
|
|
861
|
+
{"mode": mode, "implemented": ["set"],
|
|
862
|
+
"unimplemented_reason": "magick 单命令无确定等价(须多步中间件)"})
|
|
863
|
+
if key != "set":
|
|
864
|
+
raise _bad("mask.mode 不在支持面", {"got": repr(mode), "supported": ["set"]})
|
|
865
|
+
n = {"mask_path": _rel(mp), "mode": "set"}
|
|
866
|
+
return dict(n), dict(n)
|
|
867
|
+
# 不可达(run() 已在实现面处挡下范围外 op);防御性兜底:fail-closed
|
|
868
|
+
raise SkillError(E_UNSUPPORTED_OP, "op 无参数校验分支(实现表与校验表不一致)",
|
|
869
|
+
{"op": op, "implemented": list(OPS_IMPL)})
|
|
870
|
+
|
|
871
|
+
|
|
872
|
+
|
|
873
|
+
def _derive_dst(src_rel, op, nparams, src_fmt_ext):
|
|
874
|
+
"""`dst` 缺省派生(定稿 §九-#7:显式优先;缺省 `src` 同目录 + `_out` + 后缀)。
|
|
875
|
+
|
|
876
|
+
**本版解释**:定稿 §3.1/§3.6 均称「缺省由 `op`+`params` 派生」,而 §九-#7 的口诀
|
|
877
|
+
写「原后缀」——对 `convert`(换容器)二者冲突:保留原后缀会得到
|
|
878
|
+
「内容 webp / 名 .png」的自相矛盾产物。故:**换容器的 op(convert)派生时用目标
|
|
879
|
+
格式后缀,其余保留原后缀**。此为 gap-fill,已列入交付「待核实」交编排侧裁定。
|
|
880
|
+
"""
|
|
881
|
+
d = os.path.dirname(src_rel)
|
|
882
|
+
stem = os.path.splitext(os.path.basename(src_rel))[0]
|
|
883
|
+
ext = os.path.splitext(src_rel)[1] or src_fmt_ext or ".png"
|
|
884
|
+
if op == "convert" and nparams.get("format"):
|
|
885
|
+
ext = "." + _FMT2EXT.get(nparams["format"], ext.lstrip(".")).lower()
|
|
886
|
+
rel = os.path.join(d, stem + "_out" + ext) if d else stem + "_out" + ext
|
|
887
|
+
return rel
|
|
888
|
+
|
|
889
|
+
|
|
890
|
+
# ---------------------------------------------------------------- 审计
|
|
891
|
+
|
|
892
|
+
# 生效条件:台账落点经 audit_path 判定安全时以 O_APPEND|O_CREAT|O_NOFOLLOW(平台无该标志时取 0)打开并追加一行 JSON,返回 None;判定不安全(链接/根外)或打开写入失败时**不写**并返回告警 dict({"code","message","detail"}),不抛——调用方把告警并进返回体(audit_warning),run() 本身照常给结果;
|
|
893
|
+
#: issue #443:单条台账记录的总字节上限(与 md_cg/fsutil._MAX_RECORD_BYTES 同值)。
|
|
894
|
+
_MAX_AUDIT_RECORD_BYTES = 65536
|
|
895
|
+
|
|
896
|
+
|
|
897
|
+
def _audit_write(root, rec):
|
|
898
|
+
"""追加一行台账;落点不可信时**不写 + 告警**(#352-C)。
|
|
899
|
+
|
|
900
|
+
为什么是 fail-open(不写台账、照常返回结果)而不是抛错:台账落点的可信边界
|
|
901
|
+
问题若升级成拒服务,一个本地可写者建个符号链接就能让所有合法调用失败;
|
|
902
|
+
报告给的边界也是「可人工删掉追加行恢复」。是否需要改为 fail-closed 属维护者
|
|
903
|
+
裁定——本实现把它做成**可观测的告警**(结果体 `audit_warning`),不静默。
|
|
904
|
+
|
|
905
|
+
`O_NOFOLLOW`:末段是符号链接时 POSIX 直接 ELOOP(与判定之间还剩一个很窄的
|
|
906
|
+
TOCTOU 窗口,同 #325 的残余口径);Windows 无该标志,靠 audit_path 的
|
|
907
|
+
realpath 判定兜底。
|
|
908
|
+
"""
|
|
909
|
+
# issue #443:rec 由调用方可控 ⇒ 先过单条总字节闸;超限不写台账但照常返回结果
|
|
910
|
+
# (与本函数既有 fail-open 口径一致),并通过结构化 code 透出、不静默。
|
|
911
|
+
# 上限与 md_cg/fsutil._MAX_RECORD_BYTES 同值;本模块不依赖 fsutil(它只 import stdlib),
|
|
912
|
+
# 故常量在此重复一份并在守卫里钉住两处相等,避免单方面漂移。
|
|
913
|
+
if len(json.dumps(rec, ensure_ascii=False, default=str).encode("utf-8")) > _MAX_AUDIT_RECORD_BYTES:
|
|
914
|
+
return {"code": "audit_record_too_large",
|
|
915
|
+
"message": "台账记录超出单条字节上限,未写入(issue #443)",
|
|
916
|
+
"detail": int(_MAX_AUDIT_RECORD_BYTES)}
|
|
917
|
+
try:
|
|
918
|
+
p = audit_path(root)
|
|
919
|
+
except SkillError as exc:
|
|
920
|
+
return {"code": exc.code, "message": exc.message,
|
|
921
|
+
"detail": getattr(exc, "detail", None)}
|
|
922
|
+
try:
|
|
923
|
+
os.makedirs(os.path.dirname(p), exist_ok=True)
|
|
924
|
+
flags = (os.O_WRONLY | os.O_APPEND | os.O_CREAT
|
|
925
|
+
| getattr(os, "O_NOFOLLOW", 0))
|
|
926
|
+
fd = os.open(p, flags, 0o600)
|
|
927
|
+
except OSError as exc:
|
|
928
|
+
return {"code": E_PERM, "message": "台账不可写:%s" % exc,
|
|
929
|
+
"detail": {"path": p}}
|
|
930
|
+
try:
|
|
931
|
+
with os.fdopen(fd, "a", encoding="utf-8") as f:
|
|
932
|
+
f.write(json.dumps(rec, ensure_ascii=False, sort_keys=True) + "\n")
|
|
933
|
+
except Exception as exc: # noqa: BLE001
|
|
934
|
+
return {"code": E_PERM, "message": "台账写入失败:%s" % exc,
|
|
935
|
+
"detail": {"path": p}}
|
|
936
|
+
return None
|
|
937
|
+
|
|
938
|
+
|
|
939
|
+
def _audit_seq(root):
|
|
940
|
+
p = audit_path(root, strict=False)
|
|
941
|
+
if p is None or not os.path.exists(p):
|
|
942
|
+
return 1
|
|
943
|
+
n = 0
|
|
944
|
+
with open(p, "r", encoding="utf-8", errors="replace") as f:
|
|
945
|
+
for _ in f:
|
|
946
|
+
n += 1
|
|
947
|
+
return n + 1
|
|
948
|
+
|
|
949
|
+
|
|
950
|
+
def _make_audit(root, *, op, level, input_rel, input_sha, out_rel, out_sha,
|
|
951
|
+
params, tool_version, caller, ok, error_code,
|
|
952
|
+
backend, backend_note, sandbox_root, idempotency_key,
|
|
953
|
+
extra=None, output_meta=None):
|
|
954
|
+
seq = _audit_seq(root)
|
|
955
|
+
rec = {
|
|
956
|
+
"audit_id": f"audit_{int(time.time() * 1000)}_{seq}",
|
|
957
|
+
"op": op,
|
|
958
|
+
"level": level,
|
|
959
|
+
"input_path": input_rel,
|
|
960
|
+
"input_sha256": input_sha,
|
|
961
|
+
"output_path": out_rel,
|
|
962
|
+
"output_sha256": out_sha,
|
|
963
|
+
"params": params,
|
|
964
|
+
"tool_version": tool_version,
|
|
965
|
+
"env": {"os": platform.platform(), "python": sys.version.split()[0],
|
|
966
|
+
"pythonutf8": os.environ.get("PYTHONUTF8", "")},
|
|
967
|
+
"ts": time.strftime("%Y-%m-%dT%H:%M:%S", time.localtime()),
|
|
968
|
+
"caller": caller,
|
|
969
|
+
"ok": bool(ok),
|
|
970
|
+
"error_code": error_code,
|
|
971
|
+
# —— 以下为定稿 §4.1 之外的本版增量(出参 `backend` + §九-#11 降级留痕)——
|
|
972
|
+
"backend": backend,
|
|
973
|
+
"backend_note": backend_note,
|
|
974
|
+
"sandbox_root": sandbox_root,
|
|
975
|
+
"idempotency_key": idempotency_key,
|
|
976
|
+
"output_meta": output_meta,
|
|
977
|
+
}
|
|
978
|
+
if extra:
|
|
979
|
+
rec.update(extra)
|
|
980
|
+
return rec
|
|
981
|
+
|
|
982
|
+
|
|
983
|
+
# ---------------------------------------------------------------- 出参
|
|
984
|
+
|
|
985
|
+
def _result(ok, *, artifact_path=None, asset=None, meta=None, audit_id=None,
|
|
986
|
+
backend=None, error=None):
|
|
987
|
+
return {"ok": bool(ok), "artifact_path": artifact_path, "asset": asset,
|
|
988
|
+
"meta": meta, "audit_id": audit_id, "backend": backend,
|
|
989
|
+
"error": error}
|
|
990
|
+
|
|
991
|
+
|
|
992
|
+
def _err_result(code, message, detail=None, *, audit_id=None, backend=None):
|
|
993
|
+
return _result(False, audit_id=audit_id, backend=backend,
|
|
994
|
+
error={"code": code, "message": message, "detail": detail})
|
|
995
|
+
|
|
996
|
+
|
|
997
|
+
# ---------------------------------------------------------------- op 实现
|
|
998
|
+
|
|
999
|
+
def _op_inspect(ctx):
|
|
1000
|
+
"""读元数据(不改产物)。出参 artifact_path=None;meta=源元数据。"""
|
|
1001
|
+
b = ctx["backend"]
|
|
1002
|
+
if b["name"] == "magick":
|
|
1003
|
+
meta = _magick_meta(b["exe"], ctx["src_abs"])
|
|
1004
|
+
else:
|
|
1005
|
+
meta = _pillow_meta(ctx["src_abs"])
|
|
1006
|
+
ctx["out_rel"] = None
|
|
1007
|
+
ctx["out_sha"] = None
|
|
1008
|
+
ctx["output_meta"] = meta
|
|
1009
|
+
return _result(True, artifact_path=None, asset=meta["sha256"], meta=meta,
|
|
1010
|
+
backend={"name": b["name"], "version": b["version"]})
|
|
1011
|
+
|
|
1012
|
+
|
|
1013
|
+
def _op_resize(ctx):
|
|
1014
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1015
|
+
if b["name"] == "magick":
|
|
1016
|
+
w, h = p["width"], p["height"]
|
|
1017
|
+
geom = f"{w}x{h}!" if (w and h) else (f"{w}x" if w else f"x{h}")
|
|
1018
|
+
rc, _out, err = _spawn([b["exe"], ctx["src_abs"], "-strip",
|
|
1019
|
+
"-filter", _FILTERS[p["filter"]][0],
|
|
1020
|
+
"-resize", geom, ctx["dst_abs"]])
|
|
1021
|
+
if rc != 0:
|
|
1022
|
+
raise SkillError(_classify_backend_err(err), "magick resize 失败",
|
|
1023
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1024
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1025
|
+
else:
|
|
1026
|
+
_pillow_resize(ctx["src_abs"], ctx["dst_abs"],
|
|
1027
|
+
p["width"], p["height"], p["filter"])
|
|
1028
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1029
|
+
_assert_target_size(meta, p["width"], p["height"])
|
|
1030
|
+
return _finish_artifact(ctx, meta)
|
|
1031
|
+
|
|
1032
|
+
|
|
1033
|
+
def _op_convert(ctx):
|
|
1034
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1035
|
+
want = p.get("format")
|
|
1036
|
+
if b["name"] == "magick":
|
|
1037
|
+
rc, _out, err = _spawn([b["exe"], ctx["src_abs"], "-strip", ctx["dst_abs"]])
|
|
1038
|
+
if rc != 0:
|
|
1039
|
+
raise SkillError(_classify_backend_err(err), "magick convert 失败",
|
|
1040
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1041
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1042
|
+
else:
|
|
1043
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1044
|
+
_pillow_save(img, ctx["dst_abs"])
|
|
1045
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1046
|
+
if want and meta["format"] != want:
|
|
1047
|
+
raise SkillError(E_BACKEND_FAIL,
|
|
1048
|
+
"产物格式与目标不符(fail-closed)",
|
|
1049
|
+
{"want": want, "got": meta["format"]})
|
|
1050
|
+
return _finish_artifact(ctx, meta)
|
|
1051
|
+
|
|
1052
|
+
|
|
1053
|
+
def _assert_target_size(meta, w, h):
|
|
1054
|
+
if w is not None and meta["width"] != w:
|
|
1055
|
+
raise SkillError(E_BACKEND_FAIL, "resize 后宽度与目标不符",
|
|
1056
|
+
{"want": w, "got": meta["width"]})
|
|
1057
|
+
if h is not None and meta["height"] != h:
|
|
1058
|
+
raise SkillError(E_BACKEND_FAIL, "resize 后高度与目标不符",
|
|
1059
|
+
{"want": h, "got": meta["height"]})
|
|
1060
|
+
|
|
1061
|
+
|
|
1062
|
+
def _assert_same_size(meta, want, label):
|
|
1063
|
+
if (meta["width"], meta["height"]) != tuple(want):
|
|
1064
|
+
raise SkillError(E_BACKEND_FAIL, f"{label} 后尺寸与目标不符(fail-closed)",
|
|
1065
|
+
{"want": list(want), "got": [meta["width"], meta["height"]]})
|
|
1066
|
+
|
|
1067
|
+
|
|
1068
|
+
def _op_thumbnail(ctx):
|
|
1069
|
+
"""长边缩到 `max_edge`(保持纵横比,可放可缩;判据:最长边 == max_edge)。"""
|
|
1070
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1071
|
+
m = p["max_edge"]
|
|
1072
|
+
if b["name"] == "magick":
|
|
1073
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], "-strip",
|
|
1074
|
+
"-thumbnail", f"{m}x{m}", ctx["dst_abs"]])
|
|
1075
|
+
if rc != 0:
|
|
1076
|
+
raise SkillError(_classify_backend_err(err), "magick thumbnail 失败",
|
|
1077
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1078
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1079
|
+
else:
|
|
1080
|
+
_PIL, Image = _pillow()
|
|
1081
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1082
|
+
w0, h0 = img.size
|
|
1083
|
+
if max(w0, h0) != m:
|
|
1084
|
+
# 本版解释 1:Pillow `thumbnail()` 只缩不放,与判据冲突 → 改用等比 resize
|
|
1085
|
+
s = float(m) / float(max(w0, h0))
|
|
1086
|
+
img = img.resize((max(1, int(round(w0 * s))), max(1, int(round(h0 * s)))),
|
|
1087
|
+
_resample(Image, DEFAULT_FILTER))
|
|
1088
|
+
_pillow_save(img, ctx["dst_abs"])
|
|
1089
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1090
|
+
if max(meta["width"], meta["height"]) != m:
|
|
1091
|
+
raise SkillError(E_BACKEND_FAIL, "thumbnail 后最长边 != max_edge(fail-closed)",
|
|
1092
|
+
{"max_edge": m, "got": [meta["width"], meta["height"]]})
|
|
1093
|
+
return _finish_artifact(ctx, meta)
|
|
1094
|
+
|
|
1095
|
+
|
|
1096
|
+
def _op_crop(ctx):
|
|
1097
|
+
"""裁窗 `x/y/width/height`(判据:产物尺寸 == 裁窗;窗口须整幅落在源内)。"""
|
|
1098
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1099
|
+
x, y, w, h = p["x"], p["y"], p["width"], p["height"]
|
|
1100
|
+
sw, sh = _src_size(ctx)
|
|
1101
|
+
if x + w > sw or y + h > sh:
|
|
1102
|
+
# 本版解释 3:magick 越窗静默裁剪、Pillow 补黑 —— 不判齐 → 先验即拒
|
|
1103
|
+
raise _bad("crop 窗口越出源图(两后端越窗行为不判齐,fail-closed)",
|
|
1104
|
+
{"window": [x, y, w, h], "src": [sw, sh]})
|
|
1105
|
+
if b["name"] == "magick":
|
|
1106
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], "-strip",
|
|
1107
|
+
"-crop", f"{w}x{h}+{x}+{y}", "+repage", ctx["dst_abs"]])
|
|
1108
|
+
if rc != 0:
|
|
1109
|
+
raise SkillError(_classify_backend_err(err), "magick crop 失败",
|
|
1110
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1111
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1112
|
+
else:
|
|
1113
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1114
|
+
_pillow_save(img.crop((x, y, x + w, y + h)), ctx["dst_abs"])
|
|
1115
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1116
|
+
_assert_same_size(meta, (w, h), "crop")
|
|
1117
|
+
return _finish_artifact(ctx, meta)
|
|
1118
|
+
|
|
1119
|
+
|
|
1120
|
+
def _op_rotate(ctx):
|
|
1121
|
+
"""旋转 `degrees`(**本版约定正角 = 顺时针**,见模块 docstring 本版解释 2)。
|
|
1122
|
+
|
|
1123
|
+
判据(契约 §五):90 倍数时尺寸对调;非直角按外接矩形(两后端取值本有差异,
|
|
1124
|
+
故为**容差 3px 的内部门**,非跨后端逐位门)。
|
|
1125
|
+
"""
|
|
1126
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1127
|
+
deg = p["degrees"]
|
|
1128
|
+
sw, sh = _src_size(ctx)
|
|
1129
|
+
if b["name"] == "magick":
|
|
1130
|
+
# 实测:magick `-rotate` 正角即顺时针(与 Pillow 相反),故原样传
|
|
1131
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], "-strip",
|
|
1132
|
+
"-rotate", _fmt_num(deg), ctx["dst_abs"]])
|
|
1133
|
+
if rc != 0:
|
|
1134
|
+
raise SkillError(_classify_backend_err(err), "magick rotate 失败",
|
|
1135
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1136
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1137
|
+
else:
|
|
1138
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1139
|
+
img = img.rotate(-float(deg), expand=True, fillcolor=_rot_bg(img.mode))
|
|
1140
|
+
_pillow_save(img, ctx["dst_abs"])
|
|
1141
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1142
|
+
_assert_rotate_size(meta, sw, sh, deg)
|
|
1143
|
+
return _finish_artifact(ctx, meta)
|
|
1144
|
+
|
|
1145
|
+
|
|
1146
|
+
def _assert_rotate_size(meta, sw, sh, deg):
|
|
1147
|
+
k = int(round(float(deg) / 90.0))
|
|
1148
|
+
if abs(float(deg) - k * 90.0) < 1e-9: # 直角:0/180 同尺寸,90/270 对调
|
|
1149
|
+
want = (sh, sw) if (k % 2) else (sw, sh)
|
|
1150
|
+
_assert_same_size(meta, want, f"rotate({deg:g})")
|
|
1151
|
+
return
|
|
1152
|
+
c = abs(math.cos(math.radians(float(deg))))
|
|
1153
|
+
s = abs(math.sin(math.radians(float(deg))))
|
|
1154
|
+
aw, ah = sw * c + sh * s, sw * s + sh * c
|
|
1155
|
+
if abs(meta["width"] - aw) > 3 or abs(meta["height"] - ah) > 3:
|
|
1156
|
+
raise SkillError(E_BACKEND_FAIL,
|
|
1157
|
+
"rotate 非直角后尺寸偏离外接矩形(容差 3px,fail-closed)",
|
|
1158
|
+
{"analytic": [round(aw, 2), round(ah, 2)],
|
|
1159
|
+
"got": [meta["width"], meta["height"]], "degrees": deg})
|
|
1160
|
+
|
|
1161
|
+
|
|
1162
|
+
def _op_mirror(ctx):
|
|
1163
|
+
"""`flip`(上下)/`flop`(左右)镜像(判据:与源同尺寸 + 镜像像素可断言)。"""
|
|
1164
|
+
b = ctx["backend"]
|
|
1165
|
+
flag, pconst, zh = _MIRROR[ctx["op"]]
|
|
1166
|
+
sw, sh = _src_size(ctx)
|
|
1167
|
+
if b["name"] == "magick":
|
|
1168
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], "-strip", flag, ctx["dst_abs"]])
|
|
1169
|
+
if rc != 0:
|
|
1170
|
+
raise SkillError(_classify_backend_err(err), f"magick {ctx['op']} 失败",
|
|
1171
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1172
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1173
|
+
else:
|
|
1174
|
+
_PIL, Image = _pillow()
|
|
1175
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1176
|
+
_pillow_save(img.transpose(getattr(Image.Transpose, pconst)), ctx["dst_abs"])
|
|
1177
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1178
|
+
_assert_same_size(meta, (sw, sh), f"{zh}镜像")
|
|
1179
|
+
return _finish_artifact(ctx, meta)
|
|
1180
|
+
|
|
1181
|
+
|
|
1182
|
+
def _finish_artifact(ctx, meta):
|
|
1183
|
+
ctx["out_rel"] = ctx["dst_rel"]
|
|
1184
|
+
ctx["out_sha"] = meta["sha256"]
|
|
1185
|
+
ctx["output_meta"] = meta
|
|
1186
|
+
return _result(True, artifact_path=ctx["dst_rel"], asset=meta["sha256"],
|
|
1187
|
+
meta=meta,
|
|
1188
|
+
backend={"name": ctx["backend"]["name"],
|
|
1189
|
+
"version": ctx["backend"]["version"]})
|
|
1190
|
+
|
|
1191
|
+
|
|
1192
|
+
def _op_adjust(ctx):
|
|
1193
|
+
"""亮度/对比度/伽马(判据:参数入台账 + 同参幂等;两后端数学不同源,见本版解释 6)。"""
|
|
1194
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1195
|
+
br, ct, gm = p["brightness"], p["contrast"], p["gamma"]
|
|
1196
|
+
if b["name"] == "magick":
|
|
1197
|
+
args = []
|
|
1198
|
+
if br or ct:
|
|
1199
|
+
args += ["-brightness-contrast", f"{br}x{ct}"]
|
|
1200
|
+
if gm != 1.0:
|
|
1201
|
+
args += ["-gamma", _fmt_num(gm)]
|
|
1202
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], "-strip"] + args + [ctx["dst_abs"]])
|
|
1203
|
+
if rc != 0:
|
|
1204
|
+
raise SkillError(_classify_backend_err(err), "magick adjust 失败",
|
|
1205
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1206
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1207
|
+
else:
|
|
1208
|
+
_PIL, Image = _pillow()
|
|
1209
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1210
|
+
if img.mode not in ("L", "LA", "RGB", "RGBA"):
|
|
1211
|
+
img = img.convert("RGB") # 非常规 mode(P/1/CMYK/I/F)先归一
|
|
1212
|
+
img = img.point(_adj_lut_for(img, _adj_lut(br, ct, gm)))
|
|
1213
|
+
_pillow_save(img, ctx["dst_abs"])
|
|
1214
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1215
|
+
return _finish_artifact(ctx, meta)
|
|
1216
|
+
|
|
1217
|
+
|
|
1218
|
+
def _op_blur(ctx):
|
|
1219
|
+
"""高斯模糊(判据:参数入台账 + 同参幂等)。"""
|
|
1220
|
+
return _sigma_filter(ctx, "magick -blur", "GaussianBlur")
|
|
1221
|
+
|
|
1222
|
+
|
|
1223
|
+
def _op_sharpen(ctx):
|
|
1224
|
+
"""反锐化(判据:参数入台账 + 同参幂等;两后端非逐位等价,见本版解释 7)。"""
|
|
1225
|
+
return _sigma_filter(ctx, "magick -sharpen", "UnsharpMask")
|
|
1226
|
+
|
|
1227
|
+
|
|
1228
|
+
def _sigma_filter(ctx, magick_label, pil_const):
|
|
1229
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1230
|
+
s = p["sigma"]
|
|
1231
|
+
if b["name"] == "magick":
|
|
1232
|
+
flag = "-blur" if ctx["op"] == "blur" else "-sharpen"
|
|
1233
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], "-strip",
|
|
1234
|
+
flag, "0x" + _fmt_num(s), ctx["dst_abs"]])
|
|
1235
|
+
if rc != 0:
|
|
1236
|
+
raise SkillError(_classify_backend_err(err), f"{magick_label} 失败",
|
|
1237
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1238
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1239
|
+
else:
|
|
1240
|
+
_PIL, Image = _pillow()
|
|
1241
|
+
ImageFilter = _pillow_filter_mod()
|
|
1242
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1243
|
+
if img.mode not in ("L", "LA", "RGB", "RGBA"):
|
|
1244
|
+
img = img.convert("RGB")
|
|
1245
|
+
if pil_const == "UnsharpMask":
|
|
1246
|
+
flt = ImageFilter.UnsharpMask(radius=float(s), percent=150, threshold=0)
|
|
1247
|
+
else:
|
|
1248
|
+
flt = ImageFilter.GaussianBlur(float(s))
|
|
1249
|
+
img = img.filter(flt)
|
|
1250
|
+
_pillow_save(img, ctx["dst_abs"])
|
|
1251
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1252
|
+
return _finish_artifact(ctx, meta)
|
|
1253
|
+
|
|
1254
|
+
|
|
1255
|
+
def _op_composite(ctx):
|
|
1256
|
+
"""把 `over_path` 按 `gravity` 叠到 `src` 上(判据:尺寸同 base;合成位置入台账)。
|
|
1257
|
+
|
|
1258
|
+
`opacity`(0..1)在 magick 侧实现为 over 的 alpha 缩放(`-evaluate multiply`),
|
|
1259
|
+
在 Pillow 侧实现为 `putalpha` 缩放 —— 实测 opacity=1 两后端**逐像素相等**,
|
|
1260
|
+
opacity<1 有 ±1 的量化差(不设逐位门)。
|
|
1261
|
+
"""
|
|
1262
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1263
|
+
root = ctx["root"]
|
|
1264
|
+
over_rel, g, op_v = p["over_path"], p["gravity"], p["opacity"]
|
|
1265
|
+
over_abs = safe_join(root, over_rel, what="params.over_path")
|
|
1266
|
+
if not os.path.isfile(over_abs):
|
|
1267
|
+
raise SkillError(E_NOINPUT, "composite.over_path 不存在", {"over_path": over_rel})
|
|
1268
|
+
bw, bh = _src_size(ctx)
|
|
1269
|
+
ow, oh = _size_of(ctx, over_abs)
|
|
1270
|
+
if ow > bw or oh > bh:
|
|
1271
|
+
# 本版解释 4:over 大于 base 时两后端行为不一致(magick 静默裁到 base、Pillow 会平移)
|
|
1272
|
+
raise _bad("composite 的 over 不得大于 base(fail-closed)",
|
|
1273
|
+
{"over": [ow, oh], "base": [bw, bh]})
|
|
1274
|
+
fx, fy = _GRAVITY_F[g]
|
|
1275
|
+
gx, gy = int(round((bw - ow) * fx)), int(round((bh - oh) * fy))
|
|
1276
|
+
if b["name"] == "magick":
|
|
1277
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"],
|
|
1278
|
+
"(", over_abs, "-alpha", "set", "-channel", "A",
|
|
1279
|
+
"-evaluate", "multiply", _fmt_num(op_v), "+channel", ")",
|
|
1280
|
+
"-gravity", g, "-geometry", "+0+0",
|
|
1281
|
+
"-composite", "-strip", ctx["dst_abs"]])
|
|
1282
|
+
if rc != 0:
|
|
1283
|
+
raise SkillError(_classify_backend_err(err), "magick composite 失败",
|
|
1284
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1285
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1286
|
+
else:
|
|
1287
|
+
_PIL, Image = _pillow()
|
|
1288
|
+
base = _open_pillow(ctx["src_abs"])
|
|
1289
|
+
over = _open_pillow(over_abs)
|
|
1290
|
+
had_a = "A" in base.getbands() # 输出 mode 随 base(与 magick 实测一致)
|
|
1291
|
+
base = base.convert("RGBA")
|
|
1292
|
+
over = over.convert("RGBA")
|
|
1293
|
+
if op_v < 1.0:
|
|
1294
|
+
over.putalpha(over.getchannel("A").point(lambda v: int(round(v * op_v))))
|
|
1295
|
+
canvas = base.copy()
|
|
1296
|
+
canvas.alpha_composite(over, dest=(gx, gy))
|
|
1297
|
+
_pillow_save(canvas if had_a else canvas.convert("RGB"), ctx["dst_abs"])
|
|
1298
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1299
|
+
_assert_same_size(meta, (bw, bh), "composite")
|
|
1300
|
+
return _finish_artifact(ctx, meta)
|
|
1301
|
+
|
|
1302
|
+
|
|
1303
|
+
def _op_mask(ctx):
|
|
1304
|
+
"""用 `mask_path` 设 alpha(判据:alpha 通道存在且可读回)。
|
|
1305
|
+
|
|
1306
|
+
本版只落 `mode="set"`(= alpha 取 mask 灰度);写面收窄见模块 docstring 本版解释 5。
|
|
1307
|
+
"""
|
|
1308
|
+
b, p = ctx["backend"], ctx["nparams"]
|
|
1309
|
+
root = ctx["root"]
|
|
1310
|
+
fmt_ext = os.path.splitext(ctx["dst_rel"])[1].lstrip(".").lower()
|
|
1311
|
+
if fmt_ext not in _ALPHA_FMT:
|
|
1312
|
+
raise SkillError(E_UNSUPPORTED_FORMAT,
|
|
1313
|
+
"mask 目标格式须在支持 alpha 的写面内",
|
|
1314
|
+
{"dst_ext": fmt_ext, "alpha_write_face": list(_ALPHA_FMT)})
|
|
1315
|
+
mask_rel = p["mask_path"]
|
|
1316
|
+
mask_abs = safe_join(root, mask_rel, what="params.mask_path")
|
|
1317
|
+
if not os.path.isfile(mask_abs):
|
|
1318
|
+
raise SkillError(E_NOINPUT, "mask.mask_path 不存在", {"mask_path": mask_rel})
|
|
1319
|
+
sw, sh = _src_size(ctx)
|
|
1320
|
+
mw, mh = _size_of(ctx, mask_abs)
|
|
1321
|
+
if (mw, mh) != (sw, sh):
|
|
1322
|
+
raise _bad("mask 与源尺寸不一致(fail-closed:magick 会缩放 mask,Pillow 直接报错)",
|
|
1323
|
+
{"mask": [mw, mh], "src": [sw, sh]})
|
|
1324
|
+
if b["name"] == "magick":
|
|
1325
|
+
rc, _o, err = _spawn([b["exe"], ctx["src_abs"], mask_abs, "-alpha", "off",
|
|
1326
|
+
"-compose", "CopyOpacity", "-composite", "-strip",
|
|
1327
|
+
ctx["dst_abs"]])
|
|
1328
|
+
if rc != 0:
|
|
1329
|
+
raise SkillError(_classify_backend_err(err), "magick mask 失败",
|
|
1330
|
+
{"rc": rc, "stderr": (err or "")[:400]})
|
|
1331
|
+
meta = _magick_meta(b["exe"], ctx["dst_abs"])
|
|
1332
|
+
else:
|
|
1333
|
+
_PIL, Image = _pillow()
|
|
1334
|
+
img = _open_pillow(ctx["src_abs"])
|
|
1335
|
+
if "A" not in img.getbands():
|
|
1336
|
+
img = img.convert("RGBA")
|
|
1337
|
+
img.putalpha(_open_pillow(mask_abs).convert("L"))
|
|
1338
|
+
_pillow_save(img, ctx["dst_abs"])
|
|
1339
|
+
meta = _pillow_meta(ctx["dst_abs"])
|
|
1340
|
+
if "A" not in str(meta.get("mode") or "").upper():
|
|
1341
|
+
# 判据本身(alpha 通道存在)fail-closed 化:产不出 alpha 即失败,不静默放行
|
|
1342
|
+
raise SkillError(E_BACKEND_FAIL, "mask 产物无 alpha 通道(fail-closed)",
|
|
1343
|
+
{"mode": meta.get("mode")})
|
|
1344
|
+
return _finish_artifact(ctx, meta)
|
|
1345
|
+
|
|
1346
|
+
|
|
1347
|
+
_OPS = {
|
|
1348
|
+
"inspect": _op_inspect, "resize": _op_resize, "convert": _op_convert,
|
|
1349
|
+
"thumbnail": _op_thumbnail, "crop": _op_crop, "rotate": _op_rotate,
|
|
1350
|
+
"flip": _op_mirror, "flop": _op_mirror,
|
|
1351
|
+
"adjust": _op_adjust, "blur": _op_blur, "sharpen": _op_sharpen,
|
|
1352
|
+
"composite": _op_composite, "mask": _op_mask,
|
|
1353
|
+
}
|
|
1354
|
+
|
|
1355
|
+
|
|
1356
|
+
# ---------------------------------------------------------------- 入口
|
|
1357
|
+
|
|
1358
|
+
def run(req):
|
|
1359
|
+
"""结构化入口(定稿 §3.1 入参 / §3.2 出参)。
|
|
1360
|
+
|
|
1361
|
+
`req` = dict,键:`op`|`src`|`dst`|`params`|`declared_level`|`caller`|
|
|
1362
|
+
`idempotency_key` + **`sandbox_root`**(**本版解释**:定稿 §3.1 入参清单未列
|
|
1363
|
+
该项,但 §九-#8 判「调用方必须显式给根」——故本版把它实现为入参 dict 的必需键,
|
|
1364
|
+
已列入交付「待核实」)。
|
|
1365
|
+
|
|
1366
|
+
校验次序(**有意如此**,见其下注释):
|
|
1367
|
+
根 → caller → op 已知 → declared_level 派生闸 → op 实现面 → params →
|
|
1368
|
+
src 解析/存在 → dst 派生/解析 → 后端探测 → 执行 → 回读元数据 → 落审计。
|
|
1369
|
+
"""
|
|
1370
|
+
if not isinstance(req, dict):
|
|
1371
|
+
return _err_result(E_BAD_PARAM, "入参须为对象", {"got": type(req).__name__})
|
|
1372
|
+
|
|
1373
|
+
op = req.get("op")
|
|
1374
|
+
root_in = req.get("sandbox_root")
|
|
1375
|
+
caller = req.get("caller")
|
|
1376
|
+
|
|
1377
|
+
# ① 沙箱根:未给即拒(先于一切——否则连台账都无处落)
|
|
1378
|
+
try:
|
|
1379
|
+
root = _check_root(root_in)
|
|
1380
|
+
except SkillError as e:
|
|
1381
|
+
return _err_result(e.code, e.message, e.detail)
|
|
1382
|
+
|
|
1383
|
+
level = derive_level(op)
|
|
1384
|
+
ctx = {
|
|
1385
|
+
"root": root, "op": op, "caller": caller, "backend": None,
|
|
1386
|
+
"dst_rel": None, "out_rel": None, "out_sha": None,
|
|
1387
|
+
"nparams": {}, "output_meta": None,
|
|
1388
|
+
}
|
|
1389
|
+
|
|
1390
|
+
def _fail_and_audit(e, *, input_rel=None, input_sha=None, level_=level,
|
|
1391
|
+
nparams=None, backend=None, backend_note=None):
|
|
1392
|
+
"""失败也落审计(定稿 §四「每次操作」;ok=false + error_code)。"""
|
|
1393
|
+
ver = (backend or {}).get("version")
|
|
1394
|
+
rec = _make_audit(root, op=op if isinstance(op, str) else None,
|
|
1395
|
+
level=level_, input_rel=input_rel,
|
|
1396
|
+
input_sha=input_sha, out_rel=None, out_sha=None,
|
|
1397
|
+
params=nparams or {}, tool_version=ver,
|
|
1398
|
+
caller=caller if isinstance(caller, str) else None,
|
|
1399
|
+
ok=False, error_code=e.code,
|
|
1400
|
+
backend=backend, backend_note=backend_note,
|
|
1401
|
+
sandbox_root=root,
|
|
1402
|
+
idempotency_key=req.get("idempotency_key"))
|
|
1403
|
+
_aw = _audit_write(root, rec)
|
|
1404
|
+
_er = _err_result(e.code, e.message, e.detail, audit_id=rec["audit_id"],
|
|
1405
|
+
backend=backend)
|
|
1406
|
+
if _aw is not None:
|
|
1407
|
+
# #352-C:台账落点不可信 ⇒ 本次不写台账,但**不静默**(结果体带告警)
|
|
1408
|
+
_er["audit_warning"] = _aw
|
|
1409
|
+
return _er
|
|
1410
|
+
|
|
1411
|
+
try:
|
|
1412
|
+
# ② caller 必填(进审计,定稿 §3.1)
|
|
1413
|
+
if not isinstance(caller, str) or not caller.strip():
|
|
1414
|
+
raise _bad("caller 必填非空字符串(进审计)", {"got": repr(caller)})
|
|
1415
|
+
# ③ op 已知
|
|
1416
|
+
if not isinstance(op, str) or op not in LEVEL_MAP:
|
|
1417
|
+
raise SkillError(E_UNSUPPORTED_OP,
|
|
1418
|
+
"op 未知(不在本版 op 表)",
|
|
1419
|
+
{"op": op, "known": list(OPS_KNOWN)})
|
|
1420
|
+
# ④ declared_level 派生闸(定稿 §3.1「等级不可降级」)。**先于实现面判定**:
|
|
1421
|
+
# 「降级」是声明面的违规,与 op 是否已实现无关;先判才使该闸对本版
|
|
1422
|
+
# 留白的 L1/L2 op 同样可判(否则只能落到 E_UNSUPPORTED_OP,闸形同虚设)。
|
|
1423
|
+
dl = req.get("declared_level")
|
|
1424
|
+
if dl is not None:
|
|
1425
|
+
if dl not in _LEVEL_ORDER:
|
|
1426
|
+
raise _bad("declared_level 须为 L0/L1/L2", {"got": repr(dl)})
|
|
1427
|
+
if _LEVEL_ORDER[dl] < _LEVEL_ORDER[level]:
|
|
1428
|
+
raise SkillError(
|
|
1429
|
+
E_LEVEL_DOWNGRADE,
|
|
1430
|
+
"declared_level 低于 op 派生等级(等级不可降级)",
|
|
1431
|
+
{"declared": dl, "derived": level, "op": op})
|
|
1432
|
+
# ⑤ op 实现面(本版范围外 → E_UNSUPPORTED_OP,非出错)
|
|
1433
|
+
if op not in OPS_IMPL:
|
|
1434
|
+
raise SkillError(E_UNSUPPORTED_OP,
|
|
1435
|
+
"op 属本版范围外(范围外集见 OPS_OUT_OF_SCOPE)",
|
|
1436
|
+
{"op": op, "derived_level": level,
|
|
1437
|
+
"implemented": list(OPS_IMPL),
|
|
1438
|
+
"out_of_scope": list(OPS_OUT_OF_SCOPE)})
|
|
1439
|
+
# ⑥ params
|
|
1440
|
+
nparams, mp = _norm_params(op, req.get("params"))
|
|
1441
|
+
ctx["nparams"] = mp
|
|
1442
|
+
# ⑦ src:解析(越界即拒)+ 存在性
|
|
1443
|
+
src_rel = req.get("src")
|
|
1444
|
+
src_abs = safe_join(root, src_rel, what="src")
|
|
1445
|
+
if not os.path.exists(src_abs):
|
|
1446
|
+
raise SkillError(E_NOINPUT, "src 不存在", {"src": src_rel})
|
|
1447
|
+
if not os.path.isfile(src_abs):
|
|
1448
|
+
raise SkillError(E_NOINPUT, "src 不是常规文件", {"src": src_rel})
|
|
1449
|
+
in_sha = _sha256_file(src_abs)
|
|
1450
|
+
src_rel = _rel(src_rel)
|
|
1451
|
+
ctx["src_abs"], ctx["src_rel"], ctx["input_sha"] = src_abs, src_rel, in_sha
|
|
1452
|
+
# ⑧ dst:显式优先;缺省派生;禁覆盖 src(fail-closed,§九-#7)
|
|
1453
|
+
dst_rel = req.get("dst")
|
|
1454
|
+
if dst_rel is None or (isinstance(dst_rel, str) and not dst_rel.strip()):
|
|
1455
|
+
dst_rel = _derive_dst(src_rel, op, nparams,
|
|
1456
|
+
os.path.splitext(src_abs)[1])
|
|
1457
|
+
dst_rel = _rel(dst_rel)
|
|
1458
|
+
dst_abs = safe_join(root, dst_rel, what="dst")
|
|
1459
|
+
if _norm(dst_abs) == _norm(src_abs):
|
|
1460
|
+
raise _bad("dst 不得覆盖 src(fail-closed,定稿 §九-#7)",
|
|
1461
|
+
{"src": src_rel, "dst": dst_rel})
|
|
1462
|
+
# ⑨ 后端探测(两后端皆缺 → E_TOOL_MISSING,fail-closed)
|
|
1463
|
+
name, exe, ver, note = resolve_backend()
|
|
1464
|
+
backend = {"name": name, "version": ver}
|
|
1465
|
+
ctx["backend"] = {"name": name, "exe": exe, "version": ver}
|
|
1466
|
+
# ⑩ 幂等复用(同 key + 同参 + 同输入哈希 → 复用已存产物)
|
|
1467
|
+
if req.get("idempotency_key") is not None and op != "inspect":
|
|
1468
|
+
hit = _find_reuse(root, req.get("idempotency_key"), op, in_sha, nparams)
|
|
1469
|
+
if hit is not None:
|
|
1470
|
+
rec = _make_audit(
|
|
1471
|
+
root, op=op, level=level, input_rel=src_rel, input_sha=in_sha,
|
|
1472
|
+
out_rel=hit["output_path"], out_sha=hit["output_sha256"],
|
|
1473
|
+
params=nparams, tool_version=ver, caller=caller, ok=True,
|
|
1474
|
+
error_code=None, backend=backend, backend_note=note,
|
|
1475
|
+
sandbox_root=root,
|
|
1476
|
+
idempotency_key=req.get("idempotency_key"),
|
|
1477
|
+
extra={"reused_from": hit["audit_id"]},
|
|
1478
|
+
output_meta=hit.get("output_meta"))
|
|
1479
|
+
_aw = _audit_write(root, rec)
|
|
1480
|
+
_rr = _result(True, artifact_path=hit["output_path"],
|
|
1481
|
+
asset=hit["output_sha256"],
|
|
1482
|
+
meta=hit.get("output_meta"), audit_id=rec["audit_id"],
|
|
1483
|
+
backend=backend)
|
|
1484
|
+
if _aw is not None:
|
|
1485
|
+
_rr["audit_warning"] = _aw
|
|
1486
|
+
return _rr
|
|
1487
|
+
# ⑪ dst 父目录(仅限根内,已在 safe_join 验过)按需创建
|
|
1488
|
+
par = os.path.dirname(dst_abs)
|
|
1489
|
+
if par and not os.path.isdir(par):
|
|
1490
|
+
os.makedirs(par, exist_ok=True)
|
|
1491
|
+
ctx["dst_rel"], ctx["dst_abs"] = dst_rel, dst_abs
|
|
1492
|
+
# ⑫ 执行
|
|
1493
|
+
res = _OPS[op](ctx)
|
|
1494
|
+
# ⑬ 审计
|
|
1495
|
+
rec = _make_audit(
|
|
1496
|
+
root, op=op, level=level, input_rel=src_rel, input_sha=in_sha,
|
|
1497
|
+
out_rel=ctx["out_rel"], out_sha=ctx["out_sha"], params=nparams,
|
|
1498
|
+
tool_version=ver, caller=caller, ok=True, error_code=None,
|
|
1499
|
+
backend=backend, backend_note=note, sandbox_root=root,
|
|
1500
|
+
idempotency_key=req.get("idempotency_key"),
|
|
1501
|
+
output_meta=ctx.get("output_meta"))
|
|
1502
|
+
_aw = _audit_write(root, rec)
|
|
1503
|
+
res["audit_id"] = rec["audit_id"]
|
|
1504
|
+
if _aw is not None:
|
|
1505
|
+
# #352-C:台账落点不可信 ⇒ 本次不写台账,但**不静默**(结果体带告警)
|
|
1506
|
+
res["audit_warning"] = _aw
|
|
1507
|
+
return res
|
|
1508
|
+
except SkillError as e:
|
|
1509
|
+
# 已探测到后端时把降级留痕带上
|
|
1510
|
+
bn = None
|
|
1511
|
+
try:
|
|
1512
|
+
if ctx["backend"] and ctx["backend"]["name"] == "pillow" \
|
|
1513
|
+
and resolve_magick() is None:
|
|
1514
|
+
bn = {"from": "magick", "to": "pillow", "reason": E_TOOL_MISSING}
|
|
1515
|
+
except Exception:
|
|
1516
|
+
bn = None
|
|
1517
|
+
return _fail_and_audit(
|
|
1518
|
+
e, input_rel=ctx.get("src_rel"),
|
|
1519
|
+
input_sha=ctx.get("input_sha"),
|
|
1520
|
+
nparams=ctx.get("nparams"),
|
|
1521
|
+
backend=({"name": ctx["backend"]["name"],
|
|
1522
|
+
"version": ctx["backend"]["version"]}
|
|
1523
|
+
if ctx["backend"] else None),
|
|
1524
|
+
backend_note=bn)
|
|
1525
|
+
except PermissionError as e:
|
|
1526
|
+
return _fail_and_audit(SkillError(E_PERM, "OS 权限错误", {"err": str(e)}))
|
|
1527
|
+
except OSError as e:
|
|
1528
|
+
return _fail_and_audit(SkillError(E_BACKEND_FAIL, "OS 错误",
|
|
1529
|
+
{"err": str(e)}))
|
|
1530
|
+
except Exception as e: # fail-closed 兜底
|
|
1531
|
+
return _fail_and_audit(SkillError(E_BACKEND_FAIL, "未预期错误",
|
|
1532
|
+
{"err": repr(e)}))
|
|
1533
|
+
|
|
1534
|
+
|
|
1535
|
+
def _find_reuse(root, key, op, in_sha, nparams):
|
|
1536
|
+
"""同 key + 同 op + 同输入哈希 + 同参 → 复用已成功产物(定稿 §3.1 幂等 key)。"""
|
|
1537
|
+
if key is None:
|
|
1538
|
+
return None
|
|
1539
|
+
for rec in reversed(read_audit(root)):
|
|
1540
|
+
if (rec.get("idempotency_key") == key and rec.get("ok") is True
|
|
1541
|
+
and rec.get("op") == op and rec.get("input_sha256") == in_sha
|
|
1542
|
+
and rec.get("params") == nparams and rec.get("output_path")):
|
|
1543
|
+
# issue #325(2026-10-15 DSH 端):台账落在沙箱根内、**可被任意主体写**,
|
|
1544
|
+
# 故 `output_path` 是不可信输入——必须与同文件其它入口(:1177/:1228/
|
|
1545
|
+
# :1352/:1366)同过 safe_join。修前这里直接 os.path.join:投毒台账把
|
|
1546
|
+
# output_path 写成根外的相对穿越路径,本面就会读到沙箱根外任意可读文件
|
|
1547
|
+
# 并把它的 SHA-256 经 output_sha256 回带出去(存在性探测 + 完整哈希读出)。
|
|
1548
|
+
# 口径同 read_audit 对坏行的处置(_unparsable):越界条目视为**不可复用**,
|
|
1549
|
+
# 但不让整次 run() 失败(台账是不可信输入,坏条目不该造成 DoS)。
|
|
1550
|
+
try:
|
|
1551
|
+
p = safe_join(root, rec["output_path"],
|
|
1552
|
+
what="audit.output_path")
|
|
1553
|
+
except SkillError:
|
|
1554
|
+
continue
|
|
1555
|
+
if os.path.isfile(p) and _sha256_file(p) == rec.get("output_sha256"):
|
|
1556
|
+
return rec
|
|
1557
|
+
return None
|
|
1558
|
+
|
|
1559
|
+
|
|
1560
|
+
# ---------------------------------------------------------------- CLI 入口
|
|
1561
|
+
#
|
|
1562
|
+
# 暴露面(契约 §十二):**不新增 MCP op**(沿 §九-#5)——本版给库一个「人/脚本可显式
|
|
1563
|
+
# 调用」的入口:`python -X utf8 -m md_cg.imgskill <op> [参数]`。CLI **只做入参搬运**:
|
|
1564
|
+
# 把命令行映射成 `run(req)` 的入参 dict;**校验/执行/审计全在 `run()` 同一条路径内**,
|
|
1565
|
+
# 此处不另写一份逻辑(故 CLI 与库调用不可能分叉)。docs/eval 契约 §十二 记该决定。
|
|
1566
|
+
|
|
1567
|
+
_CLI_DEFAULT_CALLER = "cli:imgskill"
|
|
1568
|
+
|
|
1569
|
+
#: 每个已实现 op 的命令行参数表:`op -> ((旗标, dest, 类型, 必填, 帮助), ...)`。
|
|
1570
|
+
#: **只声明「有哪些参数、什么标量类型」,不声明取值域**——取值域与校验仍归
|
|
1571
|
+
#: `run()`/`_norm_params`(避免两处各写一份参数规则而漂移)。类型仅做命令行标量转换
|
|
1572
|
+
#: (`int`/`float`/`str`)——不转换的话 `_norm_params` 会把 `"512"` 判成非整数而拒。
|
|
1573
|
+
_CLI_OPS = {
|
|
1574
|
+
"inspect": (),
|
|
1575
|
+
"resize": (("--width", "width", int, False, "目标宽(与/或 --height;缺省保持纵横比)"),
|
|
1576
|
+
("--height", "height", int, False, "目标高"),
|
|
1577
|
+
("--filter", "filter", str, False, "重采样滤波器(缺省 lanczos)")),
|
|
1578
|
+
"convert": (("--format", "format", str, False, "目标格式(缺省由 --dst 后缀定)"),),
|
|
1579
|
+
"thumbnail": (("--max-edge", "max_edge", int, True, "长边目标像素数"),),
|
|
1580
|
+
"crop": (("--x", "x", int, False, "裁窗左(缺省 0)"),
|
|
1581
|
+
("--y", "y", int, False, "裁窗上(缺省 0)"),
|
|
1582
|
+
("--width", "width", int, True, "裁窗宽"),
|
|
1583
|
+
("--height", "height", int, True, "裁窗高")),
|
|
1584
|
+
"rotate": (("--degrees", "degrees", float, True, "旋转角度(本版约定正角=顺时针)"),),
|
|
1585
|
+
"flip": (("--axis", "axis", str, False, "轴同义确认项(vertical)"),),
|
|
1586
|
+
"flop": (("--axis", "axis", str, False, "轴同义确认项(horizontal)"),),
|
|
1587
|
+
"adjust": (("--brightness", "brightness", int, False, "亮度百分比 ±100"),
|
|
1588
|
+
("--contrast", "contrast", int, False, "对比度百分比 ±100"),
|
|
1589
|
+
("--gamma", "gamma", float, False, "伽马 (0, 10]")),
|
|
1590
|
+
"blur": (("--sigma", "sigma", float, True, "高斯 sigma (0, 100]"),),
|
|
1591
|
+
"sharpen": (("--sigma", "sigma", float, True, "反锐化 sigma (0, 100]"),),
|
|
1592
|
+
"composite": (("--over-path", "over_path", str, True, "叠加图路径(相对沙箱根)"),
|
|
1593
|
+
("--gravity", "gravity", str, False, "落位 gravity(缺省 center)"),
|
|
1594
|
+
("--opacity", "opacity", float, False, "不透明度 [0, 1](缺省 1.0)")),
|
|
1595
|
+
"mask": (("--mask-path", "mask_path", str, True, "mask 路径(相对沙箱根)"),
|
|
1596
|
+
("--mode", "mode", str, False, "mask 模式(本版只 set)")),
|
|
1597
|
+
}
|
|
1598
|
+
|
|
1599
|
+
_CLI_EPILOG = "\n".join((
|
|
1600
|
+
"示例(沙箱根与所有路径一律由调用方显式给——无隐式默认根,契约 §九-#8):",
|
|
1601
|
+
" python -X utf8 -m md_cg.imgskill inspect <源> --root <沙箱根>",
|
|
1602
|
+
" python -X utf8 -m md_cg.imgskill resize <源> --width 256 --root <沙箱根>",
|
|
1603
|
+
" python -X utf8 -m md_cg.imgskill convert <源> --format webp --root <沙箱根>",
|
|
1604
|
+
"",
|
|
1605
|
+
"路径口径:<源>/--dst/--over-path/--mask-path 一律**相对沙箱根**解析(绝对路径、或经 ..",
|
|
1606
|
+
"逃出根 → E_PATH_OUT_OF_SCOPE)——故要处理仓内文件须先拷入沙箱根;直接给仓内相对路径",
|
|
1607
|
+
"会被解析成 <根>/<该相对路径> 而返 E_NOINPUT(不是「找不到该功能」)。",
|
|
1608
|
+
"",
|
|
1609
|
+
"全局项(--root/--caller/--level/--idempotency-key)在 op 前后皆可;",
|
|
1610
|
+
"每个 op 的参数见 `python -X utf8 -m md_cg.imgskill <op> --help`。",
|
|
1611
|
+
"本版实现 op:" + "/".join(OPS_IMPL),
|
|
1612
|
+
"本版范围外 op(库面 run() 对之返 E_UNSUPPORTED_OP;**CLI 上这些名字不是子命令**,",
|
|
1613
|
+
"敲了得到 argparse 用法错 rc=2——该差异见契约 §十二):" + "/".join(OPS_OUT_OF_SCOPE),
|
|
1614
|
+
))
|
|
1615
|
+
|
|
1616
|
+
|
|
1617
|
+
def _cli_common_parent():
|
|
1618
|
+
"""公共项(供子命令副本用;`default=SUPPRESS` 使「op 前给的全局值」不被抹掉)。"""
|
|
1619
|
+
c = argparse.ArgumentParser(add_help=False)
|
|
1620
|
+
c.add_argument("--root", metavar="DIR",
|
|
1621
|
+
help="沙箱根(**无隐式默认根**:未给即 run() 拒 E_BAD_PARAM,§九-#8)")
|
|
1622
|
+
c.add_argument("--caller", metavar="NAME", help="调用者标识(进审计)")
|
|
1623
|
+
c.add_argument("--level", choices=(L0, L1, L2), metavar="{L0,L1,L2}",
|
|
1624
|
+
help="declared_level(低于 op 派生等级 → 拒 E_LEVEL_DOWNGRADE)")
|
|
1625
|
+
c.add_argument("--idempotency-key", dest="idempotency_key", metavar="KEY",
|
|
1626
|
+
help="同 key 同参可复用已存产物")
|
|
1627
|
+
for a in c._actions: # 副本不设默认:未显式给就不落属性
|
|
1628
|
+
a.default = argparse.SUPPRESS
|
|
1629
|
+
return c
|
|
1630
|
+
|
|
1631
|
+
|
|
1632
|
+
def build_parser():
|
|
1633
|
+
"""构造 CLI 解析器(`--help` 列 op 与每 op 的参数)。**不在此校验取值**。"""
|
|
1634
|
+
ap = argparse.ArgumentParser(
|
|
1635
|
+
prog="python -X utf8 -m md_cg.imgskill",
|
|
1636
|
+
description="图像 Skill(Image Skill)命令行入口——把命令行搬运成 run(req)。",
|
|
1637
|
+
epilog=_CLI_EPILOG,
|
|
1638
|
+
formatter_class=argparse.RawDescriptionHelpFormatter)
|
|
1639
|
+
ap.add_argument("--root", metavar="DIR",
|
|
1640
|
+
help="沙箱根(**无隐式默认根**:未给即 run() 拒 E_BAD_PARAM,§九-#8)")
|
|
1641
|
+
ap.add_argument("--caller", metavar="NAME", default=_CLI_DEFAULT_CALLER,
|
|
1642
|
+
help="调用者标识(进审计;缺省 %(default)s)")
|
|
1643
|
+
ap.add_argument("--level", choices=(L0, L1, L2), metavar="{L0,L1,L2}",
|
|
1644
|
+
help="declared_level(低于 op 派生等级 → 拒 E_LEVEL_DOWNGRADE)")
|
|
1645
|
+
ap.add_argument("--idempotency-key", dest="idempotency_key", metavar="KEY",
|
|
1646
|
+
help="同 key 同参可复用已存产物")
|
|
1647
|
+
parent = _cli_common_parent()
|
|
1648
|
+
sub = ap.add_subparsers(dest="op", metavar="OP")
|
|
1649
|
+
for op in OPS_IMPL: # 覆盖全部已实现 op(顺序即 OPS_IMPL)
|
|
1650
|
+
sp = sub.add_parser(op, parents=[parent], help=f"{op} 操作",
|
|
1651
|
+
description=f"{op} 操作(校验/执行/审计均走 run())")
|
|
1652
|
+
sp.add_argument("src", metavar="SRC", help="源路径(相对沙箱根,UTF-8)")
|
|
1653
|
+
sp.add_argument("--dst", metavar="DST", default=None,
|
|
1654
|
+
help="产物路径(相对沙箱根;缺省由 op+params 派生)")
|
|
1655
|
+
for flag, dest, kind, required, help_ in _CLI_OPS[op]:
|
|
1656
|
+
sp.add_argument(flag, dest=dest, type=kind, required=required,
|
|
1657
|
+
default=None, help=help_)
|
|
1658
|
+
return ap
|
|
1659
|
+
|
|
1660
|
+
|
|
1661
|
+
def _cli_params(op, args):
|
|
1662
|
+
"""把已解析的命令行搬成 `params` dict(**不校验**——校验在 `run()`/`_norm_params`)。
|
|
1663
|
+
|
|
1664
|
+
`inspect` 无参;`resize` 恒带 width/height(None 合法,交 `run()` 判「不得皆缺」);
|
|
1665
|
+
其余 op **只送用户显式给的非 None 取值**,缺省值由 `run()` 内补齐。
|
|
1666
|
+
"""
|
|
1667
|
+
if op == "inspect":
|
|
1668
|
+
return {}
|
|
1669
|
+
if op == "resize":
|
|
1670
|
+
p = {"width": args.width, "height": args.height}
|
|
1671
|
+
if args.filter is not None:
|
|
1672
|
+
p["filter"] = args.filter
|
|
1673
|
+
return p
|
|
1674
|
+
out = {}
|
|
1675
|
+
for _flag, dest, _kind, _req, _h in _CLI_OPS[op]:
|
|
1676
|
+
v = getattr(args, dest)
|
|
1677
|
+
if v is not None:
|
|
1678
|
+
out[dest] = v
|
|
1679
|
+
return out
|
|
1680
|
+
|
|
1681
|
+
|
|
1682
|
+
def cli_main(argv=None):
|
|
1683
|
+
"""CLI 主入口:解析 → 组 `req` → 调 `run()` → 打印 JSON → 退出码。
|
|
1684
|
+
|
|
1685
|
+
退出码:0 = `run()` 返回 `ok=true`;1 = `ok=false`(错误码在 stdout 的 JSON `error`
|
|
1686
|
+
里,可机械分支);2 = 未给 op(用法错,打印帮助)。
|
|
1687
|
+
"""
|
|
1688
|
+
ap = build_parser()
|
|
1689
|
+
args = ap.parse_args(argv)
|
|
1690
|
+
if not args.op:
|
|
1691
|
+
ap.print_help(sys.stderr)
|
|
1692
|
+
return 2
|
|
1693
|
+
req = {"op": args.op, "src": args.src,
|
|
1694
|
+
"params": _cli_params(args.op, args),
|
|
1695
|
+
"sandbox_root": getattr(args, "root", None),
|
|
1696
|
+
"caller": getattr(args, "caller", _CLI_DEFAULT_CALLER)}
|
|
1697
|
+
dst = getattr(args, "dst", None)
|
|
1698
|
+
if dst is not None:
|
|
1699
|
+
req["dst"] = dst
|
|
1700
|
+
level = getattr(args, "level", None)
|
|
1701
|
+
if level is not None:
|
|
1702
|
+
req["declared_level"] = level
|
|
1703
|
+
key = getattr(args, "idempotency_key", None)
|
|
1704
|
+
if key is not None:
|
|
1705
|
+
req["idempotency_key"] = key
|
|
1706
|
+
res = run(req)
|
|
1707
|
+
print(json.dumps(res, ensure_ascii=False, sort_keys=True))
|
|
1708
|
+
return 0 if res.get("ok") else 1
|
|
1709
|
+
|
|
1710
|
+
|
|
1711
|
+
if __name__ == "__main__": # CLI 入口钩子(守卫「结构防悬空」锚点)
|
|
1712
|
+
raise SystemExit(cli_main())
|