create-yss-spec 3.3.8 → 3.4.1

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/DESIGN.md

@@ -0,0 +1,264 @@
+---
+version: alpha
+name: YSS Data Quality Design System
+description: A machine-readable Data Quality default visual contract for YSS enterprise applications, aligned with YSS enterprise visual semantics and framework-independent HTML prototypes. It complements the product lifecycle and does not define product behavior, API contracts, permissions, or business states.
+
+colors:
+  primary: "#3371ff"
+  primary-control: "#245bdb"
+  primary-control-hover: "#2f68eb"
+  primary-active: "#0958d9"
+  primary-bg: "#e6f4ff"
+  on-primary: "#ffffff"
+  text: "rgba(0, 0, 0, 0.88)"
+  text-secondary: "rgba(0, 0, 0, 0.65)"
+  text-tertiary: "rgba(0, 0, 0, 0.45)"
+  canvas-layout: "#f0f2f5"
+  surface: "#ffffff"
+  surface-elevated: "#ffffff"
+  surface-subtle: "#fafafa"
+  border: "#d9d9d9"
+  border-secondary: "#f0f0f0"
+  success: "#52c41a"
+  success-bg: "#f6ffed"
+  warning: "#faad14"
+  warning-bg: "#fffbe6"
+  error: "#f5222d"
+  error-bg: "#fff2f0"
+  info-bg: "#e6f4ff"
+
+typography:
+  body:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 14px
+    fontWeight: 400
+    lineHeight: 1.571
+  body-strong:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 14px
+    fontWeight: 600
+    lineHeight: 1.571
+  heading-lg:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 24px
+    fontWeight: 600
+    lineHeight: 1.333
+  heading-md:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 18px
+    fontWeight: 600
+    lineHeight: 1.333
+  caption:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 12px
+    fontWeight: 400
+    lineHeight: 1.571
+  button:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 14px
+    fontWeight: 600
+    lineHeight: 1.571
+
+rounded:
+  none: 0px
+  sm: 4px
+  md: 6px
+  lg: 8px
+  pill: 9999px
+
+spacing:
+  xxs: 4px
+  xs: 8px
+  sm: 12px
+  md: 16px
+  card: 20px
+  lg: 24px
+  xl: 32px
+  xxl: 48px
+
+components:
+  separator:
+    backgroundColor: "{colors.border}"
+    height: 1px
+  button-primary:
+    backgroundColor: "{colors.primary-control}"
+    textColor: "{colors.on-primary}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  button-primary-hover:
+    backgroundColor: "{colors.primary-control-hover}"
+    textColor: "{colors.on-primary}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  button-primary-disabled:
+    backgroundColor: "{colors.border-secondary}"
+    textColor: "{colors.text-tertiary}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  button-default:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  input-default:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.xs}"
+    height: 32px
+  input-error:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.xs}"
+    height: 32px
+  table-header:
+    backgroundColor: "{colors.surface-subtle}"
+    textColor: "{colors.text}"
+    typography: "{typography.body-strong}"
+    padding: "{spacing.xs} {spacing.sm}"
+  table-row-selected:
+    backgroundColor: "{colors.primary-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    padding: "{spacing.xs} {spacing.sm}"
+  modal-default:
+    backgroundColor: "{colors.surface-elevated}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.lg}"
+    padding: "{spacing.md}"
+  button-primary-active:
+    backgroundColor: "{colors.primary-active}"
+    textColor: "{colors.on-primary}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  page-shell:
+    backgroundColor: "{colors.canvas-layout}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    padding: "{spacing.md}"
+  alert-success:
+    backgroundColor: "{colors.success-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  alert-warning:
+    backgroundColor: "{colors.warning-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  alert-error:
+    backgroundColor: "{colors.error-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  alert-info:
+    backgroundColor: "{colors.info-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  badge-processing-solid:
+    backgroundColor: "{colors.primary}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  badge-success-solid:
+    backgroundColor: "{colors.success}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  badge-warning-solid:
+    backgroundColor: "{colors.warning}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  badge-error-solid:
+    backgroundColor: "{colors.error}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  secondary-copy:
+    textColor: "{colors.text-secondary}"
+    typography: "{typography.caption}"
+  card-default:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.lg}"
+    padding: "{spacing.card}"
+  button-compact:
+    height: 28px
+  button-small:
+    height: 24px
+  button-large:
+    height: 40px
+  card-compact:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.lg}"
+    padding: "{spacing.md}"
+
+---
+
+## Overview
+
+YSS is an enterprise UI system for dense, scannable work surfaces: tables, forms, filters, workflows and operational feedback. This file is the normative source for visual tokens and component visual variants. Product behavior remains in Spec, interaction specifications and state matrices.
+
+The default theme adopts Data Quality global tokens on the Ant Design v6 design foundation: light mode, primary #3371ff, body 14px, controls 32/24/40px, radii 6/4/8px and card padding 20px. Compact and dark modes are opt-in. Data Quality runs Vue 3 + Ant Design Vue 4.2.6 + YSS UI; that runtime version is distinct from the design foundation. Client-specific JSP themes and page-local glass effects are not defaults. Prototypes use HTML/CSS/JavaScript with local token CSS. Production applications use the target implementation contract and lockfile; prototype visuals do not establish production component API compatibility.
+
+## Colors
+
+Use semantic roles (`primary`, `text`, `surface`, `border`, `success`, `warning`, `error`) instead of literal values in product pages. Keep a single primary action per decision area. The brand seed remains Data Quality #3371ff; primary-control #245bdb and its hover variant are deliberate YSS accessibility adaptations for white small text, not values copied from Data Quality. State colors must be paired with readable text or an icon and must meet WCAG 2.2 AA.
+
+## Typography
+
+Use the system font stack, 14px body text and 400/600 weights. Use `caption` only for supporting information; do not encode business status through weight alone.
+
+## Layout
+
+Use a 4px spacing grid and the spacing tokens above. Use the default 32px control variant directly in HTML prototypes. The explicit compact variant uses 28px; small and large controls use 24px and 40px. When production uses an Ant Design theme algorithm, keep its seed `controlHeight` at 32px and apply compact once; never seed 28px and compact again. Page, container and overlay surfaces form the base three-layer model. On narrow screens, toolbars and filters reflow or collapse; table overflow is restricted to the table container.
+
+## Elevation & Depth
+
+Prefer surface and border changes over decorative shadows. Use the component library elevation tokens when available. Shadow values remain an implementation detail until the upstream DESIGN.md schema provides a stable structured elevation contract.
+
+## Shapes
+
+Controls use `rounded.md` (6px); cards and overlays use `rounded.lg` (8px); compact tags may use `rounded.sm` or `rounded.pill`. A container radius must not be smaller than the radius of its child controls.
+
+## Components
+
+The component keys above describe default visual variants and explicitly named optional sizes, not business states. Default controls use a 32px computed height, 14px body type, pale semantic feedback surfaces and visible focus rings. Required implementation states include hover, focus, active, disabled, loading, error, empty, readonly, no-permission, conflict and success. Define those behavior and acceptance details in the lifecycle state-matrix and prototype evidence assets.
+
+## Do's and Don'ts
+
+- Do consume tokens through ConfigProvider, CSS variables or the target component library theme.
+- Do use the verified derived dark/compact token snapshot for HTML; production theme algorithms remain implementation-specific.
+- Do verify desktop (`1440x900`), mobile (`390x844`) and impacted intermediate viewports.
+- Do provide visible feedback for save, submit, publish, export and retry actions.
+- Don’t use marketing hero layouts, large gradients or decorative cards in operational pages.
+- Don’t hard-code colors, arbitrary spacing or duplicate controls that already exist in YSS UI.
+- Don’t target component-library internal DOM or generated class names; v6 internal markup is not a stable contract.
+- Don’t use a Tag as the only representation of an error, permission or approval state.

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/README.md

@@ -0,0 +1,13 @@
+# __APP_NAME__
+
+Data Quality v1 通用骨架：Vue 3 / Ant Design Vue 4 / YSS UI，默认浅色、14px 正文、32px 控件。`packages/` 是应用根。YSS 按需注册，新增页面再按实现合同引入表格或表单组件。骨架不含业务页面、用户权限、生产 API 地址或部署凭证。
+
+使用 Node >=22.12、pnpm 10.15、TypeScript5.9.3；在用户级 npm 配置中设置企业 @yss-ui registry 和认证，然后运行 `pnpm install --frozen-lockfile`。检查使用 `pnpm lint:check`、`pnpm type-check`、`pnpm build` 和 `pnpm build:standalone`。
+
+`pnpm dev` 独立预览；Qiankun 注册名为 `__MICROAPP_NAME__`、默认激活路由 `__BASE_ROUTE__`，门户传入 `container` / `routerBase` / `bridgeVersion: 1` / `themeConfig.mode`。资源部署路径由 `VITE_PUBLIC_BASE` 明确设置，不能从路由猜测。复制 `packages/.env.example` 到 `.env.local` 配置本地代理。
+
+主题文件 `packages/src/config/theme.json` 派生自随工程提供的 `DESIGN.md`，不得与设计源并列维护；更新设计后经 Harness 主题投影再同步。暗色/compact 可由宿主串行化 DTO 设置。弹层挂到当前容器，主题 CSS 只写该容器；卸载时移除容器和监听。宿主仍须约定 CSS 隔离，组件 reset / YSS 样式不是跨应用完全隔离的证明。
+
+有已冻结 API 时，受控生成器物化 `openapi/openapi.json`，再在本工程手动执行 `pnpm generate:api`。不自动联网拉取接口、不改写 schema、不覆盖业务 API 包装、不把生成加入 CI。`apiClient` 是认证/错误处理的接入 seam，需依实现合同配置。
+
+仅支持全新空工程，JSP 模式和既有工程升级尚不支持。空白首页只验证启动，不代表业务交付。

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+packages/dist/
+.env.local
+.env.*.local
+.npmrc
+.yss/

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/micro-config.json

@@ -0,0 +1,5 @@
+{
+  "name": "__MICROAPP_NAME__",
+  "activeRule": "__BASE_ROUTE__",
+  "bridgeVersion": 1
+}

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/orval.config.ts

@@ -0,0 +1,2 @@
+import { defineConfig } from 'orval';
+export default defineConfig({ api: { input: './openapi/openapi.json', output: { target: './packages/src/api/generated/client.ts', schemas: './packages/src/api/generated/model', client: 'axios', mode: 'single', override: { mutator: { path: './packages/src/api/mutator.ts', name: 'customInstance' } } } } });

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.15.0",
+  "engines": {
+    "node": ">=22.12.0",
+    "pnpm": ">=10.15.0 <11"
+  },
+  "scripts": {
+    "dev": "pnpm -C packages dev",
+    "build": "pnpm -C packages build",
+    "build:standalone": "pnpm -C packages build:standalone",
+    "preview": "pnpm -C packages preview",
+    "lint": "pnpm lint:check",
+    "lint:check": "eslint packages/src packages/vite.config.ts orval.config.ts --ext .ts,.vue --max-warnings 0",
+    "lint:fix": "pnpm lint:check --fix",
+    "type-check": "pnpm -C packages type-check",
+    "generate:api": "orval --config orval.config.ts"
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "8.70.0",
+    "@typescript-eslint/eslint-plugin": "8.70.0",
+    "eslint": "8.57.1",
+    "eslint-plugin-vue": "9.33.0",
+    "@types/node": "20.19.43",
+    "orval": "6.31.0",
+    "typescript": "5.9.3"
+  }
+}

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.development

@@ -0,0 +1 @@
+VITE_STANDALONE_LAYOUT=true

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.example

@@ -0,0 +1,5 @@
+VITE_PUBLIC_BASE=/
+VITE_API_BASE_URL=/api
+VITE_PROXY_TARGET=http://localhost:8084
+VITE_PORT=8081
+VITE_DEV_ORIGIN=http://localhost:8081

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.production

@@ -0,0 +1 @@
+VITE_STANDALONE_LAYOUT=false

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.production.standalone

@@ -0,0 +1 @@
+VITE_STANDALONE_LAYOUT=true

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/index.html

@@ -0,0 +1,2 @@
+<!doctype html>
+<html lang="zh-CN"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><link rel="icon" type="image/svg+xml" href="/favicon.svg"><title>__APP_NAME__</title></head><body><div id="app"></div><script type="module" src="/src/main.ts"></script></body></html>

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "__MICROAPP_NAME__",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "build:standalone": "vite build --mode production.standalone",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "vue": "3.5.20",
+    "vue-router": "4.6.4",
+    "pinia": "2.3.1",
+    "ant-design-vue": "4.2.6",
+    "@ant-design/icons-vue": "7.0.1",
+    "@yss-ui/components": "1.6.0",
+    "@yss-ui/hooks": "1.1.3",
+    "@yss-ui/utils": "1.0.6",
+    "@formily/core": "2.3.7",
+    "@formily/vue": "2.3.7",
+    "axios": "1.20.0",
+    "dayjs": "1.11.23"
+  },
+  "devDependencies": {
+    "vite": "6.0.5",
+    "@vitejs/plugin-vue": "6.0.8",
+    "vite-plugin-qiankun": "1.0.15",
+    "less": "4.9.1",
+    "vue-tsc": "3.3.11",
+    "@vue/tsconfig": "0.9.1"
+  }
+}

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#3371ff"/><path d="M8 10h16M8 16h12M8 22h8" stroke="white" stroke-width="3"/></svg>

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/App.vue

@@ -0,0 +1,15 @@
+<script setup lang="ts">
+import ThemeScope from '@/components/ThemeScope.vue';
+import zhCN from 'ant-design-vue/es/locale/zh_CN';
+import { useThemeStore } from '@/store/theme';
+const store = useThemeStore();
+defineProps<{ standalone: boolean; popupContainer: HTMLElement }>();
+</script>
+<template>
+  <a-config-provider :locale="zhCN" :theme="store.config" :get-popup-container="() => popupContainer">
+    <ThemeScope :container="popupContainer"><div class="yss-app-shell">
+      <header v-if="standalone" class="app-header"><strong>__APP_NAME__</strong><span class="theme-controls"><a-switch :checked="store.dark" checked-children="暗色" un-checked-children="浅色" @change="store.setDark(Boolean($event))" /><a-switch :checked="store.compact" checked-children="紧凑" un-checked-children="默认" @change="store.setCompact(Boolean($event))" /></span></header>
+      <main class="app-content"><router-view /></main>
+    </div></ThemeScope>
+  </a-config-provider>
+</template>

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/api/mutator.ts

@@ -0,0 +1,7 @@
+import axios, { type AxiosRequestConfig } from 'axios';
+/** 宿主认证可注入拦截器；骨架不假定 token 存储键或登录跳转。 */
+export const apiClient = axios.create({ baseURL: import.meta.env.VITE_API_BASE_URL || '', timeout: 10000 });
+export async function customInstance<T>(config: AxiosRequestConfig, options?: AxiosRequestConfig): Promise<T> {
+  const response = await apiClient.request<T>({ ...config, ...options });
+  return response.data;
+}

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/components/ThemeScope.vue

@@ -0,0 +1,11 @@
+<script setup lang="ts">
+import { watchEffect } from 'vue';
+import { theme } from 'ant-design-vue';
+import { useThemeStore } from '@/store/theme';
+const props = defineProps<{ container: HTMLElement }>();
+const { token } = theme.useToken();
+const store = useThemeStore();
+// Runs inside ConfigProvider; Vue stops the watcher when this scope unmounts.
+watchEffect(() => store.syncContainer(props.container, token.value));
+</script>
+<template><slot /></template>

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/config/theme.json

@@ -0,0 +1,41 @@
+{
+  "token": {
+    "colorPrimary": "#3371ff",
+    "colorSuccess": "#52c41a",
+    "colorWarning": "#faad14",
+    "colorError": "#f5222d",
+    "colorInfo": "#3371ff",
+    "colorTextBase": "#000000",
+    "colorBgBase": "#ffffff",
+    "colorBgLayout": "#f0f2f5",
+    "colorText": "rgba(0, 0, 0, 0.88)",
+    "colorTextSecondary": "rgba(0, 0, 0, 0.65)",
+    "colorBorder": "#d9d9d9",
+    "fontFamily": "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif",
+    "fontSize": 14,
+    "borderRadius": 6,
+    "sizeUnit": 4,
+    "sizeStep": 4,
+    "controlHeight": 32,
+    "controlHeightSM": 24,
+    "controlHeightLG": 40,
+    "fontSizeSM": 12,
+    "borderRadiusSM": 4,
+    "borderRadiusLG": 8,
+    "padding": 16,
+    "paddingSM": 12,
+    "paddingXS": 8,
+    "paddingLG": 20
+  },
+  "algorithm": "default",
+  "components": {
+    "Card": {
+      "borderRadiusLG": 8,
+      "paddingLG": 20
+    }
+  },
+  "accessibility": {
+    "primaryControl": "#245bdb",
+    "primaryControlHover": "#2f68eb"
+  }
+}

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/main.ts

@@ -0,0 +1,40 @@
+import { createApp, type App as VueApp } from 'vue';
+import { createPinia } from 'pinia';
+import Antd from 'ant-design-vue';
+import { YButton } from '@yss-ui/components';
+import { renderWithQiankun, qiankunWindow } from 'vite-plugin-qiankun/dist/helper';
+import 'ant-design-vue/dist/reset.css';
+import '@yss-ui/components/dist/style.css';
+import './styles/index.less';
+import App from './App.vue';
+import { createAppRouter } from './router';
+import { useThemeStore } from './store/theme';
+import { setupMicroAppRouterBridge } from './utils/microAppRouterBridge';
+import { MICRO_APP_BRIDGE_VERSION, type MicroAppLifecycleProps } from './types/microAppBridge';
+let app: VueApp | undefined;
+let dispose: (() => void) | undefined;
+let applyTheme: ReturnType<typeof useThemeStore>['applyFromMain'] | undefined;
+function assertBridge(props: MicroAppLifecycleProps) {
+  if (props.bridgeVersion !== undefined && props.bridgeVersion !== MICRO_APP_BRIDGE_VERSION) throw new Error('Unsupported micro app bridge version');
+}
+async function mount(props: MicroAppLifecycleProps = {}) {
+  assertBridge(props);
+  if (app) throw new Error('Micro app is already mounted');
+  const host = props.container?.querySelector('#app') || (!props.container ? document.querySelector('#app') : null);
+  if (!host) throw new Error('Micro app mount container #app is missing');
+  const root = document.createElement('div'); root.className = 'yss-microapp-root'; host.appendChild(root);
+  const isMicro = Boolean(qiankunWindow.__POWERED_BY_QIANKUN__);
+  const router = createAppRouter(isMicro ? props.routerBase || '__BASE_ROUTE__' : '/');
+  const pinia = createPinia();
+  app = createApp(App, { standalone: !isMicro && import.meta.env.VITE_STANDALONE_LAYOUT !== 'false', popupContainer: root });
+  app.use(pinia).use(router).use(Antd);
+  app.component("YButton", YButton);
+  const store = useThemeStore(pinia); store.applyFromMain(props.themeConfig); applyTheme = store.applyFromMain;
+  const stopBridge = isMicro ? setupMicroAppRouterBridge({ router, appName: '__MICROAPP_NAME__', activeRule: props.routerBase || '__BASE_ROUTE__' }) : () => {};
+  dispose = () => { stopBridge(); router.options.history.destroy(); root.remove(); };
+  try { await router.isReady(); app.mount(root); } catch (error) { unmount(); throw error; }
+}
+function unmount() { app?.unmount(); dispose?.(); app = undefined; dispose = undefined; applyTheme = undefined; }
+function update(props: MicroAppLifecycleProps) { assertBridge(props); applyTheme?.(props.themeConfig); }
+renderWithQiankun({ bootstrap: async () => {}, mount, unmount, update });
+if (!qiankunWindow.__POWERED_BY_QIANKUN__) void mount();

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/router/index.ts

@@ -0,0 +1,8 @@
+import { createRouter, createWebHistory } from 'vue-router';
+import Welcome from '@/views/Welcome.vue';
+export function createAppRouter(base: string) {
+  return createRouter({ history: createWebHistory(base), routes: [
+    { path: '/', name: 'welcome', component: Welcome },
+    { path: '/:pathMatch(.*)*', name: 'not-found', component: () => import('@/views/NotFound.vue') },
+  ] });
+}

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/store/theme.ts

@@ -0,0 +1,37 @@
+import { computed, ref } from 'vue';
+import { defineStore } from 'pinia';
+import { theme } from 'ant-design-vue';
+import type { ThemeConfig } from 'ant-design-vue/es/config-provider/context';
+import { applyYssTheme } from '@yss-ui/utils';
+import baseline from '@/config/theme.json';
+import type { MicroAppThemeConfigDto } from '@/types/microAppBridge';
+export const useThemeStore = defineStore('theme', () => {
+  const primary = ref(baseline.token.colorPrimary), dark = ref(false), compact = ref(false);
+  const config = computed<ThemeConfig>(() => {
+    const token: ThemeConfig['token'] = { ...baseline.token, colorPrimary: primary.value, colorInfo: primary.value };
+    if (dark.value) for (const key of ['colorTextBase', 'colorBgBase', 'colorText', 'colorTextSecondary', 'colorBorder', 'colorBgLayout'] as const) delete token[key];
+    return { token, algorithm: [dark.value ? theme.darkAlgorithm : theme.defaultAlgorithm, ...(compact.value ? [theme.compactAlgorithm] : [])], components: { ...baseline.components, Card: { ...baseline.components.Card, paddingLG: compact.value ? 16 : baseline.token.paddingLG }, Button: { colorPrimary: baseline.accessibility.primaryControl, colorPrimaryHover: baseline.accessibility.primaryControlHover } } };
+  });
+  function applyFromMain(dto?: MicroAppThemeConfigDto) {
+    const incoming = dto?.token?.colorPrimary;
+    if (typeof incoming === 'string' && /^#[0-9a-f]{6}$/i.test(incoming)) primary.value = incoming;
+    if (dto?.mode) { dark.value = dto.mode.dark; compact.value = dto.mode.compact; }
+  }
+  function syncContainer(container: HTMLElement, values: ReturnType<typeof theme.useToken>['token']['value']) {
+    // Only this micro application's own container is mutated; unmount removes it.
+
+      for (const [key, value] of Object.entries(values)) {
+        if (typeof value !== 'string' && typeof value !== 'number') continue;
+        const name = key.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+        const unit = typeof value === 'number' && /^(font-size|border-radius|control-height|padding|margin|size)(-|$)/.test(name) ? 'px' : '';
+        for (const prefix of ['brand', 'ant']) container.style.setProperty(`--${prefix}-${name}`, `${value}${unit}`);
+      }
+      const palette = applyYssTheme({ primary: primary.value, target: container, mirrorToLegacy: true });
+      container.style.setProperty('--vxe-ui-font-primary-lighten-color', palette.primary[5]);
+      container.style.setProperty('--vxe-ui-font-primary-darken-color', palette.primary[7]);
+      container.style.setProperty('--vxe-ui-font-primary-color', primary.value);
+      container.style.setProperty('--yss-card-padding', `${compact.value ? 16 : baseline.token.paddingLG}px`);
+      container.dataset.theme = dark.value ? 'dark' : 'light';
+  }
+  return { primary, dark, compact, config, applyFromMain, syncContainer, setDark: (value: boolean) => { dark.value = value; }, setCompact: (value: boolean) => { compact.value = value; } };
+});

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/styles/index.less

@@ -0,0 +1,6 @@
+.yss-microapp-root { min-height: 100vh; color: var(--brand-color-text); background: var(--brand-color-bg-layout); font: var(--brand-font-size) / 1.571 var(--brand-font-family); }
+.yss-microapp-root, .yss-microapp-root * { box-sizing: border-box; }
+.yss-microapp-root .app-header { padding: 16px 20px; background: var(--brand-color-bg-container); display: flex; align-items: center; justify-content: space-between; gap: 16px; }
+.yss-microapp-root .theme-controls { display: flex; gap: 12px; }
+.yss-microapp-root .app-content { padding: var(--yss-card-padding); }
+@media (max-width: 576px) { .yss-microapp-root .app-header { flex-wrap: wrap; } .yss-microapp-root .app-content { padding: 12px; } }

package/template/.agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/types/microAppBridge.ts

@@ -0,0 +1,28 @@
+/** 当前模板支持的门户桥接协议版本。 */
+export const MICRO_APP_BRIDGE_VERSION = 1 as const;
+
+/** 主题模式的可序列化描述。 */
+export interface MicroAppThemeModeDto {
+  readonly dark: boolean;
+  readonly compact: boolean;
+}
+
+/** 门户传入的只读主题 DTO；旧门户可以不提供 mode。 */
+export interface MicroAppThemeConfigDto {
+  readonly token?: Readonly<Record<string, unknown>>;
+  readonly components?: Readonly<Record<string, unknown>>;
+  readonly algorithm?: readonly unknown[];
+  readonly mode?: MicroAppThemeModeDto;
+}
+
+/** 微应用可识别的版本化桥接 Props；字段保持可选以兼容旧门户。 */
+export interface MicroAppBridgeProps {
+  readonly bridgeVersion?: typeof MICRO_APP_BRIDGE_VERSION;
+  readonly routerBase?: string;
+  readonly themeConfig?: MicroAppThemeConfigDto;
+}
+
+/** qiankun 生命周期额外提供的容器字段。 */
+export interface MicroAppLifecycleProps extends MicroAppBridgeProps {
+  readonly container?: Element | ShadowRoot;
+}