主题画廊 Yinxe/dsh-custom-ui

@dshp-inx/custom-ui —— DSH 定制 UI 套件

主题画廊是第一个模块：23 套主题（14 套品牌适配 + 9 套原创）+ 设置内一键切换。后续字体、布局、交互等定制模块都归入本包。

主题清单（label/desc/swatch 以 lib/themes//meta 为准；token 单源 lib/themes/，Host 经 GET /themes 下发，client 只存 meta——改色只改 lib，跑 scripts/check-themes.mjs 校验三处一致）

| 主题 id | 模式 | 风格 | 来源 |
| opencode-terminal-dark | 纯暗 | 暖黑 #201d1d + Apple 蓝 + 全站 Berkeley Mono | opencode-ai |
| opencode-terminal-light | 纯亮 | 暖白 #fdfcfc 纸感 + 暖灰层次 | opencode-ai |
| linear-dark | 纯暗 | 近黑 #08090a + Indigo #5e6ad2，半透明白边框 | linear-app |
| notion-light | 纯亮 | 纯白 + 暖灰 + Notion Blue，whisper 边框 + 微阴影 | notion |
| claude-parchment-light | 纯亮 | 羊皮纸 #f5f4ed + 赤陶 #c96442，ring 型深度 | claude |
| nvidia-dark | 纯暗 | 纯黑 #000 + 信号绿 #76b900（悬停绿→青惊喜） | nvidia |
| github-dark | 双模式 | #0d1117 + Primer 蓝 #2f81f7 + 绿色主按钮 | github |
| github-light | | 纯白 + #0969da + 发丝线 #d0d7de | github |
| replicate-light | 纯亮 | 纯白 #ffffff + 品牌红 #ea2804，全站胶囊感 | replicate |
| cisco-dark | 纯暗 | 藏青 #0f1720 + 信号蓝 #049fd9，企业级深色 | cisco |
| neobrutalism-light | 纯亮 | 奶油 #fff4cf + 橘红 #d24b1f，硬偏移阴影 | neobrutalism |
| mission-control-dark | 纯暗 | 深空 #090b12 + 指挥蓝 #60a5fa，霓虹青点缀 | mission-control |
| levels-light | 纯亮 | 米纸 #fbf7ef + 代谢绿 #2f8f46 | levels |
| arc-light | 纯亮 | 蜜桃 #fdf3ec + 珊瑚 #ff5f5f | arc |
| luxury-dark | 纯暗 | 曜石 #080706 + 鎏金 #c6a15b | luxury |
| skeumorphism-light | 纯亮 | 陶土 #f7eee6 + 陶釉 #b46a46，柔和拟物阴影 | skeumorphism |
| wechat-light | 纯亮 | 浅灰 #ededed + 微信绿 #07c160 | wechat |
| xiaohongshu-light | 纯亮 | 米灰 #f5f5f5 + 种草红 #ff2442 | xiaohongshu |
| discord-dark | 纯暗 | 深灰 #313338 + Blurple #5865f2 | discord |
| supabase-dark | 纯暗 | 墨黑 #171717 + 翡翠绿 #3ecf8e | supabase |
| nebula-dark | 纯暗 | 紫黑 #0d0a1a + 霓紫 #8b5cf6（原创） | 原创 |
| sakura-light | 纯亮 | 樱白 #fff9fa + 樱粉 #e75480（原创） | 原创 |
| tide-dark | 纯暗 | 深青 #062a2c + 潮汐 #2dd4bf（原创） | 原创 |

每套主题 ~110 个 --dsw- token 全量映射：背景 / 边框 / 品牌 / 按钮 / 交互态 / 文字 / 语义色 / Markdown / 滚动条 / 侧栏 / 气泡 / 浮层 / 阴影 / 字体栈。

结构

dsh-custom-ui/
├── package.json # @dshp-inx/custom-ui，dsh.client 声明 ├── cordis.patch.yml # bundle 挂载行 ├── lib/ │ ├── index.js # Host 半：settings 持久化 + 同源路由（state/themes/theme/config）+ 主题 allowlist（动态派生自目录） │ ├── shared.js # Host 三件套（settingsNamespace/json/sameOrigin/readBody，六插件逐字相同） │ └── themes/ │ ├── index.js # 主题目录聚合（THEME_CATALOG） │ ├── shared.js # 字体栈常量 + 字体 token 批量填充 + FLAT_SHADOWS │ ├── opencode.js # OpenCode 双模式（dark + light） │ ├── linear.js # Linear 纯暗 │ ├── notion.js # Notion 纯亮 │ ├── claude.js # Claude 纯亮 │ ├── nvidia.js # NVIDIA 纯暗 │ └── github.js # GitHub 双模式 │ ├── replicate.js # Replicate 纯亮 │ ├── cisco.js # Cisco 纯暗 │ ├── neobrutalism.js # Neobrutalism 纯亮（硬阴影例外） │ ├── missioncontrol.js # Mission Control 纯暗 │ ├── levels.js # Levels 纯亮 │ ├── arc.js # Arc 纯亮 │ ├── luxury.js # Luxury 纯暗 │ ├── skeumorphism.js # Skeumorphism 纯亮（柔和阴影例外） │ ├── wechat.js # WeChat 纯亮 │ ├── xiaohongshu.js # 小红书 纯亮 │ ├── discord.js # Discord 纯暗 │ ├── supabase.js # Supabase 纯暗 │ ├── nebula.js # Nebula 纯暗（原创） │ ├── sakura.js # Sakura 纯亮（原创，柔粉阴影） │ ├── tide.js # Tide 纯暗（原创） │ ├── photo.js # 壁纸 MD3 引擎（seed→ref 调色板→sys→DSW，含 MD3 导出） ├── scripts/ │ └── check-themes.mjs # 三处一致性校验（lib 目录 / Host allowlist / client 画廊 meta） └── client.js # Client 半（__ModuleLoader__：画廊 UI；只存主题 meta，token 按需问 Host 要）

主题数据单源 lib/themes/（规范源码，ESM、带注释）。client 半无法 require 本地 lib，主题 token 由 Host 经 GET /ext/dshp-inx-custom-ui/themes 下发（内存缓存一次）；client 只保留 id/colorScheme/label/desc/group/swatch，卡片渲染走 swatch。新增主题三步：lib/themes/ 加一文件 → lib/themes/index.js 加 import + expand → client THEMES 加一条 meta，然后跑 node scripts/check-themes.mjs。

挂载

cd ~/.dsh/profiles/web
pnpm add --offline "@dshp-inx/custom-ui@link:../../plugins/dsh-custom-ui"
rm -rf node_modules/@dshp-inx/custom-ui
ln -s "$HOME/.dsh/plugins/dsh-custom-ui" node_modules/@dshp-inx/custom-ui
cordis.patch.yml 已由 bundle 自带（cordis.patch.yml），profile 层无需再插行重启 dsh web

使用

设置 → 外观定制（两块）：

- 主题画廊：色卡预览 + 点击即切，theme/change 事件驱动"使用中" 徽标实时跟随；内置浅色/深色也可在画廊顶部查看当前态并随时切回。
- 壁纸取色（Material You）：独立配置区，不占主题卡片位。上传壁纸→ 提取 seed→生成 5 组 ref 调色板 × 亮/暗 sys 色彩，色调条 + 角色预览，一键启用；复制 MD3 导出 --md-ref-palette- + --md-sys-color--light/dark （与 MD3 令牌命名兼容，可直接用于 MD3 项目）。持久化只存 seed（兼容旧数据）。
- 全局圆角：三档（-1 跟随主题 / 0 全锐角 / 12 统一圆润），保存即生效，无需刷新。
- 背景与外观（壁纸上传/视频/毛玻璃）：已退役（见 aebe395）。settings.yaml 里残留的 wallpaper./glass. 仅做不透明透传保留数据，不再有 UI；取色请用上面的壁纸取色（MD3 动态配色）。

持久化

官方 theme 服务的 settings schema（ui-theme.preference）只接受 light/dark/system——自定义主题 id 只写内存，重启即丢。本插件补上持久化：

- Host 半：注册 dshp-inx-custom-ui settings 命名空间（settings.yaml 顶层，themeId/photoPalette/radius 字段；退役的 wallpaper/glass 仅透传保留），同源路由 GET /ext/dshp-inx-custom-ui/state（偏好快照）、 GET /ext/dshp-inx-custom-ui/themes（目录全量 token 下发）、 POST /ext/dshp-inx-custom-ui/theme（切主题）、 POST /ext/dshp-inx-custom-ui/config（圆角/取色）
- Client 半：启动时读 state 恢复主题（注册完成后再 setTheme，静默容错）；画廊点击时先 setTheme 再 POST 保存，保存失败会提示（重启后回退内置偏好）
- 清空持久化：把 settings.yaml 里 dshp-inx-custom-ui.themeId 置空串，即完全跟随官方外观偏好（system/light/dark）
- 白名单校验：Host 半只接受目录内的 23 个主题 id（+ 虚拟 photo:custom），未知 id 拒写

已知限制

- 动态插件版（会话内 cordis_define）与静态版并存会 WEB_DUPLICATE_PROVIDER，静态挂载前先 cordis_undefine 动态版。