diff --git a/docs/decisions/0006-visual-theme-and-offline-fonts.md b/docs/decisions/0006-visual-theme-and-offline-fonts.md new file mode 100644 index 0000000..9e05ef9 --- /dev/null +++ b/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。 diff --git a/frontend/e2e/dashboard.spec.ts b/frontend/e2e/dashboard.spec.ts index 6ad661b..5803dfd 100644 --- a/frontend/e2e/dashboard.spec.ts +++ b/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, + }) +}) diff --git a/frontend/index.html b/frontend/index.html index 595f0b3..f4fb96b 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -7,11 +7,19 @@ name="description" content="TaskPilot - Windows 本地定时任务管理平台" /> - - + TaskPilot diff --git a/frontend/public/fonts/Outfit-Medium.ttf b/frontend/public/fonts/Outfit-Medium.ttf new file mode 100644 index 0000000..7ae796b Binary files /dev/null and b/frontend/public/fonts/Outfit-Medium.ttf differ diff --git a/frontend/src/App.css b/frontend/src/App.css index 5ee7afa..5797ddb 100644 --- a/frontend/src/App.css +++ b/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, - border-color 150ms ease, - color 150ms ease, - transform 150ms ease; + background-color var(--transition-base), + border-color var(--transition-base), + color var(--transition-base), + 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; - background: #f7f8fa; + border-color: var(--text-light); + 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, - box-shadow 150ms ease; + border-color var(--transition-base), + 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; - color: #067a56; + background: var(--success-bg); + color: #2b8a63; } .status-disabled, .status-cancelled, .status-skipped { - background: #f3f4f6; - color: #6b7280; + background: var(--badge-bg); + color: var(--text-muted); } .status-queued { - background: #eff6ff; - color: #2563eb; + background: var(--primary-soft); + color: var(--primary); } .status-running { - background: #fffbeb; - color: #b45309; + background: var(--warning-bg); + 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-radius: 8px; + border: 1px solid var(--border); + 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; - background: #fffafb; + border-color: rgba(255, 62, 62, 0.55); + 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); - background: #fff; - box-shadow: 0 4px 18px rgba(15, 23, 42, 0.04); + border-color: var(--primary); + background: var(--primary-soft); + 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; diff --git a/frontend/src/index.css b/frontend/src/index.css index 0b6b5dd..28dfccc 100644 --- a/frontend/src/index.css +++ b/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-muted: #8c939d; - --text-light: #b5b9c0; - --primary: #111827; - --primary-hover: #262e3d; - --border-color: #f0f1f3; - --badge-bg: #f3f4f6; - --radius-sm: 8px; + --text-main: var(--theme-dark); + --text-muted: var(--theme-muted); + --text-light: var(--theme-light); + --primary: var(--theme-primary); + --primary-hover: #2f49d6; + --primary-soft: var(--theme-primary-soft); + --border-color: var(--theme-border-soft); + --badge-bg: var(--theme-border-soft); + --radius-sm: 6px; --radius-md: 12px; - --radius-lg: 18px; - --shadow-sm: 0 2px 8px rgba(0, 0, 0, 0.02); - --shadow-card: 0 8px 30px rgba(0, 0, 0, 0.03); - --shadow-modal: 0 20px 40px rgba(15, 23, 42, 0.08); + --radius-lg: 24px; + --shadow-sm: 0 2px 8px rgba(27, 26, 49, 0.02); + --shadow-card: 0 6px 16px 0 rgba(27, 26, 49, 0.03); + --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; - --border: #eceef1; - --success: #10b981; - --success-bg: #eefbf5; - --danger: #f43f5e; - --danger-bg: #fff1f2; - --warning: #d97706; - --warning-bg: #fffbeb; + --text-tertiary: #86909c; + --border: var(--theme-border); + --success: var(--theme-success); + --success-bg: rgba(74, 189, 134, 0.1); + --success-border: rgba(74, 189, 134, 0.3); + --danger: var(--theme-danger); + --danger-bg: rgba(255, 62, 62, 0.08); + --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, - 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif; - --font-mono: 'JetBrains Mono', Consolas, 'Courier New', monospace; + 'LXGW WenKai', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, + 'Hiragino Sans GB', 'Microsoft YaHei UI', 'Microsoft YaHei', + '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; - color: #fff; + background: var(--theme-primary-soft); + 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; }