@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 校验三处一致）

每套主题 ~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 动态版。