DSH Semi UI 共享包
@tnnevol/dsh-semi-ui 是插件工作空间内部的共享 UI 包。它封装 Semi Design 组件，并把组件颜色、边框、圆角、浮层和选中状态映射到 DSH 主题变量。
它是被插件依赖的包，不是 DSH 运行时插件，不需要加入 dsh.profile.bundles。当前工作空间版本为 5.3.1，尚未单独发布到 npm。
想先看组件效果，可以打开文档站的组件预览（无需安装），或安装组件总览展示插件在 DSH 中检查真实交互。
为什么单独维护
Codex Auth 和 fnOS 插件都需要按钮、浮层、树和选择器。统一封装后，两边不再各自覆盖 Semi 样式，亮色、深色和后续组件调整只需维护一处。
插件 UI 的组件选型和主题接入是强制规范，见插件 UI 规范。
组件
| 分类 | 导出 |
|---|---|
| 操作 | DshButton、DshIconButton |
| 浮层 | DshModal、DshDropdown、DshTooltip |
| 选择 | DshCascader、DshTreeSelect、DshTree |
| 图标 | 文件、文件夹、关闭、设置、更新日志等插件常用图标 |
| 主题 | installSemiDshTheme()、SEMI_DSH_THEME_ATTRIBUTE |
组件仍按需导入。共享包不会自动把整套 Semi UI 挂到 DSH 全局。
主题接入
插件客户端启动时安装主题桥接，并在卸载时清理：
ts
import { installSemiDshTheme } from '@tnnevol/dsh-semi-ui'
export function apply(ctx) {
ctx.effect(() => installSemiDshTheme(), 'plugin: Semi DSH theme')
}主题层使用 DSH 的语义变量，不自行判断浅色或深色。主要覆盖范围包括：
- 背景、文字、边框和阴影；
- 主按钮的黑白反色；
- Dropdown、Tooltip、Modal 等浮层；
- Cascader、Tree 和 TreeSelect 的选中、半选、悬停与滚动；
- fnOS 文件选择和 Codex 全局模型选择器的局部样式。
气泡浮层的磨砂背景
DSH 的 --dsw-specific-menu 从 0.2.0-rc.2 起是半透明色（浅色 #f8f9fa94、深色 #43454a73）。任何直接用它当背景、却不加背景模糊的表面都会看穿背后内容，所以气泡类浮层必须成对使用官方变量：
scss
background: var(--dsw-specific-menu);
backdrop-filter: var(--dsw-menu-backdrop-filter, blur(40px) saturate(150%));两点注意：
-webkit-backdrop-filter要单独放在@supports规则里。它与标准属性写在同一个声明块时会被构建去重成后者，产物中前缀声明会消失；Safari 18 之前只认前缀写法。- 该样式表会被内联进消费插件的产物，改完需要重建这些插件，不能只构建本包。
回归测试 tests/frosted-overlays.spec.ts 断言的是构建产物 lib/style.css，用于覆盖上述两个坑。
开发
sh
pnpm --filter @tnnevol/dsh-semi-ui run check两个插件的 prebuild 会先构建该包。新增共享组件时，应从 src/index.ts 明确导出，并同时检查 Codex Auth 和 fnOS 插件构建，避免工作空间链接仍指向旧产物。