@cherishxn/agent-scaffold 0.0.0-stage → 1.0.0

package/templates/react-fastapi-antd/compose.yaml

@@ -0,0 +1,18 @@
+services:
+  db:
+    image: postgres:17.9-alpine@sha256:c7526c0f6c3f30260a563d7bcf8ad778effac59a44f8ffa86678c35418338609
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:?run dev:setup first}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?run dev:setup first}
+      POSTGRES_DB: ${POSTGRES_DB:?run dev:setup first}
+    ports:
+      - "127.0.0.1:${POSTGRES_PORT:-54329}:5432"
+    volumes:
+      - development-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
+      interval: 2s
+      timeout: 3s
+      retries: 30
+volumes:
+  development-data:

package/templates/react-fastapi-antd/design/guide.md

@@ -0,0 +1,61 @@
+## Overview
+
+**Scientific Workspace**：从 [CleerScience 官网](https://cleerscience.com/) 提炼的通用深色科技视觉。以近黑蓝底、冷白文字、冰蓝重点、直角薄边框和清晰排版传达秩序；各组件库使用同一份视觉、控件和结构规格。它服务于登录、列表与编辑任务，不把科学品牌、产品名或营销文案带入生成项目。
+
+来源于 2026-10-20 对官网桌面 1440px 和手机 375px 的实际页面及计算样式观察。官网原值包括背景 #02040a、正文 #f4f8ff、冰蓝 #8fc3ff、0px 面板圆角；本模板沿用这些核心值。正文与控件对比度、实体表面、较小标题和 44px 以上操作尺寸是工具型界面的适配决定，并非官网原样复刻。背景视频、品牌标识、全屏叙事和科学插图不属于本模板。
+
+**唯一编辑源**：`design/tokens.json`、`design/widgets.json`、`design/structure.json`、`design/guide.md` 及中立布局/控件样式。执行 `npm run design:sync` 生成本文件、design-tokens.css、design-layout.css、design-widgets.css、design-runtime.json，再执行 `npm run design:check`。不要直接修改派生产物；build/typecheck/lint 会拒绝漂移。YAML 是与组件库无关的有效 token；阴影等非标准字段在正文给出，避免伪装成官方 schema 字段。
+
+## Colors
+
+背景使用 `colors.background`，面板使用 `colors.surface`，输入区使用 `colors.control-background`。正文使用 `colors.text`，辅助说明使用 `colors.muted`，标题不降低透明度。不要把官网用于装饰的低透明度文字直接用于表单标签或必要说明。
+
+`primary` 仅用于主要操作、当前选中项和可见焦点；按钮文字使用 `primary-text`，确保亮色按钮上的深色字可读。`primary-hover` / `primary-active` 表达交互状态。普通表面保持中性冷色，避免整页泛蓝或大面积发光。错误和成功使用各自的 background/border/text 组合，同时保留明确文字或状态角色。
+
+必要文字对比度至少 4.5:1，焦点与操作控件边界至少 3:1；装饰分隔线可以更弱。对比度必须按实际背景检查，不能只比较两个透明 token。新项目若改变主色，需重新验证文字、hover、active 和焦点，不仅替换一个十六进制值。
+
+## Typography
+
+一套无衬线字体贯穿全站：Inter 可用时优先，否则落到系统字体与 PingFang SC / Microsoft YaHei；不主动下载字体。中文正文 {{typography.body.fontSize}}、行高 {{typography.body.lineHeight}}，标签 {{typography.label.fontSize}}，辅助信息 {{typography.caption.fontSize}}；避免将官网 11px 导航字直接当作表单正文。
+
+页面标题 {{typography.h1.fontSize}}、登录标题 {{typography.login-heading.fontSize}}，手机分别 {{typography.mobile-page-heading.fontSize}}/{{typography.mobile-heading.fontSize}}；h2 为 {{typography.h2.fontSize}}，h3 为 {{typography.h3.fontSize}}。标题使用 560–600 字重与轻微负字距，中文不采用官网展示标题的 -0.075em 压缩。`eyebrow` 用 {{typography.eyebrow.fontSize}}、{{typography.eyebrow.fontWeight}} 字重、{{typography.eyebrow.letterSpacing}} 字距作短标签，不承载唯一操作说明。标题平衡换行，说明文字自然换行，长记录标题允许断行，账号单行省略。
+
+具体字号、字重与行高以 typography 为准。所有套件严格使用同一按钮字号 {{typography.button.fontSize}} 与行高 {{typography.button.lineHeight}}；不要混用第二套展示字体。
+
+## Layout
+
+沿用工作空间的信息结构：顶栏、页面标题、记录列表与编辑区。桌面 shell-max 为 {{spacing.shell-max}}，水平边距 {{spacing.s32}}；记录区两栏，登录页说明与表单两栏。面板间距 {{spacing.s24}}，桌面面板内边距 {{widgets.panel.padding}}。避免为了科技感给每一行再套卡片。
+
+在 `spacing.mobile-breakpoint`（当前 {{spacing.mobile-breakpoint}}）收为单列，水平边距 {{spacing.s18}}、面板内边距 {{spacing.s20}}。375px 不允许横向溢出；操作区允许自然增长，不用全屏固定高度压缩内容。布局 CSS 与媒体查询由同一 token 源生成。
+
+官网的超大留白、全屏分区与宽幅媒体可用于品牌落地页，但不是登录和 CRUD 页面默认规则。新增导航、统计卡或营销分区需要业务需求，不能由设计规范自行扩张功能。
+
+## Elevation & Depth
+
+面板首先依靠深浅表面和 1px 冷色边框分层；阴影为 `{{effects.panelShadow}}`，来自 design/tokens.json 的 effects.panelShadow。控件边框比装饰分隔线更清晰。选中记录增加冰蓝侧线与背景变化，不只靠文字颜色。
+
+官网玻璃面板的 blur(14px) 和影像叠层可作为品牌页面参考；本工具使用实体表面保证阅读和性能，不全局加 backdrop-filter。禁止给每个按钮、输入框加辉光或重阴影。
+
+## Shapes
+
+`rounded.md` 为 {{rounded.md}}、`rounded.panel` 为 {{rounded.panel}}、`rounded.full` 为 {{rounded.full}}：按钮、输入、面板和标签保持精确直角。`full` 是沿用的 token 名，在当前主题不代表胶囊。修改形状时同步组件 token；所有尺寸的圆角由套件显式绑定，避免库派生出另一种圆角。
+
+边框厚度通常为 1px。图标沿用所选组件库的简洁线性风格，保持光学尺寸一致；不复制官网 Logo 或专有插图。
+
+## Components
+
+主按钮：冰蓝填充、深色文字；secondary：深色表面与清晰描边；danger：暗红表面与浅红文字。按钮与单行输入高度 {{widgets.button.height}}，保持键盘焦点。default/hover/active/focus/disabled/loading 与输入错误态由 design/widgets.json 定义，套件逐项翻译，不接受原生默认值偏差。颜色派生结果以共享 token 为准；图标使用同一份 SVG 几何，套件不得替换成近似图标。
+
+输入：深色底、冷白输入文字、可读 placeholder，标签始终可见。加载时禁用重复提交；错误后保留输入；空态说明下一步；记录正文以纯文本显示。删除需确认，退出清除当前编辑内容。控件自身焦点、输入和禁用状态由原生控件/套件管理；登录身份、校验、记录状态与请求隔离只在框架无关的 workspace-model 中实现。页面区块顺序和嵌套来自 design/structure.json，框架视图负责绑定。上述行为由业务实现与 Playwright 测试负责，设计文件不替代执行逻辑。
+
+动效只用于短暂状态反馈；遵循 150–250ms 的颜色/边框变化，不新增背景循环、滚动接管或入场延迟。`prefers-reduced-motion: reduce` 下取消非必要动画与过渡。品牌页面如果采用背景媒体，需静态后备、降低亮度、保障文字对比度，并单独验收性能。
+
+## Do's and Don'ts
+
+- UI 开发前读本文件；设计修改先改源，再 sync/check，最后看浏览器真实结果。
+- 复用冷色中性层级、单一字体、直角薄边框与有限强调色；保持所选 UI 库的一致性。
+- 验证默认、hover、active、focus、disabled、loading、empty、error，以及键盘与 375px 布局。
+- 不将来源网站的行业、品牌内容、低对比装饰字或全屏动效当成通用业务要求。
+- 不给每个面板加玻璃、光晕或渐变；库默认值与规格不符时修改套件，不反向修改规范。
+- 全量执行控件/页面比较：位置容差 ≤0.6 CSS px；颜色、圆角、图标几何零容差；必须覆盖 widgets.json 和 structure.json 的全部声明项。
+- 不直接编辑生成文件，不把文档格式通过当成浏览器验收通过，不根据项目简介随机改变视觉。

package/templates/react-fastapi-antd/design/layout.css

@@ -0,0 +1,6 @@
+*{box-sizing:border-box}body{color-scheme:dark;margin:0;background:var(--design-colors-background);color:var(--design-colors-text);font-family:var(--design-typography-body-font-family);font-size:var(--design-typography-body-font-size);line-height:var(--design-typography-body-line-height)}button,input,textarea{font:inherit}button,a,input,textarea{touch-action:manipulation}button:focus-visible,a:focus-visible{outline:var(--design-spacing-s3) solid var(--design-colors-focus);outline-offset:var(--design-spacing-s3)}.app-shell{max-width:var(--design-spacing-shell-max);margin:auto;padding:0 var(--design-spacing-s32)}.topbar{display:flex;align-items:center;gap:var(--design-spacing-s20);min-height:var(--design-spacing-s88);border-bottom:var(--design-spacing-s1) solid var(--design-colors-border)}.brand{font-weight:var(--design-typography-eyebrow-font-weight);color:var(--design-colors-brand);text-decoration:none;font-size:var(--design-typography-h2-font-size)}.account{margin-left:auto;display:flex;gap:var(--design-spacing-s20);align-items:center;font-size:var(--design-typography-label-font-size)}main{padding:var(--design-spacing-s44) 0;min-height:calc(100vh - var(--design-spacing-footer-reserve))}h1,h2,h3,p{margin-top:0}h1,h2,h3{text-wrap:balance}p{text-wrap:pretty}h1{font-weight:var(--design-typography-h1-font-weight);font-size:var(--design-typography-h1-font-size);line-height:var(--design-typography-h1-line-height);letter-spacing:var(--design-typography-h1-letter-spacing);margin-bottom:var(--design-spacing-s12)}h2{font-weight:var(--design-typography-h2-font-weight);letter-spacing:var(--design-typography-h2-letter-spacing);font-size:var(--design-typography-h2-font-size);line-height:var(--design-typography-h2-line-height)}h3{font-weight:var(--design-typography-h3-font-weight);line-height:var(--design-typography-h3-line-height);font-size:var(--design-typography-h3-font-size)}.eyebrow{font-size:var(--design-typography-eyebrow-font-size);font-weight:var(--design-typography-eyebrow-font-weight);letter-spacing:var(--design-typography-eyebrow-letter-spacing);color:var(--design-colors-eyebrow);margin-bottom:var(--design-spacing-s14)}.muted{color:var(--design-colors-muted);font-size:var(--design-typography-label-font-size)}.intro{color:var(--design-colors-intro);font-size:var(--design-typography-intro-font-size);line-height:var(--design-typography-intro-line-height);max-width:var(--design-spacing-intro-max)}.page-heading{display:flex;align-items:center;justify-content:space-between;gap:var(--design-spacing-s20);margin-bottom:var(--design-spacing-s28)}.workspace{display:grid;grid-template-columns:minmax(var(--design-spacing-list-min),.8fr) minmax(0,1.6fr);gap:var(--design-spacing-s24)}.panel{background:var(--design-components-panel-background-color);border:var(--design-spacing-s1) solid var(--design-colors-panel-border);border-radius:var(--design-components-panel-rounded);padding:var(--design-components-panel-padding);box-shadow:var(--design-effects-panel-shadow)}.login-layout{display:grid;grid-template-columns:1.15fr 1fr;align-items:center;gap:var(--design-spacing-s80);max-width:var(--design-spacing-login-max);margin:auto}.login-layout h1{font-size:var(--design-typography-login-heading-font-size);font-weight:var(--design-typography-login-heading-font-weight);line-height:var(--design-typography-login-heading-line-height);letter-spacing:var(--design-typography-login-heading-letter-spacing)}.login-card{max-width:var(--design-spacing-login-card-max);width:100%;justify-self:end}.field{display:flex;flex-direction:column;gap:var(--design-spacing-s8);margin:var(--design-spacing-s22) 0}.field label{font-weight:var(--design-typography-label-font-weight);font-size:var(--design-typography-label-font-size)}.record-list ul{padding:0;margin:0;list-style:none}.record-list li+li{border-top:var(--design-spacing-s1) solid var(--design-colors-divider)}.record-link{display:flex;flex-direction:column;gap:var(--design-spacing-s4);width:100%;padding:var(--design-spacing-s15) var(--design-spacing-s12);text-align:left;cursor:pointer;background:transparent;border:0;border-radius:var(--design-rounded-md);color:var(--design-colors-record-text)}.record-link strong{overflow-wrap:anywhere}.record-link span{color:var(--design-colors-record-meta);font-size:var(--design-typography-caption-font-size)}.record-link:hover,.record-link.active{background:var(--design-colors-record-hover)}.pagination{display:flex;align-items:center;justify-content:space-between;gap:var(--design-spacing-s8);border-top:var(--design-spacing-s1) solid var(--design-colors-pagination-border);margin-top:var(--design-spacing-s20);padding-top:var(--design-spacing-s20);font-size:var(--design-typography-caption-font-size)}.editor-heading,.editor-footer{display:flex;align-items:center;justify-content:space-between;gap:var(--design-spacing-s14)}.editor-heading h2{margin:0}.empty{padding:var(--design-spacing-s60) var(--design-spacing-s14);text-align:center;color:var(--design-colors-empty)}.empty h2,.empty h3{color:var(--design-colors-empty-heading)}.notice{padding:var(--design-spacing-s12) var(--design-spacing-s16);background:var(--design-colors-success-background);border:var(--design-spacing-s1) solid var(--design-colors-success-border);border-radius:var(--design-rounded-md);color:var(--design-colors-success-text)}.alert{margin:var(--design-spacing-s16) 0;padding:var(--design-spacing-s12) var(--design-spacing-s16);background:var(--design-colors-error-background);border:var(--design-spacing-s1) solid var(--design-colors-error-border);border-radius:var(--design-rounded-md);color:var(--design-colors-error-text)}footer{padding:var(--design-spacing-s20) 0;border-top:var(--design-spacing-s1) solid var(--design-colors-footer-border);color:var(--design-colors-footer-text);font-size:var(--design-typography-caption-font-size)}.badge{display:inline-flex;border:var(--design-spacing-s1) solid var(--design-colors-badge-border);padding:var(--design-spacing-s3) var(--design-spacing-s10);border-radius:var(--design-rounded-full);color:var(--design-colors-badge-text);font-size:var(--design-typography-eyebrow-font-size);white-space:nowrap}textarea{resize:vertical}@media(max-width:{{spacing.mobile-breakpoint}}){.app-shell{padding:0 var(--design-spacing-s18)}.topbar{flex-wrap:wrap;gap:var(--design-spacing-s10);padding:var(--design-spacing-s18) 0}.account{width:100%;justify-content:space-between}.workspace,.login-layout{grid-template-columns:1fr;gap:var(--design-spacing-s24)}.login-layout h1{font-size:var(--design-typography-mobile-heading-font-size);line-height:var(--design-typography-mobile-heading-line-height)}.login-card{max-width:none}.page-heading h1{font-size:var(--design-typography-mobile-page-heading-font-size);line-height:var(--design-typography-mobile-page-heading-line-height)}.panel{padding:var(--design-spacing-s20)}main{padding:var(--design-spacing-s28) 0}.pagination button{padding:var(--design-spacing-s6)}.badge{margin-left:auto}}
+
+.account{min-width:0}.account span{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.brand{overflow-wrap:anywhere}.workspace>*{min-width:0}
+
+.record-link.active{box-shadow:inset 2px 0 var(--design-colors-primary)}
+@media(prefers-reduced-motion:reduce){*,*::before,*::after{animation-duration:0.01ms!important;animation-iteration-count:1!important;transition-duration:0.01ms!important;scroll-behavior:auto!important}}

package/templates/react-fastapi-antd/design/structure.json

@@ -0,0 +1,107 @@
+{
+  "schemaVersion": 1,
+  "root": {
+    "region": "app-shell",
+    "element": "div",
+    "children": [
+      {
+        "region": "topbar",
+        "element": "header",
+        "children": [
+          {
+            "region": "brand",
+            "element": "a",
+            "slot": "brand"
+          },
+          {
+            "region": "badge",
+            "element": "slot",
+            "slot": "badge"
+          },
+          {
+            "region": "account",
+            "element": "div",
+            "slot": "account"
+          }
+        ]
+      },
+      {
+        "region": "page",
+        "element": "slot",
+        "slot": "page"
+      },
+      {
+        "region": "footer",
+        "element": "footer",
+        "slot": "footer"
+      }
+    ]
+  },
+  "pages": {
+    "checking": {
+      "region": "checking",
+      "element": "main",
+      "slot": "checking"
+    },
+    "login": {
+      "region": "login-layout",
+      "element": "main",
+      "children": [
+        {
+          "region": "login-intro",
+          "element": "section",
+          "slot": "loginIntro"
+        },
+        {
+          "region": "login-card",
+          "element": "panel",
+          "slot": "loginCard"
+        }
+      ]
+    },
+    "workspace": {
+      "region": "workspace-main",
+      "element": "main",
+      "children": [
+        {
+          "region": "page-heading",
+          "element": "div",
+          "slot": "heading"
+        },
+        {
+          "region": "feedback",
+          "element": "div",
+          "slot": "feedback"
+        },
+        {
+          "region": "workspace",
+          "element": "div",
+          "children": [
+            {
+              "region": "record-list",
+              "element": "panel",
+              "slot": "records"
+            },
+            {
+              "region": "editor",
+              "element": "panel",
+              "slot": "editor"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "scenarios": [
+    "checking",
+    "login",
+    "login-error",
+    "login-busy",
+    "workspace-empty",
+    "workspace-loading",
+    "workspace-records",
+    "editor-new",
+    "editor-existing",
+    "editor-error"
+  ]
+}

package/templates/react-fastapi-antd/design/tokens.json

@@ -0,0 +1,171 @@
+{
+  "tokens": {
+    "version": "alpha",
+    "name": "Scientific Workspace",
+    "description": "从 CleerScience 提炼的通用深色科技视觉，适配可读、安静的工具型界面。",
+    "colors": {
+      "primary": "#8fc3ff",
+      "primary-hover": "#b5d8ff",
+      "primary-active": "#69a9f3",
+      "primary-text": "#02040a",
+      "background": "#02040a",
+      "text": "#f4f8ff",
+      "surface": "#0b111d",
+      "focus": "#8fc3ff",
+      "border": "#283547",
+      "brand": "#f4f8ff",
+      "eyebrow": "#9baecb",
+      "muted": "#a1afc3",
+      "intro": "#b5c3d7",
+      "panel-border": "#283547",
+      "divider": "#202c3e",
+      "record-text": "#f4f8ff",
+      "record-meta": "#a1afc3",
+      "record-hover": "#142237",
+      "pagination-border": "#283547",
+      "empty": "#a1afc3",
+      "empty-heading": "#e2eeff",
+      "success-background": "#102b25",
+      "success-border": "#387c69",
+      "success-text": "#a2e6cc",
+      "error-background": "#311b24",
+      "error-border": "#8f4c61",
+      "error-text": "#ffbdcd",
+      "footer-border": "#283547",
+      "footer-text": "#a1afc3",
+      "badge-border": "#435773",
+      "badge-text": "#b5c3d7",
+      "control-focus": "#8fc3ff",
+      "control-border": "#657891",
+      "control-background": "#080e18",
+      "secondary-border": "#657891",
+      "secondary-text": "#e2eeff",
+      "secondary-hover": "#19283d",
+      "danger-border": "#ad6578",
+      "danger-background": "#311b24",
+      "danger-text": "#ffbdcd",
+      "danger-hover": "#472636"
+    },
+    "typography": {
+      "body": {
+        "fontFamily": "Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,\"Segoe UI\",\"PingFang SC\",\"Hiragino Sans GB\",\"Microsoft YaHei\",sans-serif",
+        "fontSize": "16px",
+        "lineHeight": 1.65
+      },
+      "h1": {
+        "fontSize": "36px",
+        "lineHeight": 1.2,
+        "letterSpacing": "-0.03em",
+        "fontWeight": 560
+      },
+      "login-heading": {
+        "fontSize": "48px",
+        "lineHeight": 1.15,
+        "fontWeight": 560,
+        "letterSpacing": "-0.03em"
+      },
+      "h2": {
+        "fontSize": "20px",
+        "lineHeight": 1.4,
+        "fontWeight": 580,
+        "letterSpacing": "-0.02em"
+      },
+      "h3": {
+        "fontSize": "18px",
+        "fontWeight": 600,
+        "lineHeight": 1.5
+      },
+      "label": {
+        "fontSize": "14px",
+        "fontWeight": 600
+      },
+      "eyebrow": {
+        "fontSize": "11px",
+        "fontWeight": 700,
+        "letterSpacing": "0.22em",
+        "lineHeight": 1.5
+      },
+      "button": {
+        "fontSize": "14px",
+        "fontWeight": 600,
+        "lineHeight": "20px"
+      },
+      "caption": {
+        "fontSize": "12px"
+      },
+      "intro": {
+        "fontSize": "18px",
+        "lineHeight": 1.8
+      },
+      "mobile-heading": {
+        "fontSize": "32px",
+        "lineHeight": 1.2
+      },
+      "mobile-page-heading": {
+        "fontSize": "28px",
+        "lineHeight": 1.25
+      }
+    },
+    "rounded": {
+      "md": "0px",
+      "panel": "0px",
+      "full": "0px"
+    },
+    "spacing": {
+      "s0": "0px",
+      "s1": "1px",
+      "s2": "2px",
+      "s3": "3px",
+      "s4": "4px",
+      "s6": "6px",
+      "s8": "8px",
+      "s10": "10px",
+      "s12": "12px",
+      "s14": "14px",
+      "s15": "15px",
+      "s16": "16px",
+      "s18": "18px",
+      "s20": "20px",
+      "s22": "22px",
+      "s24": "24px",
+      "s26": "26px",
+      "s28": "28px",
+      "s30": "30px",
+      "s32": "32px",
+      "s34": "34px",
+      "s38": "38px",
+      "s44": "44px",
+      "s48": "48px",
+      "s60": "60px",
+      "s80": "80px",
+      "s88": "88px",
+      "shell-max": "1240px",
+      "login-max": "1020px",
+      "intro-max": "460px",
+      "login-card-max": "430px",
+      "list-min": "260px",
+      "footer-reserve": "155px",
+      "mobile-breakpoint": "760px",
+      "control-min": "44px"
+    },
+    "components": {
+      "button-primary": {
+        "backgroundColor": "{colors.primary}",
+        "textColor": "{colors.primary-text}",
+        "rounded": "{rounded.md}",
+        "height": "{spacing.control-min}"
+      },
+      "panel": {
+        "backgroundColor": "{colors.surface}",
+        "padding": "{spacing.s26}",
+        "rounded": "{rounded.panel}"
+      },
+      "input": {
+        "rounded": "{rounded.md}"
+      }
+    }
+  },
+  "effects": {
+    "panelShadow": "0 16px 48px rgba(0,0,0,0.18)"
+  }
+}

package/templates/react-fastapi-antd/design/widgets.css

@@ -0,0 +1,30 @@
+/* These semantic hooks belong to the widget contract, never to a library. */
+[data-widget]{box-sizing:border-box!important;font-family:var(--design-typography-body-font-family)!important;letter-spacing:normal!important;text-transform:none!important;box-shadow:none!important}
+[data-widget="button"]{display:inline-flex!important;align-items:center!important;justify-content:center!important;gap:8px!important;vertical-align:middle!important;position:relative!important;min-width:0!important;height:var(--design-widgets-button-height)!important;min-height:var(--design-widgets-button-height)!important;padding:var(--design-widgets-button-padding-y) var(--design-widgets-button-padding-x)!important;margin:0!important;border:var(--design-widgets-button-border-width) solid transparent!important;border-radius:var(--design-widgets-button-radius)!important;font-size:var(--design-widgets-button-font-size)!important;font-weight:var(--design-widgets-button-font-weight)!important;line-height:var(--design-widgets-button-line-height)!important;cursor:pointer!important;text-align:center!important;white-space:nowrap!important;transition:background-color 180ms,border-color 180ms,color 180ms!important}
+[data-widget="button"] [data-part="label"]{display:inline!important;margin:0!important;padding:0!important;font:inherit!important;line-height:inherit!important;color:inherit!important}
+[data-widget="button"][data-variant="primary"]{background:var(--design-colors-primary)!important;color:var(--design-colors-primary-text)!important}
+[data-widget="button"][data-variant="primary"]:hover{background:var(--design-colors-primary-hover)!important}
+[data-widget="button"][data-variant="primary"]:active{background:var(--design-colors-primary-active)!important}
+[data-widget="button"][data-variant="secondary"]{background:var(--design-colors-control-background)!important;color:var(--design-colors-secondary-text)!important;border-color:var(--design-colors-secondary-border)!important}
+[data-widget="button"][data-variant="secondary"]:hover,[data-widget="button"][data-variant="secondary"]:active{background:var(--design-colors-secondary-hover)!important}
+[data-widget="button"][data-variant="danger"]{background:var(--design-colors-danger-background)!important;color:var(--design-colors-danger-text)!important;border-color:var(--design-colors-danger-border)!important}
+[data-widget="button"][data-variant="danger"]:hover,[data-widget="button"][data-variant="danger"]:active{background:var(--design-colors-danger-hover)!important}
+[data-widget="button"]:disabled{opacity:.5!important;cursor:not-allowed!important;pointer-events:none!important}
+[data-widget="input"],[data-widget="textarea"]{display:block!important;width:100%!important;min-width:0!important;margin:0!important;padding:var(--design-widgets-input-padding-y) var(--design-widgets-input-padding-x)!important;border:var(--design-widgets-input-border-width) solid var(--design-colors-control-border)!important;border-radius:var(--design-widgets-input-radius)!important;background:var(--design-colors-control-background)!important;color:var(--design-colors-text)!important;font-size:var(--design-widgets-input-font-size)!important;font-weight:400!important;line-height:var(--design-widgets-input-line-height)!important;outline:none!important;transition:border-color 180ms!important}
+[data-widget="input"]{height:var(--design-widgets-input-height)!important;min-height:var(--design-widgets-input-height)!important}
+[data-widget="textarea"]{padding:var(--design-widgets-textarea-padding-y) var(--design-widgets-textarea-padding-x)!important;border-width:var(--design-widgets-textarea-border-width)!important;border-radius:var(--design-widgets-textarea-radius)!important;font-size:var(--design-widgets-textarea-font-size)!important;line-height:var(--design-widgets-textarea-line-height)!important;resize:vertical!important;min-height:0!important}
+[data-widget="input"]::placeholder,[data-widget="textarea"]::placeholder{color:var(--design-colors-muted)!important;opacity:1!important}
+[data-widget="input"]:hover,[data-widget="textarea"]:hover{border-color:var(--design-colors-control-focus)!important}
+[data-widget="input"][aria-invalid="true"],[data-widget="textarea"][aria-invalid="true"]{border-color:var(--design-colors-error-border)!important}
+[data-widget="input"]:disabled,[data-widget="textarea"]:disabled{opacity:.5!important;cursor:not-allowed!important}
+[data-widget="button"]:focus-visible,[data-widget="input"]:focus,[data-widget="textarea"]:focus{outline:2px solid var(--design-colors-control-focus)!important;outline-offset:2px!important}
+[data-widget="alert"]{display:flex!important;align-items:flex-start!important;gap:var(--design-widgets-alert-gap)!important;margin:16px 0!important;padding:var(--design-widgets-alert-padding-y) var(--design-widgets-alert-padding-x)!important;border:var(--design-widgets-alert-border-width) solid var(--design-colors-error-border)!important;border-radius:var(--design-widgets-alert-radius)!important;background:var(--design-colors-error-background)!important;color:var(--design-colors-error-text)!important;font-size:var(--design-widgets-alert-font-size)!important;font-weight:400!important;line-height:var(--design-widgets-alert-line-height)!important}
+[data-widget="alert"][data-variant="success"]{background:var(--design-colors-success-background)!important;color:var(--design-colors-success-text)!important;border-color:var(--design-colors-success-border)!important}
+[data-widget="alert"] [data-part="icon"]{display:block!important;width:var(--design-widgets-alert-icon-size)!important;height:var(--design-widgets-alert-icon-size)!important;flex:none!important;margin:3px 0 0!important;color:inherit!important}
+[data-widget="alert"] [data-part="message"]{display:block!important;margin:0!important;padding:0!important;font:inherit!important;line-height:inherit!important;color:inherit!important;overflow-wrap:anywhere}
+[data-widget="badge"]{display:inline-flex!important;align-items:center!important;vertical-align:middle!important;white-space:nowrap!important;margin:0!important;padding:var(--design-widgets-badge-padding-y) var(--design-widgets-badge-padding-x)!important;border:var(--design-widgets-badge-border-width) solid var(--design-colors-badge-border)!important;border-radius:var(--design-widgets-badge-radius)!important;background:transparent!important;color:var(--design-colors-badge-text)!important;font-size:var(--design-widgets-badge-font-size)!important;font-weight:400!important;line-height:var(--design-widgets-badge-line-height)!important}
+[data-widget="panel"]{background:var(--design-colors-surface)!important;border:var(--design-widgets-panel-border-width) solid var(--design-colors-panel-border)!important;border-radius:var(--design-widgets-panel-radius)!important;padding:var(--design-widgets-panel-padding)!important;box-shadow:var(--design-effects-panel-shadow)!important}
+[data-widget="field"]{display:flex!important;flex-direction:column!important;gap:var(--design-widgets-field-gap)!important;margin:var(--design-widgets-field-margin-y) 0!important}
+[data-widget="field"]>[data-part="label"]{font-size:var(--design-widgets-field-font-size)!important;font-weight:var(--design-widgets-field-font-weight)!important;line-height:var(--design-widgets-field-line-height)!important}
+@media(max-width:{{spacing.mobile-breakpoint}}){[data-widget="panel"]{padding:var(--design-spacing-s20)!important}}
+@media(prefers-reduced-motion:reduce){[data-widget]{transition-duration:0.01ms!important}}

package/templates/react-fastapi-antd/design/widgets.json

@@ -0,0 +1,233 @@
+{
+  "schemaVersion": 1,
+  "acceptance": {
+    "positionTolerance": 0.6,
+    "exact": [
+      "color",
+      "radius",
+      "iconGeometry"
+    ],
+    "viewports": [
+      {
+        "width": 1440,
+        "height": 1000
+      },
+      {
+        "width": 375,
+        "height": 812
+      }
+    ]
+  },
+  "widgets": {
+    "button": {
+      "parts": [
+        "root",
+        "label"
+      ],
+      "variants": [
+        "primary",
+        "secondary",
+        "danger"
+      ],
+      "states": [
+        "default",
+        "hover",
+        "active",
+        "focus",
+        "disabled",
+        "loading"
+      ],
+      "styles": {
+        "height": "{components.button-primary.height}",
+        "paddingX": "{spacing.s16}",
+        "paddingY": "{spacing.s8}",
+        "borderWidth": "{spacing.s1}",
+        "fontSize": "{typography.button.fontSize}",
+        "fontWeight": "{typography.button.fontWeight}",
+        "lineHeight": "{typography.button.lineHeight}",
+        "radius": "{components.button-primary.rounded}"
+      },
+      "behavior": {
+        "keyboard": [
+          "Enter",
+          "Space"
+        ],
+        "loading": "disabled-with-status-label",
+        "icon": "none"
+      }
+    },
+    "input": {
+      "parts": [
+        "root"
+      ],
+      "variants": [
+        "text",
+        "email",
+        "password"
+      ],
+      "states": [
+        "default",
+        "hover",
+        "focus",
+        "disabled",
+        "invalid",
+        "readonly"
+      ],
+      "styles": {
+        "height": "{spacing.control-min}",
+        "paddingX": "{spacing.s12}",
+        "paddingY": "{spacing.s8}",
+        "borderWidth": "{spacing.s1}",
+        "fontSize": "{typography.body.fontSize}",
+        "lineHeight": "24px",
+        "radius": "{components.input.rounded}"
+      },
+      "behavior": {
+        "keyboard": "native-text-editing",
+        "passwordVisibility": "always-masked",
+        "autocomplete": "caller-provided",
+        "validation": "business-owned"
+      }
+    },
+    "textarea": {
+      "parts": [
+        "root"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default",
+        "hover",
+        "focus",
+        "disabled",
+        "invalid",
+        "readonly"
+      ],
+      "styles": {
+        "paddingX": "{spacing.s12}",
+        "paddingY": "{spacing.s8}",
+        "borderWidth": "{spacing.s1}",
+        "fontSize": "{typography.body.fontSize}",
+        "lineHeight": "24px",
+        "radius": "{rounded.md}"
+      },
+      "behavior": {
+        "keyboard": "native-multiline-editing",
+        "resize": "vertical"
+      }
+    },
+    "alert": {
+      "parts": [
+        "root",
+        "icon",
+        "message"
+      ],
+      "variants": [
+        "error",
+        "success"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "paddingX": "{spacing.s16}",
+        "paddingY": "{spacing.s12}",
+        "gap": "{spacing.s8}",
+        "iconSize": "16px",
+        "fontSize": "14px",
+        "lineHeight": "22px",
+        "borderWidth": "1px",
+        "radius": "{rounded.md}"
+      },
+      "behavior": {
+        "errorRole": "alert",
+        "successRole": "status",
+        "dismiss": "none"
+      }
+    },
+    "badge": {
+      "parts": [
+        "root",
+        "label"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "paddingX": "{spacing.s10}",
+        "paddingY": "{spacing.s3}",
+        "fontSize": "12px",
+        "lineHeight": "18px",
+        "borderWidth": "1px",
+        "radius": "{rounded.full}"
+      },
+      "behavior": {
+        "interactive": false
+      }
+    },
+    "panel": {
+      "parts": [
+        "root"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "padding": "{components.panel.padding}",
+        "borderWidth": "1px",
+        "radius": "{components.panel.rounded}"
+      },
+      "behavior": {
+        "interactive": false
+      }
+    },
+    "field": {
+      "parts": [
+        "root",
+        "label",
+        "control"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "gap": "{spacing.s8}",
+        "marginY": "{spacing.s22}",
+        "fontSize": "{typography.label.fontSize}",
+        "fontWeight": "{typography.label.fontWeight}",
+        "lineHeight": "22px"
+      },
+      "behavior": {
+        "label": "explicit-for-control"
+      }
+    }
+  },
+  "icons": {
+    "error": {
+      "viewBox": "0 0 24 24",
+      "strokeWidth": 2,
+      "paths": [
+        "M12 3 2 21h20L12 3Z",
+        "M12 9v5",
+        "M12 17h.01"
+      ]
+    },
+    "success": {
+      "viewBox": "0 0 24 24",
+      "strokeWidth": 2,
+      "paths": [
+        "M20 6 9 17l-5-5"
+      ]
+    }
+  }
+}

package/templates/react-fastapi-antd/docs/PROJECT.md

@@ -0,0 +1,9 @@
+## 当前范围
+
+基础示例：登录、退出、个人记录列表/详情/新建/编辑/删除，以及服务端用户隔离。项目简介是用途说明，真实业务细节和额外验收条件尚未确认。
+
+## 工程事实
+
+project.json 标识技术栈和 UI；web/ 是界面或 Next 全栈应用；独立后端位于 backend/。scripts/project.mjs 提供实际安装、开发、测试、构建命令。数据库结构以迁移为准，接口见 docs/openapi.json 和生成的 docs/api.d.ts。
+
+后续需求在团队已有权威来源或本文记录，不要求接入特定任务平台。名称和简介来自创建输入，修改 project.json 可更新界面展示。