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

package/README.md

@@ -36,7 +36,7 @@ CLI 内置 Schema 与通用小程序模板支持可选 `BgMusicUrl`；填写时
 
 两套模板的 `node scripts/check-routes.js` 与 `node scripts/validate-feed-card.js` 均保留为兼容入口，规则统一来自 CLI 的 CJS validator 导出；CLI 命令本身使用对应的 ESM 外层。程序化调用 `validateFeedCard(context, { touchTimestamp: false })` 可禁用时间戳更新。Ajv 由 CLI 自带；OpenCard Lynx CSS 检查复用 `@open-dy/vibecoding-sdk-opencard/eslint/lint-lynx-css`。
 
-`pack --target taro` 默认先清理 `/tmp/microapp_artifacts`，由 CLI 编排 TT 生产构建、server 生产构建以及存在的封闭域服务和 OpenCard 构建，再生成归档。包含 `microapp.zip`、`server.zip`、`Dockerfile`、`run.sh`；存在封闭域服务时追加 `closed-domain-server.zip`、`closed-domain-Dockerfile`、`closed-domain-run.sh`，存在路由配置时复制 `card-routing.json`，存在 OpenCard 时生成 `opencard.zip`。两个 server 每次均构建，不受卡片域开关影响。旧项目若自行提供 `build:pack`，CLI 仍会传递 `ARTIFACTS_DIR` 兼容其产物；两套当前模板均不依赖该分支。
+`pack --target taro` 默认先清理 `/tmp/microapp_artifacts`，由 CLI 编排 TT 生产构建、server 生产构建以及存在的封闭域服务和 OpenCard 构建，再生成归档。包含 `microapp.zip`、`server.zip`、`Dockerfile`、`run.sh`；仅当 `config/card-routing.json` 的 `cardData.serviceDomain` 为 `closed`，且 `closed-domain-server/package.json` 是文件时，追加 `closed-domain-server.zip`、`closed-domain-Dockerfile`、`closed-domain-run.sh`。`open`、`none` 或缺少路由配置时跳过封闭域产物；存在路由配置时复制 `card-routing.json`，存在 OpenCard 时生成 `opencard.zip`。两个 server 每次均构建，不受卡片域开关影响。旧项目若自行提供 `build:pack`，CLI 仍会传递 `ARTIFACTS_DIR` 兼容其产物；两套当前模板均不依赖该分支。
 
 服务包仅包含 `dist`、生成的 `Dockerfile`、`package.json`、`run.sh` 以及可选的 `sql`、`scripts`。生成 Dockerfile 时按原脚本规则为每条 `COPY package.json` 追加存在的目录，项目源文件不改写。构建/zip 失败保留退出码，临时目录在失败时也会清理。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-dy/vibecoding-cli",
-  "version": "0.1.3-beta.0",
+  "version": "0.1.4",
   "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-beta.0",
-    "@open-dy/vibecoding-sdk-opencard": "0.1.2-beta.0"
+    "@open-dy/vibecoding-sdk-taro": "^0.1.0",
+    "@open-dy/vibecoding-sdk-opencard": "0.1.3"
   },
   "peerDependenciesMeta": {
     "@open-dy/vibecoding-sdk-taro": {
@@ -60,7 +60,7 @@
   "license": "UNLICENSED",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
-    "tag": "beta",
+    "tag": "latest",
     "access": "public"
   }
 }

package/release-provenance.json

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

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

@@ -13,8 +13,6 @@ import {
   lintAtRule,
   lintDeclaration,
   lintSelector,
-  normalizeValue,
-  toKebab,
 } from './lynx-css-rules.mjs';
 
 const __dirname = path.join(process.env.VIBECODING_OPENCARD_ROOT || process.cwd(), 'scripts');
@@ -419,32 +417,6 @@ 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);
@@ -473,39 +445,6 @@ 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 })) {
@@ -516,73 +455,8 @@ function listFiles(dir, test, acc = []) {
   return acc;
 }
 
-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 rel(file) {
+  return path.relative(ROOT, file).replace(/\\/g, '/');
 }
 
 function lintTextContainerUsage(rules, textClasses, filename, extraFindings) {
@@ -607,70 +481,32 @@ function lintTextContainerUsage(rules, textClasses, filename, extraFindings) {
   }
 }
 
-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, '..') } = {},
-) {
+export function lintProject(srcDir = SRC) {
   const cssFiles = listFiles(srcDir, (name) => name.endsWith('.css'));
   const tsxFiles = listFiles(srcDir, (name) => /\.[jt]sx$/.test(name));
-  const usage = classUsageByCss(tsxFiles, cssFiles);
+  const textClasses = new Set();
+  for (const file of tsxFiles) {
+    for (const name of collectTextClassesFromTsx(fs.readFileSync(file, 'utf8'))) {
+      textClasses.add(name);
+    }
+  }
 
   const reports = [];
   const allRules = [];
   for (const file of cssFiles) {
-    const filename = path.relative(projectRoot, file).replace(/\\/g, '/');
+    const filename = rel(file);
     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 = path.relative(projectRoot, file).replace(/\\/g, '/');
+    const filename = rel(file);
     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));
@@ -813,84 +649,6 @@ 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) {
@@ -899,7 +657,7 @@ function assertSelfTest() {
     }
     process.exit(1);
   }
-  console.log(`[lynx-css self-test] ${cases.length + 6} passed`);
+  console.log(`[lynx-css self-test] ${cases.length + 1} passed`);
 }
 
 export function main() {

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 '../adapters/interest-card/opencard/lint-lynx-css.mjs'
+import { lintOpenCardProject } from '../lint/lint-lynx-css.mjs'
 import { validateNonEmptyTaro } from '../validators/empty-project.mjs'
 import { validateOpenCardStructure } from '../validators/opencard-structure.mjs'
 import { validateSqlQueries } from '../validators/sql.mjs'

package/src/commands/pack.mjs

@@ -108,16 +108,19 @@ async function packServer(server, artifacts, closed = false) {
 
 export async function packTaroArtifacts(context, artifacts) {
   artifacts = resolveArtifactsDirectory(context.root, artifacts)
+  const serviceDomain = readCardRouting({ root: context.root, target: 'taro' })?.cardData?.serviceDomain
   mkdirSync(artifacts, { recursive: true })
   const dist = path.join(context.root, 'dist-tt')
   console.log(`Packing ${dist} into ${artifacts}/microapp.zip`)
   await zipDirectory(dist, path.join(artifacts, 'microapp.zip'))
   await packServer(context.serverRoot ?? path.join(context.root, 'server'), artifacts)
   const closedServer = path.join(context.root, 'closed-domain-server')
-  if (existsSync(path.join(closedServer, 'package.json')) && statSync(path.join(closedServer, 'package.json')).isFile()) {
+  if (serviceDomain === 'closed' &&
+    existsSync(path.join(closedServer, 'package.json')) &&
+    statSync(path.join(closedServer, 'package.json')).isFile()) {
     await packServer(closedServer, artifacts, true)
   } else {
-    console.log('No closed-domain-server/package.json; skipping closed-domain-server artifacts')
+    console.log(`Skipping closed-domain-server artifacts: requires cardData.serviceDomain=closed and a closed-domain-server/package.json file (serviceDomain=${serviceDomain ?? 'unset'})`)
   }
   const routing = path.join(context.root, 'config/card-routing.json')
   if (existsSync(routing) && statSync(routing).isFile()) {

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

@@ -0,0 +1,244 @@
+#!/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

@@ -0,0 +1,138 @@
+/**
+ * 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;
+}