dsh-ui-beautify

dsh-UI美化

线上版本 0.6.1，兼容 DSH 0.2.1 与 0.2.2：修复 0.2.2 下侧栏顶部空白、侧栏拖动不跟随、点选历史会话后列表消失、页头与侧栏重叠、正文调宽抖动，并适配新版用户消息气泡、提问回答卡片和宽表格。详见 [0.6.1 发布说明](docs/RELEASE-0.6.1.md)。

为 DeepSeek Harness 提供独立的任务面板、输入栏与侧栏材质，以及背景、主题切换和对话动效。各区域分别配置，默认样式排在材质选项最前面。

设置入口：设置 → dsh-UI美化。仓库、包名和插件标识统一为 dsh-ui-beautify；旧版 dsh-claude-beautify 的本机偏好会自动迁移。代码 MIT；可选鲸鱼娘素材为 CC BY-NC-SA 4.0，详见许可说明。

macOS 的右上工具栏支持独立排序与显示开关，访达 / Finder 与其打开方式菜单作为一组保留；收起侧栏后使用宿主提供的侧栏、新会话按钮。相关兼容处理仅作用于 macOS，Windows 沿用现有布局和按钮逻辑。

[0.4.5 发布说明](docs/RELEASE-0.4.5.md) · [功能详解](docs/FEATURES.md) · [交付与兼容](docs/DELIVERY.md) · [更新记录](CHANGELOG.md) · [安装](#安装与更新) · [来源与许可](THIRD_PARTY_NOTICES.md)

「全局配置」中的内置「默认值」预设可还原全部美化选项和两种窗口宽度，保留已导入素材，并支持撤销上次应用。详见 [恢复默认说明](docs/SETTINGS-RESET.md)。

「全局配置」分类支持导入与导出所有分类、独立黑白主题、自定义 CSS、工具栏和聊天宽度。默认导出轻量 JSON；开启「包含本机素材」后可导出背景、开屏、粒子和自定义动图包的完整备份。导入先查看摘要，支持撤销；素材变更后按提示刷新界面。详见 [配置备份与迁移](docs/SETTINGS-TRANSFER.md)。

新增 全局配置 → 预设市场 子 TAB，与「本机配置」并列：按整套 / 单项、分类、作者与标签发现官方和审核后的社区预设，查看范围后应用，或保存到本机。市场不再自带默认预设；单项预设只调整对应分类。用户可导出投稿 ZIP，在 GitHub 上传后由维护者审核上架；官方预设由维护者单独发布。首次接入新增下载路由需完全退出并重启 DSH。详见 [预设市场与审核流程](docs/PRESET-MARKET.md)。

截图使用合成内容。Artifact 预览见 [截图](assets/screenshots/artifact.png)。

底部的轮次/速度、Token 用量及上下文统计弹层支持平滑展开、退场与连续反向。详见 [统计弹层过渡](docs/STAT-POPOVER-MOTION.md)。

会话页头的文件夹下拉、“…”中的下载 Session 日志 / 反馈，以及更多会话视图菜单支持展开、关闭过渡，保留宿主的应用选择、键盘和点击外部关闭操作。内联菜单仅在活动期间观察对应页头。详见 [页头菜单过渡](docs/HEADER-MENU-MOTION.md)。

主分支新增子智能体与后台任务列表的开合过渡，子智能体入口再次点击可收起。「对话布局 → 思考动图」支持自定义 CSS，内置“自定义思考文案”和“随机思考文案”示例，旧文案自动迁移。使用方式见 [思考动图与 CSS](docs/RUNNING-ANIMATION-PACKS.md)。

左侧栏收起时，边缘箭头旁以小气泡提醒其他会话的完成、待回答和失败状态，各自带独立图形动画；点击或展开侧栏后平滑消失。边缘箭头方向随开合过渡，位于图片放大与宿主弹窗下方，关闭预览后继续可用。详见 [其他会话状态提醒](docs/SIDEBAR-ATTENTION.md)。

兼容 DSH 0.2.2 的历史会话释放通知。宿主释放内存中的会话对象时，插件会先刷新原生列表，持久记录仍存在的会话继续显示并保留选中状态。源码链接安装更新后按 Ctrl+R 加载。

自定义背景下的行内代码、文件附件、文件改动卡片与消息操作会随明暗主题适配，减少突兀白底；原生展开、预览和键盘操作保持一致。详见 [背景下的聊天样式](docs/BACKGROUND-CHAT-SURFACES.md)。

按 Ctrl+F（macOS 为 ⌘F），或点击会话页头的放大镜，可搜索当前会话已加载且展开的聊天内容：关键词高亮、命中计数、前后跳转，Enter / Shift+Enter 切换，Esc 关闭。放大镜默认位于日夜开关右侧，可在「组件布局 → 右上工具栏 → 会话搜索」拖拽排序、上下移动或隐藏；隐藏入口后快捷键仍可用，排列和显示偏好支持配置备份与恢复默认。选中正文再搜索会自动带入选中文字；搜索不会修改消息或草稿。未加载的历史和收起的详情需要先加载或展开。

正文中可点击的文件路径也支持右键，沿用右上输出卡片的打开、打开方式、复制文件、复制路径、打开文件位置、重命名、移到回收站及属性菜单；重命名与删除仍需在菜单内确认。左键继续使用该引用原有的打开方式，普通网页链接保留浏览器右键。上述新增操作在开启美化时生效；源码链接用户按 Ctrl+R 刷新界面即可加载。

功能一览

| 设置分类 | 可以调整的内容 |

| --- | --- |

| 任务面板 | 右上角任务进度、输出文件、工具与资源摘要；悬停预览或点击固定；按当前轮或全部轮次浏览；选择卡片材质、280–480px 宽度、默认 2/3 步和栏目开合。 |

| 输入栏 | 独立选择输入框材质；独立开启小按钮 Lens 玻璃；选择对话是否滚到输入栏后方；保留原生输入、模型选择、录音、发送和停止操作。 |

| 侧栏 | 独立选择侧栏材质和切换动效；左右面板覆盖主屏幕或恢复并排布局；顶部标题、标签与正文对齐，显示实际所属项目；圆角和选中反馈跟随明暗主题。 |

| 开屏欢迎 | 默认 Logo 字符填充；也可导入单文件代码、图片、动图或视频，直接预览。旧版书写模式自动迁移到默认字符 Logo。 |

| 全图背景 | 本机图片、视频与 HTML 素材库；内置 HTML 动态预设「镜海 / 深海极光」（镜海跟随主题切换日间/夜间画面，素材超分到 2560×1440，单份 HTML 上限 4MB）；点击名称或铅笔可重命名；日夜主题分别记住选择、启用状态和上一张；调整可见度、模糊、铺放、位置和视频声音。 |

| 粒子背景 | DeepSeek Logo、鲸鱼娘、自定义图片或 SVG；图片细节优先取点、选图建议和完整成形缩略预览；500–20000 颗粒子；手动调整成形进度，或跟随真实上下文占用；设置开始显示与完整成形阈值；成形后保持粒子漂浮。 |

| 思考动图 | 内置鲸鱼娘 51 个动作；ZIP / 文件夹导入动图包，导入区可直接下载含素材和中文说明的格式示例 ZIP；自由勾选动作，随机或固定播放，调整图标大小、文字间距与“深度求索中……”文案（可填多条随机显示，用 {time} 自定义用时位置）。原独立动图插件可迁移卸载，见[动图包制作与迁移说明](docs/RUNNING-ANIMATION-PACKS.md)。 |

| 对话动效 | 默认、轻盈卡片、极简分隔；用户消息气泡的 QQ 蓝、便签、玻璃和自定义 CSS；艺术字、自定义分隔动图和 CSS；新消息入场预览与开关。 |

顶部另有 日夜主题开关 和 纯背景模式：后者隐藏聊天文字、输入栏、顶部及两侧界面，只保留清晰的背景和粒子。右上角图标或 Esc 可退出，恢复原来的草稿、阅读位置和背景模糊设置。详见 [纯背景模式](docs/BACKGROUND-ONLY.md)。

“组件布局 → 任务面板”设置任务面板。“对话布局 → 欢迎语”设置新会话页面鲸鱼图标后的文字：可使用原始标题、从自定义列表随机选择，或用 JavaScript 根据 context.hour、context.minute、context.day 和 context.theme 返回文字。自定义代码区可载入按时间问候的示例。LOGO 可隐藏、调整大小，或上传 PNG、JPG、GIF、WebP 图片并切回默认鲸鱼；图片保存在本机，完整备份包含图片。可隐藏“预览版”标签并编写 CSS 调整欢迎语样式；图标与文字整体保持居中。设置页提供预览，修改自动保存；代码在本机隔离执行，执行失败时恢复原始标题。

“全局配置”可以给当前设置和素材保存本机预设、命名并快速切换，也提供内置默认值和配置导入导出。素材较多时预设占用更多本机空间，部分素材切换后需要刷新界面。

“对话布局 → 对话动效”可自定义新消息入场：载入当前动效示例后，分别编辑 user、assistant、process 的 JSON 动画帧、时长和缓动，点击应用后用于聊天与播放预览。编辑草稿不会改变当前效果；无效代码不会覆盖已应用设置，也可随时切回默认动效。

顶部标题和「对话 / 轨迹 / 上下文」支持宿主的插槽包装布局，跟随当前可见视图定位；隐藏的聊天和嵌套会话不会把标签带偏。

页签下划线切换时先从两端向旧标签中心收至零，再从新标签中心向两侧展开；总时长 280ms，收拢约 100ms、展开约 180ms，使用不同缓动曲线。连续切换会接续当前宽度和位置，减少动态效果时即时切换。

中间聊天区继续使用 DSH 原生两侧拖动控件调宽，普通窗口与全屏 / 最大化分别记住宽度，切换和刷新后恢复。缩窗时只临时适配当前可用空间，不覆盖已保存宽度；桌面侧栏覆盖模式会为左侧栏预留安全距离，避免正文和输入栏被挡住。窄屏沿用宿主抽屉交互。偏好只保存在当前浏览器来源，桌面与浏览器各自记忆。

设置分类会记住上次选择：关掉设置、刷新或在同一浏览器来源重新打开后继续回到该分类。无效分类回到“任务面板”；本机存储不可用时保留本次窗口内的选择。分类切换支持方向键、Home/End，窄窗口可横向滑动。

设置页的布尔开关统一使用 iOS 式胶囊轨道与白色圆形滑钮，开启跟随宿主主题色，关闭为中性灰；可视尺寸为 44×26px，触控热区至少 44px。暗色主题的材质选中点和信息状态点使用局部静态荧光，未选中点不发光。开关回弹复用统一动效曲线，支持键盘、禁用与焦点状态；减少动态效果时直接切换，强制颜色下使用系统色并去掉荧光。共享控件样式位于 src/settings-controls.js。

进度面板切换「当前轮次 / 全部轮次」或前后轮次时，内容相同就不重播整块刷新动效；选中状态和轮次信息照常更新。

粒子图片推荐透明背景、单一主体、轮廓清晰和明暗对比强的素材。导入后优先采样图中各处的线条与局部细节，不套用固定的人脸位置；彩色底图仍会参与取点，需要预先去底。粒子背景 → 本机图片 下的完整成形缩略预览随粒子数和明暗主题更新，静止后不持续绘制；聊天的转换进度保持独立。已有图片刷新后直接使用新采样，无需重导。

配置两份 HTML 时，先切到日间主题，应用日间背景，再切到夜间主题应用另一份。刷新后分别恢复；关闭或清除只影响当前主题。升级前的 HTML 归入升级时的当前主题，另一侧留空；原有图片、视频沿用到两侧。素材库共用，可见度、模糊等外观参数仍共用。

开屏、背景和用户消息气泡顶部并列标注日夜两套配置、启用状态、当前主题与编辑目标。自定义代码开屏支持“交互完成后结束”，该模式下提供“手势开屏示例”以录入九宫格图案；生成后点击应用保存，始终保留跳过和 Esc。详见 [自定义开屏](docs/CUSTOM-OPENING.md)。

定时与交互代码按日夜主题分成四份，切换恢复各自代码与设置页草稿，应用后持久保存。代码页会把已保存的开屏放进“本机开屏历史”，点击历史卡片即可快速切换。日间／夜间配置卡片可直接切换宿主主题，并与右上角黑白开关同步。Desktop 可使用本机提前引导补丁，从加载插件阶段直接显示自己的开屏，再由正常美化插件接管；补丁须在 Desktop 退出后应用，下次启动生效。

安装与更新

需要 Node.js 22.13+，宿主范围为 DSH >=0.2.1-rc.2 <0.3.0-0。本机实际回归版本是应用归档内的 DSH 0.2.1-rc.2，桌面外壳版本与其不同。运行时使用宿主提供的 React 和服务；构建、测试依赖仅供开发使用。

DSH 版本兼容：最低支持 DSH 0.2.1-rc.2，0.2.1-rc.5 与 0.2.2-rc.1 是当前回归版本。插件按元素、属性和接口是否存在选择新旧写法，不按版本号判断，宿主缺少某项接口时对应功能关闭，插件本身照常激活。已知限制：

• 覆盖式侧栏宽度依次读取宿主的 --dsh-windows-sidebar-width、frame 内联的首列宽度和旧版侧栏根节点宽度，三者都读不到时回退到 280px。拖动时如果侧栏不跟随，可关闭「覆盖侧栏」改用原生并列侧栏。
• 「应用 / 编辑」菜单误触最大化的修复仅适用于 Windows 自定义标题栏。
• macOS 与 DSH 0.2.2 桌面版尚未在实机完成验收。

普通安装：从本仓库 [最新 Release](https://github.com/AumiSatori/dsh-ui-beautify/releases/latest) 获取预构建包 dsh-ui-beautify.tgz，在 DSH 插件页按 URL 安装。插件市场的收录以社区目录审核合并为准。包内已有客户端，不需要在使用者机器上构建，也不要求安装配套插件。

Web profile 也可执行：

dsh plugin --profile web add https://github.com/AumiSatori/dsh-ui-beautify/releases/latest/download/dsh-ui-beautify.tgz

开发者源码链接安装：在长期保留的源码目录克隆仓库，然后进入该目录：