\n English | 中文 \n
\n\n\n\n\nMaterial You (MD3) 动态取色皮肤，面向 dsh web GUI，作为**独立项目**存在——不依赖\nmonorepo、皮肤中心注册表或画廊。克隆到任何位置、构建、一条命令安装即可。\n\n上传任意壁纸，皮肤就从它派生出整套 UI 调色板：Monet 源色提取走\n`@material/material-color-utilities`（Celebi 量化 + Score 排名），由源色相构建\nM3 亮/暗两套 scheme，再映射到 shell 的**全部** token 表面——73 个\n`--dsw-static-*` token（双主题）、写死的交互/滚动条别名、以及标准\n`--md-sys-color-*` 角色。一个都不漏：侧边栏、聊天区、详情区、对话框、菜单、\n滚动条、状态色和每个 currentColor SVG 都跟随壁纸；品牌 logo 被压平到 MD3 主色、\nfavicon 变成 Monet 源色的圆点、aionui 面板（文件树 / git 树 / 预览）经由样式表的\n`--aion-*` 桥使用同一套 M3 角色。皮肤激活期间页面滚动锁定：html 和 body 都不滚动。\n\n同时还带 Material You 有机形状 chrome：四瓣花瓣 FAB（不是普通圆钮），常驻时图标\n为 MaterialYouNewTab 温度计，菜单打开后以 M3 动效（淡入 + 旋转 + 缩放）形变为时钟\n图标。菜单提供**上传壁纸（Split Button，可选导入效果）**、恢复默认、M3 形状系统\n开关（按层级应用 Material 3 圆角语言：胶囊按钮 / 小圆角输入框 / 中等列表行 / 大圆角\n对话框 / xs 悬浮提示与菜单 / 胶囊滚动条——可从菜单关闭）。\n\n皮肤只做表现层：不注入服务、不发射 cordis 事件、不触达任何模型请求。所有写入在\ndispose 时精确回收（body 属性、token 变量、背景、滚动锁、chrome、favicon、标题）。\n\n## 功能一览\n\n围绕「背景」的一条主线：上传任意壁纸后，皮肤从它提取 Monet 源色、生成完整 MD3\n调色板并应用到 dsh 全部 UI。你可以选择**导入效果**——**原图导入**（不处理，直接\n用原图）、**MD3 色彩滤镜**（默认，以源色生成滤镜、按像素明度与原图轻量混合，保留\n画质与细节）或 **Monet 统一色调**（色调重映射）：点击右下角的 **FAB** 打开壁纸\n设置菜单，在上传壁纸按钮右侧的箭头处随时切换，并记住你的选择。整条处理像素最高\n支持 **8K 全分辨率**：像素工作跑在独立 worker（Blob 内联、零额外请求）里，GPU\n优先（WebGPU → WebGL2 回退，与 CPU 参考完全一致），主线程零卡顿；结果持久化到\nIndexedDB、状态到 localStorage，刷新即恢复、dispose 不丢已存壁纸。你还可以开启\n**显示壁纸背景**，让对话区透明、主面板半透明毛玻璃，壁纸透出。\n\n## 环境要求\n\n- Node `^22.19 || >=24`，pnpm。\n- 已安装 dsh（皮肤是面向 `web` profile 的标准 cordis bundle）。\n\n## 构建\n\n```sh\npnpm install # 安装 @material/material-color-utilities + 构建工具\npnpm build # 输出 lib/index.js（node 半区）+ lib/client.js（浏览器 bundle）\npnpm test # vitest：调色板映射 + apply/dispose 契约 + 重着色数学\n```\n\n> build 会在 tsdown 之后运行 `scripts/inline-worker.mjs`，把独立 worker chunk\n> （`lib/recolor.worker.js`）以字符串内联进 `lib/client.js`，供浏览器以 Blob URL\n> 创建 worker——**不要删掉这个 post-build 步骤**，否则重着色会退回主线程路径。\n\n## 手改主题时的热重载\n\n皮肤内置 dev watcher：开着 `pnpm watch`（每次保存 tsdown 重建 `lib/client.js`），\n皮肤每 2 秒轮询自身 bundle URL、对内容做指纹比对，bundle 一变立即刷新页面——\n改个 token、颜色或 CSS 规则、保存，GUI 几秒内重生效。**无需重启 dsh。**\n\n默认开启。关闭方式：\n\n```js\nlocalStorage.setItem(\"dsh.md3Wallpaper.devReload\", \"0\"); // 然后刷新一次\n```\n\n重新开启：删掉该键（或设为 `'1'`）后刷新一次。轮询只在页面可见时进行，interval\n随皮肤 dispose 一起回收。\n\n## 安装 + 激活到 dsh profile\n\n```sh\npnpm install:dsh # 默认 profile：web\npnpm install:dsh headless # 或任意其他 profile 名\n```\n\n脚本会：\n\n1. 把本项目链接进 `~/.dsh/profiles/