minimal-agent 0.12.0 → 0.14.0

package/workflows/wrong-question-docx/test/control-flow.test.ts

@@ -0,0 +1,165 @@
+import { expect, test } from 'bun:test';
+import { spawnSync } from 'node:child_process';
+import { mkdir, mkdtemp, readFile, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import sharp from 'sharp';
+import { loadWorkflowDir } from '../../../plugins/workflow-runner/src/discovery.js';
+import { runScript } from '../../../plugins/workflow-runner/src/sandbox.js';
+
+async function harness(questions?: string) {
+  const root = await mkdtemp(join(tmpdir(), 'wq-flow-'));
+  const workflowDir = resolve(
+    import.meta.dir,
+    '..',
+  );
+  const script = await loadWorkflowDir(workflowDir);
+  if (!script.ok) throw Error(script.errors.join(';'));
+  const path = join(root, 'context-with-neighbor.png');
+  await sharp({
+    create: { width: 1000, height: 300, channels: 3, background: '#ccc' },
+  })
+    .png()
+    .toFile(path);
+  const inventory = join(root, 'child-manifest.json');
+  await writeFile(
+    inventory,
+    JSON.stringify({
+      questions: ['5', '7', '10'].map((number, i) => ({
+        id: `q-${i + 1}`,
+        number,
+        section: '选择题',
+        status: 'exported',
+        content_status: number === '10' ? 'source_truncated' : 'complete',
+        missing_parts:
+          number === '10'
+            ? [{ kind: 'figure', reason: '原照片上缘未拍到完整数轴' }]
+            : [],
+        path,
+        fragments: [{ path, canvas: { x: 0, y: 0, width: 1000, height: 300 } }],
+      })),
+    }),
+  );
+  let children = 0;
+  const prompts: string[] = [];
+  const tool = async (_n: string, v: { file_path: string; content: string }) => {
+      const p = resolve(root, v.file_path);
+      await mkdir(resolve(p, '..'), { recursive: true });
+      await writeFile(p, v.content);
+    };
+  const execFile = async (_file: string, argv: string[]) => {
+      const [action] = argv;
+      if (action === 'render')
+        return {
+          exitCode: 0,
+          stdout: JSON.stringify({ pdf: join(root, 'fake.pdf'), pages: [] }),
+          stderr: '',
+        };
+      const target = resolve(workflowDir, _file);
+      const r = spawnSync(process.execPath, [target, ...argv], {
+        cwd: root,
+        encoding: 'utf8',
+      });
+      return { exitCode: r.status, stdout: r.stdout, stderr: r.stderr };
+    };
+  const child = async (name: string, inputs: unknown) => {
+      expect(name).toBe('question-crops');
+      expect(inputs).toEqual({ source: path, vision_timeout_seconds: 900 });
+      children++;
+      return { workflow: name, result: { manifest: inventory }, artifacts: [] };
+    };
+  const llm = async (
+      prompt: string,
+      opts: { isolated: boolean; images: unknown[] },
+    ) => {
+      expect(opts.isolated).toBe(true);
+      expect(opts.images).toHaveLength(1);
+      prompts.push(prompt);
+      const target = JSON.parse(prompt.split('目标绑定：')[1].split('\n')[0]);
+      expect(prompt).toContain('邻题');
+      expect(prompt).toContain('第X题图');
+      return {
+        question_id: target.question_id,
+        observed_number:
+          target.printed_number === '7' ? '5' : target.printed_number,
+        status: target.printed_number === '10' ? 'partial' : 'ready',
+        reason: '缺少数轴图',
+        type: 'short',
+        blocks: [{ kind: 'text', text: `仅第${target.printed_number}题原文` }],
+        figures: [],
+        missing_parts:
+          target.printed_number === '10'
+            ? [
+                {
+                  kind: 'figure',
+                  reason: '原照片上缘未拍到完整数轴',
+                  source_limited: true,
+                },
+              ]
+            : [],
+      };
+    };
+  const wf = {
+    input: { values: { source: path, questions }, resources: {} },
+    runtime: {
+      workflowName: 'wrong-question-docx', workflowDir, cwd: root,
+      sessionId: 'fixture', taskId: 'test', runId: 'run', rootRunId: 'run', goal: '',
+    },
+    model: { generate: llm, agent: async () => '', skill: async () => '', require: async () => undefined },
+    tools: { call: tool, callResult: async () => ({ content: '', images: [] }) },
+    exec: { shell: async () => ({ exitCode: 0, stdout: '', stderr: '' }), file: execFile },
+    fs: {
+      exists: async () => true,
+      readText: async (p: string) => readFile(p, 'utf8'),
+      readJson: async (p: string) => JSON.parse(await readFile(p, 'utf8')),
+      writeText: async () => undefined,
+      writeJson: async () => undefined,
+      mkdir: async () => undefined,
+    },
+    flow: { pipeline: async () => ({ results: [], succeeded: 0, failed: 0 }), child, ask: async () => '等待指定题号' },
+    check: { verify: async () => ({ passed: true, summary: '', details: [] }) },
+    state: { budget: () => ({}), resetModelContext: () => undefined, addGoalSupplement: async () => undefined, syncManagedContract: async () => undefined },
+    output: { message: () => undefined, progress: () => undefined, artifact: () => undefined },
+  };
+  return {
+    run: () => runScript(script.workflow, wf, 'test-bundle'),
+    children: () => children,
+    prompts,
+    root,
+  };
+}
+
+test('逐题绑定目标：拒绝邻题替代，源图缺图保留题干，后题继续', async () => {
+  const h = await harness('5,7,10,13');
+  const result = (await h.run()) as { manifest: string };
+  const m = JSON.parse(await readFile(result.manifest, 'utf8'));
+  expect(h.children()).toBe(1);
+  expect(h.prompts).toHaveLength(3);
+  expect(m.questions.map((q: { status: string }) => q.status)).toEqual([
+    'success',
+    'missing',
+    'partial',
+    'missing',
+  ]);
+  expect(m.success + m.partial + m.missing).toBe(4);
+  expect(m.questions[1].reason).toContain('不匹配');
+  expect(m.questions[2].reason).toContain('数轴');
+  expect(m.questions[3].reason).toContain('未找到');
+});
+
+test('没有指定题号先询问，不调用子流程、不暗中全抄', async () => {
+  const h = await harness();
+  const result = (await h.run()) as { status: string };
+  expect(result.status).toBe('awaiting_selection');
+  expect(h.children()).toBe(0);
+  expect(h.prompts).toHaveLength(0);
+});
+
+test('零可整理题只交付清单和报告，不生成Word', async () => {
+  const h = await harness('7,13');
+  const result = (await h.run()) as { manifest: string; docx?: string };
+  expect(result.docx).toBeUndefined();
+  const m = JSON.parse(await readFile(result.manifest, 'utf8'));
+  expect(m.success).toBe(0);
+  expect(m.missing).toBe(2);
+});

package/workflows/wrong-question-docx/test/workbook.test.mjs

@@ -0,0 +1,303 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { mkdtemp, readFile, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { test } from 'node:test';
+import { fileURLToPath } from 'node:url';
+import { strFromU8, unzipSync } from 'fflate';
+import sharp from 'sharp';
+import {
+  answerLines,
+  checkDetail,
+  containsMathMarkup,
+  detailMissingParts,
+  groupFigures,
+  mathComponents,
+  parseSelection,
+  selectQuestions,
+  toPixels,
+  unsupportedMathCommands,
+} from '../scripts/workbook.mjs';
+
+test('相邻图(1)+(2)合并为一个整体，远处分散图不跨邻题合并', () => {
+  const figures = [
+    {
+      id: 'g1',
+      kind: 'figure',
+      description: '图1',
+      box: { x: 295, y: 608, width: 290, height: 270 },
+    },
+    {
+      id: 'g2',
+      kind: 'figure',
+      description: '图2',
+      box: { x: 635, y: 685, width: 225, height: 195 },
+    },
+  ];
+  const merged = groupFigures(figures);
+  assert.equal(merged.length, 1);
+  assert.deepEqual(merged[0].members, ['g1', 'g2']);
+  assert.deepEqual(merged[0].box, { x: 295, y: 608, width: 565, height: 272 });
+  assert.equal(
+    groupFigures([
+      figures[0],
+      { ...figures[1], box: { x: 0, y: 0, width: 200, height: 200 } },
+    ]).length,
+    2,
+  );
+  const q16 = groupFigures([
+    {
+      id: 'fig-16-1',
+      kind: 'figure',
+      description: '图1',
+      box: { x: 190, y: 565, width: 215, height: 310 },
+    },
+    {
+      id: 'fig-16-2',
+      kind: 'figure',
+      description: '图2',
+      box: { x: 580, y: 640, width: 275, height: 255 },
+    },
+  ]);
+  assert.equal(q16.length, 1);
+  assert.deepEqual(q16[0].members, ['fig-16-1', 'fig-16-2']);
+  assert.deepEqual(q16[0].box, { x: 190, y: 565, width: 665, height: 330 });
+});
+
+const script = fileURLToPath(
+  new URL('../scripts/workbook.mjs', import.meta.url),
+);
+test('指定顺序去重、缺题占位、重复章节拒绝猜测', () => {
+  const selection = parseSelection('7,5,7,13-16');
+  assert.deepEqual(
+    selection.items.map((i) => i.number),
+    ['7', '5', '13', '14', '15', '16'],
+  );
+  const manifest = {
+    questions: [
+      { id: 'q-001', number: '5', section: '选择', status: 'exported' },
+    ],
+  };
+  assert.equal(
+    selectQuestions(manifest, selection)[0].reason,
+    '指定题目未找到',
+  );
+  assert.equal(selectQuestions(manifest, selection)[1].sourceId, 'q-001');
+  manifest.questions.push({
+    id: 'q-002',
+    number: '5',
+    section: '填空',
+    status: 'exported',
+  });
+  assert.throws(
+    () => selectQuestions(manifest, parseSelection('5')),
+    /多个章节/,
+  );
+  assert.equal(
+    selectQuestions(manifest, parseSelection('填空:5'))[0].sourceId,
+    'q-002',
+  );
+  assert.equal(selectQuestions(manifest, parseSelection('all')).length, 2);
+  assert.deepEqual(parseSelection(''), { all: false, items: [] });
+});
+
+test('目标题号不是文件序号；邻题替代、缺图及错误归属返回不得入文档', () => {
+  const q = { sourceId: 'q-001', number: '5' };
+  const detail = {
+    question_id: 'q-001',
+    observed_number: '5',
+    status: 'ready',
+    missing_parts: [],
+    blocks: [{ text: '目标题' }],
+    figures: [],
+  };
+  assert.equal(checkDetail(q, detail), '');
+  assert.match(checkDetail(q, { ...detail, observed_number: '7' }), /不匹配/);
+  assert.match(checkDetail(q, { ...detail, question_id: 'q-005' }), /不匹配/);
+  assert.equal(
+    checkDetail(q, { ...detail, status: 'missing', reason: '数轴缺失' }),
+    '数轴缺失',
+  );
+  assert.match(
+    checkDetail(q, {
+      ...detail,
+      figures: [{ id: 'g', box: { x: 900, y: 0, width: 200, height: 100 } }],
+    }),
+    /坐标/,
+  );
+  assert.match(
+    checkDetail(q, {
+      ...detail,
+      blocks: [{ kind: 'formula', text: '\\overline{AB}' }],
+    }),
+    /不支持的数学标记/,
+  );
+  const sourceLimited = {
+    ...q,
+    content_status: 'source_truncated',
+    missing_parts: [{ kind: 'figure', reason: '原照片上缘未拍到完整数轴' }],
+  };
+  const partial = {
+    ...detail,
+    status: 'partial',
+    blocks: [{ text: '如图，数轴上点A表示的数为1' }],
+    missing_parts: [
+      { kind: 'figure', reason: '数轴主体缺失', source_limited: true },
+    ],
+  };
+  assert.equal(checkDetail(sourceLimited, partial), '');
+  assert.deepEqual(
+    detailMissingParts(sourceLimited, partial).map((part) => part.kind),
+    ['figure'],
+  );
+  assert.match(
+    checkDetail(sourceLimited, {
+      ...partial,
+      missing_parts: [
+        { kind: 'option', reason: '选项缺失', source_limited: true },
+      ],
+    }),
+    /选项缺失/,
+  );
+});
+
+test('配图由实际预览比例回到奇数尺寸底图；答题行宽裕', () => {
+  const g = {
+    width: 1920,
+    height: 1281,
+    scaleX: 1920 / 3001,
+    scaleY: 1281 / 2003,
+    sourceWidth: 3001,
+    sourceHeight: 2003,
+  };
+  const b = toPixels({ x: 101, y: 203, width: 401, height: 503 }, g);
+  assert.ok(Math.abs(b.left - 3001 * 0.101) < 1);
+  assert.ok(Math.abs(b.top + b.height - 2003 * 0.706) < 1);
+  assert.equal(answerLines('long', 'standard', 0), 12);
+  assert.equal(answerLines('short', 'standard', 1), 10);
+  assert.equal(
+    mathComponents('-1\\frac{7}{12}').length,
+    3,
+    'mixed number becomes minus, integer and a native fraction',
+  );
+  assert.equal(
+    containsMathMarkup({ kind: 'option', text: 'A. \\frac{1}{2}' }),
+    true,
+  );
+  assert.deepEqual(unsupportedMathCommands('x+\\overline{y}'), ['overline']);
+  assert.throws(() => mathComponents('x+\\overline{y}'), /不支持/);
+});
+
+test('真实Node脚本：原片段重建、裁图、可编辑Word与OPC核对', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'wq-workbook-'));
+  async function action(name, payload) {
+    const path = join(root, `${name}.json`);
+    await writeFile(path, JSON.stringify(payload));
+    const r = spawnSync(process.execPath, [script, name, path], {
+      encoding: 'utf8',
+    });
+    assert.equal(r.status, 0, r.stderr);
+    return JSON.parse(r.stdout);
+  }
+  const raw = join(root, 'raw.png');
+  const enhanced = join(root, 'enhanced.png');
+  await sharp({
+    create: { width: 2001, height: 301, channels: 3, background: '#999' },
+  })
+    .png()
+    .toFile(raw);
+  await sharp(raw).linear(2, -128).png().toFile(enhanced);
+  const q = {
+    id: 'item-001',
+    sourceId: 'q-005',
+    number: '5',
+    section: '选择',
+    path: enhanced,
+    fragments: [
+      { path: raw, canvas: { x: 0, y: 0, width: 2001, height: 301 } },
+    ],
+  };
+  const p = await action('prepare', { root, question: q });
+  assert.equal(p.plain.width, 1920);
+  assert.equal(p.plain.sourceWidth, 2001);
+  const f = await action('crop', {
+    root,
+    id: q.id,
+    base: p.faithful,
+    geometry: p.plain,
+    attempt: 1,
+    figures: [
+      {
+        id: 'group',
+        description: '目标图组',
+        box: { x: 100, y: 100, width: 500, height: 500 },
+      },
+    ],
+  });
+  assert.ok(f.figures[0].width > 1000);
+  const manifest = {
+    answerSpace: 'standard',
+    questions: [
+      {
+        ...q,
+        status: 'success',
+        type: 'short',
+        blocks: [
+          { kind: 'text', text: '只抄第5题，不含邻题。' },
+          { kind: 'formula', text: '-1\\frac{7}{12}' },
+          { kind: 'option', text: 'A. -\\frac{3π}{8}+6' },
+        ],
+        figures: f.figures,
+      },
+      {
+        id: 'item-002',
+        number: '10',
+        status: 'partial',
+        reason: '原照片未拍到数轴主体',
+        missingParts: [
+          {
+            kind: 'figure',
+            reason: '原照片未拍到数轴主体',
+            source_limited: true,
+          },
+        ],
+        type: 'short',
+        blocks: [{ kind: 'text', text: '如图，数轴上点A表示的数为1。' }],
+        figures: [],
+      },
+    ],
+  };
+  const built = await action('build', { root, manifest });
+  const checked = await action('validate', { path: built.path, manifest });
+  assert.deepEqual(checked, {
+    passed: true,
+    questions: 2,
+    images: 1,
+    formulas: 2,
+  });
+  assert.ok((await readFile(built.path)).length > 0);
+  const documentXml = strFromU8(
+    unzipSync(await readFile(built.path))['word/document.xml'],
+  );
+  assert.match(documentXml, /<m:f>/, 'fraction uses native Word OMML');
+  assert.doesNotMatch(documentXml, /\\frac/, 'learner text has no TeX source');
+  assert.match(documentXml, /第10题（配图待补）/);
+  assert.match(documentXml, /原照片未拍到完整内容/);
+});
+
+test('所有视觉入口重复绑定印刷题号；提示词禁止把第7题图移给第5题', async () => {
+  const workflow = await readFile(
+    new URL('../workflow.mjs', import.meta.url),
+    'utf8',
+  );
+  const prompt = await readFile(
+    new URL('../prompts/transcribe.md', import.meta.url),
+    'utf8',
+  );
+  assert.match(workflow, /printed_number:\s*q.number/);
+  assert.match(workflow, /figureQA\s*\+\s*binding/);
+  assert.match(prompt, /第X题图/);
+  assert.match(prompt, /邻题/);
+  assert.match(prompt, /实际看见/);
+});