Dsh-Client-UI-Custom

中文 · English

---

中文

简介

Dsh-client-ui-custom 是一个纯前端插件，它为用户提供了浮动历史记录条、用户消息md渲染、外观调试、插件市场、快捷键、用量统计和动效功能。

• 修改了通用设置项 —— 在「设置 → 通用」里新增了历史记录条（位置、数量）和用户消息 Markdown 渲染开关；
• 修改了插件项 —— 在「设置 → 插件」里新增了「插件市场」；
• 新增了四个设置页 —— 「外观」「快捷键」「用量统计」「动效」。

所有功能默认关闭，不配置时保持与原生界面一致，全程零 shell 改动。

宣传视频

▶ 点击观看插件宣传视频（B 站）

功能选择（按需安装）

插件由七个相互独立的功能模块组成：appearance（外观）、shortcuts（快捷键）、 usage（用量统计）、history（历史记录条）、markdown（用户消息 Markdown 渲染）、marketplace（插件市场）、motion（动效）。可在插件配置里用 features 白名单选择要安装的功能：

- id: ui-custom
  name: '@ha-na-bi/dsh-client-ui-custom'
  config:
    features: [shortcuts, usage]   # 只安装「快捷键」+「用量统计」

features 缺省或为空时，七个功能全部启用。

---

设置改动一览

位置	类型	内容
设置 → 外观	新增页面	主题定制，包括壁纸、玻璃、强调色、表面不透明度、字体与质感
设置 → 快捷键	新增页面	自定义快捷键，包括新建对话、切换模型、思考强度等
设置 → 应用用量	新增页面	用量统计，使用四窗口聚合、趋势图，展示会话用量排行
设置 → 动效	新增页面	对话/侧边栏/新建对话入场动效与选中框动效，含三套一键预设
设置 → 通用	修改原有页	新增浮动历史条（可调节位置，数量）、用户消息 Markdown 渲染开关
设置 → 插件	修改原有页	新增「插件市场」，收录第三方插件目录

---

外观（设置 → 外观）

外观设置提供给用户极大的自定义空间，用户可根据自己需求选择背景、玻璃档位、强调色（可自动从 背景取色）、各表面不透明度、色调渐变、暗色遮罩、字体与字号、主题色滚动条 与内嵌晕影，并可把 ui-theme 的主题偏好（浅色 / 深色 / 跟随系统）合并进本 栏。改动通过 ui-custom settings 命名空间保存并即时生效（主题实时重渲染， 无需重启）。

预览—— 主题定制支持小窗预览。

也支持全屏预览，按 F2 即可退出。

预设（Preset） —— 插件内置了六种预设，每个预设都有独立的风格（预设可独立生效，你自己的 wallpaper 仍会叠加在它之下）：

id	名称	风格
ink-teal	Ink Teal 黛青	青玉色渐变，静谧沉稳
ink-blue	Ink Blue 黛蓝	黛蓝渐变，深邃克制的蓝
dusty-rose	Dusty Rose 藕荷	藕荷色渐变，温润柔和的粉
apricot-gold	Apricot Gold 杏金	杏金色渐变，温雅低调的金
mist-gray	Mist Gray 雾灰	雾灰色渐变，清冷安静的灰蓝
ink-violet	Ink Violet 墨紫	墨紫色渐变，沉静神秘

更多美术选择后续会扩展进这份列表 —— 见 src/client/presets.ts。

玻璃档位 —— glass 是透明度的开关；显式设置 wallpaperBlur 时总是优先于档位的默认半径：

档位	模糊	饱和度	气质
off	0px	1.0	不透明，无玻璃
light	6px	1.15	轻微玻璃
frosted	14px	1.25	强毛玻璃（默认）
mica	22px	1.1	柔和静态质感，保留壁纸色相

主题配置项 —— 所有字段均可选；显式配置永远优先于预设：

键	类型	默认值	含义
preset	string	''	预设 id（见上表）；'' = 不使用预设
wallpaper	string	''	壁纸 URL/路径（Web 可访问）；空字符串 = 插件保持关闭
wallpaperBlur	number 0–60	玻璃档位默认	#root 模糊半径（px）；显式值优先于玻璃档位
glass	enum	frosted	off / light / frosted / mica（见玻璃档位表）
accent	string	#4176e6	强调色，整套 deepseek 色阶由它派生
autoAccent	boolean	false	从壁纸自动派生强调色（成功后覆盖 accent）
surfaceOpacity	number 0–100	100	主表面不透明度（聊天/细节列）
sidebarOpacity	number 0–100	100	侧栏不透明度
chatSurfaceOpacity	number 0–100	100	聊天列不透明度（经 --dsw-chat-surface）
inputOpacity	number 0–100	100	输入框不透明度
codeBlockOpacity	number 0–100	100	代码块/行内代码不透明度
darkSurfaceOpacity	number 0–100	surfaceOpacity	暗色模式表面不透明度（独立档位）
gradient	string	''	亮色模式下叠加在壁纸上的渐变；空 = 无
darkScrim	number 0–100	0	暗色模式下壁纸上的遮罩强度
fontFamily	string	''	字体栈覆盖；空 = 主题默认
scrollbarAccent	boolean	false	滚动条使用强调色
vignette	boolean	false	应用根节点的柔和内嵌晕影
customCss	string	''	原样追加的自定义 CSS（逃生舱）
customVars	object	{}	额外写到 <html> 上的 CSS 自定义属性（逃生舱）

完整示例：

…