yidaconnector 2026.6.11

package/scripts/solution-center-runner.js

@@ -0,0 +1,368 @@
+#!/usr/bin/env node
+/**
+ * Execute YidaConnector build tasks generated by the DingTalk AI Solution Center.
+ *
+ * Default mode is dry-run. Use --execute to create real Yida resources.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const YIDA_BIN = path.join(ROOT, 'bin', 'yida.js');
+const CACHE_DIR = path.join(ROOT, 'project', '.cache', 'solution-center-runner');
+
+const SOURCE_APP_TYPE = 'APP_WXXZPD6QF8B2NNWGJG3J';
+const DEMO_FORM_UUID = 'FORM-88DD6EE845464D43A2C18A85B895245AK576';
+
+const FIELDS = {
+  demoName: 'textField_ajhc2hnzf',
+  customerName: 'textField_ajhc3eszd',
+  solution: 'textField_ajhc4ffn8',
+  status: 'selectField_ajhd60inc',
+  appType: 'textField_ajhd7khim',
+  pageUrl: 'textField_ajhd88lv6',
+  duration: 'numberField_ajhd9sef0',
+  feedback: 'textareaField_ajhdcpp4h',
+  buildSpec: 'textareaField_bx6z13bfq',
+  buildPrompt: 'textareaField_bx6z2j4v4',
+  tasks: 'tableField_ajhddqugc',
+  taskName: 'textField_ajhde8pga',
+  taskStatus: 'selectField_ajhdfogqg',
+  taskOutput: 'textareaField_ajhdgsmj5',
+};
+
+function printUsage() {
+  console.log(`Usage:
+  node scripts/solution-center-runner.js [--dry-run]
+  node scripts/solution-center-runner.js --execute [--limit 1] [--inst-id FINST-xxx]
+
+Options:
+  --dry-run          Preview pending tasks without creating resources (default)
+  --execute          Create Yida app/forms/page and update source Demo record
+  --limit <n>        Max tasks to process, default 1
+  --inst-id <id>     Process one specific Demo instance
+`);
+}
+
+function parseArgs(argv) {
+  const options = {
+    execute: false,
+    limit: 1,
+    instId: '',
+    help: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (arg === '--execute') {
+      options.execute = true;
+    } else if (arg === '--dry-run') {
+      options.execute = false;
+    } else if (arg === '--limit' && argv[index + 1]) {
+      options.limit = Math.max(1, Number.parseInt(argv[++index], 10) || 1);
+    } else if (arg === '--inst-id' && argv[index + 1]) {
+      options.instId = argv[++index];
+    } else {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+  }
+
+  return options;
+}
+
+function stripAnsi(value) {
+  const escapeChar = String.fromCharCode(27);
+  return String(value || '').replace(new RegExp(`${escapeChar}\\[[0-9;]*m`, 'g'), '');
+}
+
+function parseLastJson(output) {
+  const text = stripAnsi(output).trim();
+  const lines = text.split(/\r?\n/);
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index].trim();
+    if (line !== '{' && !line.startsWith('{"')) {
+      continue;
+    }
+    try {
+      return JSON.parse(lines.slice(index).join('\n'));
+    } catch {
+      // keep scanning for the next JSON-looking line
+    }
+  }
+  throw new Error('Command did not print a JSON object');
+}
+
+function runYida(args, options = {}) {
+  const result = spawnSync(process.execPath, [YIDA_BIN].concat(args), {
+    cwd: ROOT,
+    encoding: 'utf8',
+    maxBuffer: 1024 * 1024 * 20,
+  });
+  const output = `${result.stdout || ''}${result.stderr || ''}`;
+  if (options.echo) {
+    process.stdout.write(output);
+  }
+  if (result.status !== 0) {
+    throw new Error(stripAnsi(output).trim() || `yidaconnector ${args.join(' ')} failed`);
+  }
+  if (options.json) {
+    try {
+      return parseLastJson(result.stdout || '');
+    } catch {
+      return parseLastJson(output);
+    }
+  }
+  return output;
+}
+
+function field(record, fieldId) {
+  const data = record.formData || {};
+  if (data[fieldId] !== undefined && data[fieldId] !== null) {
+    return data[fieldId];
+  }
+  return '';
+}
+
+function queryDemoInstances(options) {
+  const args = ['data', 'query', 'form', SOURCE_APP_TYPE, DEMO_FORM_UUID, '--page', '1', '--size', '100'];
+  if (options.instId) {
+    args.push('--inst-id', options.instId);
+  }
+  const result = runYida(args, { json: true });
+  return Array.isArray(result.data) ? result.data : [];
+}
+
+function parseBuildSpec(record) {
+  const raw = field(record, FIELDS.buildSpec);
+  if (!raw) {
+    return null;
+  }
+  return JSON.parse(raw);
+}
+
+function pickPending(records, options) {
+  const candidates = [];
+  records.forEach((record) => {
+    let spec = null;
+    try {
+      spec = parseBuildSpec(record);
+    } catch (err) {
+      candidates.push({ record, spec: null, skipReason: `buildSpec JSON 解析失败: ${err.message}` });
+      return;
+    }
+    if (!spec) {
+      return;
+    }
+    const status = field(record, FIELDS.status);
+    const targetAppType = field(record, FIELDS.appType);
+    if (options.instId || (!targetAppType && status !== '已创建')) {
+      candidates.push({ record, spec, skipReason: '' });
+    }
+  });
+  return candidates.slice(0, options.limit);
+}
+
+function ensureCacheDir() {
+  fs.mkdirSync(CACHE_DIR, { recursive: true });
+}
+
+function sanitizeFileName(value) {
+  return String(value || 'form').replace(/[^\w\u4e00-\u9fa5-]+/g, '_').slice(0, 40);
+}
+
+function fieldSetForForm(formName) {
+  const subject = String(formName || '业务').replace(/表$/, '');
+  return [
+    { type: 'TextField', label: `${subject}名称`, required: true },
+    { type: 'TextareaField', label: '业务说明' },
+    { type: 'SelectField', label: '状态', options: ['未开始', '进行中', '已完成', '异常'] },
+    { type: 'EmployeeField', label: '负责人' },
+    { type: 'DateField', label: '发生时间' },
+  ];
+}
+
+function writeFieldsFile(taskId, formName) {
+  ensureCacheDir();
+  const filePath = path.join(CACHE_DIR, `${taskId}-${sanitizeFileName(formName)}.fields.json`);
+  fs.writeFileSync(filePath, JSON.stringify(fieldSetForForm(formName), null, 2), 'utf8');
+  return filePath;
+}
+
+function updateDemoRecord(formInstId, patch) {
+  runYida([
+    'data', 'update', 'form', SOURCE_APP_TYPE,
+    '--inst-id', formInstId,
+    '--data-json', JSON.stringify(patch),
+    '--use-latest-version', 'y',
+  ], { json: true });
+}
+
+function buildTaskRows(spec, status, extraOutput) {
+  return (spec.tasks || []).map((task) => {
+    const row = {};
+    row[FIELDS.taskName] = String(task.name || '').slice(0, 190);
+    row[FIELDS.taskStatus] = status;
+    row[FIELDS.taskOutput] = String(extraOutput || task.output || '').slice(0, 190);
+    return row;
+  });
+}
+
+function updateSourceSuccess(record, spec, result, elapsedMinutes) {
+  const patch = {};
+  patch[FIELDS.status] = '已创建';
+  patch[FIELDS.appType] = result.appType;
+  patch[FIELDS.pageUrl] = result.pageUrl || result.appUrl || '';
+  patch[FIELDS.duration] = elapsedMinutes;
+  patch[FIELDS.feedback] = [
+    'YidaConnector runner 已完成搭建。',
+    `创建应用: ${result.appType}`,
+    `表单: ${result.forms.map((item) => item.title).join('、')}`,
+    `页面: ${result.pageName || 'SA 演示首页'}`,
+  ].join('\n');
+  patch[FIELDS.tasks] = buildTaskRows(spec, '已完成');
+  updateDemoRecord(record.formInstId, patch);
+}
+
+function updateSourceFailure(record, spec, error) {
+  const patch = {};
+  patch[FIELDS.status] = '需改版';
+  patch[FIELDS.feedback] = `YidaConnector runner 执行失败：${String(error.message || error).slice(0, 500)}`;
+  patch[FIELDS.tasks] = buildTaskRows(spec, '失败', patch[FIELDS.feedback]);
+  updateDemoRecord(record.formInstId, patch);
+}
+
+function createYidaApp(spec) {
+  const appName = spec.appName || `${spec.customerName || '客户'} Demo`;
+  const result = runYida([
+    'create-app',
+    '--name', appName,
+    '--desc', `${spec.industryName || ''}${spec.solutionTitle || ''} YidaConnector Demo`,
+    '--theme', 'greyBlue',
+    '--nav-theme', 'dark',
+    '--layout', 'slide',
+  ], { json: true });
+  if (!result.success || !result.appType) {
+    throw new Error(`创建应用失败: ${JSON.stringify(result)}`);
+  }
+  return result;
+}
+
+function createYidaForms(appType, spec) {
+  const forms = [];
+  (spec.forms || []).slice(0, 8).forEach((formName, index) => {
+    const fieldsFile = writeFieldsFile(`${Date.now()}-${index}`, formName);
+    const result = runYida([
+      'create-form', 'create', appType, formName, fieldsFile,
+      '--layout', 'double',
+      '--theme', 'compact',
+      '--label-align', 'top',
+      '--no-open',
+    ], { json: true });
+    if (!result.success || !result.formUuid) {
+      throw new Error(`创建表单失败 ${formName}: ${JSON.stringify(result)}`);
+    }
+    forms.push({ title: formName, formUuid: result.formUuid, url: result.url || '' });
+  });
+  return forms;
+}
+
+function createYidaPage(appType, spec) {
+  const pageName = (spec.pages && spec.pages[0]) || 'SA 演示首页';
+  const result = runYida([
+    'create-page', appType, pageName,
+    '--mode', 'dashboard',
+    '--no-open',
+  ], { json: true });
+  if (!result.success || !result.pageId) {
+    throw new Error(`创建页面失败: ${JSON.stringify(result)}`);
+  }
+  return { pageName, pageId: result.pageId, url: result.url || result.workbenchUrl || '' };
+}
+
+function executeBuild(record, spec) {
+  const start = Date.now();
+  const app = createYidaApp(spec);
+  const forms = createYidaForms(app.appType, spec);
+  const page = createYidaPage(app.appType, spec);
+  const elapsedMinutes = Math.max(1, Math.round((Date.now() - start) / 60000));
+  const result = {
+    appType: app.appType,
+    appUrl: app.url || '',
+    forms,
+    pageName: page.pageName,
+    pageId: page.pageId,
+    pageUrl: page.url,
+  };
+  updateSourceSuccess(record, spec, result, elapsedMinutes);
+  return result;
+}
+
+function printTaskPreview(task) {
+  const record = task.record;
+  const spec = task.spec;
+  if (task.skipReason) {
+    console.log(`- ${record.formInstId}: 跳过，${task.skipReason}`);
+    return;
+  }
+  console.log(`- ${record.formInstId}`);
+  console.log(`  客户: ${field(record, FIELDS.customerName) || spec.customerName || '-'}`);
+  console.log(`  Demo: ${field(record, FIELDS.demoName) || spec.appName || '-'}`);
+  console.log(`  方案: ${spec.solutionTitle || '-'}`);
+  console.log(`  表单: ${(spec.forms || []).join('、') || '-'}`);
+  console.log(`  页面: ${(spec.pages || []).join('、') || '-'}`);
+}
+
+function main() {
+  const options = parseArgs(process.argv.slice(2));
+  if (options.help) {
+    printUsage();
+    return;
+  }
+
+  const records = queryDemoInstances(options);
+  const tasks = pickPending(records, options);
+  if (tasks.length === 0) {
+    console.log('未找到可执行的 YidaConnector 搭建任务。请先在解决方案中心点击「YidaConnector 搭建」生成任务。');
+    return;
+  }
+
+  console.log(options.execute ? '将执行以下 YidaConnector 搭建任务:' : 'Dry run: 将预览以下 YidaConnector 搭建任务:');
+  tasks.forEach(printTaskPreview);
+
+  if (!options.execute) {
+    console.log('\n未创建任何资源。确认无误后执行：node scripts/solution-center-runner.js --execute --limit 1');
+    return;
+  }
+
+  tasks.forEach((task) => {
+    if (task.skipReason) {
+      return;
+    }
+    try {
+      console.log(`\n开始执行 ${task.record.formInstId}...`);
+      const result = executeBuild(task.record, task.spec);
+      console.log(`完成: ${result.appType} ${result.pageUrl || result.appUrl}`);
+    } catch (err) {
+      console.error(`执行失败: ${err.message}`);
+      try {
+        updateSourceFailure(task.record, task.spec || {}, err);
+      } catch (updateErr) {
+        console.error(`回填失败状态也失败了: ${updateErr.message}`);
+      }
+      process.exitCode = 1;
+    }
+  });
+}
+
+try {
+  main();
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}

package/scripts/validate-ci.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+echo "=== Step 1: Install dependencies ==="
+npm ci --ignore-scripts
+
+echo ""
+echo "=== Step 2: Validate project structure ==="
+npm run check:structure
+
+echo ""
+echo "=== Step 3: Validate skills ==="
+npm run check:skills
+
+echo ""
+echo "=== Step 4: Validate command manifest ==="
+npm run check:commands
+
+echo ""
+echo "=== Step 5: Validate generated command docs ==="
+npm run check:docs
+
+echo ""
+echo "=== Step 6: Build Wukong skills package ==="
+npm run build:skills
+
+echo ""
+echo "=== Step 7: Check JavaScript syntax ==="
+npm run check:syntax
+
+echo ""
+echo "=== Step 8: Run lint ==="
+npm run lint
+
+echo ""
+echo "=== Step 9: Run tests ==="
+npm run test:unit -- --runInBand
+
+echo ""
+echo "=== Step 10: Validate npm package size budget ==="
+npm run check:package-size
+
+echo ""
+echo "=== Step 11: Validate npm package contents ==="
+npm run check:package
+
+echo ""
+echo "=== All checks passed! ==="

package/scripts/validate-command-manifest.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { COMMAND_GROUPS, flattenCommandManifest } = require('../lib/core/command-manifest');
+
+const ROOT = path.resolve(__dirname, '..');
+const ROUTER_FILE = path.join(ROOT, 'bin/yida.js');
+const README_FILE = path.join(ROOT, 'README.md');
+
+const errors = [];
+
+function toRelative(filePath) {
+  return path.relative(ROOT, filePath).split(path.sep).join('/');
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function commandRoot(value) {
+  return String(value || '').trim().split(/\s+/)[0];
+}
+
+function collectRouterCases() {
+  const text = fs.readFileSync(ROUTER_FILE, 'utf8');
+  const cases = new Set();
+  const pattern = /case '([^']+)'\s*:/g;
+  let match = pattern.exec(text);
+  while (match) {
+    cases.add(match[1]);
+    match = pattern.exec(text);
+  }
+  return cases;
+}
+
+function collectManifestRoots(commands) {
+  const roots = new Set();
+  for (const entry of commands) {
+    roots.add(entry.path[0]);
+    for (const alias of entry.aliases || []) {
+      roots.add(commandRoot(alias));
+    }
+  }
+  return roots;
+}
+
+function validateUniqueIds(commands) {
+  const seen = new Set();
+  for (const entry of commands) {
+    if (seen.has(entry.id)) {
+      errors.push(`Duplicate command manifest id: ${entry.id}`);
+    }
+    seen.add(entry.id);
+  }
+}
+
+function validateRouterCoverage(commands) {
+  const routerCases = collectRouterCases();
+  const manifestRoots = collectManifestRoots(commands);
+
+  for (const routerCase of [...routerCases].sort()) {
+    if (!manifestRoots.has(routerCase)) {
+      errors.push(`${toRelative(ROUTER_FILE)}: route case "${routerCase}" is missing from command manifest roots or aliases`);
+    }
+  }
+
+  for (const root of [...manifestRoots].sort()) {
+    if (!routerCases.has(root)) {
+      errors.push(`${toRelative(ROUTER_FILE)}: command manifest root/alias "${root}" has no route case`);
+    }
+  }
+}
+
+function validateReadmeCoverage(commands) {
+  const readme = fs.readFileSync(README_FILE, 'utf8');
+  const visibleRoots = new Set(commands.filter(entry => !entry.hidden).map(entry => entry.path[0]));
+
+  for (const root of [...visibleRoots].sort()) {
+    const pattern = new RegExp(`yidaconnector\\s+${escapeRegExp(root)}(\\s|\`|$)`);
+    if (!pattern.test(readme)) {
+      errors.push(`${toRelative(README_FILE)}: visible command root "${root}" is missing from CLI reference`);
+    }
+  }
+}
+
+function validateGroupReferences() {
+  const commands = new Set(flattenCommandManifest().map(entry => entry.id));
+  for (const group of COMMAND_GROUPS) {
+    for (const commandId of group.commands.map(entry => entry.id)) {
+      if (!commands.has(commandId)) {
+        errors.push(`Command group "${group.id}" references unknown command id "${commandId}"`);
+      }
+    }
+  }
+}
+
+function run() {
+  const commands = flattenCommandManifest();
+
+  validateUniqueIds(commands);
+  validateGroupReferences();
+  validateRouterCoverage(commands);
+  validateReadmeCoverage(commands);
+
+  if (errors.length > 0) {
+    console.error('Command manifest validation failed:');
+    for (const error of errors) {
+      console.error('  error ' + error);
+    }
+    process.exit(1);
+  }
+
+  console.log(`Command manifest OK: ${commands.length} entries aligned with router and README`);
+}
+
+run();

package/scripts/validate-package-size.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+const MAX_TARBALL_BYTES = 1536 * 1024;
+const MAX_UNPACKED_BYTES = 4608 * 1024;
+const MAX_ENTRY_COUNT = 300;
+const MAX_SINGLE_FILE_BYTES = 512 * 1024;
+
+function formatBytes(bytes) {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KiB`;
+  }
+  return `${(bytes / 1024 / 1024).toFixed(2)} MiB`;
+}
+
+function fail(message) {
+  console.error('Package size validation failed:');
+  console.error('  error ' + message);
+  process.exit(1);
+}
+
+function runNpmPackDryRun() {
+  const result = spawnSync('npm', ['pack', '--dry-run', '--json'], {
+    encoding: 'utf8',
+    stdio: 'pipe',
+  });
+
+  if (result.status !== 0) {
+    process.stderr.write(result.stderr || result.stdout);
+    process.exit(result.status || 1);
+  }
+
+  try {
+    const parsed = JSON.parse(result.stdout);
+    return parsed[0];
+  } catch (_error) {
+    process.stderr.write(result.stdout);
+    fail('npm pack --dry-run --json did not return valid JSON');
+  }
+}
+
+function validateLargestFiles(files) {
+  const sorted = [...files].sort((a, b) => b.size - a.size);
+  const oversized = sorted.find(file => file.size > MAX_SINGLE_FILE_BYTES);
+  if (oversized) {
+    fail(`${oversized.path} is ${formatBytes(oversized.size)}, above ${formatBytes(MAX_SINGLE_FILE_BYTES)}`);
+  }
+
+  return sorted.slice(0, 5).map(file => `${file.path} (${formatBytes(file.size)})`);
+}
+
+function run() {
+  const pack = runNpmPackDryRun();
+  const largestFiles = validateLargestFiles(pack.files || []);
+
+  if (pack.size > MAX_TARBALL_BYTES) {
+    fail(`tarball is ${formatBytes(pack.size)}, above ${formatBytes(MAX_TARBALL_BYTES)}`);
+  }
+  if (pack.unpackedSize > MAX_UNPACKED_BYTES) {
+    fail(`unpacked package is ${formatBytes(pack.unpackedSize)}, above ${formatBytes(MAX_UNPACKED_BYTES)}`);
+  }
+  if (pack.entryCount > MAX_ENTRY_COUNT) {
+    fail(`package has ${pack.entryCount} files, above ${MAX_ENTRY_COUNT}`);
+  }
+
+  console.log(
+    `Package size OK: ${formatBytes(pack.size)} tarball, ${formatBytes(pack.unpackedSize)} unpacked, ${pack.entryCount} files`
+  );
+  console.log('Largest files: ' + largestFiles.join(', '));
+}
+
+run();