This commit is contained in:
zhongluofeng committed 2026-09-25 18:23:56 +08:00
1 parent 79bded1cd2
commit 9e6d73e191
73 files changed
+6229 -1427

No files matched your search

+44 -3
View File
@@ -62,8 +62,12 @@ shadcn 既有(值调整) → --background / --foreground / --primary / --c
--card: #FFFFFF; /* 卡片 / 面板 */
--popover: #FFFFFF; /* 浮层 */
--subtle: #F0F0F2; /* 次级填充:搜索框底、分段控件槽、代码块 */
--hover: #EBEBED; /* 幽灵控件 hover */
--hover: #EBEBED; /* 通用中性 hover:按钮、菜单项、数据表、导航 */
--active: #E4E4E7; /* 幽灵控件 active */
--row-hover: #EBF3FB; /* 内容行 hover(= primary 8% 混入 card,随主题色变) */
--row-selected: #D9E8F7; /* 内容行选中(= primary 15% 混入 card) */
--row-hover-veil: color-mix(in srgb, var(--primary) 16%, transparent); /* mica 弹窗行 hover */
--row-selected-veil: color-mix(in srgb, var(--primary) 30%, transparent); /* mica 弹窗行选中 */
/* ── 描边 ───────────────────────────── */
--border: #E4E4E7; /* 卡片外框、输入框 */
@@ -124,6 +128,9 @@ shadcn 既有(值调整) → --background / --foreground / --primary / --c
--subtle: #26262B;
--hover: #2C2C32;
--active: #33333A;
--row-hover: #1F2B3A; /* = primary 11% 混入 card(深色下用更高强度) */
--row-selected: #213E5C; /* = primary 26% 混入 card */
/* --row-*-veil 刻意不在此重写:半透明叠在壁纸上,深浅由 --primary 自动决定 */
--border: #2E2E34;
--border-strong: #3A3A42;
@@ -313,6 +320,11 @@ shadcn 既有(值调整) → --background / --foreground / --primary / --c
深色模式**单独派生一套**(深底上要提亮),不能复用浅色值。
行高亮这一族(`--row-hover` / `--row-selected` / `--row-hover-veil` / `--row-selected-veil`)
**不在这 7 个之内**:它们在 `style.css` 里写成 `color-mix(..., var(--primary) ...)`,
而 `--primary` 的行内覆盖是惰性求值的,所以换主题色时自动跟着变,
不需要进 `theme.ts` 的派生组,也不需要新增断言。
#### 关键技术点
1. **用 OKLCH 做派生,不要用 HSL。**
@@ -592,11 +604,40 @@ useModuleTabs('proxy', activeTab, tabs, { alwaysVisible: true })
| 主按钮 | `--primary-hover`(变深) | `--primary-active` |
| 次按钮 / 卡片 | `--hover`(中性加深) | `--active` |
| 幽灵按钮 / 图标按钮 | `--primary-soft` + `--primary-soft-text` | `--primary-soft` |
| 列表行 / 菜单项 | `--hover` | — |
| 选中行 / 选中 Tab | — | `--primary-soft` |
| 内容列表行 / 选项卡片 | `--row-hover`(主题色弱底) | — |
| mica / acrylic 弹窗内的行(快速面板、托盘菜单) | `--row-hover-veil`(半透明蒙层) | `--row-selected-veil`(按下/光标) |
| 菜单项 / 数据表行 / 导航 / 分段 / 折叠头 | `--hover` | — |
| 选中行 | — | `--row-selected` |
| 选中 Tab | — | `--primary-soft` |
**焦点环**全应用统一:`ring-2 ring-ring/40`。hover ≠ selected:hover 表达"可以点",selected 表达"已经选中",后者才用强调色。
**内容行 vs 通用中性(2026-09 修订)**
`--hover` 与行高亮的分工,不是"哪个好看",而是语义:
| | 用 `--hover`(中性) | 用行高亮(主题色) |
|---|---|---|
| 判断依据 | 控件本身可点,不承载数据对象 | 一行/一卡承载一个**对象**(歌曲、任务、主机、密钥、设备、剪贴项) |
| 典型 | 按钮、菜单项、代理连接表、侧栏、Tab、设置行 | 音乐列表/队列/歌单/搜索结果、任务列表、主机/密钥/shell 卡片、监控设备项、历史命令、剪贴板条目、快速面板与托盘菜单条目 |
**四种值的选择(2×2)**
先问两件事:**是不是"一行一个对象"** → 否则用 `--hover`;**这一行坐在什么底上** → 决定用哪一对:
| 行所在的面 | hover | 选中 |
|---|---|---|
| 不透明(卡片、面板、弹窗自带底色) | `--row-hover` 8% / 11% | `--row-selected` 15% / 26% |
| mica / acrylic 糊化层(行直接画在壁纸上,窗口无自身底色) | `--row-hover-veil` 16% | `--row-selected-veil` 30% |
五条硬约束:
1. **不能全局把 `--hover` 改成主题色**。次按钮 hover 会与幽灵按钮(`--primary-soft`)撞色,菜单项与数据表整片变蓝,按钮层级和"hover 中性"的既有观感一起塌。必须是新增 token 分开用。
2. **行选中不能用 `--primary-soft`**。`--primary-soft` ≈ primary 10% 混白,和 8% 的 `--row-hover` 只差 2 个色阶,悬停已选中项时看不出区别 —— 这就是 `--row-selected`(15%)存在的原因。`--primary-soft` 留给"选中 Tab / 幽灵按钮 hover"。
3. **透明面上的行必须用 veil 而不是不透明色**。不透明浅底在糊化层上会变成一块"贴上去的白块",并盖掉 mica 质感;半透明会与壁纸自然叠合(浅壁纸偏浅、深壁纸偏深),因此 veil 只在 `:root` 定义一次,不在 `.dark` 重写。veil 也明显更重(16% vs 8%)—— 不透明的 8% 放到壁纸上基本看不见;但也不能一路加重,20% 起就偏"罩住"了,16% / 30% 是实测的手感点。
4. **禁止在内容行上继续用 `--accent/40 ~ /60`**。半透明中性灰在白卡上只有 3% 明度差,等于 hover 无效——这是本次修订要清掉的存量问题。
5. **选中态必须显式盖过 hover**。二者的 CSS 特异性经常是平的或反过来:纯 CSS 里 `:hover`((0,2,0))高于单类((0,1,0)),要写 `.sel:hover` 同规则;Vue 里静态的 `hover:bg-row-hover` 不能和条件类的 `bg-row-selected` 并存,必须写成三元互斥(见 `SftpPanel.vue` 文件表格与 `TrackItem.vue`)。
**状态点**
```