minimal-agent 0.13.0 → 0.14.0

package/plugins/workflow-runner/test/workflowState.test.ts

@@ -0,0 +1,429 @@
+/**
+ * plugins/workflow-runner/test/workflowState.test.ts —— 任务状态持久化
+ *
+ * 三条事故换来的语义，删任何一条之前先读 workflowState.ts 头注：
+ *  ① **先归档再清理**：new-task 清理旧产物必须先 rename 进 `.trash/`，rm 只作兜底。
+ *    直接 rm 曾造成不可找回的损失（仲裁误判 new-task，11 个声明产物静默消失）。
+ *  ② **归档失败不谎报位置**：一个文件都没成功移走就不能返回 archivedTo，
+ *    否则用户会去回收站找一个空目录 —— 比一开始就说「已删除」更糟。
+ *  ③ **脚本变了断点作废**：同 taskId 但脚本内容改过 → 旧 journal 的调用序号
+ *    对不上新控制流，必须明示原因后全新开始，不能静默续跑到错误的位置。
+ */
+
+import { afterEach, describe, expect, test } from 'bun:test';
+import {
+  existsSync,
+  mkdirSync,
+  mkdtempSync,
+  rmSync,
+  writeFileSync,
+} from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+import type { TaskArbitrator } from '../src/taskIdentity.js';
+import { WorkflowState } from '../src/workflowState.js';
+
+const dirs: string[] = [];
+afterEach(() => {
+  for (const d of dirs.splice(0)) {
+    // Windows 偶发 EBUSY，重试并吞掉 —— 否则会把上一条已通过的用例标红。
+    try {
+      rmSync(d, { recursive: true, force: true, maxRetries: 3 });
+    } catch {
+      /* 清理失败不影响断言 */
+    }
+  }
+});
+
+function workdir(): string {
+  const d = mkdtempSync(join(tmpdir(), 'wf-state-'));
+  dirs.push(d);
+  return d;
+}
+
+/** 在工作目录里造一个产物文件。 */
+function artifact(wd: string, rel: string, content = 'x'): string {
+  const abs = join(wd, rel);
+  mkdirSync(join(abs, '..'), { recursive: true });
+  writeFileSync(abs, content, 'utf8');
+  return abs;
+}
+
+const HASH = 'script-hash-v1';
+
+describe('四态判定', () => {
+  test('资源和参数变化不通过语义仲裁回到旧断点或旧成品', async () => {
+    const wd = workdir();
+    const defs = [
+      { name: 'source', type: 'resource' as const },
+      { name: 'range' },
+    ];
+    const inputs = {
+      source: '/image.png',
+      requestText: '转换',
+      __resource_fingerprint: 'bytes',
+      range: '1',
+    };
+    const first = new WorkflowState(wd, 'converter', 'session', defs);
+    await first.init(inputs, HASH, []);
+    let asked = false;
+    const next = new WorkflowState(wd, 'converter', 'session', defs);
+    const result = await next.init(
+      { ...inputs, range: '2' },
+      HASH,
+      [],
+      async () => {
+        asked = true;
+        return 'resume';
+      },
+    );
+    expect(result.mode).toBe('new-task');
+    expect(asked).toBe(false);
+    expect(next.taskId).not.toBe(first.taskId);
+    await first.markDone([]);
+    await first.archive();
+    expect(
+      (
+        await new WorkflowState(wd, 'converter', 'session', defs).init(
+          { ...inputs, range: '3' },
+          HASH,
+          [],
+        )
+      ).mode,
+    ).not.toBe('completed');
+  });
+  for (const completed of [false, true]) {
+    test(`dependency change retires the real journal and dynamic outputs (${completed ? 'completed' : 'failed'})`, async () => {
+      const wd = workdir();
+      const st = new WorkflowState(wd, 'demo', 's1');
+      const inputs = { goal: 'same target' };
+      await st.init(inputs, HASH, []);
+      artifact(wd, 'out/dynamic.png', 'old image bytes');
+      writeFileSync(
+        st.journalPath,
+        '{"seq":1,"kind":"tool","fp":"old","result":"stale"}\n',
+      );
+      if (completed) {
+        await st.markDone(['out/dynamic.png']);
+        await st.archive();
+      } else await st.recordFailure('network', ['out/dynamic.png']);
+      const next = new WorkflowState(wd, 'demo', 's1');
+      const info = await next.init(inputs, 'changed-bundle', []);
+      expect(info.scriptChanged).toBe(true);
+      expect(existsSync(next.journalPath)).toBe(false);
+      expect(existsSync(join(wd, 'out/dynamic.png'))).toBe(false);
+      expect(existsSync(join(wd, info.archivedTo!, 'out/dynamic.png'))).toBe(
+        true,
+      );
+      expect(
+        existsSync(join(wd, info.archivedTo!, 'state/journal.jsonl')),
+      ).toBe(true);
+      // The retired .done must not shadow the new, unfinished attempt.
+      expect(
+        (
+          await new WorkflowState(wd, 'demo', 's1').init(
+            inputs,
+            'changed-bundle',
+            [],
+          )
+        ).mode,
+      ).toBe('resume');
+    });
+  }
+
+  test('首次运行 → fresh，实例目录与 current.json 建好', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    const r = await st.init({ goal: '目标 A' }, HASH, []);
+
+    expect(r.mode).toBe('fresh');
+    expect(st.taskId).toHaveLength(16);
+    expect(existsSync(join(st.dir, 'current.json'))).toBe(true);
+  });
+
+  test('同任务未完成 → resume', async () => {
+    const wd = workdir();
+    const inputs = { goal: '目标 A' };
+    await new WorkflowState(wd, 'demo', 's1').init(inputs, HASH, []);
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(inputs, HASH, []);
+    expect(r.mode).toBe('resume');
+  });
+
+  test('同任务已完成 → completed，只报磁盘上实际存在的产物', async () => {
+    const wd = workdir();
+    const inputs = { goal: '目标 A' };
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init(inputs, HASH, ['out/real.md', 'out/never-made.md']);
+    artifact(wd, 'out/real.md');
+    await st.markDone();
+    await st.archive();
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(inputs, HASH, [
+      'out/real.md',
+      'out/never-made.md',
+    ]);
+    expect(r.mode).toBe('completed');
+    expect(r.artifacts).toEqual(['out/real.md']); // 声明了但没产出的不许报
+  });
+
+  test('★ 同任务但脚本内容变了 → new-task + scriptChanged，断点作废且明示原因', async () => {
+    const wd = workdir();
+    const inputs = { goal: '目标 A' };
+    await new WorkflowState(wd, 'demo', 's1').init(inputs, HASH, []);
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(
+      inputs,
+      'script-hash-v2',
+      [],
+    );
+    expect(r.mode).toBe('new-task');
+    expect(r.scriptChanged).toBe(true);
+  });
+
+  test('★ 已完成 + 脚本改过 → 不许报 completed，必须按新脚本重跑', async () => {
+    // 端到端实跑抓到的：改完工作流重跑同一目标，1 秒返回「此前已完成」+ 旧产物。
+    // 那份结论是**另一份脚本**产出的 —— 作者刚改完逻辑，最想要的正是重跑一遍。
+    // 报 completed 等于静默给错答案。
+    const wd = workdir();
+    const inputs = { goal: '目标 A' };
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init(inputs, HASH, []);
+    await st.markDone();
+    await st.archive();
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(
+      inputs,
+      'script-hash-v2',
+      [],
+    );
+    expect(r.mode).toBe('new-task');
+    expect(r.scriptChanged).toBe(true);
+  });
+
+  test('★ 运行时 declareArtifact 登记的产物必须落盘，否则下次 completed 报 0 产物', async () => {
+    // meta.artifacts 是静态字面量，写不出 `out/${session}/page-3.png` 这种带下标的
+    // 路径 —— 循环体里的逐迭代产物只能靠运行时登记。不落盘就静默漏档：
+    // completed 少报、new-task 清理也漏掉。端到端实跑抓到过。
+    const wd = workdir();
+    const inputs = { goal: '目标 A' };
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init(inputs, HASH, []); // 静态声明为空
+    artifact(wd, 'out/runtime-declared.md');
+    await st.markDone(['out/runtime-declared.md']); // 运行时登记的
+    await st.archive();
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(inputs, HASH, []);
+    expect(r.mode).toBe('completed');
+    expect(r.artifacts).toEqual(['out/runtime-declared.md']);
+  });
+
+  test('★ 同 session 换主题 → 各自独立实例，互不干扰', async () => {
+    const wd = workdir();
+    const a = new WorkflowState(wd, 'demo', 's1');
+    await a.init({ goal: '调研 A' }, HASH, []);
+    const b = new WorkflowState(wd, 'demo', 's1');
+    await b.init({ goal: '调研 B' }, HASH, [], async () => 'new');
+
+    expect(a.dir).not.toBe(b.dir);
+    expect(existsSync(join(a.dir, 'current.json'))).toBe(true);
+    expect(existsSync(join(b.dir, 'current.json'))).toBe(true);
+  });
+});
+
+describe('语义仲裁接入', () => {
+  const resumeArb: TaskArbitrator = async () => 'resume';
+  const newArb: TaskArbitrator = async () => 'new';
+
+  test('★ 仲裁判 resume → 采纳旧实例目录，新输入降级成补充要求', async () => {
+    const wd = workdir();
+    const first = new WorkflowState(wd, 'demo', 's1');
+    await first.init({ goal: '调研 A 主题' }, HASH, []);
+
+    const second = new WorkflowState(wd, 'demo', 's1');
+    const r = await second.init({ goal: '继续' }, HASH, [], resumeArb);
+
+    expect(r.mode).toBe('resume');
+    expect(second.dir).toBe(first.dir); // 用的是旧实例，不是新建一个
+    // 目标锚必须指向旧目标 —— 拿「继续」当目标会让后续每次调用都跑偏
+    expect(r.prevGoal).toBe('调研 A 主题');
+    expect(r.supplementaryGoal).toBe('继续');
+  });
+
+  test('仲裁判 new → 建新实例，旧的原样留着', async () => {
+    const wd = workdir();
+    const first = new WorkflowState(wd, 'demo', 's1');
+    await first.init({ goal: '调研 A 主题' }, HASH, []);
+
+    const second = new WorkflowState(wd, 'demo', 's1');
+    const r = await second.init({ goal: '完全不同的事' }, HASH, [], newArb);
+
+    expect(r.mode).toBe('new-task');
+    expect(second.dir).not.toBe(first.dir);
+    expect(existsSync(join(first.dir, 'current.json'))).toBe(true);
+  });
+
+  test('没有未完成的兄弟任务时不调用仲裁（省一次 LLM）', async () => {
+    const wd = workdir();
+    let called = false;
+    await new WorkflowState(wd, 'demo', 's1').init(
+      { goal: 'x' },
+      HASH,
+      [],
+      async () => {
+        called = true;
+        return 'new';
+      },
+    );
+    expect(called).toBe(false);
+  });
+});
+
+describe('声明产物的先归档再清理', () => {
+  test('★ 旧产物被 move 进 .trash 而不是直接删掉', async () => {
+    const wd = workdir();
+    await new WorkflowState(wd, 'demo', 's1').init({ goal: 'A' }, HASH, [
+      'out/report.md',
+    ]);
+    artifact(wd, 'out/report.md', '重要成果');
+
+    const second = new WorkflowState(wd, 'demo', 's1');
+    const r = await second.init(
+      { goal: 'B' },
+      HASH,
+      ['out/report.md'],
+      async () => 'new',
+    );
+
+    expect(r.mode).toBe('new-task');
+    expect(existsSync(join(wd, 'out/report.md'))).toBe(false); // 已从工作目录移走
+    expect(r.archivedTo).toBeDefined();
+    // 而且真的能在回收目录里找回来
+    expect(existsSync(join(wd, r.archivedTo as string, 'out/report.md'))).toBe(
+      true,
+    );
+  });
+
+  test('★ 没有任何产物可归档时不填 archivedTo（不谎报位置）', async () => {
+    const wd = workdir();
+    await new WorkflowState(wd, 'demo', 's1').init({ goal: 'A' }, HASH, [
+      'out/never.md',
+    ]);
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(
+      { goal: 'B' },
+      HASH,
+      ['out/never.md'],
+      async () => 'new',
+    );
+    expect(r.archivedTo).toBeUndefined();
+  });
+
+  test('glob 声明按实际匹配展开', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init({ goal: 'A' }, HASH, ['research/*.md']);
+    // ⚠️ 产物必须在 init **之后**造：fresh 启动会把已存在的声明产物残留
+    // 归档清理掉（`/new` 之后的孤儿文件靠这条），init 之前造等于自己清掉自己。
+    artifact(wd, 'research/01-a.md');
+    artifact(wd, 'research/02-b.md');
+    artifact(wd, 'research/notes.txt');
+    await st.markDone();
+    await st.archive();
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(
+      { goal: 'A' },
+      HASH,
+      ['research/*.md'],
+    );
+    expect(r.artifacts?.sort()).toEqual([
+      'research/01-a.md',
+      'research/02-b.md',
+    ]);
+  });
+
+  test('★ 越界路径 fail-closed —— 声明 ../ 跳出 cwd 的产物一律无视', async () => {
+    const wd = workdir();
+    const outside = join(wd, '..', 'outside-victim.md');
+    writeFileSync(outside, '别人的文件', 'utf8');
+    try {
+      await new WorkflowState(wd, 'demo', 's1').init({ goal: 'A' }, HASH, [
+        '../outside-victim.md',
+      ]);
+      const r = await new WorkflowState(wd, 'demo', 's1').init(
+        { goal: 'B' },
+        HASH,
+        ['../outside-victim.md'],
+        async () => 'new',
+      );
+      expect(r.cleanedArtifacts ?? []).toEqual([]);
+      expect(existsSync(outside)).toBe(true); // 一根汗毛都没动
+    } finally {
+      rmSync(outside, { force: true });
+    }
+  });
+});
+
+describe('补充要求持久化', () => {
+  test('追加后可读回，跨实例（跨进程）不丢', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init({ goal: 'A' }, HASH, []);
+    await st.appendSupplement('改成 12 页');
+
+    const again = new WorkflowState(wd, 'demo', 's1');
+    await again.init({ goal: 'A' }, HASH, []);
+    expect(await again.readSupplements()).toEqual(['改成 12 页']);
+  });
+
+  test('重复内容不重复追加（否则每次 resume 都会翻倍）', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init({ goal: 'A' }, HASH, []);
+    await st.appendSupplement('改成 12 页');
+    await st.appendSupplement('改成 12 页');
+    expect(await st.readSupplements()).toHaveLength(1);
+  });
+
+  test('空白内容被忽略', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init({ goal: 'A' }, HASH, []);
+    await st.appendSupplement('   ');
+    expect(await st.readSupplements()).toEqual([]);
+  });
+});
+
+describe('归档与失败记录', () => {
+  test('archive() 把实例目录改名成 .done', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init({ goal: 'A' }, HASH, []);
+    const before = st.dir;
+    await st.markDone();
+    await st.archive();
+    expect(st.dir).toBe(`${before}.done`);
+    expect(existsSync(before)).toBe(false);
+  });
+
+  test('recordFailure 的原因在下次 resume 时读得到', async () => {
+    const wd = workdir();
+    const st = new WorkflowState(wd, 'demo', 's1');
+    await st.init({ goal: 'A' }, HASH, []);
+    await st.recordFailure('provider 返回 429');
+
+    const r = await new WorkflowState(wd, 'demo', 's1').init(
+      { goal: 'A' },
+      HASH,
+      [],
+    );
+    expect(r.lastError).toBe('provider 返回 429');
+  });
+
+  test('progress 日志写失败不该让任务挂掉', async () => {
+    const st = new WorkflowState(workdir(), 'demo', 's1');
+    // 没 init，dir 为空 → 写盘必失败；但不许抛
+    await expect(st.appendProgress('一行')).resolves.toBeUndefined();
+  });
+});

package/skills/pptx/examples/assets/cover-bg.svg

@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1330 750">
+  <!-- 封面满铺美术背景：渐变 + 有机色块 + 一条流线。
+       注意：标题文字不写在 SVG 里 —— 留给 pptx 原生文字层（可编辑、可重排）。
+       每个语义元素用独立 <g>，PowerPoint「转换为形状」后即得干净可编辑形状。 -->
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0F172A"/>
+      <stop offset="0.55" stop-color="#1E2761"/>
+      <stop offset="1" stop-color="#024E5B"/>
+    </linearGradient>
+    <radialGradient id="glow" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#00A896" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#00A896" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+  <g id="background"><rect width="1330" height="750" fill="url(#bg)"/></g>
+  <g id="glow-orb"><circle cx="1020" cy="250" r="320" fill="url(#glow)"/></g>
+  <g id="ice-disc"><circle cx="1080" cy="200" r="150" fill="#CADCFC" opacity="0.9"/></g>
+  <g id="flow-line">
+    <path d="M0 600 Q 360 470 700 560 T 1330 470" stroke="#FFFFFF" stroke-width="3" fill="none" opacity="0.6"/>
+  </g>
+  <g id="accent-bar"><rect x="80" y="300" width="70" height="8" rx="4" fill="#00A896"/></g>
+</svg>

package/skills/pptx/examples/assets/icon-spark.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <!-- 小图标：圆底 + 闪电。单一语义用一个 <g>，转换为形状后可单独改色。 -->
+  <g id="badge"><circle cx="50" cy="50" r="46" fill="#00A896"/></g>
+  <g id="bolt"><path d="M56 18 L30 54 H48 L44 82 L72 44 H52 Z" fill="#FFFFFF"/></g>
+</svg>

package/skills/ui-design/SKILL.md

@@ -13,7 +13,10 @@ description: 高质量「样式与视觉设计」的统一入口，覆盖 web
 
 本技能同时服务两类产物、规则差异很大——**先认领路径，别读错规则带偏构图**：
 
-- 🅰 **deck / PPT 导出**（最常见；工作流 `/workflow ppt` 走这条）：目标是**静态、可编辑的 PPTX**。
+- 🅰 **deck / PPT 导出**（最常见）：目标是**静态、可编辑的 PPTX**。
+  > ⚠️ 曾经有一条 `/workflow ppt` 把下面这套脚本按序串起来，它随 yaml DSL 一并**下线**了
+  > （脚本与本技能都还在，只是没有现成编排了）。捞回旧编排：`git show ffbb313:workflows/ppt.yaml`，
+  > 重写成代码形态见 `skills/workflow-creator/references/migration.md`。在那之前，按下面的流程手动走。
   - **只读** `references/layout-composition.md`（grid 结构化构图 + 0.6 每页内容预算 + 图文混排）+ `references/export-pptx.md`（背景/前景/文本三层**自动分层**，标注可选）。
   - **流程**：按 archetype 用 CSS grid **大胆把画布填满**地排 `deck.html`（分层自动，正常写语义化 HTML 即可）→ `check_ui_artifact.py --for-pptx-export` 拦截坏 HTML（重复 head/body、裸 CSS、结构错误）→ `export_pptx_from_html.mjs --measure-only` 量几何 → `layout_balance.py` 判（硬门=**真重叠**、**截图夹带 HTML/SVG 文本**、**整页无内容**；软门=空半、挤角、空心卡片、覆盖率偏低等构图警告）→ 出现错误时按"问题+归一化坐标"改 HTML 重判直到通过 → `--mode hybrid` 导出一次 → `opc_check.py` 校验。
   - **以下网页规则对 deck 不适用**（下文看到请直接跳过）：`claude_design.md`、Tweaks/EDITMODE、localStorage/postMessage、React/Babel、JS 视口缩放、翻页 nav、`browser_check`（deck 走 `layout_balance` 闸门，不走 browser_check）。
@@ -147,7 +150,7 @@ description: 高质量「样式与视觉设计」的统一入口，覆盖 web
   - `--catastrophic-only`：**只**报「内容不可见灾难」（严重越界 + 无真实视觉的空页），**抑制**重叠/占空族噪声——供导出阶段做**回归安全的几何硬门**（不误伤只有良性相邻/嵌套重叠的干净 deck）。治本仍在 `layout-composition.md` §0.7 的 `min-width:0` 骨架。
   - `--ppt-strict`（2026-07-02，ppt 视觉门专用、默认关 = webppt 行为不变）：①重叠**去噪**——剔行盒贴边/膨胀父盒包含/行盒尾部（纵横）四类 box 模型伪象，只留真碰撞（真机 57 条→9 条全真）；②任何越界（含「超出下边缘」）升 ERROR；③**大空卡**（≥15% 页面、填充 <10%、且没被媒体块盖住 ≥70%——需 measure 产物带 mediaRects）升【空心大卡】ERROR；④（2026-07-03）**R6 导出加宽框幻影剔除**——重叠框按原点匹配回原始 textRuns 行盒重算，交叠归零的整条剔除（副标题导出框 h 达真实 2×、凭空压到下方卡片的假 ERROR）；⑤**R5 媒体卡内文字降 WARNING**——文字 ≥85% 落在含媒体前景卡内（caption/图内说明字，fgParent 断链才漏成重叠）降【媒体卡内文字】WARNING，可读性交像素门裁决；非媒体卡包含/骑边/text⊃fg 仍 ERROR（裸 `<img>` 自身作前景块时 hasMedia 恒 false，靠 fgRects 加性 `tag` 字段识别）。
 
-**ppt 工作流专属脚本（`/workflow ppt` 按序调用，细节 `--help`）**：
+**ppt 专属脚本（原 `/workflow ppt` 按序调用；该工作流已随 yaml DSL 下线，现按下面的顺序手动走，细节 `--help`）**：
 - 素材摄取：`resolve_source_input.py` → `extract_source_assets.py` → `assemble_material.py` → `plan_source_layout.py`（每张客户图确定性算定 route/模板/文字落区/是否图生图）。
 - 设计文档（design.json）：`normalize_design_json.py`（归一化字段）→ `design_budget_check.py`（每页要点数/字数预算防溢出，纯文本层）→ `design_style_check.py` / `deck_visual_style_check.py`（构图风格枚举 / 卡片墙·表格墙倾向 / **视觉优先内容形状**：max_visible_words 对账 + 影像叙事页 ≤3 条短语 + 文章化倾向 WARNING——治「文本阅读型页面」；`speaker_notes` 讲稿字段不计上屏、不参与倾向扫描，经 deck 的 `<aside class="speaker-notes" hidden>` 导出进 PPT 备注栏）→ `design_repair_hints.py`（有 ERROR 时收敛成小批修复提示）。
 - 配图：`image_prompt_rewrite.py`（t2i 提示词**唯一生产/净化点**：绑定页面锚点，且与 image_plan_lint **共享黑名单词表**——design 字段/原 prompt 里的结构词·坏审美词在拼接前被剥掉或触发安全重组，产出保证过 lint。**2026-07-03 背景层去内容化**：背景 t2i/i2i 提示词不再拼 `Slide title:/Core message:` 字面正文与图表描述——Seedream 类文字渲染型模型会照着画出整版烘字假幻灯片（ai_p9 事故），页面绑定只靠去数字化/去句子碎片的场景名词锚）→ `image_plan_lint.py`（兜底验证；ppt 链路只扫 img_plan prompt 不带 `--outline`，webppt 仍扫 note；新增 slide_copy 检查：背景 t2i prompt 含页标题/正文标记/图表词 → ERROR）/ `generated_image_review_collect.py`（生成图语义复核汇总——**已屏蔽**：2026-07-02 用户裁决验证只走确定性脚本，ppt.yaml 阶段14-16 when:"false"，恢复方法见该处注释；生成图带字风险由前述提示词去内容化+lint 从源头拦）。

package/skills/ui-design/references/layout-composition.md

@@ -413,7 +413,7 @@ PPT 不是每页都要浮动卡片。先根据内容和素材选择**整页视
 
 ### 2.2.1 `composition_style` 机器枚举（design.json 必填）
 
-`ppt.yaml` 的 `design.json` 每页必须写 `composition_style`，构建时按它落地，不再只靠 `archetype/composition` 猜：
+ppt 链路的 `design.json` 每页必须写 `composition_style`，构建时按它落地，不再只靠 `archetype/composition` 猜：
 
 | composition_style | 首选用途 | 视觉重量 | 禁用项 |
 |---|---|---:|---|