frank-fan-818/dsh-f1-skin

dsh-f1-skin 🏁

一个为 DeepSeek Harness Web UI 打造的 F1 赛事控制中心主题皮肤。

CI
License: MIT
DSH

[!IMPORTANT]
这是一个非官方、非商业的开源粉丝项目，与 Formula 1、FIA、DeepSeek
或任何车队不存在隶属、赞助、认可或合作关系。Formula 1、F1、车队名称、
标志、赛车涂装及相关商业外观归各自权利人所有。代码采用 MIT；内嵌照片和
标志不因此转为 MIT，完整来源与再分发条件见
THIRD_PARTY_NOTICES.md。

dsh-f1-skin 是给 DeepSeek Harness Web UI 写的一台「赛事控制中心」。

它把 F1 的转播美学带进你的 AI 工作台：红牛、法拉利、迈凯伦、梅奔四支车队的完整主题，一键切换——每队拥有独立的品牌色、对比度文本、车队性格和专属赛车摄影背景，并完整跟随 DSH 的浅色 / 深色 / 跟随系统三档主题。

与普通换肤不同，它按「设计系统」而非「样式覆盖」来工作：背景场景、阅读材质、工作组件、真实运行状态、车队 DNA 被拆成五个独立层级——照片只负责气氛，文字可读性由局部材质保证，界面运行状态直接映射 DSH 真实的 data-state，不做虚假的 LIVE 播报，也不遮挡任何宿主功能。所有控制（总开关、车队选择、背景强度、文字衬底、模糊、动效）都住在 DSH 官方的「设置 → Formula One 车队」面板里：用总开关随时关掉即可立刻恢复原生外观，卸载则连插件一起移除。

仓库：github.com/frank-fan-818/dsh-f1-skin

实机画面

以下截图来自 DSH Web 0.1.1-rc.2，背景强度 100%、文字衬底 84%、背景模糊
10px；图片没有脱离真实界面单独合成。

| Oracle Red Bull Racing | Scuderia Ferrari |
|---|---|
| Oracle Red Bull Racing 主题 | Scuderia Ferrari 主题 |

| McLaren Racing | Mercedes-AMG Petronas Formula One Team |
|---|---|
| McLaren Racing 主题 | Mercedes-AMG Petronas Formula One Team 主题 |

原生设置页不会浮在输入框上方抢占宿主层级：

Formula One 车队设置页

四套车队主题（红牛 / 法拉利 / 迈凯伦 / 梅奔），每队使用对应的 2024 F1 赛车动态摄影背景。皮肤把背景场景、阅读材质、工作组件、真实运行状态和车队性格拆成独立层级，并继续跟随 DSH 的浅色 / 深色 / 跟随系统三档。

| 车队 | 品牌主色 | 辅助色 |
|---|---|---|
| 🔴 Red Bull 红牛 | #FFC800 红牛黄 | #D90F0F 红牛红 |
| 🟥 Ferrari 法拉利 | #DC0000 法拉利红 | #FFF200 摩德纳黄 |
| 🟠 McLaren 迈凯伦 | #FF8000 木瓜橙 | #47C7FC 迈凯伦蓝 |
| 🟢 Mercedes 梅奔 | #00D2BE 石油绿 | #B4B5B7 梅奔银 |

特性

- 照片优先：赛车摄影是独立场景层；导航、输入、代码和工具结果分别使用局部材质，不再以全局暗幕牺牲背景。
- 主题 token：覆盖 DSH 全部 79 个 --dsw-alias- / --dsw-specific-sidebar-fill 设计变量，通过 theme.overrideTokens 叠加——官方外观三档开关照常工作。
- 组件语言：输入框、消息、推理、工具调用、代码块、菜单和弹层共用精密边线、数据字体和局部状态条。
- 真实状态：直接使用 DSH 的 data-state 表现运行、完成和错误，不显示虚假的 LIVE 或 TEAM RADIO。
- 原生 F1 设置页：通过 DSH 官方 settings.section slot 切换车队，并调整照片强度、文字衬底、模糊和动效；不会悬浮遮挡对话或宿主功能。
- 总开关：设置页最上方的「皮肤总开关」可以随时把皮肤关掉而无需卸载——设计令牌层被撤销、皮肤样式表被移出文档（不是被覆盖），界面立即回到 DSH 原生外观。开关状态存在本机 localStorage，刷新与重启后保持；设置页本身始终保留，所以随时可以再打开，不会变成死路。
- HTTP 照片层：赛车摄影由宿主路由（/plugin-assets/dsh-f1-skin/）以静态文件下发，不再内联进 JS——没有约 2MB 的 data-URI 限制，因此支持 4K 及以上分辨率；红牛背景当前为 4K 摄影原图。
- 自定义壁纸（按车队）：设置页可为每个车队单独上传 JPEG/PNG/WebP（≤25MB）背景；相同图片只存一份（按内容哈希去重）；已上传壁纸库支持随时「应用 / 删除」，删除会同步清掉所有车队对它的引用。选择存于 localStorage，图片文件存于 $DSH_HOME/dsh-f1-skin/custom/。想替换内置背景图，覆盖 assets/cockpits/-broadcast.jpg 后运行 npm run build 即可。
- 记忆：车队、视觉参数与自定义壁纸选择保存在本机 localStorage，刷新后保持。

安装

0. 先安装 DSH CLI

本皮肤是 DSH Web 的插件，不能脱离 DSH 单独运行。请先安装 Node.js 20 或更高
版本，再全局安装与本皮肤兼容的 DSH CLI：

npm install -g @deepseek-ai/dsh@0.1.1-rc.2
dsh --version

版本检查应输出 0.1.1-rc.2。如果 PowerShell 报错
无法将“dsh”项识别为 cmdlet、函数、脚本文件或可运行程序的名称，说明 CLI
尚未安装成功或 npm 全局目录不在 PATH 中。安装后请重新打开 PowerShell；仍然
无法识别时，运行 npm config get prefix，并把输出的目录加入用户 PATH。

如果 PowerShell 提示脚本执行策略禁止运行 dsh.ps1，可将下文命令中的
dsh 临时改为 dsh.cmd。

方式一：npm（推荐）

dsh plugin --profile web add dsh-f1-skin

方式二：GitHub 仓库

dsh plugin --profile web add github:frank-fan-818/dsh-f1-skin

仓库已提交构建产物（lib/client.js 与 lib/cockpits/ 照片），无需安装步骤里的 build 脚本；请确保两者随仓库 / npm 包一起发布。

方式三：下载源码 / ZIP 后本地链接

在解压后的仓库目录执行
dsh plugin --profile web add link:.
Windows 且路径含空格时，dsh 转发器会拆词，改用 pnpm 直装 + 手动 reconcile：
cd $DSH_HOME/profiles/web
pnpm add "link:D:\path\to\dsh-f1-skin"
node D:\path\to\dsh-f1-skin\scripts\reconcile-profile.mjs

安装后重启 dsh web，打开 http://127.0.0.1:3080；前往「设置 → Formula One 车队」切换车队、调节视觉强度，并为各车队上传 / 管理自定义壁纸。宿主照片与壁纸路由在重启后挂载，重启前自定义壁纸的上传 / 列表 / 删除接口不可用。

更新

dsh plugin --profile web update dsh-f1-skin

临时关闭（不卸载）

只想暂时不看赛车涂装时，不必卸载：打开「设置 → Formula One 车队」，用最上方的
皮肤总开关一键关闭。关闭后：

- 设计令牌层被撤销，皮肤样式表被移出文档——不是被覆盖，所以界面立刻回到 DSH
原生外观，浅色 / 深色与「跟随系统」照常工作；
- 车队选择、视觉强度与自定义背景一并置灰，避免出现「点了没反应」的假控件；
- 本设置页仍然保留，开关本身始终可用，随时可以再打开。

关闭状态保存在本机 localStorage（键 dsh-f1-skin:enabled），刷新页面或重启
dsh web 后依然有效。要彻底移除请看下面的「卸载」。

卸载

dsh plugin --profile web remove dsh-f1-skin