@furongjun1999/dsh-memory 0.9.6 → 0.9.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
@@ -1,418 +1,418 @@
1
- # -*- coding: utf-8 -*-
2
- # 功能名:imgskill 审计台账落点不得跟随符号链接写到沙箱根外(issue #352-C)
3
- # 生效条件:python -X utf8 -m md_cg.test_issue352_imgaudit [--mutate];被测面=md_cg/imgskill.py 的 audit_path/_audit_write/read_audit/_audit_seq
4
- # 子功能:A 组=根内 .imgskill 指向根外时 run() 照常返回、台账不落根外、结果体带 audit_warning、audit_path(strict) 抛 E_PATH_OUT_OF_SCOPE、读面不跟随;K 组=非恒真对照(正常台账照写照读、幂等复用面不受影响、目录尚未创建时不误拒);E 组=源码面单点
5
- # 执行:在临时沙箱根内把 .imgskill 造成指向根外的**目录链接**(POSIX=symlink,Windows=junction——junction 不需特权而 open() 同样跟随,本机实测),随后调 md_cg.imgskill.run()/_find_reuse()
6
- # 验证方式:全部 PASS 即通过;--mutate 走镜像树定点变异,变异后红项必须**恰为**预期集合
7
- # 不适用条件:①不判台账完整性(HMAC/签名)②不判台账落点搬迁(移到 aux_root 属设计决定)③不判台账被「换内容」的投毒面(#325 读方向已覆盖)④不覆盖「末段是符号链接」的实机腿——本机无 SeCreateSymbolicLinkPrivilege(已实测),该腿在有权限的宿主上自动启用,无权限时按源码面单点(E1)钉住
8
- """issue #352-C 守卫:台账落点不得跟随链接写到沙箱根外。
9
-
10
- 病象(修前):`audit_path` 只有一句 `os.path.join(root, AUDIT_REL)`,而
11
- `_audit_write` 用 `open(p, "a")` **跟随符号链接**。沙箱根内可写者只做一步
12
- (把 `.imgskill` 目录或 `.imgskill/audit.jsonl` 换成链接),受害者下一次**合法**
13
- 调用就会把一行审计 JSON 追加到根外任意可写文件——目标是 `json.dump` 写的整文件
14
- JSON 时该文件从此解析失败(报告实测:指向 `MDCG_TOKEN_FILE` 后 MCP 服务重启
15
- rc=3 退出)。`read_audit` / `_audit_seq` 同样跟随链接**读**根外文件。
16
-
17
- 处置(真源复用):落点判定一律走同文件既有的 `safe_join`(realpath +
18
- commonpath,与 src/dst 同一份实现),上段/末段各补一次 `os.path.islink` 显式判;
19
- 写面用 `os.open(..., O_NOFOLLOW)`(平台无该标志时取 0)。
20
-
21
- ★**fail-open 还是 fail-closed**:报告把这一条列为维护者裁定。本实现取
22
- **fail-open + 可观测告警**——台账落点不可信时 `run()` 照常返回结果,只是不写
23
- 台账并在结果体带 `audit_warning`(读面按空表计)。理由:imgskill 不经 MCP 暴露,
24
- 把本地可信边界问题升级成「一个可写者建个链接就让所有合法调用失败」的拒服务面
25
- 得不偿失;且报告给的边界本就是「可人工删掉追加行恢复」。**不静默**是硬要求——
26
- M3 变异(摘掉告警回填)必须打红 C1。
27
-
28
- ★**过度收紧方向**:K1(正常台账照写照读)、K2(幂等复用面不受影响)、
29
- K3(`.imgskill` 目录尚未创建时不得误拒)三条盯住「修复没把正常面一起关掉」。
30
- """
31
- import hashlib
32
- import inspect
33
- import json
34
- import os
35
- import shutil
36
- import struct
37
- import subprocess
38
- import sys
39
- import tempfile
40
- import zlib
41
-
42
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
43
-
44
- _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
45
- sys.path.insert(0, _REPO)
46
- from md_cg import imgskill as _I # noqa: E402
47
-
48
- FAILS = []
49
- _SKIPPED = []
50
-
51
-
52
- def _check(name, cond, detail=""):
53
- if cond:
54
- print(" PASS " + name)
55
- else:
56
- print(" FAIL " + name + " " + str(detail)[:400])
57
- FAILS.append(name)
58
-
59
-
60
- _TMP = tempfile.mkdtemp(prefix="iss352c_")
61
-
62
-
63
- def _png(path, w=8, h=8):
64
- ch = lambda t, d: (struct.pack(">I", len(d)) + t + d
65
- + struct.pack(">I", zlib.crc32(t + d) & 0xffffffff))
66
- raw = b"".join(b"\x00" + b"\xff\x00\x00" * w for _ in range(h))
67
- with open(path, "wb") as f:
68
- f.write(b"\x89PNG\r\n\x1a\n"
69
- + ch(b"IHDR", struct.pack(">IIBBBBB", w, h, 8, 2, 0, 0, 0))
70
- + ch(b"IDAT", zlib.compress(raw)) + ch(b"IEND", b""))
71
-
72
-
73
- def _sandbox(tag):
74
- base = os.path.join(_TMP, tag)
75
- root = os.path.join(base, "sandbox")
76
- out = os.path.join(base, "outside")
77
- os.makedirs(root)
78
- os.makedirs(out)
79
- _png(os.path.join(root, "a.png"))
80
- return base, root, out
81
-
82
-
83
- def _dir_link(link, target):
84
- """把 link 造成指向 target 的**目录链接**。
85
-
86
- POSIX 用 `os.symlink`;Windows 用 `mklink /J`(junction)——junction
87
- **不需要 SeCreateSymbolicLinkPrivilege**(本机 `os.symlink` 实测
88
- WinError 1314 拒绝,junction 成功),而 `open()` 与 `realpath` 对它的行为
89
- 与符号链接一致(本机实测:跟随写入成立、realpath 解析到链接目标)。
90
- 故这条腿在两个平台上都是**真实**复现,不是桩。
91
- """
92
- if os.name == "nt":
93
- # 文本模式子进程必须显式声明编码(scripts 的编码守卫要求;不依赖 locale)。
94
- pr = subprocess.run(["cmd", "/c", "mklink", "/J", link, target],
95
- capture_output=True, text=True,
96
- encoding="utf-8", errors="replace")
97
- return pr.returncode == 0
98
- try:
99
- os.symlink(target, link, target_is_directory=True)
100
- return True
101
- except OSError:
102
- return False
103
-
104
-
105
- def _file_link(link, target):
106
- try:
107
- os.symlink(target, link)
108
- return True
109
- except OSError:
110
- return False
111
-
112
-
113
- def _run(root, **extra):
114
- req = {"op": "inspect", "src": "a.png", "sandbox_root": root,
115
- "caller": "victim"}
116
- req.update(extra)
117
- try:
118
- return _I.run(req)
119
- except Exception as exc: # noqa: BLE001
120
- return {"_raised": "%s: %s" % (type(exc).__name__, exc)}
121
-
122
-
123
- def _sha(path):
124
- with open(path, "rb") as f:
125
- return hashlib.sha256(f.read()).hexdigest()
126
-
127
-
128
- # 能力探测:末段文件符号链接是否可建(本机无 SeCreateSymbolicLinkPrivilege)
129
- _T = tempfile.mkdtemp(prefix="iss352c_cap_")
130
- open(os.path.join(_T, "tgt"), "w", encoding="utf-8").close()
131
- _FILE_LINK_OK = _file_link(os.path.join(_T, "lnk"), os.path.join(_T, "tgt"))
132
- print(" [能力] 文件符号链接可建=%s(Windows 无特权时 False;目录链接走 junction,恒可用)"
133
- % _FILE_LINK_OK)
134
-
135
- print("== A 组:台账落点跟随链接 ==")
136
-
137
- # --- C1:.imgskill 目录指向根外 ---
138
- _b, _root, _out = _sandbox("c1")
139
- _link_ok = _dir_link(os.path.join(_root, ".imgskill"), _out)
140
- _res = _run(_root)
141
- _out_ledger = os.path.join(_out, "audit.jsonl")
142
- print(" [读数] C1 目录链接=%s run=%s 根外台账=%s 告警=%s"
143
- % (_link_ok, {k: _res.get(k) for k in ("ok", "error")},
144
- os.path.exists(_out_ledger),
145
- bool(_res.get("audit_warning"))))
146
- _check("C1 .imgskill 指向根外:run() 照常返回结果(不拒服务)、台账不落根外、"
147
- "结果体带 audit_warning(不静默)",
148
- _link_ok and "_raised" not in _res
149
- and not os.path.exists(_out_ledger)
150
- and bool(_res.get("audit_warning"))
151
- and bool(_res.get("audit_id")), (_res, os.path.exists(_out_ledger)))
152
-
153
- # --- C4:audit_path(strict) 对不可信落点抛 E_PATH_OUT_OF_SCOPE ---
154
- _c4 = None
155
- try:
156
- _I.audit_path(_root)
157
- _c4 = "未抛"
158
- except _I.SkillError as _e:
159
- _c4 = _e.code
160
- _check("C4 audit_path(root) 对链接落点抛 E_PATH_OUT_OF_SCOPE(fail-closed 调用方可用)",
161
- _c4 == _I.E_PATH_OUT_OF_SCOPE and _I.audit_path(_root, strict=False) is None,
162
- _c4)
163
-
164
- # --- C3:读面不跟随链接去读根外台账(含投毒条目)---
165
- _poison = {"idempotency_key": "k352", "ok": True, "op": "inspect",
166
- "input_sha256": _sha(os.path.join(_root, "a.png")), "params": {},
167
- "output_path": "a.png",
168
- "output_sha256": _sha(os.path.join(_root, "a.png")),
169
- "audit_id": "audit_poison"}
170
- with open(_out_ledger, "w", encoding="utf-8") as f:
171
- f.write(json.dumps(_poison, ensure_ascii=False) + "\n")
172
- _rows = _I.read_audit(_root)
173
- _hit = _I._find_reuse(_root, "k352", "inspect",
174
- _poison["input_sha256"], {})
175
- print(" [读数] C3 读面条目=%d _find_reuse=%s(均须为空)"
176
- % (len(_rows), _hit))
177
- _check("C3 读面不跟随链接:read_audit 按空表计、_find_reuse 不复用根外台账条目",
178
- _rows == [] and _hit is None, (_rows, _hit))
179
-
180
- # --- C2:末段(audit.jsonl 本身)是符号链接 ---
181
- if _FILE_LINK_OK:
182
- _b2, _root2, _out2 = _sandbox("c2")
183
- _victim = os.path.join(_out2, "tokens.json")
184
- with open(_victim, "w", encoding="utf-8") as f:
185
- json.dump({"tokens": {"abc": {"role": "designer"}}}, f)
186
- os.makedirs(os.path.join(_root2, ".imgskill"))
187
- _lk = _file_link(os.path.join(_root2, ".imgskill", "audit.jsonl"), _victim)
188
- _res2 = _run(_root2)
189
- _raw = open(_victim, encoding="utf-8").read()
190
- try:
191
- json.loads(_raw)
192
- _parses = True
193
- except ValueError:
194
- _parses = False
195
- print(" [读数] C2 末段链接=%s 根外 JSON 仍可解析=%s 含 audit_id=%s 告警=%s"
196
- % (_lk, _parses, "audit_id" in _raw, bool(_res2.get("audit_warning"))))
197
- _check("C2 末段是符号链接:根外整文件 JSON 不被追加破坏",
198
- _lk and _parses and "audit_id" not in _raw
199
- and bool(_res2.get("audit_warning")), _raw[:120])
200
- else:
201
- _SKIPPED.append("C2")
202
- print(" [跳过] C2 末段符号链接腿:本机无 SeCreateSymbolicLinkPrivilege"
203
- "(os.symlink 实测 WinError 1314)——该腿在有权限的宿主上自动启用,"
204
- "此处由源码面单点 E1 兜底")
205
-
206
- # ========================================================= K 组:非恒真对照
207
- print("== K 组:非恒真对照(含**过度收紧**方向)==")
208
-
209
- # --- K1:正常沙箱:台账照写照读、结果体无告警 ---
210
- _kb, _kroot, _kout = _sandbox("k1")
211
- _kres = _run(_kroot)
212
- _kp = _I.audit_path(_kroot)
213
- _krows = _I.read_audit(_kroot)
214
- print(" [读数] K1 run=%s 台账路径在根内=%s 条目=%d 告警=%s"
215
- % ({k: _kres.get(k) for k in ("ok", "error")},
216
- bool(_kp) and not os.path.relpath(_kp, _kroot).startswith(".."),
217
- len(_krows), _kres.get("audit_warning")))
218
- _check("K1 正常沙箱(无链接):台账照常写入可读回、结果体**无** audit_warning",
219
- "_raised" not in _kres and os.path.isfile(_kp) and len(_krows) >= 1
220
- and _kres.get("audit_warning") is None
221
- and bool(_kres.get("audit_id")), (_kres, _kp))
222
-
223
- # --- K2:正常沙箱:幂等复用面不受影响(#325 的 safe_join 未回退)---
224
- _krec = {"idempotency_key": "kk352", "ok": True, "op": "inspect",
225
- "input_sha256": _sha(os.path.join(_kroot, "a.png")), "params": {},
226
- "output_path": "a.png",
227
- "output_sha256": _sha(os.path.join(_kroot, "a.png")),
228
- "audit_id": "audit_k2"}
229
- with open(_kp, "a", encoding="utf-8") as f:
230
- f.write(json.dumps(_krec, ensure_ascii=False) + "\n")
231
- _khit = _I._find_reuse(_kroot, "kk352", "inspect", _krec["input_sha256"], {})
232
- _check("K2 正常台账仍可复用(幂等面不因本次收口而失效)",
233
- isinstance(_khit, dict) and _khit.get("audit_id") == "audit_k2", _khit)
234
-
235
- # --- K3:.imgskill 目录**尚不存在**时不得误拒(过度收紧方向)---
236
- _kb3, _kroot3, _ = _sandbox("k3")
237
- _p3 = _I.audit_path(_kroot3)
238
- _res3 = _run(_kroot3)
239
- _p3b = _I.audit_path(_kroot3)
240
- print(" [读数] K3 目录未建时 audit_path=%s 事后条目=%d"
241
- % (bool(_p3), len(_I.read_audit(_kroot3))))
242
- _check("K3 .imgskill 目录尚未创建时不误拒:audit_path 仍返根内路径、run() 能建目录写入",
243
- _p3 is not None and os.path.isfile(_p3b)
244
- and len(_I.read_audit(_kroot3)) >= 1
245
- and not str(_res3.get("audit_warning") or ""), (_p3, _p3b))
246
-
247
- # ========================================================= E 组:源码面单点
248
- print("== E 组:源码面单点 ==")
249
- _src_ap = inspect.getsource(_I.audit_path)
250
- _src_aw = inspect.getsource(_I._audit_write)
251
- _src_ra = inspect.getsource(_I.read_audit)
252
- _src_as = inspect.getsource(_I._audit_seq)
253
- _src_fr = inspect.getsource(_I._find_reuse)
254
- _check("E1 落点判定走 safe_join 真源 + 上段/末段 islink 显式判",
255
- 'safe_join(root, AUDIT_REL, what="audit_path")' in _src_ap
256
- and "os.path.islink(d)" in _src_ap and "os.path.islink(p)" in _src_ap)
257
- _check("E2 写面用 os.open + O_NOFOLLOW(不再裸 open(p, 'a'))",
258
- "os.open(p, flags, 0o600)" in _src_aw and "O_NOFOLLOW" in _src_aw)
259
- _check("E3 读面(read_audit/_audit_seq)走同一判定、不可信即按空表",
260
- "audit_path(root, strict=False)" in _src_ra
261
- and "audit_path(root, strict=False)" in _src_as)
262
- _check("E4 #325 的 safe_join 收口未回退(_find_reuse 仍过 safe_join)",
263
- 'safe_join(root, rec["output_path"]' in _src_fr)
264
-
265
- shutil.rmtree(_TMP, ignore_errors=True)
266
-
267
- print("")
268
- if FAILS:
269
- print("issue #352-C 结果:%d 失败 → %s" % (len(FAILS), ", ".join(FAILS)))
270
- else:
271
- print("issue #352-C 结果:全部通过(跳过腿:%s)"
272
- % (",".join(_SKIPPED) or "无"))
273
-
274
- # ------------------------------------------------------------- 定点变异(镜像树)
275
- _EXP_M1 = ("C1", "C3", "C4", "E1") + (("C2",) if _FILE_LINK_OK else ())
276
- _MUTATIONS = (
277
- ("M1 摘掉落点判定(回到 os.path.join + open 跟随链接的修前形态)",
278
- (("md_cg/imgskill.py",
279
- [' if os.path.islink(d):',
280
- ' why = "%s 是符号链接(台账落点不得经链接指向沙箱根外)" % os.path.dirname(rel)',
281
- ' elif os.path.islink(p):',
282
- ' why = "%s 是符号链接(台账落点不得经链接指向沙箱根外)" % rel',
283
- ' else:',
284
- ' try:',
285
- ' cand = safe_join(root, AUDIT_REL, what="audit_path")',
286
- ' except SkillError as exc:',
287
- ' why = exc.message'],
288
- [' if False:',
289
- ' why = None',
290
- ' else:',
291
- ' cand = os.path.join(root, AUDIT_REL)']),),
292
- _EXP_M1),
293
- ("M2 写面摘掉 O_NOFOLLOW(回到跟随链接的 open 口径)",
294
- (("md_cg/imgskill.py",
295
- [' flags = (os.O_WRONLY | os.O_APPEND | os.O_CREAT',
296
- ' | getattr(os, "O_NOFOLLOW", 0))',
297
- ' fd = os.open(p, flags, 0o600)'],
298
- [' fd = os.open(p, os.O_WRONLY | os.O_APPEND | os.O_CREAT, 0o600)']),),
299
- ("E2",)),
300
- ("M3 摘掉结果体的告警回填(落点不可信重新变成**静默**不写)",
301
- (("md_cg/imgskill.py",
302
- [' if _aw is not None:',
303
- ' # #352-C:台账落点不可信 ⇒ 本次不写台账,但**不静默**(结果体带告警)',
304
- ' res["audit_warning"] = _aw'],
305
- [' pass']),),
306
- ("C1",)),
307
- ("M4 读面回退成直接拼接(跟随链接读根外台账)",
308
- (("md_cg/imgskill.py",
309
- [' p = audit_path(root, strict=False)',
310
- ' if p is None or not os.path.exists(p):',
311
- ' return []'],
312
- [' p = os.path.join(root, AUDIT_REL)',
313
- ' if not os.path.exists(p):',
314
- ' return []']),),
315
- ("C3", "E3")),
316
- )
317
-
318
-
319
- def _mirror_build():
320
- dst = tempfile.mkdtemp(prefix="iss352c_mut_")
321
- for name in ("md_cg", "scripts"):
322
- src = os.path.join(_REPO, name)
323
- if os.path.isdir(src):
324
- shutil.copytree(src, os.path.join(dst, name),
325
- ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
326
- for name in sorted(os.listdir(_REPO)):
327
- p = os.path.join(_REPO, name)
328
- if os.path.isfile(p) and name.endswith(".py"):
329
- shutil.copy2(p, os.path.join(dst, name))
330
- return dst
331
-
332
-
333
- def _nl_of(path):
334
- with open(path, "rb") as fh:
335
- raw = fh.read(8192)
336
- return "\r\n" if b"\r\n" in raw else "\n"
337
-
338
-
339
- def _run_in(tree):
340
- env = dict(os.environ)
341
- env["PYTHONPATH"] = tree
342
- env["PYTHONUTF8"] = "1"
343
- env["PYTHONDONTWRITEBYTECODE"] = "1"
344
- pr = subprocess.run([sys.executable, "-X", "utf8", "-m",
345
- "md_cg.test_issue352_imgaudit"],
346
- capture_output=True, text=True, encoding="utf-8",
347
- errors="replace", cwd=tree, env=env, timeout=1800)
348
- out = (pr.stdout or "") + (pr.stderr or "")
349
- reds = [ln.split("FAIL ", 1)[1].strip()
350
- for ln in out.splitlines() if "FAIL " in ln]
351
- return pr.returncode, reds, out
352
-
353
-
354
- def _mutate():
355
- print("!! 定点变异自证:把修复点改回改动前形态,守卫必须转红")
356
- tree = _mirror_build()
357
- try:
358
- rc, reds, out = _run_in(tree)
359
- print(" 未变异镜像基线:rc=%d 红项=%d(必须 rc=0 且 0 红)" % (rc, len(reds)))
360
- if rc != 0 or reds:
361
- print(chr(10).join(out.splitlines()[-30:]))
362
- for ln in out.splitlines():
363
- if "[读数]" in ln or "[跳过]" in ln:
364
- print(" 修后读数(未变异镜像):" + ln.strip())
365
- okc, bad = 0, []
366
- for desc, edits, exp in _MUTATIONS:
367
- backups, miss = [], []
368
- for rel, oldp, newp in edits:
369
- p = os.path.join(tree, rel)
370
- nl = _nl_of(p)
371
- old, new = nl.join(oldp), nl.join(newp)
372
- with open(p, encoding="utf-8", newline="") as fh:
373
- t = fh.read()
374
- if t.count(old) != 1:
375
- miss.append("%s —— 锚点命中 %d 次" % (rel, t.count(old)))
376
- continue
377
- backups.append((p, t))
378
- with open(p, "w", encoding="utf-8", newline="") as fh:
379
- fh.write(t.replace(old, new, 1))
380
- if miss:
381
- bad.append("%s —— %s" % (desc, ";".join(miss)))
382
- print(" ANCHOR-MISS " + desc)
383
- for p, t in backups:
384
- with open(p, "w", encoding="utf-8", newline="") as fh:
385
- fh.write(t)
386
- continue
387
- rc2, reds2, out2 = _run_in(tree)
388
- for p, t in backups:
389
- with open(p, "w", encoding="utf-8", newline="") as fh:
390
- fh.write(t)
391
- hit = sorted({e for r in reds2 for e in exp if r.startswith(e + " ")})
392
- if rc2 != 0 and hit == sorted(exp) and len(reds2) == len(exp):
393
- okc += 1
394
- print(" OK %s 红项=%d 指定命中=%d/%d"
395
- % (desc, len(reds2), len(hit), len(exp)))
396
- else:
397
- bad.append(desc)
398
- print(" MISMATCH %s 红项=%d 指定命中=%d/%d rc=%d"
399
- % (desc, len(reds2), len(hit), len(exp), rc2))
400
- for r in reds2[:14]:
401
- print(" FAIL " + r)
402
- print("定点变异自证:%s(%d 条不合格)"
403
- % ("PASS" if not bad else "FAIL", len(bad)))
404
- for b in bad:
405
- print(" 不合格:" + b)
406
- finally:
407
- shutil.rmtree(tree, ignore_errors=True)
408
-
409
-
410
- def main():
411
- if "--mutate" in sys.argv:
412
- _mutate()
413
- return 1 if FAILS else 0
414
- return 0 if not FAILS else 1
415
-
416
-
417
- if __name__ == "__main__":
418
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:imgskill 审计台账落点不得跟随符号链接写到沙箱根外(issue #352-C)
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue352_imgaudit [--mutate];被测面=md_cg/imgskill.py 的 audit_path/_audit_write/read_audit/_audit_seq
4
+ # 子功能:A 组=根内 .imgskill 指向根外时 run() 照常返回、台账不落根外、结果体带 audit_warning、audit_path(strict) 抛 E_PATH_OUT_OF_SCOPE、读面不跟随;K 组=非恒真对照(正常台账照写照读、幂等复用面不受影响、目录尚未创建时不误拒);E 组=源码面单点
5
+ # 执行:在临时沙箱根内把 .imgskill 造成指向根外的**目录链接**(POSIX=symlink,Windows=junction——junction 不需特权而 open() 同样跟随,本机实测),随后调 md_cg.imgskill.run()/_find_reuse()
6
+ # 验证方式:全部 PASS 即通过;--mutate 走镜像树定点变异,变异后红项必须**恰为**预期集合
7
+ # 不适用条件:①不判台账完整性(HMAC/签名)②不判台账落点搬迁(移到 aux_root 属设计决定)③不判台账被「换内容」的投毒面(#325 读方向已覆盖)④不覆盖「末段是符号链接」的实机腿——本机无 SeCreateSymbolicLinkPrivilege(已实测),该腿在有权限的宿主上自动启用,无权限时按源码面单点(E1)钉住
8
+ """issue #352-C 守卫:台账落点不得跟随链接写到沙箱根外。
9
+
10
+ 病象(修前):`audit_path` 只有一句 `os.path.join(root, AUDIT_REL)`,而
11
+ `_audit_write` 用 `open(p, "a")` **跟随符号链接**。沙箱根内可写者只做一步
12
+ (把 `.imgskill` 目录或 `.imgskill/audit.jsonl` 换成链接),受害者下一次**合法**
13
+ 调用就会把一行审计 JSON 追加到根外任意可写文件——目标是 `json.dump` 写的整文件
14
+ JSON 时该文件从此解析失败(报告实测:指向 `MDCG_TOKEN_FILE` 后 MCP 服务重启
15
+ rc=3 退出)。`read_audit` / `_audit_seq` 同样跟随链接**读**根外文件。
16
+
17
+ 处置(真源复用):落点判定一律走同文件既有的 `safe_join`(realpath +
18
+ commonpath,与 src/dst 同一份实现),上段/末段各补一次 `os.path.islink` 显式判;
19
+ 写面用 `os.open(..., O_NOFOLLOW)`(平台无该标志时取 0)。
20
+
21
+ ★**fail-open 还是 fail-closed**:报告把这一条列为维护者裁定。本实现取
22
+ **fail-open + 可观测告警**——台账落点不可信时 `run()` 照常返回结果,只是不写
23
+ 台账并在结果体带 `audit_warning`(读面按空表计)。理由:imgskill 不经 MCP 暴露,
24
+ 把本地可信边界问题升级成「一个可写者建个链接就让所有合法调用失败」的拒服务面
25
+ 得不偿失;且报告给的边界本就是「可人工删掉追加行恢复」。**不静默**是硬要求——
26
+ M3 变异(摘掉告警回填)必须打红 C1。
27
+
28
+ ★**过度收紧方向**:K1(正常台账照写照读)、K2(幂等复用面不受影响)、
29
+ K3(`.imgskill` 目录尚未创建时不得误拒)三条盯住「修复没把正常面一起关掉」。
30
+ """
31
+ import hashlib
32
+ import inspect
33
+ import json
34
+ import os
35
+ import shutil
36
+ import struct
37
+ import subprocess
38
+ import sys
39
+ import tempfile
40
+ import zlib
41
+
42
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
43
+
44
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
45
+ sys.path.insert(0, _REPO)
46
+ from md_cg import imgskill as _I # noqa: E402
47
+
48
+ FAILS = []
49
+ _SKIPPED = []
50
+
51
+
52
+ def _check(name, cond, detail=""):
53
+ if cond:
54
+ print(" PASS " + name)
55
+ else:
56
+ print(" FAIL " + name + " " + str(detail)[:400])
57
+ FAILS.append(name)
58
+
59
+
60
+ _TMP = tempfile.mkdtemp(prefix="iss352c_")
61
+
62
+
63
+ def _png(path, w=8, h=8):
64
+ ch = lambda t, d: (struct.pack(">I", len(d)) + t + d
65
+ + struct.pack(">I", zlib.crc32(t + d) & 0xffffffff))
66
+ raw = b"".join(b"\x00" + b"\xff\x00\x00" * w for _ in range(h))
67
+ with open(path, "wb") as f:
68
+ f.write(b"\x89PNG\r\n\x1a\n"
69
+ + ch(b"IHDR", struct.pack(">IIBBBBB", w, h, 8, 2, 0, 0, 0))
70
+ + ch(b"IDAT", zlib.compress(raw)) + ch(b"IEND", b""))
71
+
72
+
73
+ def _sandbox(tag):
74
+ base = os.path.join(_TMP, tag)
75
+ root = os.path.join(base, "sandbox")
76
+ out = os.path.join(base, "outside")
77
+ os.makedirs(root)
78
+ os.makedirs(out)
79
+ _png(os.path.join(root, "a.png"))
80
+ return base, root, out
81
+
82
+
83
+ def _dir_link(link, target):
84
+ """把 link 造成指向 target 的**目录链接**。
85
+
86
+ POSIX 用 `os.symlink`;Windows 用 `mklink /J`(junction)——junction
87
+ **不需要 SeCreateSymbolicLinkPrivilege**(本机 `os.symlink` 实测
88
+ WinError 1314 拒绝,junction 成功),而 `open()` 与 `realpath` 对它的行为
89
+ 与符号链接一致(本机实测:跟随写入成立、realpath 解析到链接目标)。
90
+ 故这条腿在两个平台上都是**真实**复现,不是桩。
91
+ """
92
+ if os.name == "nt":
93
+ # 文本模式子进程必须显式声明编码(scripts 的编码守卫要求;不依赖 locale)。
94
+ pr = subprocess.run(["cmd", "/c", "mklink", "/J", link, target],
95
+ capture_output=True, text=True,
96
+ encoding="utf-8", errors="replace")
97
+ return pr.returncode == 0
98
+ try:
99
+ os.symlink(target, link, target_is_directory=True)
100
+ return True
101
+ except OSError:
102
+ return False
103
+
104
+
105
+ def _file_link(link, target):
106
+ try:
107
+ os.symlink(target, link)
108
+ return True
109
+ except OSError:
110
+ return False
111
+
112
+
113
+ def _run(root, **extra):
114
+ req = {"op": "inspect", "src": "a.png", "sandbox_root": root,
115
+ "caller": "victim"}
116
+ req.update(extra)
117
+ try:
118
+ return _I.run(req)
119
+ except Exception as exc: # noqa: BLE001
120
+ return {"_raised": "%s: %s" % (type(exc).__name__, exc)}
121
+
122
+
123
+ def _sha(path):
124
+ with open(path, "rb") as f:
125
+ return hashlib.sha256(f.read()).hexdigest()
126
+
127
+
128
+ # 能力探测:末段文件符号链接是否可建(本机无 SeCreateSymbolicLinkPrivilege)
129
+ _T = tempfile.mkdtemp(prefix="iss352c_cap_")
130
+ open(os.path.join(_T, "tgt"), "w", encoding="utf-8").close()
131
+ _FILE_LINK_OK = _file_link(os.path.join(_T, "lnk"), os.path.join(_T, "tgt"))
132
+ print(" [能力] 文件符号链接可建=%s(Windows 无特权时 False;目录链接走 junction,恒可用)"
133
+ % _FILE_LINK_OK)
134
+
135
+ print("== A 组:台账落点跟随链接 ==")
136
+
137
+ # --- C1:.imgskill 目录指向根外 ---
138
+ _b, _root, _out = _sandbox("c1")
139
+ _link_ok = _dir_link(os.path.join(_root, ".imgskill"), _out)
140
+ _res = _run(_root)
141
+ _out_ledger = os.path.join(_out, "audit.jsonl")
142
+ print(" [读数] C1 目录链接=%s run=%s 根外台账=%s 告警=%s"
143
+ % (_link_ok, {k: _res.get(k) for k in ("ok", "error")},
144
+ os.path.exists(_out_ledger),
145
+ bool(_res.get("audit_warning"))))
146
+ _check("C1 .imgskill 指向根外:run() 照常返回结果(不拒服务)、台账不落根外、"
147
+ "结果体带 audit_warning(不静默)",
148
+ _link_ok and "_raised" not in _res
149
+ and not os.path.exists(_out_ledger)
150
+ and bool(_res.get("audit_warning"))
151
+ and bool(_res.get("audit_id")), (_res, os.path.exists(_out_ledger)))
152
+
153
+ # --- C4:audit_path(strict) 对不可信落点抛 E_PATH_OUT_OF_SCOPE ---
154
+ _c4 = None
155
+ try:
156
+ _I.audit_path(_root)
157
+ _c4 = "未抛"
158
+ except _I.SkillError as _e:
159
+ _c4 = _e.code
160
+ _check("C4 audit_path(root) 对链接落点抛 E_PATH_OUT_OF_SCOPE(fail-closed 调用方可用)",
161
+ _c4 == _I.E_PATH_OUT_OF_SCOPE and _I.audit_path(_root, strict=False) is None,
162
+ _c4)
163
+
164
+ # --- C3:读面不跟随链接去读根外台账(含投毒条目)---
165
+ _poison = {"idempotency_key": "k352", "ok": True, "op": "inspect",
166
+ "input_sha256": _sha(os.path.join(_root, "a.png")), "params": {},
167
+ "output_path": "a.png",
168
+ "output_sha256": _sha(os.path.join(_root, "a.png")),
169
+ "audit_id": "audit_poison"}
170
+ with open(_out_ledger, "w", encoding="utf-8") as f:
171
+ f.write(json.dumps(_poison, ensure_ascii=False) + "\n")
172
+ _rows = _I.read_audit(_root)
173
+ _hit = _I._find_reuse(_root, "k352", "inspect",
174
+ _poison["input_sha256"], {})
175
+ print(" [读数] C3 读面条目=%d _find_reuse=%s(均须为空)"
176
+ % (len(_rows), _hit))
177
+ _check("C3 读面不跟随链接:read_audit 按空表计、_find_reuse 不复用根外台账条目",
178
+ _rows == [] and _hit is None, (_rows, _hit))
179
+
180
+ # --- C2:末段(audit.jsonl 本身)是符号链接 ---
181
+ if _FILE_LINK_OK:
182
+ _b2, _root2, _out2 = _sandbox("c2")
183
+ _victim = os.path.join(_out2, "tokens.json")
184
+ with open(_victim, "w", encoding="utf-8") as f:
185
+ json.dump({"tokens": {"abc": {"role": "designer"}}}, f)
186
+ os.makedirs(os.path.join(_root2, ".imgskill"))
187
+ _lk = _file_link(os.path.join(_root2, ".imgskill", "audit.jsonl"), _victim)
188
+ _res2 = _run(_root2)
189
+ _raw = open(_victim, encoding="utf-8").read()
190
+ try:
191
+ json.loads(_raw)
192
+ _parses = True
193
+ except ValueError:
194
+ _parses = False
195
+ print(" [读数] C2 末段链接=%s 根外 JSON 仍可解析=%s 含 audit_id=%s 告警=%s"
196
+ % (_lk, _parses, "audit_id" in _raw, bool(_res2.get("audit_warning"))))
197
+ _check("C2 末段是符号链接:根外整文件 JSON 不被追加破坏",
198
+ _lk and _parses and "audit_id" not in _raw
199
+ and bool(_res2.get("audit_warning")), _raw[:120])
200
+ else:
201
+ _SKIPPED.append("C2")
202
+ print(" [跳过] C2 末段符号链接腿:本机无 SeCreateSymbolicLinkPrivilege"
203
+ "(os.symlink 实测 WinError 1314)——该腿在有权限的宿主上自动启用,"
204
+ "此处由源码面单点 E1 兜底")
205
+
206
+ # ========================================================= K 组:非恒真对照
207
+ print("== K 组:非恒真对照(含**过度收紧**方向)==")
208
+
209
+ # --- K1:正常沙箱:台账照写照读、结果体无告警 ---
210
+ _kb, _kroot, _kout = _sandbox("k1")
211
+ _kres = _run(_kroot)
212
+ _kp = _I.audit_path(_kroot)
213
+ _krows = _I.read_audit(_kroot)
214
+ print(" [读数] K1 run=%s 台账路径在根内=%s 条目=%d 告警=%s"
215
+ % ({k: _kres.get(k) for k in ("ok", "error")},
216
+ bool(_kp) and not os.path.relpath(_kp, _kroot).startswith(".."),
217
+ len(_krows), _kres.get("audit_warning")))
218
+ _check("K1 正常沙箱(无链接):台账照常写入可读回、结果体**无** audit_warning",
219
+ "_raised" not in _kres and os.path.isfile(_kp) and len(_krows) >= 1
220
+ and _kres.get("audit_warning") is None
221
+ and bool(_kres.get("audit_id")), (_kres, _kp))
222
+
223
+ # --- K2:正常沙箱:幂等复用面不受影响(#325 的 safe_join 未回退)---
224
+ _krec = {"idempotency_key": "kk352", "ok": True, "op": "inspect",
225
+ "input_sha256": _sha(os.path.join(_kroot, "a.png")), "params": {},
226
+ "output_path": "a.png",
227
+ "output_sha256": _sha(os.path.join(_kroot, "a.png")),
228
+ "audit_id": "audit_k2"}
229
+ with open(_kp, "a", encoding="utf-8") as f:
230
+ f.write(json.dumps(_krec, ensure_ascii=False) + "\n")
231
+ _khit = _I._find_reuse(_kroot, "kk352", "inspect", _krec["input_sha256"], {})
232
+ _check("K2 正常台账仍可复用(幂等面不因本次收口而失效)",
233
+ isinstance(_khit, dict) and _khit.get("audit_id") == "audit_k2", _khit)
234
+
235
+ # --- K3:.imgskill 目录**尚不存在**时不得误拒(过度收紧方向)---
236
+ _kb3, _kroot3, _ = _sandbox("k3")
237
+ _p3 = _I.audit_path(_kroot3)
238
+ _res3 = _run(_kroot3)
239
+ _p3b = _I.audit_path(_kroot3)
240
+ print(" [读数] K3 目录未建时 audit_path=%s 事后条目=%d"
241
+ % (bool(_p3), len(_I.read_audit(_kroot3))))
242
+ _check("K3 .imgskill 目录尚未创建时不误拒:audit_path 仍返根内路径、run() 能建目录写入",
243
+ _p3 is not None and os.path.isfile(_p3b)
244
+ and len(_I.read_audit(_kroot3)) >= 1
245
+ and not str(_res3.get("audit_warning") or ""), (_p3, _p3b))
246
+
247
+ # ========================================================= E 组:源码面单点
248
+ print("== E 组:源码面单点 ==")
249
+ _src_ap = inspect.getsource(_I.audit_path)
250
+ _src_aw = inspect.getsource(_I._audit_write)
251
+ _src_ra = inspect.getsource(_I.read_audit)
252
+ _src_as = inspect.getsource(_I._audit_seq)
253
+ _src_fr = inspect.getsource(_I._find_reuse)
254
+ _check("E1 落点判定走 safe_join 真源 + 上段/末段 islink 显式判",
255
+ 'safe_join(root, AUDIT_REL, what="audit_path")' in _src_ap
256
+ and "os.path.islink(d)" in _src_ap and "os.path.islink(p)" in _src_ap)
257
+ _check("E2 写面用 os.open + O_NOFOLLOW(不再裸 open(p, 'a'))",
258
+ "os.open(p, flags, 0o600)" in _src_aw and "O_NOFOLLOW" in _src_aw)
259
+ _check("E3 读面(read_audit/_audit_seq)走同一判定、不可信即按空表",
260
+ "audit_path(root, strict=False)" in _src_ra
261
+ and "audit_path(root, strict=False)" in _src_as)
262
+ _check("E4 #325 的 safe_join 收口未回退(_find_reuse 仍过 safe_join)",
263
+ 'safe_join(root, rec["output_path"]' in _src_fr)
264
+
265
+ shutil.rmtree(_TMP, ignore_errors=True)
266
+
267
+ print("")
268
+ if FAILS:
269
+ print("issue #352-C 结果:%d 失败 → %s" % (len(FAILS), ", ".join(FAILS)))
270
+ else:
271
+ print("issue #352-C 结果:全部通过(跳过腿:%s)"
272
+ % (",".join(_SKIPPED) or "无"))
273
+
274
+ # ------------------------------------------------------------- 定点变异(镜像树)
275
+ _EXP_M1 = ("C1", "C3", "C4", "E1") + (("C2",) if _FILE_LINK_OK else ())
276
+ _MUTATIONS = (
277
+ ("M1 摘掉落点判定(回到 os.path.join + open 跟随链接的修前形态)",
278
+ (("md_cg/imgskill.py",
279
+ [' if os.path.islink(d):',
280
+ ' why = "%s 是符号链接(台账落点不得经链接指向沙箱根外)" % os.path.dirname(rel)',
281
+ ' elif os.path.islink(p):',
282
+ ' why = "%s 是符号链接(台账落点不得经链接指向沙箱根外)" % rel',
283
+ ' else:',
284
+ ' try:',
285
+ ' cand = safe_join(root, AUDIT_REL, what="audit_path")',
286
+ ' except SkillError as exc:',
287
+ ' why = exc.message'],
288
+ [' if False:',
289
+ ' why = None',
290
+ ' else:',
291
+ ' cand = os.path.join(root, AUDIT_REL)']),),
292
+ _EXP_M1),
293
+ ("M2 写面摘掉 O_NOFOLLOW(回到跟随链接的 open 口径)",
294
+ (("md_cg/imgskill.py",
295
+ [' flags = (os.O_WRONLY | os.O_APPEND | os.O_CREAT',
296
+ ' | getattr(os, "O_NOFOLLOW", 0))',
297
+ ' fd = os.open(p, flags, 0o600)'],
298
+ [' fd = os.open(p, os.O_WRONLY | os.O_APPEND | os.O_CREAT, 0o600)']),),
299
+ ("E2",)),
300
+ ("M3 摘掉结果体的告警回填(落点不可信重新变成**静默**不写)",
301
+ (("md_cg/imgskill.py",
302
+ [' if _aw is not None:',
303
+ ' # #352-C:台账落点不可信 ⇒ 本次不写台账,但**不静默**(结果体带告警)',
304
+ ' res["audit_warning"] = _aw'],
305
+ [' pass']),),
306
+ ("C1",)),
307
+ ("M4 读面回退成直接拼接(跟随链接读根外台账)",
308
+ (("md_cg/imgskill.py",
309
+ [' p = audit_path(root, strict=False)',
310
+ ' if p is None or not os.path.exists(p):',
311
+ ' return []'],
312
+ [' p = os.path.join(root, AUDIT_REL)',
313
+ ' if not os.path.exists(p):',
314
+ ' return []']),),
315
+ ("C3", "E3")),
316
+ )
317
+
318
+
319
+ def _mirror_build():
320
+ dst = tempfile.mkdtemp(prefix="iss352c_mut_")
321
+ for name in ("md_cg", "scripts"):
322
+ src = os.path.join(_REPO, name)
323
+ if os.path.isdir(src):
324
+ shutil.copytree(src, os.path.join(dst, name),
325
+ ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
326
+ for name in sorted(os.listdir(_REPO)):
327
+ p = os.path.join(_REPO, name)
328
+ if os.path.isfile(p) and name.endswith(".py"):
329
+ shutil.copy2(p, os.path.join(dst, name))
330
+ return dst
331
+
332
+
333
+ def _nl_of(path):
334
+ with open(path, "rb") as fh:
335
+ raw = fh.read(8192)
336
+ return "\r\n" if b"\r\n" in raw else "\n"
337
+
338
+
339
+ def _run_in(tree):
340
+ env = dict(os.environ)
341
+ env["PYTHONPATH"] = tree
342
+ env["PYTHONUTF8"] = "1"
343
+ env["PYTHONDONTWRITEBYTECODE"] = "1"
344
+ pr = subprocess.run([sys.executable, "-X", "utf8", "-m",
345
+ "md_cg.test_issue352_imgaudit"],
346
+ capture_output=True, text=True, encoding="utf-8",
347
+ errors="replace", cwd=tree, env=env, timeout=1800)
348
+ out = (pr.stdout or "") + (pr.stderr or "")
349
+ reds = [ln.split("FAIL ", 1)[1].strip()
350
+ for ln in out.splitlines() if "FAIL " in ln]
351
+ return pr.returncode, reds, out
352
+
353
+
354
+ def _mutate():
355
+ print("!! 定点变异自证:把修复点改回改动前形态,守卫必须转红")
356
+ tree = _mirror_build()
357
+ try:
358
+ rc, reds, out = _run_in(tree)
359
+ print(" 未变异镜像基线:rc=%d 红项=%d(必须 rc=0 且 0 红)" % (rc, len(reds)))
360
+ if rc != 0 or reds:
361
+ print(chr(10).join(out.splitlines()[-30:]))
362
+ for ln in out.splitlines():
363
+ if "[读数]" in ln or "[跳过]" in ln:
364
+ print(" 修后读数(未变异镜像):" + ln.strip())
365
+ okc, bad = 0, []
366
+ for desc, edits, exp in _MUTATIONS:
367
+ backups, miss = [], []
368
+ for rel, oldp, newp in edits:
369
+ p = os.path.join(tree, rel)
370
+ nl = _nl_of(p)
371
+ old, new = nl.join(oldp), nl.join(newp)
372
+ with open(p, encoding="utf-8", newline="") as fh:
373
+ t = fh.read()
374
+ if t.count(old) != 1:
375
+ miss.append("%s —— 锚点命中 %d 次" % (rel, t.count(old)))
376
+ continue
377
+ backups.append((p, t))
378
+ with open(p, "w", encoding="utf-8", newline="") as fh:
379
+ fh.write(t.replace(old, new, 1))
380
+ if miss:
381
+ bad.append("%s —— %s" % (desc, ";".join(miss)))
382
+ print(" ANCHOR-MISS " + desc)
383
+ for p, t in backups:
384
+ with open(p, "w", encoding="utf-8", newline="") as fh:
385
+ fh.write(t)
386
+ continue
387
+ rc2, reds2, out2 = _run_in(tree)
388
+ for p, t in backups:
389
+ with open(p, "w", encoding="utf-8", newline="") as fh:
390
+ fh.write(t)
391
+ hit = sorted({e for r in reds2 for e in exp if r.startswith(e + " ")})
392
+ if rc2 != 0 and hit == sorted(exp) and len(reds2) == len(exp):
393
+ okc += 1
394
+ print(" OK %s 红项=%d 指定命中=%d/%d"
395
+ % (desc, len(reds2), len(hit), len(exp)))
396
+ else:
397
+ bad.append(desc)
398
+ print(" MISMATCH %s 红项=%d 指定命中=%d/%d rc=%d"
399
+ % (desc, len(reds2), len(hit), len(exp), rc2))
400
+ for r in reds2[:14]:
401
+ print(" FAIL " + r)
402
+ print("定点变异自证:%s(%d 条不合格)"
403
+ % ("PASS" if not bad else "FAIL", len(bad)))
404
+ for b in bad:
405
+ print(" 不合格:" + b)
406
+ finally:
407
+ shutil.rmtree(tree, ignore_errors=True)
408
+
409
+
410
+ def main():
411
+ if "--mutate" in sys.argv:
412
+ _mutate()
413
+ return 1 if FAILS else 0
414
+ return 0 if not FAILS else 1
415
+
416
+
417
+ if __name__ == "__main__":
418
+ sys.exit(main())