style(frontend): 对齐 Alright 主题并接入离线字体

- 主题色板、圆角、阴影与 0.3s 缓动对齐参考站点，布局与尺寸不变
- index.html 预加载本地字体，index.css 定义 LXGW WenKai / Outfit-Medium
- 新增断网渲染端到端用例与 ADR-0006

docs/decisions/0006-visual-theme-and-offline-fonts.md

@@ -0,0 +1,32 @@
+# ADR-0006：视觉风格对齐主题并自托管字体
+
+- 状态：已接受
+- 日期：2026-10-25
+
+## 背景
+
+产品要求前端视觉与参考站点（Alright / nicetheme）一致，包括字体、配色和交互，但不改变既有布局。参考站点使用 Bootstrap 5 + 自定义变量，正文依赖 CDN 的 `lxgw-wenkai-webfont`，标题使用自托管的 `Outfit-Medium`。
+
+本项目的目标是"本机、离线可复现"：依赖 CDN 会在断网、内网或 CDN 故障时导致字体回退，从而破坏视觉一致性。
+
+## 决策
+
+1. 从参考站点抓取其 CSS 的变量定义，把真实色值映射到本项目既有语义变量（`--primary`、`--text-main`、`--border`、`--success` 等），布局相关声明一律不改。
+2. 交互细节对齐主题：`0.3s ease-in-out` 过渡、主/危险按钮 hover 使用 `opacity: .85`、输入框聚焦使用主色半透明光环、选中项使用主色浅染。
+3. 字重遵循主题的 `--font-weight-bold: 500`；标题与指标数字使用 `Outfit-Medium`，正文使用 `LXGW WenKai`，等宽使用主题的 `SFMono-Regular…Consolas` 栈。
+4. 字体全部自托管：`Outfit-Medium.ttf` 直接取自主题；`LXGW WenKai` 由官方 webfont 的 97 个 woff2 子集合并后，再裁剪到 GB2312 + 常用符号子集，输出简体中文 Regular 与 Bold 两个文件。
+5. 移除所有 Google Fonts / CDN 字体链接，`index.html` 只 preload 本地字体文件。
+6. 新增端到端用例"renders fully offline"：拦截并拒绝一切非 `127.0.0.1` 请求，断言页面正常渲染、`document.fonts.check` 命中两种字体且没有任何外部请求。
+
+## 原因
+
+- 直接用主题的变量值，颜色不会"看起来像"而是确实一致。
+- 字体子集化把 8.8 MB 的 194 个子集压到 6.7 MB 的两个文件，仓库与安装包体积可控，浏览器只需一次请求。
+- 离线断言把"可复现"变成可回归的测试，而不是口头承诺。
+
+## 边界
+
+- 字体子集覆盖 GB2312（6763 字）+ Latin + CJK 标点 + 全角符号；更生僻的汉字（GB18030 扩展区）会按浏览器逐字回退到系统字体，显示正常但字形风格不一致。
+- 只包含 400 / 700 两个字重，500 / 600 由 CSS 字重匹配落到 400 / 700；主题的 Light（300）未包含。
+- 未实现参考站点的暗色模式（`data-scheme="dark"`）。
+- 字体文件随 `frontend/public/fonts` 一起进入安装包，体积增加约 6.7 MB。

frontend/e2e/dashboard.spec.ts

@@ -221,3 +221,41 @@ test('cancels a running task from the log drawer', async ({
   await drawer.getByRole('button', { name: '取消运行' }).click()
   await expect(drawer.locator('.status-cancelled').first()).toBeVisible()
 })
+
+test('renders fully offline with bundled fonts', async ({ page }) => {
+  const blocked: string[] = []
+  await page.route('**/*', (route) => {
+    const url = route.request().url()
+    const isLocal =
+      url.startsWith('http://127.0.0.1:5173') ||
+      url.startsWith('http://localhost:5173') ||
+      url.startsWith('data:') ||
+      url.startsWith('blob:')
+    if (isLocal) {
+      return route.continue()
+    }
+    blocked.push(url)
+    return route.abort()
+  })
+
+  await page.goto('/')
+  await expect(page.getByRole('heading', { name: 'TaskPilot' })).toBeVisible()
+
+  const fonts = await page.evaluate(async () => {
+    await document.fonts.ready
+    return {
+      wenkai: document.fonts.check('14px "LXGW WenKai"'),
+      display: document.fonts.check('500 26px "Outfit-Medium"'),
+      loaded: Array.from(document.fonts).map((face) => face.family),
+    }
+  })
+
+  expect(blocked).toEqual([])
+  expect(fonts.wenkai).toBe(true)
+  expect(fonts.display).toBe(true)
+  expect(fonts.loaded).toContain('LXGW WenKai')
+  await page.screenshot({
+    path: 'test-results/dashboard-offline.png',
+    fullPage: true,
+  })
+})

frontend/index.html

@@ -7,11 +7,19 @@
       name="description"
       content="TaskPilot - Windows 本地定时任务管理平台"
     />
-    <link rel="preconnect" href="https://fonts.googleapis.com" />
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
-      href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"
+      rel="preload"
-      rel="stylesheet"
+      href="/fonts/LXGWWenKai-Regular.woff2"
+      as="font"
+      type="font/woff2"
+      crossorigin
+    />
+    <link
+      rel="preload"
+      href="/fonts/Outfit-Medium.ttf"
+      as="font"
+      type="font/ttf"
+      crossorigin
     />
     <title>TaskPilot</title>
   </head>

frontend/src/App.css

@@ -67,7 +67,7 @@ h3 {
   align-items: center;
   gap: 8px;
   min-height: 40px;
-  border: 1px solid #d7f2e7;
+  border: 1px solid var(--success-border);
   border-radius: 999px;
   padding: 0 14px;
   background: var(--success-bg);
@@ -81,7 +81,7 @@ h3 {
 }
 
 .connection-pill.is-offline {
-  border-color: #ffd9df;
+  border-color: var(--danger-border);
   background: var(--danger-bg);
   color: var(--danger);
 }
@@ -92,16 +92,17 @@ h3 {
   align-items: center;
   justify-content: center;
   border: 1px solid transparent;
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   padding: 8px 16px;
   font-size: 13px;
   font-weight: 500;
   text-decoration: none;
   transition:
-    background-color 150ms ease,
+    background-color var(--transition-base),
-    border-color 150ms ease,
+    border-color var(--transition-base),
-    color 150ms ease,
+    color var(--transition-base),
-    transform 150ms ease;
+    transform var(--transition-base),
+    opacity var(--transition-base);
 }
 
 .button:hover:not(:disabled) {
@@ -114,12 +115,13 @@ h3 {
 }
 
 .button-primary {
-  background: var(--text);
+  background: var(--primary);
   color: #fff;
 }
 
 .button-primary:hover:not(:disabled) {
-  background: #293241;
+  background: var(--primary);
+  opacity: 0.85;
 }
 
 .button-secondary {
@@ -129,8 +131,8 @@ h3 {
 }
 
 .button-secondary:hover:not(:disabled) {
-  border-color: #c8ccd3;
+  border-color: var(--text-light);
-  background: #f7f8fa;
+  background: var(--surface-muted);
 }
 
 .button-danger {
@@ -139,7 +141,8 @@ h3 {
 }
 
 .button-danger:hover:not(:disabled) {
-  background: #b91c3b;
+  background: var(--danger);
+  opacity: 0.85;
 }
 
 .button-ghost {
@@ -165,7 +168,7 @@ h3 {
 }
 
 .text-button:hover {
-  color: var(--text);
+  color: var(--primary);
 }
 
 .danger-text {
@@ -178,10 +181,10 @@ h3 {
   right: 24px;
   bottom: 24px;
   max-width: min(420px, calc(100vw - 48px));
-  border: 1px solid #2f3845;
+  border: 1px solid var(--theme-secondary);
   border-radius: 12px;
   padding: 14px 18px;
-  background: #111827;
+  background: var(--theme-dark);
   color: #fff;
   box-shadow: 0 16px 48px rgba(15, 23, 42, 0.2);
   font-size: 13px;
@@ -210,7 +213,7 @@ h3 {
   align-items: flex-start;
   justify-content: space-between;
   gap: 16px;
-  border-color: #ffd7df;
+  border-color: var(--danger-border);
   background: var(--danger-bg);
   color: var(--danger);
 }
@@ -255,8 +258,9 @@ h3 {
   overflow: hidden;
   display: block;
   margin-top: 8px;
+  font-family: var(--font-display);
   font-size: 26px;
-  font-weight: 700;
+  font-weight: 500;
   letter-spacing: -0.03em;
   line-height: 1.2;
   text-overflow: ellipsis;
@@ -274,7 +278,7 @@ h3 {
 .card {
   overflow: hidden;
   border: 1px solid var(--border);
-  border-radius: 18px;
+  border-radius: var(--radius-md);
   background: var(--surface);
   box-shadow: var(--shadow);
 }
@@ -286,7 +290,7 @@ h3 {
   gap: 14px;
   border-bottom: 1px solid var(--border);
   padding: 12px 18px;
-  background: #fafafa;
+  background: var(--surface-muted);
 }
 
 .search-form {
@@ -316,24 +320,24 @@ h3 {
   width: 100%;
   min-height: 38px;
   border: 1px solid var(--border);
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   outline: 0;
   padding: 8px 12px;
   font-size: 13px;
   background: var(--surface);
   color: var(--text);
   transition:
-    border-color 150ms ease,
+    border-color var(--transition-base),
-    box-shadow 150ms ease;
+    box-shadow var(--transition-base);
 }
 
 .field-input:hover {
-  border-color: #cfd3da;
+  border-color: var(--text-light);
 }
 
 .field-input:focus {
   border-color: var(--primary);
-  box-shadow: 0 0 0 3px rgba(17, 24, 39, 0.06);
+  box-shadow: 0 0 0 3px var(--theme-primary-soft);
 }
 
 .field-input:disabled {
@@ -358,7 +362,7 @@ code {
   border-radius: 6px;
   padding: 3px 8px;
   background: var(--badge-bg);
-  color: #374151;
+  color: var(--theme-secondary);
   font-size: 12px;
 }
 
@@ -376,11 +380,11 @@ code {
 
 .task-table th {
   padding: 14px 12px;
-  background: #fafafa;
+  background: var(--surface-muted);
   color: var(--text-tertiary);
   font-family: var(--font-sans);
   font-size: 11px;
-  font-weight: 600;
+  font-weight: 500;
   letter-spacing: 0.06em;
   text-transform: uppercase;
   white-space: nowrap;
@@ -395,11 +399,11 @@ code {
 }
 
 .task-table tbody tr {
-  transition: background-color 120ms ease;
+  transition: background-color var(--transition-base);
 }
 
 .task-table tbody tr:hover {
-  background: #fbfcfd;
+  background: var(--surface-muted);
 }
 
 .task-name {
@@ -443,7 +447,7 @@ code {
   display: inline-flex;
   padding: 0;
   background: transparent;
-  color: #4b5563;
+  color: var(--text-muted);
   font-size: 12px;
   font-weight: 400;
 }
@@ -455,7 +459,7 @@ code {
   border-radius: 999px;
   padding: 4px 10px;
   background: var(--badge-bg);
-  color: #5d6470;
+  color: var(--text-muted);
   font-size: 12px;
   font-weight: 500;
   white-space: nowrap;
@@ -470,25 +474,25 @@ code {
 
 .status-enabled,
 .status-succeeded {
-  background: #ecfdf5;
+  background: var(--success-bg);
-  color: #067a56;
+  color: #2b8a63;
 }
 
 .status-disabled,
 .status-cancelled,
 .status-skipped {
-  background: #f3f4f6;
+  background: var(--badge-bg);
-  color: #6b7280;
+  color: var(--text-muted);
 }
 
 .status-queued {
-  background: #eff6ff;
+  background: var(--primary-soft);
-  color: #2563eb;
+  color: var(--primary);
 }
 
 .status-running {
-  background: #fffbeb;
+  background: var(--warning-bg);
-  color: #b45309;
+  color: var(--warning);
 }
 
 .status-running .status-dot {
@@ -588,7 +592,7 @@ code {
   max-height: calc(100vh - 48px);
   overflow: hidden;
   border: 1px solid var(--border);
-  border-radius: 18px;
+  border-radius: var(--radius-lg);
   background: var(--surface);
   box-shadow: var(--shadow-modal);
   animation: modal-in 180ms ease-out;
@@ -699,17 +703,17 @@ code {
   flex-direction: column;
   gap: 6px;
   overflow-y: auto;
-  border: 1px solid #eeeff2;
+  border: 1px solid var(--border);
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   padding: 10px 12px;
-  background: #fafafa;
+  background: var(--surface-muted);
 }
 
 .cron-run-item {
   display: flex;
   align-items: center;
   gap: 8px;
-  color: #374151;
+  color: var(--theme-secondary);
   font-family: var(--font-mono);
   font-size: 12px;
 }
@@ -722,7 +726,7 @@ code {
 }
 
 .cron-run-time {
-  border: 1px solid #e5e7eb;
+  border: 1px solid var(--border);
   border-radius: 4px;
   padding: 2px 8px;
   background: #fff;
@@ -748,7 +752,7 @@ code {
 }
 
 .field-label {
-  color: #374151;
+  color: var(--theme-secondary);
   font-size: 13px;
   font-weight: 600;
 }
@@ -794,7 +798,7 @@ code {
   margin-top: -1px;
   padding: 8px 12px;
   border: 1px solid var(--border);
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   background: var(--surface);
   font-size: 12px;
 }
@@ -839,8 +843,8 @@ code {
 }
 
 .field-input[aria-invalid='true'] {
-  border-color: #f08aa0;
+  border-color: rgba(255, 62, 62, 0.55);
-  background: #fffafb;
+  background: rgba(255, 62, 62, 0.04);
 }
 
 .field-textarea {
@@ -856,7 +860,7 @@ code {
   min-height: 48px;
   border: 1px solid var(--border);
   border: 0;
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   padding: 8px 0;
   background: transparent;
   cursor: pointer;
@@ -887,10 +891,10 @@ code {
 
 .dynamic-fields {
   margin: 22px 0 0;
-  border: 1px solid #eeeff2;
+  border: 1px solid var(--border);
   border-radius: 12px;
   padding: 20px;
-  background: #fafafa;
+  background: var(--surface-muted);
 }
 
 .collection-header {
@@ -940,18 +944,18 @@ code {
 
 .cli-preview {
   margin-top: 18px;
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   padding: 14px 18px;
-  background: #18191c;
+  background: var(--theme-dark);
 }
 
 .cli-preview-header {
   display: flex;
   justify-content: space-between;
   margin-bottom: 8px;
-  border-bottom: 1px solid #282a30;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
   padding-bottom: 6px;
-  color: #71767f;
+  color: var(--text-tertiary);
   font-size: 11px;
   letter-spacing: 0.06em;
   text-transform: uppercase;
@@ -965,11 +969,11 @@ code {
 
 .cli-line-env {
   margin-bottom: 4px;
-  color: #9da3af;
+  color: var(--text-tertiary);
 }
 
 .cli-line-cmd {
-  color: #34d399;
+  color: var(--success);
   font-weight: 500;
   overflow-wrap: anywhere;
 }
@@ -980,7 +984,7 @@ code {
   gap: 8px;
   border-top: 1px solid var(--border);
   padding: 16px 28px;
-  background: #fafafb;
+  background: var(--surface-muted);
 }
 
 .confirm-card {
@@ -1047,7 +1051,7 @@ code {
   align-items: center;
   gap: 10px;
   border: 0;
-  border-radius: 8px;
+  border-radius: var(--radius-sm);
   padding: 8px 10px;
   background: transparent;
   color: var(--text);
@@ -1083,7 +1087,7 @@ code {
   gap: 16px;
   border-top: 1px solid var(--border);
   padding: 14px 24px;
-  background: #fafafb;
+  background: var(--surface-muted);
 }
 
 .directory-picker-summary {
@@ -1119,7 +1123,7 @@ code {
   flex-direction: column;
   overflow: hidden;
   border: 1px solid var(--border);
-  border-radius: 18px;
+  border-radius: var(--radius-lg);
   background: var(--surface);
   box-shadow: var(--shadow-modal);
   animation: drawer-in 220ms ease-out;
@@ -1158,7 +1162,7 @@ code {
 
 .run-history-panel {
   border-right: 1px solid var(--border);
-  background: #fafbfc;
+  background: var(--surface-muted);
 }
 
 .section-heading {
@@ -1208,13 +1212,13 @@ code {
 }
 
 .run-list-item:hover {
-  background: #fff;
+  background: var(--surface);
 }
 
 .run-list-item.is-selected {
-  border-color: var(--border);
+  border-color: var(--primary);
-  background: #fff;
+  background: var(--primary-soft);
-  box-shadow: 0 4px 18px rgba(15, 23, 42, 0.04);
+  box-shadow: 0 4px 18px rgba(27, 26, 49, 0.06);
 }
 
 .run-list-main {
@@ -1261,35 +1265,35 @@ code {
 
 .run-error-metadata {
   grid-column: 1 / -1;
-  border-color: #ffd7df !important;
+  border-color: var(--danger-border) !important;
   background: var(--danger-bg) !important;
   color: var(--danger);
 }
 
 .log-viewer-wrap {
   overflow: hidden;
-  border: 1px solid #252c38;
+  border: 1px solid rgba(255, 255, 255, 0.08);
   border-radius: 14px;
-  background: #0d1117;
+  background: var(--theme-dark);
 }
 
 .log-viewer-header {
   display: flex;
   align-items: center;
   justify-content: space-between;
-  border-bottom: 1px solid #252c38;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
   padding: 10px 14px;
-  color: #aab4c3;
+  color: var(--text-tertiary);
   font-family: var(--font-mono);
   font-size: 10px;
 }
 
 .log-streaming {
-  color: #fbbf24;
+  color: var(--warning);
 }
 
 .log-complete {
-  color: #6ee7b7;
+  color: var(--success);
 }
 
 .log-viewer {
@@ -1298,7 +1302,7 @@ code {
   overflow: auto;
   margin: 0;
   padding: 16px;
-  color: #d1d5db;
+  color: var(--text-light);
   font-family: var(--font-mono);
   font-size: 12px;
   line-height: 1.65;

frontend/src/index.css

@@ -1,37 +1,84 @@
+@font-face {
+  font-family: 'Outfit-Medium';
+  src: url('/fonts/Outfit-Medium.ttf') format('truetype');
+  font-weight: 500;
+  font-style: normal;
+  font-display: swap;
+}
+
+/* 正文中文字体：LXGW WenKai（自托管，GB2312 + 常用符号子集） */
+@font-face {
+  font-family: 'LXGW WenKai';
+  src: url('/fonts/LXGWWenKai-Regular.woff2') format('woff2');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'LXGW WenKai';
+  src: url('/fonts/LXGWWenKai-Bold.woff2') format('woff2');
+  font-weight: 700;
+  font-style: normal;
+  font-display: swap;
+}
+
 :root {
-  --bg-color: #f7f7f8;
+  /* 设计令牌：对齐 Alright 主题（nicetheme） */
+  --theme-primary: #3858f6;
+  --theme-primary-soft: rgba(56, 88, 246, 0.1);
+  --theme-dark: #1d2129;
+  --theme-secondary: #2c343c;
+  --theme-muted: #4e5969;
+  --theme-light: #c9cdd4;
+  --theme-border: #eee;
+  --theme-border-soft: #f6f6f6;
+  --theme-bg: #f7f8fa;
+  --theme-success: #4abd86;
+  --theme-danger: #ff3e3e;
+  --theme-warning: #ff8338;
+
+  --bg-color: var(--theme-bg);
   --card-bg: #ffffff;
-  --text-main: #111827;
+  --text-main: var(--theme-dark);
-  --text-muted: #8c939d;
+  --text-muted: var(--theme-muted);
-  --text-light: #b5b9c0;
+  --text-light: var(--theme-light);
-  --primary: #111827;
+  --primary: var(--theme-primary);
-  --primary-hover: #262e3d;
+  --primary-hover: #2f49d6;
-  --border-color: #f0f1f3;
+  --primary-soft: var(--theme-primary-soft);
-  --badge-bg: #f3f4f6;
+  --border-color: var(--theme-border-soft);
-  --radius-sm: 8px;
+  --badge-bg: var(--theme-border-soft);
+  --radius-sm: 6px;
   --radius-md: 12px;
-  --radius-lg: 18px;
+  --radius-lg: 24px;
-  --shadow-sm: 0 2px 8px rgba(0, 0, 0, 0.02);
+  --shadow-sm: 0 2px 8px rgba(27, 26, 49, 0.02);
-  --shadow-card: 0 8px 30px rgba(0, 0, 0, 0.03);
+  --shadow-card: 0 6px 16px 0 rgba(27, 26, 49, 0.03);
-  --shadow-modal: 0 20px 40px rgba(15, 23, 42, 0.08);
+  --shadow-modal: 0 16px 48px rgba(27, 26, 49, 0.08);
   --background: var(--bg-color);
   --surface: var(--card-bg);
-  --surface-muted: #fafafa;
+  --surface-muted: #f7f8fa;
   --text: var(--text-main);
   --text-secondary: var(--text-muted);
-  --text-tertiary: #a4aab3;
+  --text-tertiary: #86909c;
-  --border: #eceef1;
+  --border: var(--theme-border);
-  --success: #10b981;
+  --success: var(--theme-success);
-  --success-bg: #eefbf5;
+  --success-bg: rgba(74, 189, 134, 0.1);
-  --danger: #f43f5e;
+  --success-border: rgba(74, 189, 134, 0.3);
-  --danger-bg: #fff1f2;
+  --danger: var(--theme-danger);
-  --warning: #d97706;
+  --danger-bg: rgba(255, 62, 62, 0.08);
-  --warning-bg: #fffbeb;
+  --danger-border: rgba(255, 62, 62, 0.24);
+  --warning: var(--theme-warning);
+  --warning-bg: #fffbe8;
   --shadow: var(--shadow-card);
+  --transition-base: 0.3s ease-in-out;
   --font-sans:
-    'Plus Jakarta Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
+    'LXGW WenKai', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
-    'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;
+    'Hiragino Sans GB', 'Microsoft YaHei UI', 'Microsoft YaHei',
-  --font-mono: 'JetBrains Mono', Consolas, 'Courier New', monospace;
+    'Source Han Sans CN', sans-serif;
+  --font-display: 'Outfit-Medium', var(--font-sans);
+  --font-mono:
+    SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New',
+    monospace;
 
   color: var(--text);
   background: var(--background);
@@ -42,6 +89,13 @@
   -moz-osx-font-smoothing: grayscale;
 }
 
+h1,
+h2,
+h3 {
+  font-family: var(--font-display);
+  font-weight: 500;
+}
+
 * {
   box-sizing: border-box;
 }
@@ -74,13 +128,17 @@ button:disabled {
   cursor: not-allowed;
 }
 
+::placeholder {
+  color: var(--text-light);
+}
+
 ::selection {
-  background: #111827;
+  background: var(--theme-primary-soft);
-  color: #fff;
+  color: var(--theme-dark);
 }
 
 :focus-visible {
-  outline: 3px solid rgba(17, 24, 39, 0.25);
+  outline: 3px solid rgba(56, 88, 246, 0.28);
   outline-offset: 3px;
 }