@open-dy/vibecoding-cli 0.1.4 → 0.1.6-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-dy/vibecoding-cli",
-  "version": "0.1.4",
+  "version": "0.1.6-beta.0",
   "description": "Command orchestration, validation and packaging for Douyin vibecoding Taro and OpenCard projects.",
   "type": "module",
   "bin": {
@@ -43,8 +43,8 @@
     "ajv": "^8.18.0"
   },
   "peerDependencies": {
-    "@open-dy/vibecoding-sdk-taro": "^0.1.0",
-    "@open-dy/vibecoding-sdk-opencard": "0.1.3"
+    "@open-dy/vibecoding-sdk-taro": "0.1.1-beta.0",
+    "@open-dy/vibecoding-sdk-opencard": "0.1.5-beta.0"
   },
   "peerDependenciesMeta": {
     "@open-dy/vibecoding-sdk-taro": {
@@ -60,7 +60,7 @@
   "license": "UNLICENSED",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
-    "tag": "latest",
+    "tag": "beta",
     "access": "public"
   }
 }

package/release-provenance.json

@@ -2,14 +2,14 @@
   "schema": 1,
   "producer": "vibecoding-cli",
   "packageName": "@open-dy/vibecoding-cli",
-  "version": "0.1.4",
+  "version": "0.1.6-beta.0",
   "source": {
-    "digest": "sha256-e03f57170ea6127cad313ef3d94a0f50d515eee64741b0675ed4536132c285e6",
-    "files": 85
+    "digest": "sha256-f2018ad1f7d7656392315c81128e717ce478aeb75dedecdec706fe0035cb026d",
+    "files": 87
   },
-  "payload": "sha256-64c484bf390b2145117810f76b8d81868ab4e969d931d401a1bc01e3d1b65cf5",
+  "payload": "sha256-e85c65882947a652f0d0ec0b05ad00afe0a9106143ff44467c80bb045b86879c",
   "toolchain": {
-    "node": "v22.22.3",
+    "node": "v22.23.1",
     "packageManager": null
   }
 }

package/src/adapters/interest-card/opencard/lint-lynx-css.mjs

@@ -13,6 +13,8 @@ import {
   lintAtRule,
   lintDeclaration,
   lintSelector,
+  normalizeValue,
+  toKebab,
 } from './lynx-css-rules.mjs';
 
 const __dirname = path.join(process.env.VIBECODING_OPENCARD_ROOT || process.cwd(), 'scripts');
@@ -417,6 +419,32 @@ function collectTextClassesRegex(source) {
   return classes;
 }
 
+function collectTextParentClassesRegex(source) {
+  const classes = new Set();
+  const stack = [];
+  const tagPattern = /<(\/?)([A-Za-z][\w.]*)\b([^<>]*?)(\/?)>/g;
+  for (const match of source.matchAll(tagPattern)) {
+    const [, closing, tagName, attributes, selfClosing] = match;
+    if (closing) {
+      const index = stack.findLastIndex((entry) => entry.tagName === tagName);
+      if (index >= 0) stack.splice(index);
+      continue;
+    }
+    if (tagName === 'Text') {
+      for (const ancestor of stack) {
+        for (const className of ancestor.classes) classes.add(className);
+      }
+    }
+    if (!selfClosing) {
+      const tagClasses = new Set();
+      const className = /className\s*=\s*(?:\{\s*)?(["'`])([^"'`]+)\1/.exec(match[0]);
+      if (className) addClassTokens(tagClasses, className[2].replace(/\$\{[^}]*\}/g, ' '));
+      stack.push({ tagName, classes: tagClasses });
+    }
+  }
+  return classes;
+}
+
 export function collectTextClassesFromTsx(source) {
   const babel = loadBabel();
   if (!babel) return collectTextClassesRegex(source);
@@ -445,6 +473,39 @@ export function collectTextClassesFromTsx(source) {
   return classes;
 }
 
+export function collectTextParentClassesFromTsx(source) {
+  const babel = loadBabel();
+  if (!babel) return collectTextParentClassesRegex(source);
+  let ast;
+  try {
+    ast = babel.parser.parse(source, {
+      sourceType: 'module',
+      plugins: ['jsx', 'typescript'],
+    });
+  } catch {
+    return collectTextParentClassesRegex(source);
+  }
+  const classes = new Set();
+  babel.traverse(ast, {
+    JSXOpeningElement(pathNode) {
+      const name = pathNode.node.name;
+      if (name.type !== 'JSXIdentifier' || name.name !== 'Text') return;
+      let ancestor = pathNode.parentPath?.parentPath;
+      while (ancestor) {
+        if (ancestor.isJSXElement?.()) {
+          const openingElement = ancestor.node.openingElement;
+          for (const attr of openingElement.attributes) {
+            if (attr.type !== 'JSXAttribute' || attr.name?.name !== 'className') continue;
+            for (const chunk of collectStaticStrings(attr.value)) addClassTokens(classes, chunk);
+          }
+        }
+        ancestor = ancestor.parentPath;
+      }
+    },
+  });
+  return classes;
+}
+
 function listFiles(dir, test, acc = []) {
   if (!fs.existsSync(dir)) return acc;
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
@@ -455,8 +516,73 @@ function listFiles(dir, test, acc = []) {
   return acc;
 }
 
-function rel(file) {
-  return path.relative(ROOT, file).replace(/\\/g, '/');
+function cssImportsFromSource(source, importer) {
+  const imports = new Set();
+  const patterns = [
+    /\bimport\s+(?:[^'"]+\s+from\s+)?["']([^"']+\.css)["']/g,
+    /\brequire\(\s*["']([^"']+\.css)["']\s*\)/g,
+    /@import\s+(?:url\(\s*)?["']([^"']+\.css)["']\s*\)?\s*;/g,
+  ];
+  for (const pattern of patterns) {
+    for (const match of source.matchAll(pattern)) {
+      imports.add(path.resolve(path.dirname(importer), match[1]));
+    }
+  }
+  return imports;
+}
+
+function addClasses(target, source) {
+  for (const className of source) target.add(className);
+}
+
+function classUsageByCss(tsxFiles, cssFiles) {
+  const usage = new Map(
+    cssFiles.map((file) => [
+      file,
+      { textClasses: new Set(), textParentClasses: new Set() },
+    ]),
+  );
+  const allTextClasses = new Set();
+  const allTextParentClasses = new Set();
+  for (const file of tsxFiles) {
+    const source = fs.readFileSync(file, 'utf8');
+    const textClasses = collectTextClassesFromTsx(source);
+    const textParentClasses = collectTextParentClassesFromTsx(source);
+    addClasses(allTextClasses, textClasses);
+    addClasses(allTextParentClasses, textParentClasses);
+    for (const cssFile of cssImportsFromSource(source, file)) {
+      const entry = usage.get(cssFile);
+      if (!entry) continue;
+      addClasses(entry.textClasses, textClasses);
+      addClasses(entry.textParentClasses, textParentClasses);
+    }
+  }
+
+  for (const file of cssFiles) {
+    if (path.basename(file) !== 'app.css') continue;
+    addClasses(usage.get(file).textClasses, allTextClasses);
+    addClasses(usage.get(file).textParentClasses, allTextParentClasses);
+  }
+
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const file of cssFiles) {
+      const entry = usage.get(file);
+      if (entry.textClasses.size === 0 && entry.textParentClasses.size === 0) continue;
+      const source = fs.readFileSync(file, 'utf8');
+      for (const importedFile of cssImportsFromSource(source, file)) {
+        const importedEntry = usage.get(importedFile);
+        if (!importedEntry) continue;
+        const before = importedEntry.textClasses.size + importedEntry.textParentClasses.size;
+        addClasses(importedEntry.textClasses, entry.textClasses);
+        addClasses(importedEntry.textParentClasses, entry.textParentClasses);
+        const after = importedEntry.textClasses.size + importedEntry.textParentClasses.size;
+        if (after > before) changed = true;
+      }
+    }
+  }
+  return usage;
 }
 
 function lintTextContainerUsage(rules, textClasses, filename, extraFindings) {
@@ -481,32 +607,70 @@ function lintTextContainerUsage(rules, textClasses, filename, extraFindings) {
   }
 }
 
-export function lintProject(srcDir = SRC) {
+function lintHiddenTextParentUsage(rules, textParentClasses, filename, extraFindings) {
+  if (textParentClasses.size === 0) return;
+  for (const rule of rules) {
+    const subjects = lastCompoundSelector(rule.selector);
+    const hitsTextParent = subjects.some((compound) =>
+      classesInCompound(compound).some((name) => textParentClasses.has(name)),
+    );
+    if (!hitsTextParent) continue;
+    const displayNone = rule.decls.find(
+      (decl) =>
+        toKebab(decl.prop) === 'display' &&
+        normalizeValue(decl.value).toLowerCase() === 'none',
+    );
+    if (!displayNone) continue;
+    const clipsHiddenText = rule.decls.some(
+      (decl) =>
+        toKebab(decl.prop) === 'overflow' &&
+        normalizeValue(decl.value).toLowerCase() === 'hidden',
+    );
+    if (clipsHiddenText) continue;
+    extraFindings.push({
+      id: 'hidden-text-parent-overflow',
+      message:
+        '隐藏包含 Text 的父级时，请在同一个隐藏 selector 中同时写 ' +
+        'display: none 与 overflow: hidden，避免 Lynx 残留文字。',
+      line: displayNone.line,
+      column: displayNone.column,
+      selector: rule.selector,
+      file: filename,
+    });
+  }
+}
+
+export function lintProject(
+  srcDir = SRC,
+  { projectRoot = path.resolve(srcDir, '..') } = {},
+) {
   const cssFiles = listFiles(srcDir, (name) => name.endsWith('.css'));
   const tsxFiles = listFiles(srcDir, (name) => /\.[jt]sx$/.test(name));
-  const textClasses = new Set();
-  for (const file of tsxFiles) {
-    for (const name of collectTextClassesFromTsx(fs.readFileSync(file, 'utf8'))) {
-      textClasses.add(name);
-    }
-  }
+  const usage = classUsageByCss(tsxFiles, cssFiles);
 
   const reports = [];
   const allRules = [];
   for (const file of cssFiles) {
-    const filename = rel(file);
+    const filename = path.relative(projectRoot, file).replace(/\\/g, '/');
     const { findings, rules } = lintCssText(fs.readFileSync(file, 'utf8'), { filename });
     for (const item of findings) reports.push({ ...item, file: filename });
     for (const rule of rules) allRules.push({ ...rule, file: filename });
   }
   for (const file of cssFiles) {
-    const filename = rel(file);
+    const filename = path.relative(projectRoot, file).replace(/\\/g, '/');
     const subset = allRules.filter((rule) => rule.file === filename);
+    const { textClasses, textParentClasses } = usage.get(file);
     lintTextContainerUsage(subset, textClasses, filename, reports);
+    lintHiddenTextParentUsage(subset, textParentClasses, filename, reports);
   }
   return reports;
 }
 
+export function lintOpenCardProject(projectRoot) {
+  const root = path.resolve(projectRoot);
+  return lintProject(path.join(root, 'src'), { projectRoot: root });
+}
+
 function printReports(reports) {
   for (const item of reports) {
     console.error(formatFinding(item.file, item.line, item.column, item.message));
@@ -649,6 +813,84 @@ function assertSelfTest() {
     failures.push({ css: textCss, expected: 'text-container', actual: extra.map((f) => f.id) });
   }
 
+  const ordinaryTextCss = '.label { display: block; } .label.is-hidden { display: none; }';
+  const ordinaryTextRules = lintCssText(ordinaryTextCss, { filename: 'src/pages/x.css' }).rules;
+  const ordinaryTextFindings = [];
+  lintTextContainerUsage(
+    ordinaryTextRules,
+    new Set(['label']),
+    'src/pages/x.css',
+    ordinaryTextFindings,
+  );
+  if (ordinaryTextFindings.length > 0) {
+    failures.push({
+      css: ordinaryTextCss,
+      expected: null,
+      actual: ordinaryTextFindings.map((finding) => finding.id),
+    });
+  }
+
+  const hiddenParentCases = [
+    {
+      css: '.panel { display: none; }',
+      expected: 'hidden-text-parent-overflow',
+    },
+    {
+      css: '.panel { display: none; overflow: hidden; }',
+      expected: null,
+    },
+    {
+      css: '.icon-wrap { display: none; }',
+      expected: null,
+      textParentClasses: new Set(),
+    },
+  ];
+  const hiddenTextParents = collectTextParentClassesFromTsx(
+    '<View className="panel"><Text className="label">文字</Text></View>',
+  );
+  for (const item of hiddenParentCases) {
+    const hiddenRules = lintCssText(item.css, { filename: 'src/pages/x.css' }).rules;
+    const hiddenFindings = [];
+    lintHiddenTextParentUsage(
+      hiddenRules,
+      item.textParentClasses ?? hiddenTextParents,
+      'src/pages/x.css',
+      hiddenFindings,
+    );
+    const hit = hiddenFindings.some((finding) => finding.id === item.expected);
+    const ok = item.expected === null ? hiddenFindings.length === 0 : hit;
+    if (!ok) {
+      failures.push({
+        css: item.css,
+        expected: item.expected,
+        actual: hiddenFindings.map((finding) => finding.id),
+      });
+    }
+  }
+
+  const fixture = fs.mkdtempSync(path.join(process.cwd(), '.lynx-css-test-'));
+  try {
+    fs.writeFileSync(
+      path.join(fixture, 'index.tsx'),
+      'import "./index.css";\n<View className="panel"><Text className="label">文字</Text></View>',
+    );
+    fs.writeFileSync(
+      path.join(fixture, 'index.css'),
+      '.panel { display: none; overflow: hidden; }',
+    );
+    fs.writeFileSync(path.join(fixture, 'unrelated.css'), '.panel { display: none; }');
+    const crossFileReports = lintProject(fixture);
+    if (crossFileReports.length > 0) {
+      failures.push({
+        css: '.panel { display: none; } in unimported CSS',
+        expected: null,
+        actual: crossFileReports.map((finding) => finding.id),
+      });
+    }
+  } finally {
+    fs.rmSync(fixture, { recursive: true, force: true });
+  }
+
   if (failures.length) {
     console.error(`[lynx-css self-test] ${failures.length} failed`);
     for (const fail of failures) {
@@ -657,7 +899,7 @@ function assertSelfTest() {
     }
     process.exit(1);
   }
-  console.log(`[lynx-css self-test] ${cases.length + 1} passed`);
+  console.log(`[lynx-css self-test] ${cases.length + 6} passed`);
 }
 
 export function main() {

package/src/commands/build.mjs

@@ -24,6 +24,7 @@ export async function buildTaroFrontend(context, type, options = {}) {
     cwd: context.taroRoot,
     env: taroEnvironment(context.taroRoot, options.env),
     label: `taro ${type} build`,
+    quiet: options.quiet,
   })
   if (type === 'tt' && !options.watch) {
     writeWebConfig(path.join(context.taroRoot, 'dist-tt'))
@@ -45,6 +46,7 @@ export async function buildOpenCard(context, options = {}) {
       ...cardEnvironment,
     }),
     label: 'opencard tt build',
+    quiet: options.quiet,
   })
   if (!options.watch) {
     writeWebConfig(path.join(root, options.env?.TT_OUTPUT_ROOT?.trim() || 'dist'))
@@ -62,6 +64,7 @@ export function buildServer(context, options = {}) {
     cwd: context.taroRoot,
     env: options.env,
     label: 'server build',
+    quiet: options.quiet,
   })
 }
 
@@ -70,6 +73,7 @@ export function buildClosedDomainServer(context, options = {}) {
     cwd: context.taroRoot,
     env: options.env,
     label: 'closed-domain-server build',
+    quiet: options.quiet,
   })
 }
 
@@ -90,7 +94,7 @@ export async function buildPackInputs(context, options = {}) {
   if (context.hasOpenCard) {
     tasks.push({ name: 'opencard', run: () => buildOpenCard(context, options) })
   }
-  await runTasks(tasks, { label: 'pack build' })
+  await runTasks(tasks, { label: 'pack build', quiet: options.quiet })
 }
 
 export async function runBuild(context, options = {}) {
@@ -136,6 +140,6 @@ export async function runBuild(context, options = {}) {
   if (context.hasOpenCard) {
     tasks.push({ name: 'opencard', run: () => buildOpenCard(context, buildOptions) })
   }
-  await runTasks(tasks, { label: 'build' })
-  validateRoutes(context)
+  await runTasks(tasks, { label: 'build', quiet: buildOptions.quiet })
+  validateRoutes(context, { quiet: buildOptions.quiet })
 }

package/src/commands/db.mjs

@@ -10,5 +10,6 @@ export async function runDatabaseInit(context, options = {}) {
     cwd: context.serverRoot,
     env: options.env,
     label: 'database initialization',
+    quiet: options.quiet,
   })
 }

package/src/commands/lint.mjs

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync } from 'node:fs'
 import path from 'node:path'
 import { CliError } from '../core/errors.mjs'
 import { resolveProjectBinary, runCaptured, runProcess, runTasks } from '../core/runner.mjs'
-import { lintOpenCardProject } from '../lint/lint-lynx-css.mjs'
+import { lintOpenCardProject } from '../adapters/interest-card/opencard/lint-lynx-css.mjs'
 import { validateNonEmptyTaro } from '../validators/empty-project.mjs'
 import { validateOpenCardStructure } from '../validators/opencard-structure.mjs'
 import { validateSqlQueries } from '../validators/sql.mjs'
@@ -106,21 +106,21 @@ export async function lintOpenCard(context, options = {}) {
     { name: 'opencard-structure', run: async () => validateOpenCardStructure(validationContext) },
     { name: 'opencard-widget-shell', run: async () => validateWidgetShell(validationContext) },
     { name: 'opencard-lynx-css', run: () => runLynxCss(root, options.lintProject) },
-    { name: 'opencard-tsc', run: () => runProcess(tsc, ['--noEmit'], { cwd: root }) },
+    { name: 'opencard-tsc', run: () => runProcess(tsc, ['--noEmit'], { cwd: root, quiet: options.quiet }) },
   ]
   if (eslintSelection.runEslint) {
     tasks.push({
       name: 'opencard-eslint',
-      run: () => runProcess(eslint, eslintArgs, { cwd: root }),
+      run: () => runProcess(eslint, eslintArgs, { cwd: root, quiet: options.quiet }),
     })
   }
-  await runTasks(tasks, { label: 'opencard lint' })
+  await runTasks(tasks, { label: 'opencard lint', quiet: options.quiet })
 }
 
 export async function runLint(context, options = {}) {
   const incremental = options.incremental || process.env.LINT_INCREMENTAL === '1'
   if (context.target === 'opencard') {
-    await lintOpenCard(context, { incremental })
+    await lintOpenCard(context, { incremental, quiet: options.quiet })
     return
   }
 
@@ -142,8 +142,8 @@ export async function runLint(context, options = {}) {
   const tasks = []
   if (full || changed.some((file) => file.startsWith('src/'))) {
     tasks.push(
-      { name: 'taro-tsc', run: () => runProcess(tsc, ['--noEmit'], { cwd: context.root }) },
-      { name: 'taro-eslint', run: () => runProcess(eslint, eslintArgs, { cwd: context.root }) },
+      { name: 'taro-tsc', run: () => runProcess(tsc, ['--noEmit'], { cwd: context.root, quiet: options.quiet }) },
+      { name: 'taro-eslint', run: () => runProcess(eslint, eslintArgs, { cwd: context.root, quiet: options.quiet }) },
     )
   }
   if (full || serverChanged || closedDomainChanged) {
@@ -156,7 +156,7 @@ export async function runLint(context, options = {}) {
     tasks.push({
       name: 'server-lint',
       run: () => runTasks([
-        { name: 'server-tsc', run: () => runProcess(tsc, ['--noEmit'], { cwd: context.serverRoot }) },
+        { name: 'server-tsc', run: () => runProcess(tsc, ['--noEmit'], { cwd: context.serverRoot, quiet: options.quiet }) },
         {
           name: 'server-eslint',
           run: () => runProcess(eslint, [
@@ -164,13 +164,16 @@ export async function runLint(context, options = {}) {
             '--cache-location',
             'node_modules/.cache/eslint/server-src',
             'src/**/*.{js,jsx,ts,tsx}',
-          ], { cwd: context.serverRoot }),
+          ], { cwd: context.serverRoot, quiet: options.quiet }),
         },
-      ], { label: 'server lint' }),
+      ], { label: 'server lint', quiet: options.quiet }),
     })
   }
   if (context.hasOpenCard && (full || changed.some((file) => file.startsWith('opencard/')))) {
-    tasks.push({ name: 'opencard-lint', run: () => lintOpenCard(context, { incremental: !full }) })
+    tasks.push({
+      name: 'opencard-lint',
+      run: () => lintOpenCard(context, { incremental: !full, quiet: options.quiet }),
+    })
   }
-  await runTasks(tasks, { label: 'lint' })
+  await runTasks(tasks, { label: 'lint', quiet: options.quiet })
 }

package/src/commands/verify.mjs

@@ -33,21 +33,23 @@ async function runStatic(context) {
   validateDependencies(context)
   const env = await readRuntimeEnvironment(context.root)
   const tasks = [
-    { name: 'lint', run: () => runLint(context) },
-    { name: 'build', run: () => runBuild(context, { frontendTarget: 'tt' }) },
+    { name: 'lint', run: () => runLint(context, { quiet: true }) },
+    { name: 'build', run: () => runBuild(context, { frontendTarget: 'tt', quiet: true }) },
   ]
   if (context.target === 'taro') {
     tasks.push(
-      { name: 'database', run: () => runDatabaseInit(context, { env }) },
-      { name: 'feed-card', run: async () => validateFeedCard(context) },
+      { name: 'database', run: () => runDatabaseInit(context, { env, quiet: true }) },
+      { name: 'feed-card', run: async () => validateFeedCard(context, { quiet: true }) },
     )
   }
-  await runTasks(tasks, { label: 'static verification' })
+  await runTasks(tasks, { label: 'static verification', quiet: true })
   if (context.target === 'taro') {
     validateServerArtifactFileCount(context.serverRoot ?? path.join(context.root, 'server'), {
       packScriptPath: path.join(context.root, 'scripts/pack.sh'),
+      quiet: true,
     })
   }
+  console.log('[verify] Static phase passed (all parallel tasks OK).')
 }
 
 export function startDevDetached(context, spawnProcess = spawn) {
@@ -623,19 +625,31 @@ export async function runVerify(context, options = {}) {
   options = { timeoutSeconds: 90, ...options, full }
   const frontendUrl = resolveFrontendUrl(context, options)
   parseHttpUrl(frontendUrl, 'frontend')
-  if (full || options.staticOnly) await runStatic(context)
-  if (options.staticOnly) return
+  if (full || options.staticOnly) {
+    await runStatic(context)
+  }
+  if (options.staticOnly) {
+    console.log('[verify] --static-only: done.')
+    return
+  }
 
   await verifyPorts(context, options, frontendUrl)
-  if (options.portsOnly) return
-  if (full && context.target === 'taro') await verifyFeedApi(context)
+  if (options.portsOnly) {
+    console.log('[verify] --ports-only: done.')
+    return
+  }
+  if (full && context.target === 'taro') {
+    await verifyFeedApi(context)
+  }
   if (context.target === 'taro' &&
       existsSync(path.resolve(context.root, '../sar_game/package.json'))) {
     console.log('[vibecoding:verify] SAR game project detected; skipping browser runtime checks')
+    console.log('[verify] All checks passed.')
     return
   }
   await browserCheck(context.root, frontendUrl, context.target)
   if (context.target === 'taro' && context.hasOpenCard) {
     await browserCheck(context.opencardRoot, 'http://localhost:10087/', 'opencard')
   }
+  console.log('[verify] All checks passed.')
 }

package/src/core/runner.mjs

@@ -12,28 +12,49 @@ export function resolveSdkTaroEntry(root) {
   return createRequire(path.join(root, 'package.json')).resolve('@open-dy/vibecoding-sdk-opencard/build/taro-toolchain')
 }
 
+function withCapturedOutput(message, stdout, stderr) {
+  if (!stdout && !stderr) return message
+  const separator = stdout && stderr && !stdout.endsWith('\n') ? '\n' : ''
+  return `${message}\n${stdout}${separator}${stderr}`
+}
+
 export function runProcess(command, args = [], options = {}) {
   const label = options.label ?? path.basename(command)
   return new Promise((resolve, reject) => {
+    const captureOutput = options.quiet && options.stdio === undefined
     const child = spawn(command, args, {
       cwd: options.cwd,
       env: { ...process.env, ...options.env },
-      stdio: options.stdio ?? 'inherit',
+      stdio: captureOutput ? ['ignore', 'pipe', 'pipe'] : (options.stdio ?? 'inherit'),
       detached: options.detached ?? false,
       shell: options.shell ?? false,
     })
+    let stdout = ''
+    let stderr = ''
+    if (captureOutput) {
+      child.stdout.setEncoding('utf8')
+      child.stderr.setEncoding('utf8')
+      child.stdout.on('data', (chunk) => { stdout += chunk })
+      child.stderr.on('data', (chunk) => { stderr += chunk })
+    }
 
     child.on('error', (error) => {
-      reject(new CliError(`${label} failed to start: ${error.message}`))
+      reject(new CliError(withCapturedOutput(
+        `${label} failed to start: ${error.message}`,
+        stdout,
+        stderr,
+      )))
     })
     child.on('exit', (code, signal) => {
       if (code === 0) {
         resolve({ code: 0, signal, child })
         return
       }
-      reject(new CliError(
+      reject(new CliError(withCapturedOutput(
         `${label} failed${signal ? ` with signal ${signal}` : ` with exit code ${code}`}`,
-      ))
+        stdout,
+        stderr,
+      )))
     })
   })
 }
@@ -78,9 +99,9 @@ export function runCaptured(command, args = [], options = {}) {
 export async function runTasks(tasks, options = {}) {
   const results = await Promise.allSettled(
     tasks.map(async ({ name, run }) => {
-      console.log(`[vibecoding] starting ${name}`)
+      if (!options.quiet) console.log(`[vibecoding] starting ${name}`)
       await run()
-      console.log(`[vibecoding] completed ${name}`)
+      if (!options.quiet) console.log(`[vibecoding] completed ${name}`)
       return name
     }),
   )

package/src/validators/feed-card.cjs

@@ -149,7 +149,7 @@ function validateFeedCard(context, options = {}) {
     }
   }
 
-  console.log("All validations passed!");
+  if (!options.quiet) console.log("All validations passed!");
   return { skipped: false };
 }
 

package/src/validators/routes.cjs

@@ -3,6 +3,7 @@ const path = require('path');
 
 function validateRoutes(context, options = {}) {
 if (context.target !== 'taro') return;
+const quiet = Boolean(options.quiet);
 const ROOT = context.root;
 const routesDir = options.routesDir || '/tmp/routes';
 const CLIENT_FILE = path.join(routesDir, 'client-routes.json');
@@ -402,7 +403,7 @@ function main() {
   const closedDomainServerRoutes = loadClosedDomainServerRoutes();
   const cardRoutingConfig = loadCardRoutingConfig();
 
-  console.log('=== 前后端路由一致性检测报告 ===\n');
+  if (!quiet) console.log('=== 前后端路由一致性检测报告 ===\n');
 
   assertOpenDomainServerDoesNotCallClosedDomainOpenAPI();
 
@@ -451,7 +452,7 @@ function main() {
     }
   }
 
-  console.log('--- 检测结果 ---\n');
+  if (!quiet) console.log('--- 检测结果 ---\n');
 
   if (mismatched.length > 0) {
     console.error(`未匹配（${mismatched.length} 条）：以下前端请求路径未匹配到所选服务域的服务端路由，请检查前端请求路径、服务域配置，或确认服务端已注册对应路由`);
@@ -460,7 +461,7 @@ function main() {
     }
     throw new Error('前后端路由一致性检测失败');
   } else {
-    console.log('所有前端静态请求路径均已在服务端注册对应路由，检测通过。');
+    if (!quiet) console.log('所有前端静态请求路径均已在服务端注册对应路由，检测通过。');
   }
 }
 

package/src/validators/server-artifact.mjs

@@ -63,7 +63,7 @@ function countFiles(target, policy) {
     (policy.excludes && isServerPackExcluded(name, policy) ? 0 : countFiles(path.join(target, name), policy)), 0)
 }
 
-export function validateServerArtifactFileCount(serverRoot, { packScriptPath } = {}) {
+export function validateServerArtifactFileCount(serverRoot, { packScriptPath, quiet = false } = {}) {
   if (!existsSync(serverRoot)) throw new CliError(`Server directory is missing: ${serverRoot}`)
   let policy = DEFAULT_POLICY
   if (packScriptPath) {
@@ -84,6 +84,8 @@ export function validateServerArtifactFileCount(serverRoot, { packScriptPath } =
   if (count > MAX_FILE_COUNT) {
     throw new CliError(`Packed server artifact ${serverRoot} would contain ${count} files, exceeding the limit ${MAX_FILE_COUNT}. This count follows the server pack policy. Reduce files included by pack before submission.`)
   }
-  console.log(`[verify] static:server-artifact-file-count → OK (${count}/${MAX_FILE_COUNT}, ${serverRoot}).`)
+  if (!quiet) {
+    console.log(`[verify] static:server-artifact-file-count → OK (${count}/${MAX_FILE_COUNT}, ${serverRoot}).`)
+  }
   return { skipped: false, count, missing: [] }
 }

package/src/lint/lint-lynx-css.mjs

@@ -1,244 +0,0 @@
-#!/usr/bin/env node
-/**
- * OpenCard Lynx CSS 静态检查：扫 src 下 CSS，并复用同一规则检查 Text class。
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-import {
-  formatFinding,
-  isTextContainerDeclaration,
-  lintAtRule,
-  lintDeclaration,
-  lintSelector,
-} from './lynx-css-rules.mjs';
-
-// Keep string literals intact: comment delimiters inside quoted URLs are data.
-function scanComments(source) {
-  const chars = source.split('');
-  const errors = [];
-  let quote = '';
-  for (let i = 0; i < source.length; i += 1) {
-    if (quote) {
-      if (source[i] === '\\') i += 1;
-      else if (source[i] === quote) quote = '';
-      continue;
-    }
-    if (source[i] === '"' || source[i] === "'") {
-      quote = source[i];
-      continue;
-    }
-    if (source.slice(i, i + 2) === '*/') {
-      errors.push({ index: i, message: '孤立的 CSS 注释结束符 */；检查文件是否缺失开头。' });
-      i += 1;
-    } else if (source.slice(i, i + 2) === '/*') {
-      const end = source.indexOf('*/', i + 2);
-      if (end < 0) errors.push({ index: i, message: 'CSS 注释未闭合，缺少 */。' });
-      const stop = end < 0 ? source.length : end + 2;
-      for (let j = i; j < stop; j += 1) {
-        if (chars[j] !== '\n') chars[j] = ' ';
-      }
-      i = stop - 1;
-    }
-  }
-  return { content: chars.join(''), errors };
-}
-
-export function stripCommentsPreservingLines(source) {
-  return scanComments(source).content;
-}
-
-function lineAt(source, index) {
-  const before = source.slice(0, index);
-  return {
-    line: before.split('\n').length,
-    column: index - before.lastIndexOf('\n'),
-  };
-}
-
-function splitTopLevel(source, delimiter) {
-  const parts = [];
-  let current = '';
-  let depth = 0;
-  let quote = '';
-  for (const char of source) {
-    if (quote) {
-      current += char;
-      if (char === quote) quote = '';
-      continue;
-    }
-    if (char === '"' || char === "'") {
-      quote = char;
-      current += char;
-      continue;
-    }
-    if (char === '(') depth += 1;
-    if (char === ')') depth = Math.max(0, depth - 1);
-    if (char === delimiter && depth === 0) {
-      parts.push(current);
-      current = '';
-      continue;
-    }
-    current += char;
-  }
-  if (current) parts.push(current);
-  return parts;
-}
-
-function walkRules(source, onRule, offset = 0) {
-  let index = 0;
-  while (index < source.length) {
-    const open = source.indexOf('{', index);
-    if (open < 0) break;
-    const selector = source.slice(index, open).trim();
-    let depth = 1;
-    let cursor = open + 1;
-    while (cursor < source.length && depth > 0) {
-      if (source[cursor] === '{') depth += 1;
-      if (source[cursor] === '}') depth -= 1;
-      cursor += 1;
-    }
-    const bodyEnd = depth === 0 ? cursor - 1 : source.length;
-    const body = source.slice(open + 1, bodyEnd);
-    onRule({ selector, body, selectorOffset: offset + index, bodyOffset: offset + open + 1 });
-    index = cursor;
-  }
-}
-
-function listFiles(directory, predicate, files = []) {
-  if (!fs.existsSync(directory)) return files;
-  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-    const target = path.join(directory, entry.name);
-    if (entry.isDirectory()) {
-      listFiles(target, predicate, files);
-    } else if (predicate(target)) {
-      files.push(target);
-    }
-  }
-  return files;
-}
-
-function textClassTokensFromTsx(source) {
-  const names = new Set();
-  for (const match of source.matchAll(/<Text\b[^>]*\bclassName\s*=\s*(?:"([^"]+)"|'([^']+)')/g)) {
-    const value = match[1] ?? match[2] ?? '';
-    for (const className of value.split(/\s+/)) {
-      if (className) names.add(className);
-    }
-  }
-  return names;
-}
-
-export function lintCssText(source, { filename = 'input.css' } = {}) {
-  const { content, errors } = scanComments(source);
-  const findings = errors.map(({ index, message }) => ({
-    file: filename, ...lineAt(source, index), message,
-  }));
-  const textClassRules = new Map();
-
-  walkRules(content, ({ selector, body, selectorOffset, bodyOffset }) => {
-    const selectorLocation = lineAt(content, selectorOffset);
-    if (selector.startsWith('@')) {
-      const name = selector.split(/\s|\{/)[0];
-      for (const item of lintAtRule(name)) {
-        findings.push({ file: filename, ...selectorLocation, message: item.message });
-      }
-      return;
-    }
-
-    const allowRoot = filename.replace(/\\/g, '/').endsWith('/src/app.css') || filename === 'src/app.css';
-    for (const item of lintSelector(selector, { allowRoot })) {
-      findings.push({ file: filename, ...selectorLocation, message: item.message });
-    }
-
-    const classNames = [...selector.matchAll(/\.([A-Za-z0-9_-]+)/g)].map((match) => match[1]);
-    const declarations = [];
-    let consumed = 0;
-    for (const fragment of splitTopLevel(body, ';')) {
-      const colon = fragment.indexOf(':');
-      if (colon < 0) {
-        consumed += fragment.length + 1;
-        continue;
-      }
-      const property = fragment.slice(0, colon).trim();
-      const value = fragment.slice(colon + 1).trim();
-      if (!property || !value) {
-        consumed += fragment.length + 1;
-        continue;
-      }
-      const location = lineAt(content, bodyOffset + consumed);
-      declarations.push({ property, value, location });
-      for (const item of lintDeclaration(property, value)) {
-        findings.push({ file: filename, ...location, message: item.message });
-      }
-      consumed += fragment.length + 1;
-    }
-
-    for (const className of classNames) {
-      textClassRules.set(className, declarations);
-    }
-  });
-
-  return { findings, textClassRules };
-}
-
-export function lintProject(
-  sourceDirectory = path.join(process.cwd(), 'src'),
-  { projectRoot = path.resolve(sourceDirectory, '..') } = {},
-) {
-  const reports = [];
-  const textClasses = new Set();
-  const cssFiles = listFiles(sourceDirectory, (file) => file.endsWith('.css'));
-  const tsxFiles = listFiles(sourceDirectory, (file) => /\.(?:tsx|jsx)$/.test(file));
-  const ruleMap = new Map();
-
-  for (const file of tsxFiles) {
-    for (const className of textClassTokensFromTsx(fs.readFileSync(file, 'utf8'))) {
-      textClasses.add(className);
-    }
-  }
-
-  for (const file of cssFiles) {
-    const relative = path.relative(projectRoot, file).replace(/\\/g, '/');
-    const result = lintCssText(fs.readFileSync(file, 'utf8'), { filename: relative });
-    reports.push(...result.findings);
-    for (const [className, declarations] of result.textClassRules) {
-      ruleMap.set(className, { declarations, filename: relative });
-    }
-  }
-
-  for (const [className, rule] of ruleMap) {
-    if (!textClasses.has(className)) continue;
-    for (const declaration of rule.declarations) {
-      if (!isTextContainerDeclaration(declaration.property)) continue;
-      reports.push({
-        file: rule.filename,
-        ...declaration.location,
-        message: `Text 不是 Flex/Grid 容器，不要写 ${declaration.property}: ${declaration.value}。多个节点的排列由外层 View 承担。`,
-      });
-    }
-  }
-
-  return reports;
-}
-
-export function lintOpenCardProject(projectRoot) {
-  const root = path.resolve(projectRoot);
-  return lintProject(path.join(root, 'src'), { projectRoot: root });
-}
-
-function main() {
-  const reports = lintOpenCardProject(process.cwd());
-  if (reports.length === 0) return;
-  console.error(`ERROR: OpenCard Lynx CSS 检查失败（${reports.length}）`);
-  for (const report of reports) {
-    console.error(formatFinding(report.file, report.line, report.column, report.message));
-  }
-  process.exit(1);
-}
-
-const invoked =
-  process.argv[1] &&
-  import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href;
-
-if (invoked) main();

package/src/lint/lynx-css-rules.mjs

@@ -1,138 +0,0 @@
-/**
- * OpenCard Lynx CSS 机械检查规则。
- *
- * CLI 自己执行 OpenCard lint，因此这里不依赖 SDK；SDK 暴露给项目 ESLint 配置的
- * 规则仍独立维护在 SDK 内。
- */
-
-export const HINT = '见 references/opencard/rendering.md';
-
-const FORBIDDEN_AT_RULES = new Set(['media', 'supports', 'layer', 'namespace']);
-
-const FORBIDDEN_PROPERTIES = new Map([
-  ['float', '不要用 float。改用 Flex / Grid。'],
-  ['clear', '不要用 clear。改用 Flex / Grid。'],
-  ['pointer-events', 'Lynx 不支持 pointer-events。用条件渲染或事件层级。'],
-  ['cursor', 'Lynx 不支持 cursor。不要生成。'],
-  ['resize', 'Lynx 不支持 resize。用组件状态或 JS 调尺寸。'],
-  ['scroll-behavior', 'Lynx 不支持 scroll-behavior。不要生成。'],
-  ['overscroll-behavior', '不要用 overscroll-behavior 承接滚动。'],
-  ['content', '不能用伪元素生成内容。增加真实 Taro 节点。'],
-  ['list-style', '列表 marker 不可用。用真实节点表达。'],
-  ['list-style-type', '列表 marker 不可用。用真实节点表达。'],
-  ['word-break', 'Lynx 不支持 word-break。控制文本节点宽度。'],
-  ['overflow-wrap', 'Lynx 不支持 overflow-wrap。控制文本节点宽度。'],
-  ['word-wrap', 'Lynx 不支持 word-wrap。控制文本节点宽度。'],
-  ['-webkit-line-clamp', '不要迁移 -webkit-line-clamp。收敛内容或使用单行省略。'],
-  ['-webkit-box-orient', '不要迁移 -webkit-box。'],
-]);
-
-const TEXT_CONTAINER_PROPS = new Set([
-  'flex-direction',
-  'flex-wrap',
-  'flex-flow',
-  'justify-content',
-  'align-items',
-  'align-content',
-  'gap',
-  'row-gap',
-  'column-gap',
-]);
-
-export function toKebab(value) {
-  return String(value ?? '')
-    .trim()
-    .replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`)
-    .toLowerCase();
-}
-
-export function formatFinding(file, line, column, message) {
-  return `${file}:${line}:${column} ${message}`;
-}
-
-function issue(message) {
-  return { message: `${message} ${HINT}` };
-}
-
-export function lintAtRule(name) {
-  const normalized = String(name ?? '').trim().replace(/^@/, '').toLowerCase();
-  if (!FORBIDDEN_AT_RULES.has(normalized)) {
-    return [];
-  }
-  if (normalized === 'media') {
-    return [issue('Lynx 的 @media 不生效。容器用 flex、vw/vh 适配。')];
-  }
-  return [issue(`Lynx 不支持 @${normalized}。使用常规 CSS 或运行时 class。`)];
-}
-
-export function lintSelector(selector, { allowRoot = false } = {}) {
-  const normalized = String(selector ?? '');
-  const findings = [];
-  if (/::(?:before|after|first-line|first-letter|marker|backdrop)\b/i.test(normalized)) {
-    findings.push(issue('不要使用 CSS 伪元素。需要内容时增加真实节点。'));
-  }
-  if (/:?(?:first-child|last-child|only-child|nth-child|nth-of-type|has)\b/i.test(normalized)) {
-    findings.push(issue('不要依赖结构伪类。为对应节点添加显式 class。'));
-  }
-  if (!allowRoot && /(?:^|[^A-Za-z0-9_-]):root(?![A-Za-z0-9_-])/i.test(normalized)) {
-    findings.push(issue(':root 只允许出现在 src/app.css。页面和组件变量写在局部 class。'));
-  }
-  return findings;
-}
-
-export function isTextContainerDeclaration(prop) {
-  return TEXT_CONTAINER_PROPS.has(toKebab(prop));
-}
-
-export function lintDeclaration(prop, rawValue) {
-  const property = toKebab(prop);
-  const value = String(rawValue ?? '').trim();
-  const normalized = value.toLowerCase();
-  const findings = [];
-
-  if (property.startsWith('--')) {
-    return findings;
-  }
-
-  const propertyMessage = FORBIDDEN_PROPERTIES.get(property);
-  if (propertyMessage) {
-    findings.push(issue(propertyMessage));
-  }
-
-  if (property.startsWith('scroll-snap-')) {
-    findings.push(issue('Lynx 不支持 scroll-snap。横向轮播使用 Swiper。'));
-  }
-
-  if (property === 'display' && /(?:^|\s)(?:inline|inline-block|table|contents|list-item)(?:\s|$)/i.test(normalized)) {
-    findings.push(issue('不要依赖 inline、table、contents 或 list-item 布局。使用 Flex / Grid。'));
-  }
-
-  if (property === 'position' && /^(?:static|sticky)$/i.test(normalized)) {
-    findings.push(issue(`不要使用 position: ${normalized}。改用普通布局或 fixed / absolute。`));
-  }
-
-  if (
-    (property === 'overflow' || property === 'overflow-y') &&
-    /(?:^|\s)(?:auto|scroll)(?:\s|$)/i.test(normalized)
-  ) {
-    findings.push(issue('固定 widget 不允许纵向滚动。减项、摘要化或切换局部状态。'));
-  }
-
-  if (property === 'white-space' && /(?:pre|pre-wrap|pre-line|break-spaces)/i.test(normalized)) {
-    findings.push(issue('不要使用预格式 white-space。收敛文案并控制节点尺寸。'));
-  }
-
-  if (property === 'flex' && /^\s*\d+(?:\.\d+)?\s*$/i.test(normalized)) {
-    findings.push(issue('不要写 flex: 1。使用完整三值 flex: 1 1 0，并显式设置 min-height / min-width。'));
-  }
-
-  if (/\b(?:min|max|clamp)\s*\(/i.test(value)) {
-    findings.push(issue('Lynx 不支持 min()、max()、clamp()。用 flex、vw/vh 或明确尺寸。'));
-  }
-
-  if (/(?:^|[^\w-])(?:cm|mm|in|pt|pc|ch|ex)(?:$|[^\w-])/i.test(value)) {
-    findings.push(issue('不要使用 cm/mm/in/pt/pc/ch/ex 单位。使用 px、rem、vw 或 vh。'));
-  }
-
-  return findings;
-}