helixlife-v5-cli 1.1.3

package/scripts/analysis-detail-upload-both.js

@@ -0,0 +1,45 @@
+async page => {
+  const files = [
+    {
+      label: '数据矩阵',
+      path: 'C:/Users/zouyh/Desktop/WorkSpace/jieluoxuan/cli/helix-cli/.helixlife-v5-cli/差异分析-数据矩阵1.csv',
+    },
+    {
+      label: '样本信息',
+      path: 'C:/Users/zouyh/Desktop/WorkSpace/jieluoxuan/cli/helix-cli/.helixlife-v5-cli/差异分析-样本信息2.xlsx',
+    },
+  ];
+
+  const card = page
+    .locator('main .u-filter-card')
+    .filter({ hasText: '数据参数' });
+
+  for (const { label, path: filePath } of files) {
+    const row = card.getByText(label, { exact: true }).locator('..');
+    const openUpload = row
+      .getByLabel('上传文件 - 打开上传弹窗')
+      .or(row.getByLabel('上传文件'));
+    await openUpload.click();
+
+    const dlg = page.getByRole('dialog', { name: '上传文件' });
+    await dlg.waitFor({ state: 'visible', timeout: 8000 });
+
+    await dlg.locator('input[type="file"]').setInputFiles(filePath);
+    await page.waitForTimeout(500);
+    await dlg.getByRole('button', { name: '确认' }).click();
+    await dlg.waitFor({ state: 'hidden', timeout: 15000 });
+    await page.waitForTimeout(1500);
+  }
+
+  if ((await card.getByRole('button', { name: '验证' }).count()) > 0) {
+    await card.getByRole('button', { name: '验证' }).click();
+    await page.waitForTimeout(2000);
+  }
+
+  const text = await card.innerText();
+  return {
+    files: files.map(f => ({ label: f.label, file: f.path.split(/[/\\]/).pop() })),
+    verifySuccess: text.includes('验证成功'),
+    verifyFail: text.includes('验证失败'),
+  };
+}

package/scripts/analysis-detail-upload-file.js

@@ -0,0 +1,52 @@
+/**
+ * 数据分析 · 工具详情页 · 上传文件（D-2 三步弹窗）
+ *
+ * 1) getByLabel('上传文件 - 打开上传弹窗') → dialog "上传文件"
+ * 2) 弹窗内 button /将文件拖到此处|点击上传/ + filechooser
+ * 3) 弹窗内 button「确认」
+ *
+ * 修改 filePath / paramLabel 后执行：
+ *   helixlife-v5-cli run-code --filename=scripts/analysis-detail-upload-file.js
+ */
+async page => {
+  const filePath = 'C:/Users/zouyh/Desktop/helix-test-upload.csv';
+  const paramLabel = null; // 如 '数据矩阵'；null 表示单上传行或取第一行
+
+  const card = page.locator('main .u-filter-card');
+  const row = paramLabel
+    ? card.getByText(paramLabel, { exact: true }).locator('..')
+    : card;
+  const openUpload = (paramLabel ? row : card)
+    .getByLabel('上传文件 - 打开上传弹窗')
+    .or((paramLabel ? row : card).getByLabel('上传文件'))
+    .first();
+  await openUpload.click();
+
+  const dlg = page.getByRole('dialog', { name: '上传文件' });
+  await dlg.waitFor({ state: 'visible', timeout: 8000 });
+
+  const uploadBtn = dlg.getByRole('button', {
+    name: /将文件拖到此处|点击上传/,
+  });
+  const [chooser] = await Promise.all([
+    page.waitForEvent('filechooser', { timeout: 8000 }),
+    uploadBtn.click(),
+  ]);
+  await chooser.setFiles(filePath);
+  await dlg.getByRole('button', { name: '确认' }).click();
+  await dlg.waitFor({ state: 'hidden', timeout: 8000 }).catch(() => {});
+
+  const main = page.locator('main');
+  await page.waitForTimeout(1500);
+  if ((await main.getByRole('button', { name: '验证' }).count()) > 0) {
+    await main.getByRole('button', { name: '验证' }).click();
+    await page.waitForTimeout(2000);
+  }
+  const text = await main.innerText();
+  return {
+    filePath,
+    paramLabel,
+    verifySuccess: text.includes('验证成功'),
+    verifyFail: text.includes('验证失败'),
+  };
+};

package/scripts/chrome-pdf-enumerate-a11y.js

@@ -0,0 +1,16 @@
+/**
+ * 枚举当前 PDF 阅读器帧内带 aria-label 的节点（排障 / 对照 site-ops 控件表）。
+ * 运行：helixlife-v5-cli run-code --filename=scripts/chrome-pdf-enumerate-a11y.js
+ */
+async page => {
+  const PDF_VIEWER_PREFIX = 'chrome-extension://mhjfbmdgcfjbbpaeojofohoefgiehjai';
+  const fr = page.frames().find(f => f.url().startsWith(PDF_VIEWER_PREFIX));
+  if (!fr)
+    throw new Error(
+      `未找到 Chrome 内置 PDF 阅读器 frame（前缀 ${PDF_VIEWER_PREFIX}）。请确认「课件」Tab 与 PDF 已加载。`
+    );
+  const labels = await fr.locator('[aria-label]').evaluateAll(elements =>
+    [...new Set(elements.map(el => el.getAttribute('aria-label')).filter(Boolean))].sort()
+  );
+  return { count: labels.length, ariaLabels: labels };
+}

package/scripts/chrome-pdf-goto-page.js

@@ -0,0 +1,30 @@
+/**
+ * Helix 学习中心 · 课件 Tab · Chrome 内置 PDF 页码跳转（S-25）。
+ * 执行前将 target 改为用户口述的第 N 页（1 起计）。
+ * 运行：helixlife-v5-cli run-code --filename=scripts/chrome-pdf-goto-page.js
+ */
+async page => {
+  const PDF_VIEWER_PREFIX = 'chrome-extension://mhjfbmdgcfjbbpaeojofohoefgiehjai';
+  const target = 1;
+
+  const fr = page.frames().find(f => f.url().startsWith(PDF_VIEWER_PREFIX));
+  if (!fr)
+    throw new Error(
+      `未找到 Chrome 内置 PDF 阅读器 frame（期望 url 前缀 ${PDF_VIEWER_PREFIX}）。请确认已在「课件」Tab 且 PDF 已加载。`
+    );
+
+  const pageInput = fr.getByLabel('页码');
+  const want = String(target);
+
+  for (let attempt = 1; attempt <= 2; attempt++) {
+    await pageInput.click({ clickCount: 3 });
+    await pageInput.fill(want);
+    await pageInput.press('Enter');
+    const v = await pageInput.inputValue();
+    if (v === want)
+      return { ok: true, target, inputValue: v, attempts: attempt };
+  }
+
+  const last = await pageInput.inputValue();
+  return { ok: false, target, inputValue: last, attempts: 2 };
+}

package/scripts/chrome-pdf-zoom-out.js

@@ -0,0 +1,14 @@
+/**
+ * Chrome 内置 PDF 工具栏 · 点击「缩小」。
+ * 运行：helixlife-v5-cli run-code --filename=scripts/chrome-pdf-zoom-out.js
+ */
+async page => {
+  const PDF_VIEWER_PREFIX = 'chrome-extension://mhjfbmdgcfjbbpaeojofohoefgiehjai';
+  const fr = page.frames().find(f => f.url().startsWith(PDF_VIEWER_PREFIX));
+  if (!fr)
+    throw new Error(
+      `未找到 Chrome 内置 PDF 阅读器 frame（前缀 ${PDF_VIEWER_PREFIX}）。请确认「课件」Tab 与 PDF 已加载。`
+    );
+  await fr.getByRole('button', { name: '缩小' }).click();
+  return { ok: true };
+}

package/scripts/jigsaw-inspect-dom.js

@@ -0,0 +1,15 @@
+async page => {
+  return page.evaluate(() => {
+    const root = document.querySelector('.jigsaw');
+    if (!root) return null;
+    const walk = (el, depth = 0) => {
+      if (depth > 4) return null;
+      return {
+        tag: el.tagName,
+        cls: (el.className || '').toString().slice(0, 80),
+        ch: [...el.children].slice(0, 8).map(c => walk(c, depth + 1)),
+      };
+    };
+    return [...root.children].map(c => walk(c, 0));
+  });
+}

package/scripts/jigsaw-verify-bio-tools.js

@@ -0,0 +1,11 @@
+/** 展开生信工具 Ant Select 并枚举选项 */
+async page => {
+  const main = page.locator('main');
+  const selectWrap = main.locator('generic[title="生信工具"]').locator('..');
+  const combo = selectWrap.getByRole('combobox');
+  await combo.click({ force: true });
+  await page.waitForTimeout(600);
+  const options = await page.locator('.ant-select-item-option-content').allTextContents();
+  await page.keyboard.press('Escape');
+  return { optionCount: options.length, options: options.slice(0, 40) };
+}

package/scripts/jigsaw-verify-drag-tool.js

@@ -0,0 +1,23 @@
+/** 自左侧 .jigsaw-images 拖入 .analysis-right-box */
+async page => {
+  const main = page.locator('main');
+  const tiff = main.getByRole('button', { name: 'TIFF下载' });
+  const beforeDisabled = await tiff.isDisabled();
+
+  const src = page.locator('.jigsaw-images .cursor-move').first();
+  const board = page.locator('.analysis-right-box');
+  await src.dragTo(board, { targetPosition: { x: 120, y: 120 } });
+  await page.waitForTimeout(1500);
+
+  const placed = await board.evaluate(box => ({
+    childCount: box.children.length,
+    htmlLen: box.innerHTML.length,
+  }));
+
+  return {
+    beforeDisabled,
+    afterDisabled: await tiff.isDisabled(),
+    pdfDisabled: await main.getByRole('button', { name: 'PDF下载' }).isDisabled(),
+    placed,
+  };
+}

package/scripts/jigsaw-verify-enumerate.js

@@ -0,0 +1,54 @@
+/** 拼图工具页 · 非破坏性枚举。helixlife-v5-cli run-code --filename=scripts/jigsaw-verify-enumerate.js */
+async page => {
+  const main = page.locator('main');
+  const out = {
+    pathname: await page.evaluate(() => location.pathname),
+    title: await page.title(),
+  };
+
+  const abcBtn = main.getByRole('button', { name: 'ABC标注' });
+  if ((await abcBtn.getAttribute('aria-expanded')) !== 'true') {
+    await abcBtn.click();
+    await page.waitForTimeout(400);
+  }
+  out.abcExpanded = (await abcBtn.getAttribute('aria-expanded')) === 'true';
+
+  const labels = [
+    '是否标注',
+    '字体',
+    '标注',
+    '标注大小',
+    '左偏斜',
+    '上偏斜',
+    '固定输出图片宽度',
+    '固定输出图片高度',
+  ];
+  out.abcFieldsVisible = {};
+  for (const label of labels) {
+    out.abcFieldsVisible[label] = await main.getByText(label, { exact: true }).first().isVisible();
+  }
+  out.annotationSwitchChecked = await main
+    .getByText('是否标注', { exact: true })
+    .locator('..')
+    .locator('[role=switch]')
+    .first()
+    .getAttribute('aria-checked');
+  out.annotationText = await main.getByRole('textbox', { name: '逗号间隔' }).inputValue();
+  out.fontShown = await main.locator('text=Arial').first().isVisible().catch(() => false);
+  out.sizeShown = await main.locator('text=15pt').first().isVisible().catch(() => false);
+
+  out.comboboxCount = await main.getByRole('combobox').count();
+  out.bioLabelVisible = await main.getByText('生信工具', { exact: true }).isVisible();
+
+  out.referenceLineButtons = {
+    horizontal: await main.getByText('横向参考线', { exact: true }).isVisible(),
+    vertical: await main.getByText('竖向参考线', { exact: true }).isVisible(),
+    clear: await main.getByText('清除参考线', { exact: true }).isVisible(),
+  };
+
+  out.tiffDisabled = await main.getByRole('button', { name: 'TIFF下载' }).isDisabled();
+  out.pdfDisabled = await main.getByRole('button', { name: 'PDF下载' }).isDisabled();
+  out.historyVisible = await main.getByText('历史记录', { exact: true }).isVisible();
+
+  return out;
+}

package/scripts/jigsaw-verify-reference-lines.js

@@ -0,0 +1,27 @@
+/** 参考线：横向 → 竖向 → 清除；用页面内标尺区 DOM 变化作辅验收 */
+async page => {
+  const main = page.locator('main');
+  const countGuides = () =>
+    page.evaluate(() => {
+      const mainEl = document.querySelector('main');
+      if (!mainEl) return 0;
+      const texts = [...mainEl.querySelectorAll('*')].filter(
+        el => el.childElementCount === 0 && /^\d+$/.test((el.textContent || '').trim())
+      );
+      const svgs = mainEl.querySelectorAll('svg line, svg path[stroke]');
+      return { svgLines: svgs.length, rulerNums: texts.length };
+    });
+
+  const before = await countGuides();
+  await main.getByText('横向参考线', { exact: true }).click();
+  await page.waitForTimeout(400);
+  const afterH = await countGuides();
+  await main.getByText('竖向参考线', { exact: true }).click();
+  await page.waitForTimeout(400);
+  const afterV = await countGuides();
+  await main.getByText('清除参考线', { exact: true }).click();
+  await page.waitForTimeout(400);
+  const afterClear = await countGuides();
+
+  return { before, afterH, afterV, afterClear, clicksOk: true };
+}