dsh-liya-ui-plugin · 莉娅 DSH UI 润色插件

tapIndex 注入 CSS 统一加大圆角，让界面更圆润。radius 可配置： 设置 → 插件 里本插件的配置项可编辑基础圆角（4-48），保存即时生效（host 持久化）。

v0.4.0（2026-10-02）适配 DSH 0.2.0-rc.2：rc.2 移除了客户端 settingsScope 服务与 host 的 ctx.settings.register()。配置改为「插件导出 Config（字段需 .volatile()）+ profile entry id 作 namespace」+ 客户端 ctx.get('configForms')，配置项由原生「设置 → 插件」页自动生成（旧的自定义 settings.plugin.item 卡退役）。本版本起仅适配 rc.2 及以后。

另修（2026-08-17 实锤）：覆盖声明需 !important——host 默认样式（:root{--liya-radius:16px}）注入在 <body> 开头，晚于 head 里的覆盖样式，同特异性按文档顺序后者赢。改完刷新页面即生效。

改了什么

表面	圆角
输入框 / 搜索框（textarea、text/search/email/url）	基础值 + 2px
对话框 [role="dialog"]	基础值 + 6px
菜单 / 下拉 / 提示 [role="menu"/"listbox"/"tooltip"/"combobox"]	基础值

基础值 = 插件配置 radius（默认 16），走 --liya-radius 变量。

原理

• host 半 webServer.tapIndex() 往 index.html 的 <body> 后注入 <style>（官方 ui-theme bootTheme 同款 seam）， radius 用 config.radius（cordis.patch.yml，默认 16）作为启动兜底
• host 半导出 Config = Schema.object({ radius })（字段 .volatile()），namespace = profile entry id dsh-liya-ui； 配置项由原生「设置 → 插件」页自动生成
• client 半 ctx.get('configForms').get('dsh-liya-ui')：用户配置存在时注入 :root{--liya-radius:Xpx} 覆盖 host 默认 （保存即时生效）；未配置/重置时移除覆盖，沿用 host 默认
• 选择器全部走语义 role / 标签，不碰 DSH 的 hash 类名（升级不失效）；!important 才能压过组件内联样式

安装 / 打包

# 安装（装完重启 WebUI 生效）
dsh plugin --profile web add <插件目录>

# 打包归档（产物输出到你的 dist 目录）
pnpm pack --pack-destination <你的插件分发目录>

# 卸载
dsh plugin --profile web remove dsh-liya-ui-plugin

dsh 请替换为你自己 DSH 安装对应的 CLI 调用方式。

装完重启 WebUI 生效（改过 manifest/client 后必须重启）。

调圆角大小

推荐：设置 → 插件 → 找到 dsh-liya-ui-plugin → 改 radius（4-48）→ 保存，即时生效（DSH 0.2.0-rc.2 起配置项由原生插件页自动生成）。 兜底默认值在 cordis.patch.yml 的 config.radius。想细化某个表面，改 index.js 的 radiusCss() 里对应行的系数。

已知边界

• 只覆盖语义 role / 标签选择器能命中的表面；个别组件用了非常规 role 会漏
• !important 覆盖组件内联圆角——如果某处原设计就是刻意的小圆角（如小徽章），会被统一拉大
• 想加更多表面（如卡片/面板）：往 radiusCss() 里加一行选择器，但别用 * 全量（会把圆形元素压扁）

姊妹仓库

同族的其它 DSH 插件（各一个独立仓库）：

• dsh-liya-skin —— 皮肤：壁纸（缩略图选择 + 透明度滑条）+ 星月皮肤层（星带 / 星轨 / 标题栏徽标），素材自备
• dsh-character-emote —— 角色立绘表情：多角色 + 流式情绪自动判定 + 拖拽缩放，素材自备
• dsh-liya-workspace —— 工作区档案速览：FILE-MAP 摘要 / memory·records·diary 统计 / 最近日记
• dsh-liya-archives —— 归档会话抽屉：侧边栏「已归档 (n)」入口，一键恢复 / 复制为新会话 / 移回侧边栏
• dsh-puzzle —— 莉娅拼图：滑块拼图小游戏，agent 可发话 / 换图 / 看进度
• dsh-chess-xq —— 天界象棋：中国象棋人机对战，可悔棋 / 存档 / 调难度
• dsh-dist-manager —— 插件分发目录（dist/）管理：自动归档旧版本 + WebUI 管理页

许可

双许可——文档与代码分开：

• 代码（index.js、client.js 与其它源文件）：MIT —— 拿去用、改、再发，保留版权声明即可。
• 文档（本 README 的正文）：CC BY 4.0 —— 可以自由使用、改编、连商用都行，但要署名（莉娅 / @feverZHONG）并注明来源。

两份许可的全文：LICENSE（MIT）／LICENSE-DOCS（CC BY 4.0）。

---

莉娅（@feverZHONG）· 宇宙美好记录官