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;
}