Zalpha263/dsh-ui-beautify

dsh-ui-beautify

给 DSH 的 Web 界面换一套更顺眼的外观：配色预设、整页背景图；同时它还是其他插件接入 DSH 官方右侧栏的统一入口。所有改动都存在浏览器本地，随时可以一键还原。

能做什么

- 配色预设：内置四套（默认 / 深海蓝 / 暖沙 / 松石绿），浅色与深色各有适配。切换时不只是换背景和气泡，DSH 界面里的蓝色强调元素（文件夹图标、加载动画、标签高亮、链接等）也会一起换成预设色。
- 整页背景图：上传一张本地图片，插件自动压缩到最长边 2560px 以内，并给上层文字加可读遮罩；侧边栏与主区都会显示。
- 插件面板入口：其他插件通过 sidebarPanel 服务把自己注册成官方右侧栏的标签页。标签条、增删、横向溢出、浮动、分屏、每会话独立状态都由官方负责；本插件只提供统一的注册入口和标签正文的布局契约，不接管任何列几何。
- 随时还原：配色与背景图存在浏览器 localStorage，刷新或重启 DSH 都会自动恢复；「重置全部」回到出厂状态，卸载插件后注入的样式会被移除。

使用说明

所有开关都在 设置 → UI设置：

| 区域 | 控件 | 作用 |
| --- | --- | --- |
| 外观美化 | 配色预设 | 一键切换整套配色；点「默认」还原 DSH 原生蓝 |
| 外观美化 | 选择图片 / 清除 | 上传本地图片作为全页背景，或移除背景图 |
| 外观美化 | 重置全部 | 恢复默认外观并清除已保存的设置 |

3.0.0 起移除了卡片布局引擎，所以「UI设置」里只剩外观美化，布局模式、恢复默认布局这类控件随之消失。

安装

要求：DSH 0.1.5-rc.2 及以上（本插件针对带官方右侧栏的 Web 客户端编写）与 pnpm。

发布态：钉死提交，最稳定
dsh plugin --profile web add github:Zalpha263/dsh-ui-beautify#

开发态：裸目录路径 = link:（源码即部署，改完不用重装）
dsh plugin --profile web add D:/path/to/dsh-ui-beautify

升级与卸载
dsh plugin --profile web install
dsh plugin --profile web remove dsh-ui-beautify

装完重启 DSH，打开「设置 → UI设置」即可。改完源码只需刷新页面（本插件全部逻辑在浏览器侧，无构建步骤）。

常见问题

| 问题 | 原因与解决 |
| --- | --- |
| 「设置」里没有「UI设置」 | 安装后没有重启 DSH；重启后再看 |
| 卡片布局 / 布局模式去哪了？ | 3.0.0 起整体移除：拖卡片要改写官方 AppFrame 的列宽，而那正是官方右侧栏申领的资源，两边互相覆盖就是过去「面板与侧边栏冲突」的根因 |
| 插件面板去哪了？ | 2.0.0 起它不再是独立面板，插件界面成了官方右侧栏的标签页，在右侧栏「开始」页的入口胶囊里点开 |
| 换浏览器 / 清缓存后设置不见了 | 设置存在浏览器 localStorage，属预期行为 |
| 卸载后还有样式残留 | 先硬刷新（Ctrl+F5） |
| 其他插件热重载后界面异常 | 引擎会自动重新接管，最迟 1 秒恢复；仍异常请硬刷新并反馈 |

兼容性

面向 DSH 0.1.5-rc.2 的 Web 界面编写，依赖官方右侧栏标签系统（sidebarRightTabs / sidebar.right.pane.tab）。用户气泡走宿主 token --dsw-specific-bubble；只有会话发送按钮和侧边栏淡出层仍按当前客户端产物的哈希类名覆盖（.uV2eYG_primary / .bhn1Oq_fade，在 0.1.5-rc.2 仍然存在），DSH 大版本升级后建议在「外观美化」里复核这两处。背景图以压缩后的 data URL 存在 localStorage（约 5MB 配额内）。

开发者

单文件实现：Host 半区 lib/index.js 是空壳（仅用于注册），全部逻辑在 lib/client.js。这是手写的 __ModuleLoader__.load 格式、不是构建产物，改完刷新页面即可生效。调色板在 PRESETS 常量里；SHEET 只保留标签正文的布局契约（.dsh-sidebar-panel-host）。三个 effect 分别是外观清理、ctx.provide('sidebarPanel')、以及把已注册面板绑到官方右侧栏的 bindPanelHost。

插件接入规范：docs/plugin-panel-integration.md 是 sidebarPanel（apiVersion = 1）的完整契约。消费方要用 cordis 的可选依赖写法 ctx.inject(['sidebarPanel'], (c) => { const s = c.get('sidebarPanel'); const d = s.registerPanel(def); return () => d() })（回调必须是箭头函数），既不要把 sidebarPanel 写进 inject: [...]，也不要用 ctx.get('sidebarPanel') 做身份比对。改这个 API 时必须同步更新该文档。

更新日志

v3.0.1
- 修复：目标面板里的用户气泡不跟随配色预设（改用宿主 token --dsw-specific-bubble，chat 与 goal 共用），并去掉一处会在宿主重建后失效的哈希类名依赖。
- 修复：SHEET 样式在卸载 / 热重载后残留；背景图超出 localStorage 配额时的回退路径不再自相矛盾（过去会把旧背景写回存储、屏幕与存储长期不一致）。

v3.0.0
- 破坏性变更：卡片布局引擎整体移除（侧栏 / 对话区 / 停靠卡的拖动、吸附、浮动、缩放与布局模式开关全部删除），lib/client.js 从 117KB 降到 32KB；设置里只剩外观美化。

v2.x 及更早
- v2.0.2：修复卡片模式拖不动 / 界面卡死（beginDrag / endDrag 被误删导致 ReferenceError，且发生在 preventDefault 之前）。
- v2.0.1：插件面板挂到官方右侧栏后的布局错乱（宿主统一给出 .dsh-sidebar-panel-host 布局契约）；按面板自身宽度做响应式。
- v2.0.0：dock（v2）与自研面板宿主整体移除，改为注册成官方右侧栏标签页（新服务 sidebarPanel，apiVersion = 1）；修复与官方侧边栏的列宽冲突。
- v1.15.1：修复宿主热重载后布局引擎失效（表现为「更新任意插件后 ui-beautify 整体消失」）。
- v1.14–v1.15：插件面板标签按打开顺序排列、横向滚动标签条；dock API 升 v2。
- v1.13.x：改用正式契约 ctx.provide 对外提供面板服务；修复热重载后的面板消失与拖拽状态残留。
- v1.12.x：卡片布局引擎的几何打磨（列宽保底、缩放下限、溢出与回位）。
- v1.8–v1.11：统一的插件面板（启动器 + 标签页宿主）、五区域吸附、界面归一化到 DSH 设计系统与 Apple HIG。
- v1.4–v1.7：卡片布局引擎上线、接缝线体系、停靠位置白名单与框架重挂载自愈。
- v1.0–v1.3：配色预设 + 整页背景图（自动压缩、持久化）+ 官方 bundle 安装支持。

License

MIT