create-yss-spec 3.3.8 → 3.4.3

package/template/.agents/skills/yss-frontend-scaffold-generator/SKILL.md

@@ -9,19 +9,20 @@ description: Use when creating a new YSS frontend micro-application from the sta
 
 ## Template Source
 
-```text
-repo: http://192.168.167.142:8081/Data-Middleground-Develop-Area/product-code/ai-frontend/yss-design/yss-frontend-template.git
-branch: template
-```
+默认使用随 Skill 分发的 `assets/data-quality-v1/`，从 Data Quality 抽取工作区、主题与微应用模式，重建为通用空骨架。来源、差异、支持范围见 `references/data-quality-baseline.md`；`references/data-quality-v1.manifest.json` 是文件白名单与 SHA-256 依据。
+
+技术栈：Vue 3、TypeScript、Vite、Pinia、Vue Router、Qiankun、pnpm、Ant Design Vue 4、YSS UI、Orval。Ant Design v6 是视觉设计参考，不是此 Vue 工程的运行时包。默认主题继承根 `DESIGN.md` 的 Data Quality 浅色、14px 正文、32px 控件、20px Card 内距；暗色 / compact 显式开启。
+
+合同 `frontend.template` 默认填 `{ "kind": "bundled", "baseline_id": "data-quality-v1", "manifest_digest": "sha256:<当前manifest字节摘要>" }`。用 `node .agents/skills/yss-frontend-scaffold-generator/scripts/refresh_baseline.mjs` 只读核验摘要；维护主题或骨架后先审阅改动，再用 `--write` 更新派生。
 
-模板基线：Vue 3、TypeScript、Vite、Qiankun、pnpm、Ant Design Vue、`@yss-ui/components`、`@yss-ui/hooks`、Orval。
+兼容已有 `{ repository, commit }` 合同：只有明确选择外部 Git 模板时传 `--template-checkout` 并核验 origin 与精确 40 位 commit；不再默认从私网浮动分支获取模板。
 
 ## Inputs
 
 - `app_name`：应用名。
 - `microapp_name`：微应用注册名。
 - `base_route`：基础路由。
-- Project Scaffold Contract schema v4：包含用户确认的仓库 scope、目标路径、`init_git`、模板 commit、应用参数、允许写路径和验证命令。
+- Project Scaffold Contract schema v4：包含用户确认的仓库 scope、目标路径、`init_git`、模板 manifest 摘要或 Git commit、应用参数、允许写路径和验证命令。
 - OpenAPI Freeze 记录：有 API 影响时提供已批准的冻结 YAML 版本和引用；无 API 影响时提供带原因的 `not-applicable`。
 - OpenAPI JSON 派生记录：`docs/.scratch/<feature>/api/<feature>-json-export.md`，包含 YAML / JSON SHA-256、Redocly CLI 版本和 lockfile 引用。
 - 冻结 JSON 产物：`docs/.scratch/<feature>/api/<feature>.json`；这是唯一允许交给既有前端代码生成流程的上游产物。
@@ -35,18 +36,20 @@ branch: template
 
 1. 确认当前任务已经通过 Harness 入口分诊、逐项目脚手架决定已由真实用户确认，且 schema v4 合同已由生命周期批准、持久化并保持当前。
 2. 确认目标是外部实现仓库；只有用户明确选择时才输出到 Harness 仓库的 `apps/frontend/<project>/`。`apps/frontend/` 只能作为项目容器，`app/frontend/`、`app/backend/` 及其子路径禁止作为输出位置。`git-submodule` 只能在已初始化且附加分支的子仓工作树生成；空 gitlink、detached HEAD、`--force` 覆盖挂载点不得当成普通目录。
-3. 只读检查模板分支和合同锁定的 40 位 commit 是否可访问；生成时使用精确 commit，不跟随浮动分支。
-4. 使用 `scripts/generate_and_verify_scaffold.mjs` 从已核验 checkout 的批准 commit 导出模板，排除模板 `.git` 及未提交的工作树内容；目标必须不存在或为空。不得默认写入 Harness、不得 `--force`。仅合同 `init_git=true` 时初始化目标 Git。
+3. 默认核验 bundled manifest 摘要、白名单和每个文件字节；Git 兼容方式核验合同的精确 commit。生成不读取 Data Quality 本机路径或未提交业务代码。
+4. 使用 `scripts/generate_and_verify_scaffold.mjs --contract-file <合同> --output-dir <目录> --evidence-dir <证据目录>` 生成白名单骨架；Git 来源额外提供 checkout，导出批准 commit 并排除 `.git` 及未提交工作树内容；目标必须不存在或为空。不得默认写入 Harness、不得 `--force`。仅合同 `init_git=true` 时初始化目标 Git。
 5. 替换应用名、微应用名、路由、`micro-config.json`、环境变量和 README 中的模板占位。
 6. 有 API 影响时核验 OpenAPI Freeze 记录和 JSON 派生记录，将摘要一致的 JSON 原样物化到 `<frontend>/openapi/openapi.json`；`openapi_impact=not-applicable` 时必须有原因并禁止生成 API client。
 7. 保持模板既有的前端代码生成配置不变；本 Harness 只将 SHA-256 一致的 JSON 原样交给既有前端代码生成流程，不修改该配置、不在此仓库执行生成，也不设置生成 CI 门禁。目标前端项目在需要时手动运行其既有命令。
-8. 实际执行并记录 `pnpm install --frozen-lockfile`、`pnpm lint`、`pnpm type-check`、`pnpm build` 的退出码和日志；缺失脚本只能由批准的工程基线提供替代命令。任何必需命令失败都阻断。
+8. 企业 registry / 认证由目标环境用户级 npm 配置提供，禁止复制来源 `.npmrc` 或 token。实际执行并记录 `pnpm install --frozen-lockfile`、`pnpm lint:check`、`pnpm type-check`、`pnpm build`、`pnpm build:standalone` 的退出码和日志；缺失脚本只能由批准的工程基线提供替代命令。任何必需命令失败都阻断。
 9. 按 `docs/templates/implementation-repo-registry-template.md` 回写前端实现仓库登记。
 
 ## Expected Template Shape
 
 ```text
-openapi/
+DESIGN.md
+packages/src/config/theme.json
+openapi/ # 仅有冻结 API 时物化
 packages/src/api/
 packages/src/router/
 packages/src/views/
@@ -64,15 +67,16 @@ packages/package.json
 - 不推送、不创建 MR / PR，除非用户明确要求。
 - 不绕过 OpenAPI Draft / Freeze；API client 只消费与 OpenAPI JSON 派生记录 SHA-256 一致的冻结 JSON。
 - 不接受任意 URL、未冻结 YAML、后端运行时输出或手工 JSON 作为既有前端代码生成流程的输入。
-- 不修改模板既有的代码生成配置，也不把客户端生成加入 CI。
+- 目标生成时不修改既有代码生成配置，也不把客户端生成加入 CI；本模板维护允许审阅和更新标准配置。
+- 不携带 Data Quality 业务页面、默认管理员、生产接口、私网 Postman 同步、部署凭证或残缺 JSP 命令；当前支持 Qiankun 与 standalone，JSP 不在可用基线内。
 - 不得把 `apps/frontend/` 容器根登记为项目根；Harness 内每个前端项目必须有独立的 `apps/frontend/<project>/` 路径。
 - 不把模板示例页面当作业务功能交付。
-- 生成后仍需使用 `yss-ui-business-page-generation`、`yss-components`、`yss-api-integration` 等专项 skill 实现业务页面。
+- 生成后仍需使用 `yss-ui-business-page-generation`、`component-selection-imports`、`yss-api-integration` 以及实际命中的表格、树、Formily 等专项 skill 实现业务页面。
 
 ## Output
 
 - 前端工程生成位置或目标仓库信息。
-- 模板来源和 commit / branch 证据。
+- 模板 baseline / manifest 摘要，或 Git repository / commit 证据。
 - 替换参数清单。
 - install / lint / type-check / build 命令，以及目标前端项目既有的手动客户端生成命令（如有）。
 - OpenAPI Freeze 记录、OpenAPI JSON 派生记录、JSON SHA-256 和 `openapi/openapi.json` 物化证据。

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

@@ -0,0 +1 @@
+module.exports = { root: true, env: { browser: true, node: true, es2022: true }, extends: ['eslint:recommended', 'plugin:vue/vue3-essential', 'plugin:@typescript-eslint/recommended'], parser: 'vue-eslint-parser', parserOptions: { parser: '@typescript-eslint/parser', ecmaVersion: 'latest', sourceType: 'module', extraFileExtensions: ['.vue'] }, ignorePatterns: ['packages/src/api/generated/**'], rules: { 'vue/multi-word-component-names': 'off' } };

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

@@ -0,0 +1,2 @@
+# 在用户级 npm 配置中配置企业 @yss-ui registry 和认证；禁止提交 token。
+registry=https://registry.npmjs.org/

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') },
+  ] });
+}