feat: enhance prompt quality tests and modules

- Updated prompt quality tests to include additional checks for new markers and constraints in both Chinese and English.
- Refactored prompt quality module to centralize shared constraints, delivery contracts, and acceptance criteria for better maintainability.
- Added new test cases for data integrity in case and recipe prompts, ensuring all prompts contain necessary sections and adhere to defined standards.
- Introduced a standalone preparation script for static assets to streamline deployment.
- Created a custom error component for localized error handling in the application.
- Configured Vitest for testing with path aliasing for cleaner imports.

Author: peixl

eslint.config.mjs

@@ -1,15 +1,9 @@
-import { FlatCompat } from '@eslint/eslintrc';
-import { dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import nextConfig from 'eslint-config-next';
+import tseslint from 'typescript-eslint';
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const compat = new FlatCompat({ baseDirectory: __dirname });
-
-const eslintConfig = [
+export default tseslint.config(
   {
     ignores: ['.next/**', '.open-next/**', 'node_modules/**', 'next-env.d.ts'],
   },
-  ...compat.extends('next/core-web-vitals', 'next/typescript'),
-];
-
-export default eslintConfig;
+  ...nextConfig,
+);

next.config.mjs

@@ -8,6 +8,7 @@ const __dirname = path.dirname(__filename);
 const nextConfig = {
   output: 'standalone',
   outputFileTracingRoot: __dirname,
+  bundlePagesRouterDependencies: true,
   reactStrictMode: true,
   poweredByHeader: false,
   compress: true,

package.json

@@ -6,9 +6,9 @@
   "description": "Beginner-friendly Codex desktop tutorial site for non-developers (Windows & macOS)",
   "scripts": {
     "dev": "next dev",
-    "build:next": "next build",
+    "build:next": "next build && node scripts/prepare-standalone.mjs",
     "build": "npm run build:next && opennextjs-cloudflare build --skipNextBuild",
-    "start": "next start",
+    "start": "node .next/standalone/server.js",
     "test": "vitest run",
     "lint": "eslint .",
     "prompt:stats": "node scripts/prompt-stats.mjs",

scripts/prepare-standalone.mjs

@@ -0,0 +1,23 @@
+import { cp, rm } from 'node:fs/promises';
+import path from 'node:path';
+
+const rootDir = process.cwd();
+const standaloneDir = path.join(rootDir, '.next', 'standalone');
+
+const copies = [
+  {
+    from: path.join(rootDir, '.next', 'static'),
+    to: path.join(standaloneDir, '.next', 'static'),
+  },
+  {
+    from: path.join(rootDir, 'public'),
+    to: path.join(standaloneDir, 'public'),
+  },
+];
+
+for (const { from, to } of copies) {
+  await rm(to, { recursive: true, force: true });
+  await cp(from, to, { recursive: true });
+}
+
+console.log('Prepared standalone static assets.');

scripts/prompt-stats.mjs

@@ -8,6 +8,50 @@ const json = args.has('--json');
 const limitArg = process.argv.find((arg) => arg.startsWith('--limit='));
 const limit = Number(limitArg?.split('=')[1] ?? 10);
 
+const CONTENT_SIGNALS = {
+  zh: [
+    ['AI 小白', '不懂代码', '小白'],
+    ['sample-data', '示例数据'],
+    ['烟测'],
+    ['不覆盖原文件'],
+    ['不写死', '不写死密钥'],
+    ['真实接线'],
+    ['友好', '不闪退'],
+    ['降级', '3 次失败'],
+  ],
+  en: [
+    ['AI beginner', 'non-technical', 'non-developer'],
+    ['sample-data', 'sample data'],
+    ['Smoke test', 'smoke-tested'],
+    ['Never overwrite', 'never overwrite'],
+    ['No hard-coded', 'no hard-coded'],
+    ['Real wiring'],
+    ['friendly', 'no crash'],
+    ['downgrade', '3 times'],
+  ],
+};
+
+const STRUCTURE_SIGNALS = {
+  zh: [
+    ['目标：', '【目标】'],
+    ['功能：', '【核心功能】'],
+    ['平台：', '【平台与技术】', '【环境】'],
+    ['【快速交付】', '【交付】'],
+    ['完成标准', '验收清单', '自检清单'],
+    ['【约束】', '【实现纪律 / 安全】'],
+    ['最终只报', '最终汇报', '使用说明'],
+  ],
+  en: [
+    ['Goal:', '[Goal]'],
+    ['Features:', '[Core Features]'],
+    ['Platform:', '[Platform & Stack]'],
+    ['[Fast Delivery]', '[Delivery]', '[Desktop Delivery Contract]'],
+    ['Done criteria', 'Acceptance checklist', 'Self-check'],
+    ['[Constraints]', '[Implementation / Safety]'],
+    ['Final report', 'user guide', 'guide'],
+  ],
+};
+
 const entry = `
 import { caseBundles, getCasePrompt } from './src/data/cases/index.ts';
 import { recipes, getRecipePrompt } from './src/data/recipes.ts';
@@ -38,17 +82,11 @@ export function collectPrompts() {
 }
 `;
 
-function estimateTokens(text) {
-  const cjk = text.match(/[\u3400-\u9FFF]/gu)?.length ?? 0;
-  const compactOther = text.replace(/[\s\u3400-\u9FFF]/gu, '');
-  return Math.ceil(cjk * 1.05 + compactOther.length / 4);
-}
-
-function percentile(values, p) {
-  if (!values.length) return 0;
-  const sorted = [...values].sort((a, b) => a - b);
-  const index = Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1);
-  return sorted[index];
+function signalCount(text, lang, signals) {
+  const normalized = text.toLowerCase();
+  return signals[lang].filter((alternatives) =>
+    alternatives.some((phrase) => normalized.includes(phrase.toLowerCase()))
+  ).length;
 }
 
 function summarize(rows) {
@@ -61,16 +99,18 @@ function summarize(rows) {
   }
 
   return [...groups.entries()].map(([bucket, list]) => {
-    const chars = list.map((item) => item.chars);
-    const tokens = list.map((item) => item.tokens);
+    const contentSignals = list.map((item) => item.contentSignals);
+    const structureSignals = list.map((item) => item.structureSignals);
+    const qualityScore = list.map((item) => item.qualityScore);
     return {
       bucket,
       count: list.length,
-      avgChars: Math.round(chars.reduce((sum, value) => sum + value, 0) / list.length),
-      p95Chars: percentile(chars, 95),
-      maxChars: Math.max(...chars),
-      avgTokens: Math.round(tokens.reduce((sum, value) => sum + value, 0) / list.length),
-      maxTokens: Math.max(...tokens),
+      avgContentSignals: Number((contentSignals.reduce((sum, value) => sum + value, 0) / list.length).toFixed(1)),
+      minContentSignals: Math.min(...contentSignals),
+      avgStructureSignals: Number((structureSignals.reduce((sum, value) => sum + value, 0) / list.length).toFixed(1)),
+      minStructureSignals: Math.min(...structureSignals),
+      avgQualityScore: Number((qualityScore.reduce((sum, value) => sum + value, 0) / list.length).toFixed(1)),
+      minQualityScore: Math.min(...qualityScore),
     };
   });
 }
@@ -101,32 +141,37 @@ const { collectPrompts } = await import(moduleUrl);
 const rows = collectPrompts()
   .map((item) => ({
     ...item,
-    chars: [...item.text].length,
-    bytes: Buffer.byteLength(item.text, 'utf8'),
-    tokens: estimateTokens(item.text),
+    contentSignals: signalCount(item.text, item.lang, CONTENT_SIGNALS),
+    structureSignals: signalCount(item.text, item.lang, STRUCTURE_SIGNALS),
+  }))
+  .map((item) => ({
+    ...item,
+    qualityScore: item.contentSignals + item.structureSignals,
   }))
-  .sort((a, b) => b.tokens - a.tokens);
+  .sort((a, b) => a.qualityScore - b.qualityScore || a.contentSignals - b.contentSignals);
 
 const result = {
   generatedAt: new Date().toISOString(),
   total: rows.length,
   summary: summarize(rows),
-  longest: rows.slice(0, Number.isFinite(limit) ? limit : 10),
+  reviewQueue: rows.slice(0, Number.isFinite(limit) ? limit : 10),
 };
 
 if (json) {
   console.log(JSON.stringify(result, null, 2));
 } else {
-  console.log(`Prompt stats (${result.total} final copy prompts)`);
+  console.log(`Prompt quality report (${result.total} final copy prompts)`);
+  console.log('Focus: content, structure, safety, verification, and beginner usability coverage.');
   console.table(result.summary);
-  console.log(`\nTop ${limit} longest prompts:`);
+  console.log(`\nReview queue (${limit} lowest quality-coverage prompts):`);
   console.table(
-    result.longest.map(({ group, id, lang, chars, tokens }) => ({
+    result.reviewQueue.map(({ group, id, lang, contentSignals, structureSignals, qualityScore }) => ({
       group,
       id,
       lang,
-      chars,
-      approxTokens: tokens,
+      contentSignals,
+      structureSignals,
+      qualityScore,
     }))
   );
   console.log('\nTip: run npm run prompt:stats -- --json for machine-readable output.');

src/app/[locale]/cases/[slug]/page.tsx

@@ -18,19 +18,9 @@ import {
   PuzzleIcon,
   RocketIcon,
   SparkleIcon,
-  FinanceIcon,
-  OpsIcon,
-  SupportIcon,
-  HRIcon,
-  LogisticsIcon,
-  ProcurementIcon,
-  MarketingIcon,
-  LegalIcon,
-  DataIcon,
-  AdminIcon,
-  ProductIcon,
   WindowsIcon,
 } from '@/components/icons';
+import { deptIcons } from '@/components/cases/deptIcons';
 
 type Props = { params: Promise<{ locale: string; slug: string }> };
 
@@ -69,20 +59,6 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
   };
 }
 
-const deptIcons = {
-  finance: <FinanceIcon size={28} />,
-  operations: <OpsIcon size={28} />,
-  'customer-service': <SupportIcon size={28} />,
-  hr: <HRIcon size={28} />,
-  logistics: <LogisticsIcon size={28} />,
-  procurement: <ProcurementIcon size={28} />,
-  marketing: <MarketingIcon size={28} />,
-  legal: <LegalIcon size={28} />,
-  data: <DataIcon size={28} />,
-  admin: <AdminIcon size={28} />,
-  product: <ProductIcon size={28} />,
-} as const;
-
 export default async function CasePage({ params }: Props) {
   const { locale: rawLocale, slug } = await params;
   if (!isLocale(rawLocale)) notFound();

src/app/[locale]/error.tsx

@@ -0,0 +1,51 @@
+'use client';
+
+import { useEffect } from 'react';
+import Link from 'next/link';
+
+type Props = {
+  error: Error & { digest?: string };
+  reset: () => void;
+};
+
+export default function LocaleError({ error, reset }: Props) {
+  useEffect(() => {
+    console.error(error);
+  }, [error]);
+
+  return (
+    <div className="mx-auto flex max-w-md flex-col items-center gap-4 px-4 py-24 text-center">
+      <div className="text-6xl font-bold aurora-text">!</div>
+      <h1 className="text-xl font-semibold text-ink">
+        出了点问题 / Something went wrong
+      </h1>
+      <p className="text-sm text-ink-soft">
+        页面加载时遇到了错误。可以试试刷新，或者回到首页。
+      </p>
+      <p className="text-sm text-ink-soft">
+        An error occurred while loading this page. Try refreshing or head home.
+      </p>
+      <div className="mt-4 flex gap-3">
+        <button
+          type="button"
+          onClick={reset}
+          className="rounded-full border border-[color:var(--line)] bg-white/70 px-4 py-2 text-sm font-medium text-ink shadow-glass backdrop-blur-xl transition hover:bg-white"
+        >
+          重试 / Retry
+        </button>
+        <Link
+          href="/zh"
+          className="rounded-full border border-[color:var(--line)] bg-white/70 px-4 py-2 text-sm font-medium text-ink shadow-glass backdrop-blur-xl transition hover:bg-white"
+        >
+          中文首页
+        </Link>
+        <Link
+          href="/en"
+          className="rounded-full border border-[color:var(--line)] bg-white/70 px-4 py-2 text-sm font-medium text-ink shadow-glass backdrop-blur-xl transition hover:bg-white"
+        >
+          English home
+        </Link>
+      </div>
+    </div>
+  );
+}

src/app/globals.css

@@ -144,6 +144,21 @@ html {
   .focus-ring {
     @apply focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--accent)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--surface)];
   }
+  .aurora-text {
+    background: linear-gradient(135deg, #FF9EC4 0%, #B8A4FF 45%, #9CCEFF 100%);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    background-clip: text;
+  }
+  .shadow-glass {
+    box-shadow: 0 1px 2px rgba(15, 17, 22, 0.04), 0 8px 24px rgba(15, 17, 22, 0.06);
+  }
+  .shadow-glass-sm {
+    box-shadow: 0 1px 2px rgba(15, 17, 22, 0.03), 0 4px 12px rgba(15, 17, 22, 0.05);
+  }
+  .text-aurora-violet {
+    color: #B8A4FF;
+  }
   .prose-body p {
     @apply text-[15px] leading-[1.85] text-[color:var(--fg-secondary)];
   }

src/components/LanguageSwitcher.tsx

@@ -2,7 +2,7 @@
 
 import { usePathname, useRouter } from 'next/navigation';
 import { useCallback, useMemo, useTransition } from 'react';
-import { localeCookieName, locales, type Locale, localeNames } from '@/i18n/config';
+import { localeCookieName, type Locale, localeNames } from '@/i18n/config';
 import { cn } from '@/lib/cn';
 
 type Props = {
@@ -79,45 +79,3 @@ export function LanguageSwitcher({ currentLocale, compact = false, className }:
     </button>
   );
 }
-
-export function LocaleList({
-  currentLocale,
-  className,
-}: {
-  currentLocale: Locale;
-  className?: string;
-}) {
-  const router = useRouter();
-  const pathname = usePathname() ?? '/';
-
-  const targetPath = (locale: Locale) => {
-    const segments = pathname.split('/').filter(Boolean);
-    if (segments.length === 0) return `/${locale}`;
-    segments[0] = locale;
-    return '/' + segments.join('/');
-  };
-
-  return (
-    <div className={cn('flex flex-wrap gap-2', className)}>
-      {locales.map((locale) => (
-        <button
-          key={locale}
-          type="button"
-          onClick={() => {
-            persistLocalePreference(locale);
-            router.push(targetPath(locale));
-          }}
-          aria-current={locale === currentLocale ? 'true' : undefined}
-          className={cn(
-            'focus-ring rounded-full border px-3.5 py-1.5 text-xs font-medium transition',
-            locale === currentLocale
-              ? 'border-ink/20 bg-white text-ink'
-              : 'border-[color:var(--line)] bg-white/50 text-ink-soft hover:bg-white/80'
-          )}
-        >
-          {localeNames[locale]}
-        </button>
-      ))}
-    </div>
-  );
-}