@finebi/finebi-cli 1.6.1 → 1.6.2

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/src/services/table-data.ts

@@ -1,47 +1,47 @@
-import type {Cell,Dataset,WidgetBinding} from '../finebi/types';
-import {displayCell} from './view-data';
-function decimal(value:string) {
-  const match=/^([+-]?)(\d*\.?\d+|\d+\.)(?:e([+-]?\d+))?$/i.exec(value);
-  if(!match)throw new Error('无效十进制值');
-  const [whole,fraction='']=match[2].split('.');
-  const digits=(whole+fraction).replace(/^0+/,'').replace(/0+$/,'');
-  const significant=(whole+fraction).replace(/^0+/,'');
-  return {sign:!digits?0:match[1]==='-'?-1:1,digits,order:BigInt(significant.length)+BigInt(match[3]||0)-BigInt(fraction.length)};
-}
-export function compareDecimal(a:string,b:string) {
-  const x=decimal(a),y=decimal(b);
-  if(x.sign!==y.sign)return x.sign<y.sign?-1:1;
-  if(x.sign===0)return 0;
-  const length=Math.max(x.digits.length,y.digits.length);
-  const left=x.digits.padEnd(length,'0'),right=y.digits.padEnd(length,'0');
-  const order=x.order!==y.order?(x.order<y.order?-1:1):left===right?0:left<right?-1:1;
-  return order===0?0:order*x.sign;
-}
-export function tableDataset(dataset:Dataset,binding:WidgetBinding):Dataset {
-  if(!binding.tableFieldIds)return dataset;
-  const indices=binding.tableFieldIds.map(id=>fieldIndex(dataset,id));
-  return {...dataset,columns:indices.map(i=>dataset.columns[i]),rows:dataset.rows.map(row=>({...row,cells:indices.map(i=>row.cells[i])}))};
-}
-export function fieldIndex(dataset:Dataset,id:string) {
-  const index=dataset.columns.findIndex(c=>c.fieldId===id);
-  if(index<0)throw new Error(`结果字段绑定缺失：${id}`);
-  return index;
-}
-type Options={search:string;sort?:{fieldId:string;direction:'asc'|'desc'};filters:Record<string,string>};
-export function tableRows(dataset:Dataset,{search,sort,filters}:Options) {
-  const columns=Object.entries(filters).map(([id,value])=>({index:fieldIndex(dataset,id),value}));
-  const rows=dataset.rows.filter(row=>row.cells.some(c=>displayCell(c).toLocaleLowerCase().includes(search.toLocaleLowerCase()))&&columns.every(({index,value})=>!value||displayCell(row.cells[index])===value));
-  if(!sort)return rows;
-  const index=fieldIndex(dataset,sort.fieldId),numeric=dataset.columns[index].type==='DECIMAL';
-  return [...rows].sort((a,b)=>{
-    const x=a.cells[index],y=b.cells[index];
-    const valid=(c:Cell)=>c.state==='AVAILABLE'&&c.value!==null;
-    if(!valid(x)||!valid(y))return valid(x)?-1:valid(y)?1:0;
-    const order=numeric?compareDecimal(x.value!,y.value!):displayCell(x).localeCompare(displayCell(y),'zh-CN');
-    return sort.direction==='asc'?order:-order;
-  });
-}
-export function tableCsv(dataset:Dataset,rows:Dataset['rows']) {
-  const escape=(value:string)=>`"${(/^[\s]*[=+\-@]/.test(value)?"'"+value:value).replace(/"/g,'""')}"`;
-  return '\uFEFF'+[[...dataset.columns.map(c=>c.name),'行类型'],...rows.map(row=>[...row.cells.map(displayCell),row.kind])].map(row=>row.map(escape).join(',')).join('\r\n');
-}
+import type {Cell,Dataset,WidgetBinding} from '../finebi/types';
+import {displayCell} from './view-data';
+function decimal(value:string) {
+  const match=/^([+-]?)(\d*\.?\d+|\d+\.)(?:e([+-]?\d+))?$/i.exec(value);
+  if(!match)throw new Error('无效十进制值');
+  const [whole,fraction='']=match[2].split('.');
+  const digits=(whole+fraction).replace(/^0+/,'').replace(/0+$/,'');
+  const significant=(whole+fraction).replace(/^0+/,'');
+  return {sign:!digits?0:match[1]==='-'?-1:1,digits,order:BigInt(significant.length)+BigInt(match[3]||0)-BigInt(fraction.length)};
+}
+export function compareDecimal(a:string,b:string) {
+  const x=decimal(a),y=decimal(b);
+  if(x.sign!==y.sign)return x.sign<y.sign?-1:1;
+  if(x.sign===0)return 0;
+  const length=Math.max(x.digits.length,y.digits.length);
+  const left=x.digits.padEnd(length,'0'),right=y.digits.padEnd(length,'0');
+  const order=x.order!==y.order?(x.order<y.order?-1:1):left===right?0:left<right?-1:1;
+  return order===0?0:order*x.sign;
+}
+export function tableDataset(dataset:Dataset,binding:WidgetBinding):Dataset {
+  if(!binding.tableFieldIds)return dataset;
+  const indices=binding.tableFieldIds.map(id=>fieldIndex(dataset,id));
+  return {...dataset,columns:indices.map(i=>dataset.columns[i]),rows:dataset.rows.map(row=>({...row,cells:indices.map(i=>row.cells[i])}))};
+}
+export function fieldIndex(dataset:Dataset,id:string) {
+  const index=dataset.columns.findIndex(c=>c.fieldId===id);
+  if(index<0)throw new Error(`结果字段绑定缺失：${id}`);
+  return index;
+}
+type Options={search:string;sort?:{fieldId:string;direction:'asc'|'desc'};filters:Record<string,string>};
+export function tableRows(dataset:Dataset,{search,sort,filters}:Options) {
+  const columns=Object.entries(filters).map(([id,value])=>({index:fieldIndex(dataset,id),value}));
+  const rows=dataset.rows.filter(row=>row.cells.some(c=>displayCell(c).toLocaleLowerCase().includes(search.toLocaleLowerCase()))&&columns.every(({index,value})=>!value||displayCell(row.cells[index])===value));
+  if(!sort)return rows;
+  const index=fieldIndex(dataset,sort.fieldId),numeric=dataset.columns[index].type==='DECIMAL';
+  return [...rows].sort((a,b)=>{
+    const x=a.cells[index],y=b.cells[index];
+    const valid=(c:Cell)=>c.state==='AVAILABLE'&&c.value!==null;
+    if(!valid(x)||!valid(y))return valid(x)?-1:valid(y)?1:0;
+    const order=numeric?compareDecimal(x.value!,y.value!):displayCell(x).localeCompare(displayCell(y),'zh-CN');
+    return sort.direction==='asc'?order:-order;
+  });
+}
+export function tableCsv(dataset:Dataset,rows:Dataset['rows']) {
+  const escape=(value:string)=>`"${(/^[\s]*[=+\-@]/.test(value)?"'"+value:value).replace(/"/g,'""')}"`;
+  return '\uFEFF'+[[...dataset.columns.map(c=>c.name),'行类型'],...rows.map(row=>[...row.cells.map(displayCell),row.kind])].map(row=>row.map(escape).join(',')).join('\r\n');
+}

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/src/services/view-data.ts

@@ -1,18 +1,18 @@
-import type {Cell, Dataset, QueryResult, WidgetBinding} from '../finebi/types';
-export function selectDataset(result: QueryResult, id?: string): Dataset {
-  if (result.normalization === 'UNSUPPORTED') throw new Error('当前结果类型尚未支持，请使用 FineBI 原生查看页');
-  const dataset = id ? result.datasets.find(d => d.id === id) : result.datasets.length === 1 ? result.datasets[0] : undefined;
-  if (!dataset) throw new Error('请绑定唯一的数据模型 datasetId');
-  return dataset;
-}
-export const displayCell = (cell: Cell) => cell.state === 'RESTRICTED' ? '受限' : cell.display ?? (cell.state === 'AVAILABLE' ? cell.value : null) ?? (cell.state === 'NULL' ? '—' : '不可用');
-export function chartValues(dataset: Dataset, binding: Pick<WidgetBinding, 'categoryFieldId' | 'valueFieldId'>) {
-  const x = dataset.columns.findIndex(c => c.fieldId === binding.categoryFieldId);
-  const y = dataset.columns.findIndex(c => c.fieldId === binding.valueFieldId);
-  if (x < 0 || y < 0 || dataset.columns[y].type !== 'DECIMAL') throw new Error('图表字段绑定缺失或类型不匹配');
-  return dataset.rows.map(row => {
-    const cell = row.cells[y];
-    const n = cell.state === 'AVAILABLE' ? Number(cell.value) : NaN;
-    return {name: displayCell(row.cells[x]), value: Number.isFinite(n) ? n : null};
-  });
-}
+import type {Cell, Dataset, QueryResult, WidgetBinding} from '../finebi/types';
+export function selectDataset(result: QueryResult, id?: string): Dataset {
+  if (result.normalization === 'UNSUPPORTED') throw new Error('当前结果类型尚未支持，请使用 FineBI 原生查看页');
+  const dataset = id ? result.datasets.find(d => d.id === id) : result.datasets.length === 1 ? result.datasets[0] : undefined;
+  if (!dataset) throw new Error('请绑定唯一的数据模型 datasetId');
+  return dataset;
+}
+export const displayCell = (cell: Cell) => cell.state === 'RESTRICTED' ? '受限' : cell.display ?? (cell.state === 'AVAILABLE' ? cell.value : null) ?? (cell.state === 'NULL' ? '—' : '不可用');
+export function chartValues(dataset: Dataset, binding: Pick<WidgetBinding, 'categoryFieldId' | 'valueFieldId'>) {
+  const x = dataset.columns.findIndex(c => c.fieldId === binding.categoryFieldId);
+  const y = dataset.columns.findIndex(c => c.fieldId === binding.valueFieldId);
+  if (x < 0 || y < 0 || dataset.columns[y].type !== 'DECIMAL') throw new Error('图表字段绑定缺失或类型不匹配');
+  return dataset.rows.map(row => {
+    const cell = row.cells[y];
+    const n = cell.state === 'AVAILABLE' ? Number(cell.value) : NaN;
+    return {name: displayCell(row.cells[x]), value: Number.isFinite(n) ? n : null};
+  });
+}

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/src/services/widget-queries.ts

@@ -1,18 +1,18 @@
-import {queryWidget} from '../finebi/client';
-import type {AppConfig,FilterState,QueryResult,WidgetBinding} from '../finebi/types';
-export type WidgetState={loading:boolean;result?:QueryResult;error?:Error;at?:string};
-export const widgetKey=(binding:WidgetBinding,index:number)=>`${index}:${binding.entryId}`;
-export async function loadWidgets(config:AppConfig,filters:FilterState,signal:AbortSignal,onState:(id:string,state:WidgetState)=>void,fetchImpl:typeof fetch=fetch) {
-  const queue=config.widgets.map((binding,index)=>({binding,key:widgetKey(binding,index)}));
-  const worker=async()=>{
-    while(queue.length&&!signal.aborted) {
-      const {binding,key}=queue.shift()!;
-      onState(key,{loading:true});
-      try {
-        const result=await queryWidget(config,binding,filters,signal,fetchImpl);
-        if(!signal.aborted)onState(key,{loading:false,result,at:new Date().toLocaleTimeString()});
-      } catch(error) {if(!signal.aborted)onState(key,{loading:false,error:error instanceof Error?error:new Error('查询失败')});}
-    }
-  };
-  await Promise.all(Array.from({length:Math.min(3,queue.length)},worker));
-}
+import {queryWidget} from '../finebi/client';
+import type {AppConfig,FilterState,QueryResult,WidgetBinding} from '../finebi/types';
+export type WidgetState={loading:boolean;result?:QueryResult;error?:Error;at?:string};
+export const widgetKey=(binding:WidgetBinding,index:number)=>`${index}:${binding.entryId}`;
+export async function loadWidgets(config:AppConfig,filters:FilterState,signal:AbortSignal,onState:(id:string,state:WidgetState)=>void,fetchImpl:typeof fetch=fetch) {
+  const queue=config.widgets.map((binding,index)=>({binding,key:widgetKey(binding,index)}));
+  const worker=async()=>{
+    while(queue.length&&!signal.aborted) {
+      const {binding,key}=queue.shift()!;
+      onState(key,{loading:true});
+      try {
+        const result=await queryWidget(config,binding,filters,signal,fetchImpl);
+        if(!signal.aborted)onState(key,{loading:false,result,at:new Date().toLocaleTimeString()});
+      } catch(error) {if(!signal.aborted)onState(key,{loading:false,error:error instanceof Error?error:new Error('查询失败')});}
+    }
+  };
+  await Promise.all(Array.from({length:Math.min(3,queue.length)},worker));
+}

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/tests/browser/fixtures.mjs

@@ -1,28 +1,28 @@
-// Synthetic native responses, confined to the browser acceptance page.
-export function fixtureConfig(layout, chartCount = 8) {
-  return {schemaVersion: '1', title: '合成门店经营验证', basePath: '/fixture-decision', layout,
-    dashboardId: 'fixture-dashboard', directoryEntryId: 'fixture-directory', maxRows: 1000, pageSize: 8,
-    filters: [{name: '区域', label: '区域', type: 'text'}], widgets: [
-      ...Array.from({length: 4}, (_, i) => ({entryId: `kpi${i}`, name: i === 3 ? '独立范围指标' : `合成指标 ${i + 1}`,
-        type: 'kpi', valueFieldId: 'amount', valueFormat: 'number', filterNames: i === 3 ? [] : ['区域']})),
-      ...Array.from({length: chartCount}, (_, i) => ({entryId: `chart${i}`, name: `${['趋势','对比','构成'][i % 3]} ${i + 1} · 较长标题用于检查文字换行和布局边界`,
-        type: ['line','bar','pie'][i % 3], categoryFieldId: 'region', valueFieldId: 'amount', filterNames: ['区域']})),
-      {entryId: 'table', name: '合成明细', type: 'table', filterNames: ['区域']},
-    ]};
-}
-
-export function nativeFixture(id, refer, scenario) {
-  const filtered = refer['区域']?.[0] === '华东';
-  const kpi = id.startsWith('kpi');
-  const headers = kpi ? [{dId: 'amount', text: '金额'}] : [{dId: 'region', text: '区域'}, {dId: 'amount', text: '金额'}];
-  const cell = (value, authority = true) => ({value, authority});
-  let rows = kpi ? [[cell(filtered ? '120' : '260')]]
-    : (filtered ? [['华东','120']] : [['华东','120'],['华北','80'],['华南','60']]).map(([region, amount]) => [cell(region), cell(amount)]);
-  if (!filtered && id === 'chart0') rows = [[cell('华东'),cell('120')],[cell('华北'),cell(null)],[cell('华南'),cell('-20')]];
-  if (!filtered && id === 'table') rows[1][1] = cell('hidden', false);
-  if (scenario === 'empty') rows = [];
-  const partial = scenario === 'partial' && id === 'chart0';
-  if (partial) rows[1] = [cell('华北')];
-  return {previewResult: {resultType: 'DETAIL', header: headers, items: rows, row: partial ? 30 : rows.length,
-    size: 1000, hasNext: partial}, widgetBean: {dimensions: {region: {type: 1}, amount: {type: 2}}}};
-}
+// Synthetic native responses, confined to the browser acceptance page.
+export function fixtureConfig(layout, chartCount = 8) {
+  return {schemaVersion: '1', title: '合成门店经营验证', basePath: '/fixture-decision', layout,
+    dashboardId: 'fixture-dashboard', directoryEntryId: 'fixture-directory', maxRows: 1000, pageSize: 8,
+    filters: [{name: '区域', label: '区域', type: 'text'}], widgets: [
+      ...Array.from({length: 4}, (_, i) => ({entryId: `kpi${i}`, name: i === 3 ? '独立范围指标' : `合成指标 ${i + 1}`,
+        type: 'kpi', valueFieldId: 'amount', valueFormat: 'number', filterNames: i === 3 ? [] : ['区域']})),
+      ...Array.from({length: chartCount}, (_, i) => ({entryId: `chart${i}`, name: `${['趋势','对比','构成'][i % 3]} ${i + 1} · 较长标题用于检查文字换行和布局边界`,
+        type: ['line','bar','pie'][i % 3], categoryFieldId: 'region', valueFieldId: 'amount', filterNames: ['区域']})),
+      {entryId: 'table', name: '合成明细', type: 'table', filterNames: ['区域']},
+    ]};
+}
+
+export function nativeFixture(id, refer, scenario) {
+  const filtered = refer['区域']?.[0] === '华东';
+  const kpi = id.startsWith('kpi');
+  const headers = kpi ? [{dId: 'amount', text: '金额'}] : [{dId: 'region', text: '区域'}, {dId: 'amount', text: '金额'}];
+  const cell = (value, authority = true) => ({value, authority});
+  let rows = kpi ? [[cell(filtered ? '120' : '260')]]
+    : (filtered ? [['华东','120']] : [['华东','120'],['华北','80'],['华南','60']]).map(([region, amount]) => [cell(region), cell(amount)]);
+  if (!filtered && id === 'chart0') rows = [[cell('华东'),cell('120')],[cell('华北'),cell(null)],[cell('华南'),cell('-20')]];
+  if (!filtered && id === 'table') rows[1][1] = cell('hidden', false);
+  if (scenario === 'empty') rows = [];
+  const partial = scenario === 'partial' && id === 'chart0';
+  if (partial) rows[1] = [cell('华北')];
+  return {previewResult: {resultType: 'DETAIL', header: headers, items: rows, row: partial ? 30 : rows.length,
+    size: 1000, hasNext: partial}, widgetBean: {dimensions: {region: {type: 1}, amount: {type: 2}}}};
+}

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/tests/browser/index.html

@@ -1,16 +1,16 @@
-<!doctype html>
-<html lang="zh-CN">
-<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>FineBI 模板浏览器验收</title></head>
-<body>
-  <section id="browser-checks" aria-label="浏览器验收">
-    <h1>模板浏览器验收 · 合成数据</h1>
-    <p>复用实际页面组件，不连接 FineBI。调整浏览器视口后重新运行；真实身份、业务口径与视觉质量需另外核对。</p>
-    <label>测试布局 <select id="test-layout"><option>overview</option><option>workbench</option><option>cockpit</option><option selected>retail</option></select></label>
-    <button id="test-run">运行浏览器检查</button>
-    <strong id="test-result" role="status">未运行</strong>
-    <ol id="test-checks"></ol>
-  </section>
-  <div id="root"></div>
-  <script type="module" src="./main.tsx"></script>
-</body>
-</html>
+<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>FineBI 模板浏览器验收</title></head>
+<body>
+  <section id="browser-checks" aria-label="浏览器验收">
+    <h1>模板浏览器验收 · 合成数据</h1>
+    <p>复用实际页面组件，不连接 FineBI。调整浏览器视口后重新运行；真实身份、业务口径与视觉质量需另外核对。</p>
+    <label>测试布局 <select id="test-layout"><option>overview</option><option>workbench</option><option>cockpit</option><option selected>retail</option></select></label>
+    <button id="test-run">运行浏览器检查</button>
+    <strong id="test-result" role="status">未运行</strong>
+    <ol id="test-checks"></ol>
+  </section>
+  <div id="root"></div>
+  <script type="module" src="./main.tsx"></script>
+</body>
+</html>

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/tests/browser/main.tsx

@@ -1,149 +1,149 @@
-import {createElement} from 'react';
-import {createRoot} from 'react-dom/client';
-import {flushSync} from 'react-dom';
-import App from '../../src/App';
-import '../../src/styles.css';
-import {fixtureConfig, nativeFixture} from './fixtures.mjs';
-import './test-page.css';
-
-const root = createRoot(document.getElementById('root')!);
-const result = document.getElementById('test-result')!;
-const checks = document.getElementById('test-checks')!;
-const runButton = document.getElementById('test-run') as HTMLButtonElement;
-const layoutSelect = document.getElementById('test-layout') as HTMLSelectElement;
-let config = fixtureConfig(layoutSelect.value), scenario = 'normal', generation = 0, failOnce = false;
-let requests: any[] = [];
-const runtimeErrors: string[] = [];
-for (const level of ['error', 'warn'] as const) {
-  const original = console[level].bind(console);
-  console[level] = (...args) => {runtimeErrors.push(args.map(String).join(' ')); original(...args);};
-}
-window.addEventListener('error', event => runtimeErrors.push(event.message));
-window.addEventListener('unhandledrejection', event => runtimeErrors.push(String(event.reason)));
-
-// This page is a test-only network boundary. Unexpected app requests fail closed.
-window.fetch = async (input, init = {}) => {
-  const url = new URL(input instanceof Request ? input.url : String(input), location.href);
-  if (url.origin !== location.origin) throw new Error('浏览器夹具禁止外部请求');
-  if (url.pathname.endsWith('/app-config.json')) return Response.json(config);
-  if (url.pathname !== '/fixture-decision/v5/api/dashboard/report/fixture-dashboard/widgets/query') throw new Error(`未配置的夹具请求：${url.pathname}`);
-  const body = JSON.parse(String(init.body));
-  requests.push(body);
-  await new Promise(resolve => setTimeout(resolve, 25));
-  if (init.signal?.aborted) throw new DOMException('Aborted', 'AbortError');
-  const id = body.widgetIds[0];
-  if (failOnce && id === 'chart1') {failOnce = false; return Response.json({}, {status: 403});}
-  return Response.json({success: true, data: {[id]: nativeFixture(id, body.refer, scenario)}});
-};
-
-function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}
-async function wait(check: () => boolean, label: string) {
-  const deadline = performance.now() + 15000;
-  while (!check()) {
-    assert(performance.now() < deadline, `超时：${label}`);
-    await new Promise(resolve => setTimeout(resolve, 40));
-  }
-}
-function pass(message: string) {const li = document.createElement('li'); li.textContent = `PASS · ${message}`; checks.append(li);}
-const panels = () => Array.from(document.querySelectorAll<HTMLElement>('#root .panel'));
-async function settled() {
-  await wait(() => panels().length === config.widgets.length && panels().every(panel => /更新于|查询失败/.test(panel.querySelector('.component-status')?.textContent ?? '')), '组件查询结束');
-}
-async function mount(state = 'normal', chartCount = 8) {
-  scenario = state; config = fixtureConfig(layoutSelect.value, chartCount); requests = []; failOnce = state === 'failure';
-  flushSync(() => root.render(createElement(App, {key: ++generation})));
-  await settled();
-}
-function assertRequests(filtered: boolean) {
-  assert(requests.length === config.widgets.length, '每个展示组件应恰好请求一次');
-  for (const request of requests) {
-    assert(request.reportEntryId === 'fixture-directory', '目录入口丢失');
-    const expected = filtered && request.widgetIds[0] !== 'kpi3' ? {区域: ['华东']} : {};
-    assert(JSON.stringify(request.refer) === JSON.stringify(expected), '筛选编码或组件作用范围错误');
-  }
-}
-async function painted(count: number) {
-  await wait(() => {
-    const canvases = Array.from(document.querySelectorAll<HTMLCanvasElement>('#root .chart canvas'));
-    return canvases.length === count && canvases.every(canvas => {
-      const pixels = canvas.getContext('2d')!.getImageData(0, 0, canvas.width, canvas.height).data;
-      let colored = 0;
-      for (let i = 3; i < pixels.length; i += 4) if (pixels[i] && ++colored > 100) return true;
-      return false;
-    });
-  }, '柱/线/饼图实际绘制');
-  assert(runtimeErrors.length === 0, runtimeErrors.join('\n'));
-}
-function geometry(even: boolean) {
-  assert(document.documentElement.scrollWidth <= innerWidth + 1, '页面存在横向溢出');
-  const cards = panels().map(panel => panel.getBoundingClientRect());
-  for (let i = 0; i < cards.length; i++) {
-    const a = cards[i];
-    assert(a.width > 0 && a.left >= -1 && a.right <= innerWidth + 1, '卡片超出视口');
-    for (const b of cards.slice(i + 1)) assert(Math.min(a.right,b.right) - Math.max(a.left,b.left) <= 1 || Math.min(a.bottom,b.bottom) - Math.max(a.top,b.top) <= 1, '卡片重叠');
-  }
-  const grid = document.querySelector<HTMLElement>('#root .grid')!;
-  const columns = getComputedStyle(grid).gridTemplateColumns.split(' ').length;
-  const regular = Array.from(grid.querySelectorAll<HTMLElement>(':scope > .panel:not(.wide)')).map(el => el.getBoundingClientRect());
-  if (even && columns === 2 && regular.length % 2 === 0) for (let i = 0; i < regular.length; i += 2) assert(Math.abs(regular[i].top - regular[i + 1].top) < 2, '偶数组件双列排列出现孤立卡片');
-}
-function button(text: string) {
-  const found = Array.from(document.querySelectorAll<HTMLButtonElement>('#root button')).find(el => el.textContent?.trim() === text);
-  assert(found, `找不到按钮：${text}`); return found;
-}
-
-async function retailNavigation() {
-  if (layoutSelect.value !== 'retail') return;
-  const nav = document.querySelector<HTMLElement>('#root .retail-nav')!;
-  for (const id of ['components', 'data-notes', 'dashboard']) {
-    nav.querySelector<HTMLAnchorElement>(`a[href="#${id}"]`)!.click();
-    await new Promise<void>(resolve => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
-    const bar = nav.getBoundingClientRect(), target = document.getElementById(id)!.getBoundingClientRect();
-    assert(bar.top >= -1 && bar.bottom < innerHeight, '跳转后导航离开视口');
-    assert(target.top >= bar.bottom - 1 && target.top < innerHeight, '锚点标题被导航遮住或离开视口');
-  }
-  assert(document.querySelector('#components h2')?.textContent === '销售表现', '销售分析未定位到区域标题');
-  window.scrollTo(0, 0);
-  pass('页内导航持续可见，三个锚点标题可见且不被遮挡');
-}
-
-async function run() {
-  runButton.disabled = true; layoutSelect.disabled = true; checks.replaceChildren(); result.textContent = '运行中';
-  const started = performance.now();
-  try {
-    assert(runtimeErrors.length === 0, '已有运行错误，请修复并刷新测试页：' + runtimeErrors.join('\n'));
-    await mount(); await painted(8); assertRequests(false); geometry(true);
-    assert(document.querySelector('#root .widget-table')?.textContent?.includes('受限'), '受限值未标记');
-    pass('八张图实际绘制，长标题/边界/偶数排列、目录入口和受限值');
-    const input = document.querySelector<HTMLInputElement>('#root input[aria-label="区域"]');
-    assert(input, '文本筛选尚未加载');
-    Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')!.set!.call(input, '华东');
-    input.dispatchEvent(new Event('input', {bubbles: true}));
-    await wait(() => document.querySelector('.filter-status')?.textContent === '待应用', '筛选草稿');
-    assert(requests.length === config.widgets.length, '编辑草稿触发了查询');
-    requests = []; button('应用筛选').click();
-    await wait(() => requests.length === config.widgets.length, '应用发起查询'); await settled();
-    assertRequests(true);
-    assert(document.querySelector('#root .kpi')?.textContent === '120', '应用条件后指标未变化');
-    pass('草稿不查询，应用后按真实编码及组件范围请求，显示值变化');
-    requests = []; button('恢复全部默认').click();
-    await wait(() => requests.length === config.widgets.length, '恢复默认查询'); await settled();
-    assertRequests(false); assert(document.querySelector('#root .kpi')?.textContent === '260', '恢复默认后指标未恢复');
-    pass('恢复默认省略覆盖，显示值恢复');
-    await mount('normal', 7); await painted(7); geometry(false); pass('七张图、奇数组件无溢出与重叠');
-    await mount('empty'); assert(document.querySelectorAll('#root .empty').length === config.widgets.length, '空结果未独立显示');
-    assert(!document.querySelector('#root canvas'), '空结果保留了旧图'); pass('空结果不保留旧图');
-    await mount('partial'); await painted(8);
-    assert(document.querySelector('#root .notice')?.textContent?.includes('首屏'), '截断警告缺失');
-    assert(document.querySelector('#root .notice')?.textContent?.includes('PARTIAL'), '部分适配标记缺失');
-    pass('部分适配与首屏范围警告保持可见');
-    await mount('failure'); assert(document.querySelectorAll('#root .component-error').length === 1, '单组件失败未隔离');
-    assert(document.querySelector('#root .component-error')?.textContent?.includes('PERMISSION_DENIED'), '权限失败语义错误');
-    requests = []; button('重试组件').click(); await wait(() => requests.length === 1, '组件重试'); await settled(); await painted(8);
-    assert(requests.length === 1 && requests[0].widgetIds[0] === 'chart1', '重试影响了其他组件'); pass('权限失败独立显示，单项重试只请求失败组件');
-    await mount(); await painted(8); geometry(true); await retailNavigation();
-    result.textContent = `PASS · ${layoutSelect.value} · ${innerWidth}×${innerHeight} · ${checks.children.length} 项 · ${((performance.now()-started)/1000).toFixed(1)}s`;
-  } catch (error) {result.textContent = `FAIL · ${layoutSelect.value} · ${innerWidth}×${innerHeight} · ${String(error)}`;}
-  finally {runButton.disabled = false; layoutSelect.disabled = false;}
-}
-runButton.addEventListener('click', run);
+import {createElement} from 'react';
+import {createRoot} from 'react-dom/client';
+import {flushSync} from 'react-dom';
+import App from '../../src/App';
+import '../../src/styles.css';
+import {fixtureConfig, nativeFixture} from './fixtures.mjs';
+import './test-page.css';
+
+const root = createRoot(document.getElementById('root')!);
+const result = document.getElementById('test-result')!;
+const checks = document.getElementById('test-checks')!;
+const runButton = document.getElementById('test-run') as HTMLButtonElement;
+const layoutSelect = document.getElementById('test-layout') as HTMLSelectElement;
+let config = fixtureConfig(layoutSelect.value), scenario = 'normal', generation = 0, failOnce = false;
+let requests: any[] = [];
+const runtimeErrors: string[] = [];
+for (const level of ['error', 'warn'] as const) {
+  const original = console[level].bind(console);
+  console[level] = (...args) => {runtimeErrors.push(args.map(String).join(' ')); original(...args);};
+}
+window.addEventListener('error', event => runtimeErrors.push(event.message));
+window.addEventListener('unhandledrejection', event => runtimeErrors.push(String(event.reason)));
+
+// This page is a test-only network boundary. Unexpected app requests fail closed.
+window.fetch = async (input, init = {}) => {
+  const url = new URL(input instanceof Request ? input.url : String(input), location.href);
+  if (url.origin !== location.origin) throw new Error('浏览器夹具禁止外部请求');
+  if (url.pathname.endsWith('/app-config.json')) return Response.json(config);
+  if (url.pathname !== '/fixture-decision/v5/api/dashboard/report/fixture-dashboard/widgets/query') throw new Error(`未配置的夹具请求：${url.pathname}`);
+  const body = JSON.parse(String(init.body));
+  requests.push(body);
+  await new Promise(resolve => setTimeout(resolve, 25));
+  if (init.signal?.aborted) throw new DOMException('Aborted', 'AbortError');
+  const id = body.widgetIds[0];
+  if (failOnce && id === 'chart1') {failOnce = false; return Response.json({}, {status: 403});}
+  return Response.json({success: true, data: {[id]: nativeFixture(id, body.refer, scenario)}});
+};
+
+function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}
+async function wait(check: () => boolean, label: string) {
+  const deadline = performance.now() + 15000;
+  while (!check()) {
+    assert(performance.now() < deadline, `超时：${label}`);
+    await new Promise(resolve => setTimeout(resolve, 40));
+  }
+}
+function pass(message: string) {const li = document.createElement('li'); li.textContent = `PASS · ${message}`; checks.append(li);}
+const panels = () => Array.from(document.querySelectorAll<HTMLElement>('#root .panel'));
+async function settled() {
+  await wait(() => panels().length === config.widgets.length && panels().every(panel => /更新于|查询失败/.test(panel.querySelector('.component-status')?.textContent ?? '')), '组件查询结束');
+}
+async function mount(state = 'normal', chartCount = 8) {
+  scenario = state; config = fixtureConfig(layoutSelect.value, chartCount); requests = []; failOnce = state === 'failure';
+  flushSync(() => root.render(createElement(App, {key: ++generation})));
+  await settled();
+}
+function assertRequests(filtered: boolean) {
+  assert(requests.length === config.widgets.length, '每个展示组件应恰好请求一次');
+  for (const request of requests) {
+    assert(request.reportEntryId === 'fixture-directory', '目录入口丢失');
+    const expected = filtered && request.widgetIds[0] !== 'kpi3' ? {区域: ['华东']} : {};
+    assert(JSON.stringify(request.refer) === JSON.stringify(expected), '筛选编码或组件作用范围错误');
+  }
+}
+async function painted(count: number) {
+  await wait(() => {
+    const canvases = Array.from(document.querySelectorAll<HTMLCanvasElement>('#root .chart canvas'));
+    return canvases.length === count && canvases.every(canvas => {
+      const pixels = canvas.getContext('2d')!.getImageData(0, 0, canvas.width, canvas.height).data;
+      let colored = 0;
+      for (let i = 3; i < pixels.length; i += 4) if (pixels[i] && ++colored > 100) return true;
+      return false;
+    });
+  }, '柱/线/饼图实际绘制');
+  assert(runtimeErrors.length === 0, runtimeErrors.join('\n'));
+}
+function geometry(even: boolean) {
+  assert(document.documentElement.scrollWidth <= innerWidth + 1, '页面存在横向溢出');
+  const cards = panels().map(panel => panel.getBoundingClientRect());
+  for (let i = 0; i < cards.length; i++) {
+    const a = cards[i];
+    assert(a.width > 0 && a.left >= -1 && a.right <= innerWidth + 1, '卡片超出视口');
+    for (const b of cards.slice(i + 1)) assert(Math.min(a.right,b.right) - Math.max(a.left,b.left) <= 1 || Math.min(a.bottom,b.bottom) - Math.max(a.top,b.top) <= 1, '卡片重叠');
+  }
+  const grid = document.querySelector<HTMLElement>('#root .grid')!;
+  const columns = getComputedStyle(grid).gridTemplateColumns.split(' ').length;
+  const regular = Array.from(grid.querySelectorAll<HTMLElement>(':scope > .panel:not(.wide)')).map(el => el.getBoundingClientRect());
+  if (even && columns === 2 && regular.length % 2 === 0) for (let i = 0; i < regular.length; i += 2) assert(Math.abs(regular[i].top - regular[i + 1].top) < 2, '偶数组件双列排列出现孤立卡片');
+}
+function button(text: string) {
+  const found = Array.from(document.querySelectorAll<HTMLButtonElement>('#root button')).find(el => el.textContent?.trim() === text);
+  assert(found, `找不到按钮：${text}`); return found;
+}
+
+async function retailNavigation() {
+  if (layoutSelect.value !== 'retail') return;
+  const nav = document.querySelector<HTMLElement>('#root .retail-nav')!;
+  for (const id of ['components', 'data-notes', 'dashboard']) {
+    nav.querySelector<HTMLAnchorElement>(`a[href="#${id}"]`)!.click();
+    await new Promise<void>(resolve => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
+    const bar = nav.getBoundingClientRect(), target = document.getElementById(id)!.getBoundingClientRect();
+    assert(bar.top >= -1 && bar.bottom < innerHeight, '跳转后导航离开视口');
+    assert(target.top >= bar.bottom - 1 && target.top < innerHeight, '锚点标题被导航遮住或离开视口');
+  }
+  assert(document.querySelector('#components h2')?.textContent === '销售表现', '销售分析未定位到区域标题');
+  window.scrollTo(0, 0);
+  pass('页内导航持续可见，三个锚点标题可见且不被遮挡');
+}
+
+async function run() {
+  runButton.disabled = true; layoutSelect.disabled = true; checks.replaceChildren(); result.textContent = '运行中';
+  const started = performance.now();
+  try {
+    assert(runtimeErrors.length === 0, '已有运行错误，请修复并刷新测试页：' + runtimeErrors.join('\n'));
+    await mount(); await painted(8); assertRequests(false); geometry(true);
+    assert(document.querySelector('#root .widget-table')?.textContent?.includes('受限'), '受限值未标记');
+    pass('八张图实际绘制，长标题/边界/偶数排列、目录入口和受限值');
+    const input = document.querySelector<HTMLInputElement>('#root input[aria-label="区域"]');
+    assert(input, '文本筛选尚未加载');
+    Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')!.set!.call(input, '华东');
+    input.dispatchEvent(new Event('input', {bubbles: true}));
+    await wait(() => document.querySelector('.filter-status')?.textContent === '待应用', '筛选草稿');
+    assert(requests.length === config.widgets.length, '编辑草稿触发了查询');
+    requests = []; button('应用筛选').click();
+    await wait(() => requests.length === config.widgets.length, '应用发起查询'); await settled();
+    assertRequests(true);
+    assert(document.querySelector('#root .kpi')?.textContent === '120', '应用条件后指标未变化');
+    pass('草稿不查询，应用后按真实编码及组件范围请求，显示值变化');
+    requests = []; button('恢复全部默认').click();
+    await wait(() => requests.length === config.widgets.length, '恢复默认查询'); await settled();
+    assertRequests(false); assert(document.querySelector('#root .kpi')?.textContent === '260', '恢复默认后指标未恢复');
+    pass('恢复默认省略覆盖，显示值恢复');
+    await mount('normal', 7); await painted(7); geometry(false); pass('七张图、奇数组件无溢出与重叠');
+    await mount('empty'); assert(document.querySelectorAll('#root .empty').length === config.widgets.length, '空结果未独立显示');
+    assert(!document.querySelector('#root canvas'), '空结果保留了旧图'); pass('空结果不保留旧图');
+    await mount('partial'); await painted(8);
+    assert(document.querySelector('#root .notice')?.textContent?.includes('首屏'), '截断警告缺失');
+    assert(document.querySelector('#root .notice')?.textContent?.includes('PARTIAL'), '部分适配标记缺失');
+    pass('部分适配与首屏范围警告保持可见');
+    await mount('failure'); assert(document.querySelectorAll('#root .component-error').length === 1, '单组件失败未隔离');
+    assert(document.querySelector('#root .component-error')?.textContent?.includes('PERMISSION_DENIED'), '权限失败语义错误');
+    requests = []; button('重试组件').click(); await wait(() => requests.length === 1, '组件重试'); await settled(); await painted(8);
+    assert(requests.length === 1 && requests[0].widgetIds[0] === 'chart1', '重试影响了其他组件'); pass('权限失败独立显示，单项重试只请求失败组件');
+    await mount(); await painted(8); geometry(true); await retailNavigation();
+    result.textContent = `PASS · ${layoutSelect.value} · ${innerWidth}×${innerHeight} · ${checks.children.length} 项 · ${((performance.now()-started)/1000).toFixed(1)}s`;
+  } catch (error) {result.textContent = `FAIL · ${layoutSelect.value} · ${innerWidth}×${innerHeight} · ${String(error)}`;}
+  finally {runButton.disabled = false; layoutSelect.disabled = false;}
+}
+runButton.addEventListener('click', run);

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/tests/browser/test-page.css

@@ -1,4 +1,4 @@
-#browser-checks{padding:20px 24px;border-bottom:2px solid #adb8c5;background:#fff;color:#243042;overflow-wrap:anywhere}
-#browser-checks h1{font-size:19px;margin:0 0 8px}#browser-checks p,#browser-checks li{font-size:12px;line-height:1.7}
-#browser-checks label{display:inline-flex;align-items:center;gap:8px;margin:8px 12px 8px 0}#test-result{display:block;margin:12px 0;font-size:14px}
-#test-checks{padding-left:22px;margin:0}#test-run{background:#243042;color:white}
+#browser-checks{padding:20px 24px;border-bottom:2px solid #adb8c5;background:#fff;color:#243042;overflow-wrap:anywhere}
+#browser-checks h1{font-size:19px;margin:0 0 8px}#browser-checks p,#browser-checks li{font-size:12px;line-height:1.7}
+#browser-checks label{display:inline-flex;align-items:center;gap:8px;margin:8px 12px 8px 0}#test-result{display:block;margin:12px 0;font-size:14px}
+#test-checks{padding-left:22px;margin:0}#test-run{background:#243042;color:white}

package/skills/finebi-cli-agent/scripts/finebi-cli/templates/web-app/tests/browser/vite.config.mjs

@@ -1,13 +1,13 @@
-import {fileURLToPath} from 'node:url';
-import {defineConfig, normalizePath} from 'vite';
-
-const project = fileURLToPath(new URL('../../', import.meta.url));
-export default defineConfig({
-  root: fileURLToPath(new URL('./', import.meta.url)),
-  publicDir: false,
-  envDir: false,
-  cacheDir: fileURLToPath(new URL('../../temp/vite-browser', import.meta.url)),
-  resolve: {alias: [{find: /^date-fns\/locale$/, replacement: fileURLToPath(new URL('../../src/components/calendar-locales.ts', import.meta.url))}]},
-  server: {host: '127.0.0.1', port: 4188, strictPort: true, hmr: false,
-    fs: {allow: [project], deny: ['.env', '.env.*', '*.{crt,pem}', '**/.git/**', normalizePath(project) + 'temp/**']}},
-});
+import {fileURLToPath} from 'node:url';
+import {defineConfig, normalizePath} from 'vite';
+
+const project = fileURLToPath(new URL('../../', import.meta.url));
+export default defineConfig({
+  root: fileURLToPath(new URL('./', import.meta.url)),
+  publicDir: false,
+  envDir: false,
+  cacheDir: fileURLToPath(new URL('../../temp/vite-browser', import.meta.url)),
+  resolve: {alias: [{find: /^date-fns\/locale$/, replacement: fileURLToPath(new URL('../../src/components/calendar-locales.ts', import.meta.url))}]},
+  server: {host: '127.0.0.1', port: 4188, strictPort: true, hmr: false,
+    fs: {allow: [project], deny: ['.env', '.env.*', '*.{crt,pem}', '**/.git/**', normalizePath(project) + 'temp/**']}},
+});