minimal-agent 0.8.2 → 0.10.0

package/skills/ui-design/scripts/image_prompt_rewrite_test.py

@@ -0,0 +1,966 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+import json
+import os
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, HERE)
+from image_plan_lint import lint  # noqa: E402
+from image_prompt_rewrite import rewrite_plan  # noqa: E402
+
+
+class ImagePromptRewriteTest(unittest.TestCase):
+    def test_rewrites_generic_text_to_image_with_page_anchors(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("用知乎长文生成能源电网智能巡检平台 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 11,
+                                "title": "多终端协同巡检",
+                                "one_sentence_takeaway": "调度端、移动端和现场设备共享同一张电网运行图。",
+                                "page_grammar": "product-closeup",
+                                "visual_focus": "电网巡检终端协同查看运行态势",
+                                "safe_text_zone": "left",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p11.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "professional product photography of a sleek device on a dark background",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertIn("多终端协同巡检", prompt)
+            self.assertIn("电网", prompt)
+            self.assertNotIn("aviation", prompt.lower())
+            self.assertIn("no game controller", prompt)
+            self.assertIn("no cosmetic bottle", prompt)
+
+    def test_rewrites_i2i_with_page_takeaway_and_preserve_policy(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("客户图必须图生图增强后使用", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 5,
+                                "title": "采集终端",
+                                "one_sentence_takeaway": "多种采集终端把现场状态变成可追溯记录。",
+                                "safe_text_zone": "right",
+                                "visual": {"source_file": "src_1.png"},
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "enhanced_src_1.png",
+                            "mode": "image-to-image",
+                            "source_file": "src_1.png",
+                            "aspect": "16:9",
+                            "enhance_style": "cutout",
+                            "prompt": "restore quality",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            rewrite_plan(build)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertIn("Use the attached image", prompt)
+            # 句子切片「多种采集终端把现场状态变」被碎片过滤剔除，名词锚「采集终端」保留页面绑定。
+            self.assertIn("采集终端", prompt)
+            self.assertIn("transparent", prompt)
+            # 2026-07-03 起：i2i 不再拼 Slide title/Core message 原句（增强图常当 hero/背景层，
+            # 原句会被画成新文字）；尾部负面从 no text 改为 no new text（dense 忠实还原不删原文字）。
+            self.assertIn("no new text", prompt)
+            self.assertNotIn("Slide title:", prompt)
+            self.assertNotIn("Core message:", prompt)
+
+    def _i2i_setup(self, build, enhance_style, source_file, source_plan_entry=None, takeaway="", prompt="old prompt"):
+        (build / "user_request.md").write_text("测试", encoding="utf-8")
+        (build / "design.json").write_text(
+            json.dumps({"pages": [{"page": 1, "title": "测试页", "one_sentence_takeaway": takeaway,
+                                   "safe_text_zone": "right", "visual": {"source_file": source_file}}]},
+                       ensure_ascii=False),
+            encoding="utf-8",
+        )
+        (build / "source_layout_plan.json").write_text(
+            json.dumps({"images": [source_plan_entry] if source_plan_entry else []}, ensure_ascii=False),
+            encoding="utf-8",
+        )
+        enhanced = f"enhanced_{source_file}"
+        (build / "img_plan.json").write_text(
+            json.dumps([{"file": enhanced, "mode": "image-to-image", "source_file": source_file,
+                        "aspect": "16:9", "enhance_style": enhance_style, "prompt": prompt}],
+                       ensure_ascii=False),
+            encoding="utf-8",
+        )
+        rewrite_plan(build)
+        plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+        return plan[0]["prompt"]
+
+    def test_dense_with_embedded_text_strips_caption_preserves_structure_regression(self):
+        # 2026-07-03 真机 src_6 回归事故：_rewrite_i2i 此前无条件重生保真 prompt，把
+        # plan_source_layout.py 已算好的去字提示词（text_policy=remove_all_text）覆盖掉——
+        # 原图标题「AI全景相机优势」因此没被去掉。现在必须读 source_plan 引用实际文字。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {
+                "file": "src_6.png", "text_policy": "remove_all_text",
+                "embedded_text": [
+                    {"text": "AI全景相机优势", "region": "顶部左侧标题"},
+                    {"text": "多台监控", "region": "上排中间蓝色箭头内"},
+                ],
+            }
+            prompt = self._i2i_setup(build, "dense", "src_6.png", entry)
+            self.assertIn("AI全景相机优势", prompt)
+            self.assertIn("多台监控", prompt)
+            self.assertIn("REMOVED", prompt)
+            self.assertIn("layout, sub-images, comparison structure", prompt)
+            self.assertNotIn("do not rewrite charts, screenshots, numbers, labels, UI structure or data", prompt)
+
+    def test_dense_without_embedded_text_keeps_faithful_preserve_regression(self):
+        # 回归锁：chart 类图表（text_policy=preserve_data_text 或无 embedded_text）不受影响，
+        # 仍走原有的无条件保真措辞——图表坐标轴/图例数值是数据本身，不能被误去字。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {"file": "chart_1.png", "text_policy": "preserve_data_text", "embedded_text": []}
+            prompt = self._i2i_setup(build, "dense", "chart_1.png", entry)
+            self.assertIn("do not rewrite charts, screenshots, numbers, labels, UI structure or data", prompt)
+            self.assertNotIn("REMOVED", prompt)
+
+    def test_dense_missing_source_plan_entry_keeps_faithful_preserve(self):
+        # source_layout_plan.json 里找不到对应条目（旧产物/未透传）→ 静默退回原有保真措辞，不报错。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            prompt = self._i2i_setup(build, "dense", "src_9.png", None)
+            self.assertIn("do not rewrite charts, screenshots, numbers, labels, UI structure or data", prompt)
+
+    def test_cutout_with_embedded_text_appends_removal_instruction(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {"file": "src_7.png", "text_policy": "remove_all_text",
+                     "embedded_text": [{"text": "720Avatar", "region": "车身侧面"}]}
+            prompt = self._i2i_setup(build, "cutout", "src_7.png", entry)
+            self.assertIn("transparent", prompt)
+            self.assertIn("720Avatar", prompt)
+            self.assertIn("completely removed", prompt)
+
+    def test_generic_bg_hero_with_embedded_text_appends_removal_instruction(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {"file": "src_8.png", "text_policy": "remove_all_text",
+                     "embedded_text": [{"text": "PILOT LOOK", "region": "海报角标"}]}
+            prompt = self._i2i_setup(build, "hero", "src_8.png", entry)
+            self.assertIn("clean negative space for editable PPT text", prompt)
+            self.assertIn("PILOT LOOK", prompt)
+            self.assertIn("completely removed", prompt)
+
+    def test_i2i_tier1_keeps_genuine_prompt_with_complete_deltext_clause_unchanged(self):
+        # Tier 1：original 已经像真 i2i 指令、且完整引用了所有 embedded_text → 原样保留，
+        # 一个字都不改（包括只有页面定制才会有的独特措辞），不走模板重建。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {
+                "file": "src_6.png", "text_policy": "remove_all_text",
+                "embedded_text": [
+                    {"text": "AI全景相机优势", "region": "顶部左侧标题"},
+                    {"text": "多台监控", "region": "上排中间蓝色箭头内"},
+                ],
+            }
+            custom_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject. "
+                "Faithfully keep the exact same layout and comparison structure, misty harbor at dusk mood. "
+                "However, the original image also has this exact baked-in text that must be completely "
+                "REMOVED, leaving clean empty space in its place: 'AI全景相机优势' (顶部左侧标题), "
+                "'多台监控' (上排中间蓝色箭头内). Never reproduce or invent any text."
+            )
+            prompt = self._i2i_setup(build, "dense", "src_6.png", entry, prompt=custom_prompt)
+            self.assertEqual(prompt, custom_prompt)
+
+    def test_i2i_tier1_keeps_asis_when_no_deltext_required_and_no_source_plan_entry(self):
+        # Tier 1：genuine i2i 指令但 source_layout_plan.json 没有对应条目 → 仍然原样保留，
+        # 锁定"无 plan 条目 ≠ 强制重建"这个刻意设计（多数 i2i 条目本来就没有去字要求）。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            custom_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject "
+                "and key factual content. Faithfully restore clarity only; do not rewrite charts, data. "
+                "golden hour rooftop scene."
+            )
+            prompt = self._i2i_setup(build, "dense", "src_9.png", None, prompt=custom_prompt)
+            self.assertEqual(prompt, custom_prompt)
+
+    def test_i2i_tier2_patches_missing_deltext_preserves_custom_wording_src6_regression(self):
+        # Tier 2 端到端复刻真机 src_6 事故：设计 LLM 抄来的 prompt 本身没问题（有 i2i 指令特征 +
+        # 独特页面措辞），只是缺去字指令 → 必须打补丁保留原有措辞，而不是被推翻重建成写死模板。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {
+                "file": "src_6.png", "text_policy": "remove_all_text",
+                "embedded_text": [
+                    {"text": "AI全景相机优势", "region": "顶部左侧标题"},
+                    {"text": "多台监控", "region": "上排中间蓝色箭头内"},
+                    {"text": "1台全景", "region": "下方对比标签"},
+                ],
+            }
+            custom_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject "
+                "and key factual content. Faithfully keep the exact same layout, sub-images, comparison "
+                "structure and every non-text visual detail unchanged, cinematic aviation hangar mood."
+            )
+            prompt = self._i2i_setup(build, "dense", "src_6.png", entry, prompt=custom_prompt)
+            self.assertIn("cinematic aviation hangar mood", prompt)
+            self.assertIn("AI全景相机优势", prompt)
+            self.assertIn("多台监控", prompt)
+            self.assertIn("1台全景", prompt)
+            self.assertIn("REMOVED", prompt)
+
+    def test_i2i_tier2_patch_partial_embedded_text_quoted_still_patches(self):
+        # 原 prompt 只引用了 embedded_text 中的一条 → 仍判定需要 Tier 2 补丁（追加完整引用集）。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {
+                "file": "src_6.png", "text_policy": "remove_all_text",
+                "embedded_text": [
+                    {"text": "AI全景相机优势", "region": "顶部左侧标题"},
+                    {"text": "多台监控", "region": "上排中间蓝色箭头内"},
+                ],
+            }
+            custom_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject. "
+                "The original has this exact baked-in text that must be completely removed: 'AI全景相机优势'."
+            )
+            prompt = self._i2i_setup(build, "dense", "src_6.png", entry, prompt=custom_prompt)
+            self.assertIn("多台监控", prompt)
+
+    def test_i2i_tier2_patch_is_idempotent_second_run(self):
+        # 打补丁后再跑一次必须幂等：changed_count==0，img_plan.json 逐字节不变。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {
+                "file": "src_6.png", "text_policy": "remove_all_text",
+                "embedded_text": [{"text": "AI全景相机优势", "region": "顶部左侧标题"}],
+            }
+            custom_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject "
+                "and key factual content. Faithfully keep the exact same layout unchanged, dusk mood."
+            )
+            self._i2i_setup(build, "dense", "src_6.png", entry, prompt=custom_prompt)
+            plan_after_first = (build / "img_plan.json").read_text(encoding="utf-8")
+            second = rewrite_plan(build)
+            self.assertEqual(second["changed_count"], 0, second)
+            self.assertEqual((build / "img_plan.json").read_text(encoding="utf-8"), plan_after_first)
+
+    def test_i2i_tier3_fallback_when_prompt_missing_i2i_signature(self):
+        # 原 prompt 是纯 t2i 风格文本误放在 i2i 槽位（不含任何 i2i 特征词）→ 走 Tier 3 全量重建。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            entry = {"file": "src_6.png", "text_policy": "remove_all_text",
+                      "embedded_text": [{"text": "AI全景相机优势", "region": "顶部左侧标题"}]}
+            t2i_style_prompt = "professional product photography of a sleek device on a dark background"
+            prompt = self._i2i_setup(build, "dense", "src_6.png", entry, prompt=t2i_style_prompt)
+            self.assertIn("AI全景相机优势", prompt)
+            self.assertIn("REMOVED", prompt)
+            self.assertIn("layout, sub-images, comparison structure", prompt)
+            self.assertNotIn("sleek device", prompt)
+
+    def test_i2i_tier_counts_reported_in_summary(self):
+        # report 里的 i2i_tier_counts 应准确反映每条 i2i 走了哪一层。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("测试", encoding="utf-8")
+            (build / "design.json").write_text(json.dumps({"pages": []}, ensure_ascii=False), encoding="utf-8")
+            (build / "source_layout_plan.json").write_text(
+                json.dumps({"images": [
+                    {"file": "src_1.png", "text_policy": "remove_all_text",
+                     "embedded_text": [{"text": "标题A", "region": "顶部"}]},
+                    {"file": "src_2.png", "text_policy": "remove_all_text",
+                     "embedded_text": [{"text": "标题B", "region": "顶部"}]},
+                ]}, ensure_ascii=False),
+                encoding="utf-8",
+            )
+            kept_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject. "
+                "The original has this exact baked-in text that must be completely removed: '标题A'."
+            )
+            patch_prompt = (
+                "Use the attached image as the strict visual reference. Preserve the real main subject "
+                "and key factual content. Faithfully keep the exact same layout unchanged."
+            )
+            (build / "img_plan.json").write_text(
+                json.dumps([
+                    {"file": "enhanced_src_1.png", "mode": "image-to-image", "source_file": "src_1.png",
+                     "enhance_style": "dense", "prompt": kept_prompt},
+                    {"file": "enhanced_src_2.png", "mode": "image-to-image", "source_file": "src_2.png",
+                     "enhance_style": "dense", "prompt": patch_prompt},
+                    {"file": "ai_p1.png", "mode": "text-to-image", "prompt": ""},
+                ], ensure_ascii=False),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["i2i_tier_counts"]["kept_as_is"], 1, report)
+            self.assertEqual(report["i2i_tier_counts"]["patched_missing_deltext"], 1, report)
+
+    def test_background_prompt_does_not_preserve_chapter_numbers(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("做产品详情页式 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 2,
+                                "title": "四段导览",
+                                "one_sentence_takeaway": "先建立全文阅读地图。",
+                                "page_grammar": "cinematic-feature",
+                                "visual_focus": "4个章节序号浮在浅蓝矢量准线上",
+                                "safe_text_zone": "left",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p2.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "light blue route background with chapter numbers 1 2 3 4",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("chapter numbers", prompt.lower())
+            self.assertNotIn("1 2 3 4", prompt)
+            self.assertIn("complementary background", prompt)
+            self.assertIn("no text", prompt)
+
+    def test_background_prompt_does_not_copy_foreground_layout(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("做产品详情页式 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 5,
+                                "title": "证据形式变了",
+                                "one_sentence_takeaway": "多台监控拍出分屏碎片，一台全景拍出可计算的整体。",
+                                "page_grammar": "cinematic-feature",
+                                "visual_focus": "客户图增强的上下对比图作主视觉，顶部 takeaway + 下方 3 张图横排",
+                                "safe_text_zone": "top",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p5.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "professional product photography of a sleek device",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("3 张", prompt)
+            self.assertNotIn("横排", prompt)
+            self.assertNotIn("对比图", prompt)
+            self.assertIn("complementary background", prompt)
+
+    def test_background_prompt_rejects_text_chip_labels(self):
+        # 2026-07-02 真机事故回归锁（ai_p23）：design visual_focus 里的「三组'一'短标」漏过词表 →
+        # Seedream 照画三条带字药丸横在背景正中，与 HTML 标题叠字（deck 里根本没有这些字，全烧在图里）。
+        # 「短标/角标/清单」等带字元件词进 visual_focus/anchors 必须被拒收。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("做产品详情页式 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 23,
+                                "title": "让看不见无处遁形",
+                                "one_sentence_takeaway": "看见，是一切质量的起点。",
+                                "page_grammar": "hero-scene",
+                                "visual_focus": "飞机翱翔云层航拍图 + 三组'一'短标",
+                                "safe_text_zone": "left-center",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p23.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "professional product photography of a sleek device",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            rewrite_plan(build)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("短标", prompt)
+
+    def test_background_prompt_does_not_copy_svg_timeline_layout(self):
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text(
+                "用我电脑下载目录里面的航空器制造组装360度全景影像档案系统方案_副本 word 生成 PPT",
+                encoding="utf-8",
+            )
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 4,
+                                "title": "三个根本性转变",
+                                "one_sentence_takeaway": "360° 全景把工艺升级为完整时空档案。",
+                                "page_grammar": "data-visual",
+                                "visual_focus": "三个并列胶囊 + SVG 箭头时间线",
+                                "safe_text_zone": "center",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p4.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "professional product photography of a sleek device",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertIn("三个根本性转变", prompt)
+            # 2026-07-03 起：背景锚剔除数字碎片与句子切片（"360°""全景把工艺升级…"会被文字渲染型
+            # 模型画进图），场景名词锚（档案/影像档案系统方案）仍在、页面绑定不丢。
+            self.assertNotIn("360°", prompt)
+            self.assertIn("档案", prompt)
+            self.assertNotIn("时间线", prompt)
+            self.assertNotIn("胶囊", prompt)
+            self.assertNotIn("箭头", prompt)
+            # data-visual 页背景 = 纯氛围 + 留白，数据视觉声明由 HTML 层画。
+            self.assertIn("drawn by the HTML layer", prompt)
+            self.assertNotIn("Slide title:", prompt)
+            self.assertNotIn("Core message:", prompt)
+
+    def test_risky_design_fields_never_reach_prompt(self):
+        # 2026-07-01 真机事故回归锁：design 字段里的「行业缩略图」（经 Topic anchors）与
+        # 页标题里的裸「架构」（经 Slide title 拼接）曾被机器拼进 t2i prompt，被下游
+        # image_plan_lint 拦下 → 机器自产自拦、整条工作流确定性 halt。
+        # 现在 rewrite 与 lint 共享词表：这些词在拼接前被剥掉/拒收，产出必过 lint。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("生成全景相机行业方案 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 8,
+                                "title": "平台总体架构",
+                                "one_sentence_takeaway": "一台全景相机覆盖 18+ 行业场景。",
+                                "page_grammar": "hero-scene",
+                                "visual_focus": "src_8 全景相机 + 18+ 行业落地 hero",
+                                "visual_story": "上半用全景相机行业缩略图墙展示落地广度",
+                                "safe_text_zone": "bottom",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p8.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "professional product photography of a sleek device",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("缩略图", prompt)
+            self.assertNotIn("架构", prompt)
+            self.assertIn("全景相机", prompt)
+            # 集成兜底：改写后的 plan 直接过 lint（不带 outline，同 ppt.yaml 阶段11 调用形态）
+            violations, _, _ = lint(str(build / "img_plan.json"), None)
+            self.assertEqual(violations, [], violations)
+
+    def test_structural_original_prompt_recomposed_to_safe(self):
+        # LLM 原 prompt 自报结构图（decision tree / layered architecture / 对比图）→
+        # 不再靠下游 halt 等人修：机器直接重组成安全的页面绑定 prompt（「结构图回退」的确定性实现，
+        # 结构交 HTML 层、AI 图退化为安全底图），且重组产物必过 lint。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("生成质量追溯平台 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 3,
+                                "title": "证据链闭环",
+                                "one_sentence_takeaway": "全流程留痕让追溯一步到位。",
+                                "page_grammar": "hero-scene",
+                                "visual_focus": "车间产线追溯场景",
+                                "safe_text_zone": "left",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p3.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "clean decision tree diagram with layered architecture, 对比图 style",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            self.assertIn("risky_terms", report["changed"][0]["reason"])
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("decision tree", prompt.lower())
+            self.assertNotIn("architecture", prompt.lower())
+            self.assertNotIn("对比图", prompt)
+            self.assertIn("证据链闭环", prompt)
+            violations, _, _ = lint(str(build / "img_plan.json"), None)
+            self.assertEqual(violations, [], violations)
+
+    def test_product_identity_anchor_appended_when_page_omits_subject(self):
+        # 2026-07-07 真机 p9 复盘：页面文案（"安全性·分层防御"）省略主语（不重复"全景相机"），
+        # 原 prompt 已含页面局部锚点（分层防御）+ 无风险词，此前 force_rewrite=False 直接放行，
+        # 完全不提客户真实产品外观，t2i 会画出无关设备。deck_meta.product_identity 必须被补上，
+        # 不依赖该页文案是否显式提及产品名。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("航空器制造组装 360 度全景影像档案系统方案", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "deck_meta": {
+                            "product_identity": "a compact panoramic camera unit, matte black cylindrical housing with a red accent ring around the lens",
+                            "customer_context": "Shenyang Taikeyi, serving aviation manufacturing clients",
+                        },
+                        "pages": [
+                            {
+                                "page": 9,
+                                "title": "安全性 · 分层防御",
+                                "one_sentence_takeaway": "安全是这套系统的一等约束，不是事后补丁",
+                                "page_grammar": "spec-overlay",
+                                "visual_focus": "硬件定制与物理隔离",
+                                "safe_text_zone": "right",
+                            }
+                        ],
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            original_prompt = (
+                "a secure server rack inside an airplane cabin illustrating 分层防御 hardware isolation "
+                "with clean studio lighting and calm color grading"
+            )
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [{"file": "ai_p9.png", "mode": "text-to-image", "aspect": "16:9", "prompt": original_prompt}],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1, report)
+            self.assertIn("product_identity_anchor", report["changed"][0]["reason"])
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertIn("matte black cylindrical housing", prompt)
+            self.assertIn("Shenyang Taikeyi", prompt)
+
+    def test_product_identity_absent_is_backward_compatible(self):
+        # 没有 deck_meta（旧 design.json / 纯示意主题无真实产品照）时行为不变——不强行拼任何锚。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("航空器制造组装 360 度全景影像档案系统方案", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 9,
+                                "title": "安全性 · 分层防御",
+                                "one_sentence_takeaway": "安全是这套系统的一等约束，不是事后补丁",
+                                "page_grammar": "spec-overlay",
+                                "visual_focus": "硬件定制与物理隔离",
+                                "safe_text_zone": "right",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            original_prompt = (
+                "a secure server rack inside an airplane cabin illustrating 分层防御 hardware isolation "
+                "with clean studio lighting and calm color grading"
+            )
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [{"file": "ai_p9.png", "mode": "text-to-image", "aspect": "16:9", "prompt": original_prompt}],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            # deck_meta 缺失 → 只有原有的 append_negative_constraints 行为生效，不拼任何产品身份锚
+            # （这才是"行为不变"：旧代码在这个 fixture 上也会因缺 NEGATIVE_OBJECTS 而报 changed=1）。
+            self.assertEqual(report["changed_count"], 1, report)
+            self.assertEqual(report["changed"][0]["reason"], "append_negative_constraints")
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            self.assertNotIn("Product visual consistency", plan[0]["prompt"])
+
+    def test_product_identity_risky_terms_stripped_before_landing_in_prompt(self):
+        # deck_meta.product_identity 是 LLM 写的自由文本，可能意外含 lint 黑名单词（如 architecture）——
+        # 落进 prompt 前必须剥净，保证「rewrite 产出必过 lint」的生产者契约不被 deck_meta 破坏。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("测试主题", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "deck_meta": {
+                            "product_identity": "a device with a visible architecture diagram sticker, matte black housing",
+                        },
+                        "pages": [
+                            {
+                                "page": 3,
+                                "title": "测试页",
+                                "one_sentence_takeaway": "测试要点",
+                                "page_grammar": "spec-overlay",
+                            }
+                        ],
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [{"file": "ai_p3.png", "mode": "text-to-image", "aspect": "16:9", "prompt": ""}],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            rewrite_plan(build)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("architecture", prompt.lower())
+            self.assertIn("matte black housing", prompt)
+            violations, _, _ = lint(str(build / "img_plan.json"), None)
+            self.assertEqual(violations, [], violations)
+
+    def test_product_identity_included_in_force_rewritten_background_prompt(self):
+        # force_rewrite 路径（原 prompt 缺锚点，被整段重组）也要带上产品身份锚，
+        # 不只是"看起来还行、原样放行"的 tail 分支才补。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("航空器制造组装 360 度全景影像档案系统方案", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "deck_meta": {
+                            "product_identity": "a compact panoramic camera unit, matte black cylindrical housing with a red accent ring around the lens",
+                        },
+                        "pages": [
+                            {
+                                "page": 9,
+                                "title": "安全性 · 分层防御",
+                                "one_sentence_takeaway": "安全是这套系统的一等约束，不是事后补丁",
+                                "page_grammar": "spec-overlay",
+                                "visual_focus": "硬件定制与物理隔离",
+                                "safe_text_zone": "right",
+                            }
+                        ],
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [{"file": "ai_p9.png", "mode": "text-to-image", "aspect": "16:9", "prompt": ""}],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1, report)
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertIn("matte black cylindrical housing", prompt)
+
+    def test_second_run_is_idempotent_changed_zero(self):
+        # 幂等/真报：首跑重组后，二跑必须 changed_count==0 且 prompt 逐字节不变
+        # （旧实现 force_rewrite 无条件报 changed，真机二跑虚报 changed=12、报告失真）。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("用知乎长文生成能源电网智能巡检平台 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 11,
+                                "title": "多终端协同巡检",
+                                "one_sentence_takeaway": "调度端、移动端和现场设备共享同一张电网运行图。",
+                                "page_grammar": "product-closeup",
+                                "visual_focus": "电网巡检终端协同查看运行态势",
+                                "safe_text_zone": "left",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p11.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "prompt": "professional product photography of a sleek device on a dark background",
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            first = rewrite_plan(build)
+            self.assertEqual(first["changed_count"], 1)
+            plan_after_first = (build / "img_plan.json").read_text(encoding="utf-8")
+            second = rewrite_plan(build)
+            self.assertEqual(second["changed_count"], 0, second)
+            self.assertEqual((build / "img_plan.json").read_text(encoding="utf-8"), plan_after_first)
+
+    def test_product_identity_anchor_second_run_is_idempotent(self):
+        # 带 deck_meta.product_identity 时同样必须幂等——二跑不重复拼锚、不虚报 changed。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("航空器制造组装 360 度全景影像档案系统方案", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "deck_meta": {
+                            "product_identity": "a compact panoramic camera unit, matte black cylindrical housing with a red accent ring around the lens",
+                        },
+                        "pages": [
+                            {
+                                "page": 9,
+                                "title": "安全性 · 分层防御",
+                                "one_sentence_takeaway": "安全是这套系统的一等约束，不是事后补丁",
+                                "page_grammar": "spec-overlay",
+                            }
+                        ],
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [{"file": "ai_p9.png", "mode": "text-to-image", "aspect": "16:9", "prompt": ""}],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            first = rewrite_plan(build)
+            self.assertEqual(first["changed_count"], 1, first)
+            plan_after_first = (build / "img_plan.json").read_text(encoding="utf-8")
+            second = rewrite_plan(build)
+            self.assertEqual(second["changed_count"], 0, second)
+            self.assertEqual((build / "img_plan.json").read_text(encoding="utf-8"), plan_after_first)
+
+    def test_background_prompt_never_carries_slide_copy_ai_p9_regression(self):
+        # 2026-07-03 ai_p9 真机事故回归锁：背景 t2i prompt 曾拼进页标题/带金额的正文句/图表描述，
+        # Seedream 类文字渲染型模型照着画出一整版烘字假幻灯片（投入有限对冲无限 + 成本清单 + 柱状图），
+        # 与 HTML 真表格/真图表互相遮挡。背景层提示词必须去内容化，且产出必过 lint 新增 slide_copy 检查。
+        with tempfile.TemporaryDirectory() as d:
+            build = Path(d)
+            (build / "user_request.md").write_text("生成航空制造全景影像方案 PPT", encoding="utf-8")
+            (build / "design.json").write_text(
+                json.dumps(
+                    {
+                        "pages": [
+                            {
+                                "page": 9,
+                                "title": "投入有限，对冲无限",
+                                "one_sentence_takeaway": "核心总投入约 3 万元，相当于单架飞机潜在事故成本的对冲。",
+                                "page_grammar": "data-visual",
+                                "visual_focus": "成本拆解 HTML 表 + 投入/对冲对比柱状图",
+                                "safe_text_zone": "center",
+                            }
+                        ]
+                    },
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            (build / "source_layout_plan.json").write_text("{}", encoding="utf-8")
+            # 旧模板产物原样作为输入（含 Slide title/Core message/柱状图描述）——必须被强制重组。
+            (build / "img_plan.json").write_text(
+                json.dumps(
+                    [
+                        {
+                            "file": "ai_p9.png",
+                            "mode": "text-to-image",
+                            "aspect": "16:9",
+                            "target_layer": "background",
+                            "prompt": (
+                                "low-interference data-space background. Slide title: 投入有限，对冲无限. "
+                                "Core message: 核心总投入约 3 万元，相当于单架飞机潜在事故成本的对冲. "
+                                "Topic anchors: 投入有限, 核心总投入约, 万元. "
+                                "Visual focus: 成本拆解 HTML 表 + 投入/对冲对比柱状图. no text, no logo."
+                            ),
+                        }
+                    ],
+                    ensure_ascii=False,
+                ),
+                encoding="utf-8",
+            )
+            report = rewrite_plan(build)
+            self.assertEqual(report["changed_count"], 1)
+            self.assertIn("slide_copy_in_background_prompt", report["changed"][0]["reason"])
+            plan = json.loads((build / "img_plan.json").read_text(encoding="utf-8"))
+            prompt = plan[0]["prompt"]
+            self.assertNotIn("Slide title:", prompt)
+            self.assertNotIn("Core message:", prompt)
+            self.assertNotIn("Topic anchors:", prompt)
+            self.assertNotIn("3 万元", prompt)
+            self.assertNotIn("柱状图", prompt)
+            self.assertNotIn("万元", prompt)
+            self.assertIn("no charts", prompt)
+            # 生产者-闸门契约：重组产物必过 lint（含新增 slide_copy 背景检查）。
+            violations, _, _ = lint(str(build / "img_plan.json"), None)
+            self.assertEqual(violations, [], violations)
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)