简洁界面 Sumnyte/dsh-clean-ui

dsh-clean-ui · DSH 简洁与优化界面

一个为 DeepSeek Harness（DSH）Web GUI 打造的客户端主题插件，小而有个性：更紧凑的对话界面、更沉稳的排版、悬停才出现的 tab 指示条，以及可配置的输入区状态行——内置预设，可选原版外观、作者外观，或自己调。

中文说明 · English

状态：0.2.x beta。 在 Windows 上针对 DSH 0.2.1-rc.3 构建并测试。它是 DOM 级主题，宿主一旦改版，个别功能可能无声失效。安装前请先读兼容性。

把 DSH 的 Web GUI 收紧一档——更紧凑的顶栏、悬停才出现的 tab、可调排版和输入区、可逐项隐藏的右上角按钮与底部状态行，并带「默认 / 作者 / 自定义」预设。

主要功能

- 顶栏：高度可调，tab 悬停浮现，2px 滑动指示条；右上角五个工具按钮可逐项显示/隐藏
- 排版：正文行高、正文字重、标题/加粗字重、正文列最大宽度与占父宽比例
- 输入区：输入卡与正文同宽，输入框最小高度可调；底部状态行可整行隐藏或只留任意几项
- 模式徽章：PTC 模式 / 创造模式 / 标准模式 / 后台任务徽章可显示/隐藏，15px，tab 浮现时渐隐
- 预设：默认外观（完全不动样式）/ 作者预设 / 自定义；Ctrl+Alt+L 打开实时调参面板，配置存本机

浅色主题 · 隐藏 tab 时的 header 与输入区

深色主题 · 同一套布局与可调参数

中文说明

这是一个纯前端的 DSH 插件：宿主半边是空函数，所有效果都在 lib/client.js 里，通过一个 标签 + 若干次受控的 DOM 调整实现。没有依赖、没有构建步骤，也不发网络请求。

它做了什么

预设

- 默认外观：插件完全不动样式，只保留 Ctrl+Alt+L 面板——相当于"恢复用户原来的样子"
- 作者预设：作者调过的一整套参数（42px 顶栏、1.65 行高、370 字重、980px 正文列等）
- 自定义：你在面板里拖出来的参数；拖任意滑块后自动归到这里
- 切换预设会刷新一次页面（见已知限制）

排版

- 对话正文行高、正文字重、标题字重、加粗字重都可调（默认 1.75 / 350 / 500 / 500）
- 段落/列表间距放宽

顶部栏

- 高度压到 50px，去掉底部分界线，改用 mask-image 让内容在顶沿渐隐（深浅色通用）
- 视图 tab 平时隐藏，鼠标移入 header 才浮现（淡入 + 上浮 6px）
- 当前 tab 用一条 2px 圆角蓝条指示：从中间伸长、在 tab 间滑动、移开时缩回
- tab 水平垂直居中；窗口变窄到会和标题碰撞时自动淡出（按实测像素判定，不是固定断点）
- 右上角五个工具按钮（文件资源管理器（含更多打开方式）、更多操作、打开右侧边栏、 展开底部面板、上下文诊断）可逐项勾选显示/隐藏，像底部状态行一样
- 隐藏「更多会话视图」按钮、rc.3 新增的侧栏「更多」项

tab 来源：对话 / 轨迹 由 DSH 自带；上下文 / 编队 是 dsh-context 插件注册的。
本插件只负责把整条 tab 条隐藏/浮现，不区分 tab 来自哪个插件；没装 dsh-context 时自然只会看到前两个。

tab 悬停浮现 · 对话 / 轨迹 / 上下文 / 编队 + 2px 蓝条

侧栏 / 输入区

- 左侧栏文字统一 16px（导航、工作区、会话标题、时间戳）
- 输入框底部的状态行（tok/s、缓存命中、上下文占比）可以整行隐藏，也可以只保留其中任意几项
- 显示状态行时，它上下留白由一个参数控制并保持对称；隐藏时用另一个参数控制输入卡到底部的距离
- 对话正文列可调宽（最大宽度 + 占父宽比例）
- 输入框与正文同宽：输入卡的最大宽度跟随正文列实时测量，两者边缘对齐；可在面板里关掉

隐藏底部状态行

只保留上下文占比的状态行

安装

需要先按 DSH 的插件方式安装
dsh plugin --profile desktop add github:Sumnyte/dsh-clean-ui

或本地链接安装（改代码即时生效，但需要重启 DSH）：

dsh plugin --profile desktop add link:<本仓库绝对路径>

重要：客户端插件在 DSH 启动时构建。装完/更新后请完全退出 DSH（含托盘）再打开。
版本、平台与已验证的宿主组合见兼容性。

卸载

dsh plugin --profile desktop remove dsh-clean-ui

可调参数（CONFIG）

所有开关集中在 lib/client.js 顶部的 CONFIG 对象里，改完重启 DSH 生效：

var CONFIG = {
preset: "custom", // "stock" | "author" | "custom"

lineHeight: 1.75, // 正文行高 bodyWeight: 350, // 正文/列表/表格字重 headingWeight: 500, // 标题字重（默认 700） strongWeight: 500, // 加粗字重

headerHeight: 50, // 顶部栏高度 px titleSize: 17, // 会话标题字号 px headerPaddingTop: 14, // 顶部栏内容整体下移 px tabOffsetY: 8, // tab 条额外垂直微调 px

tabFontSize: 14, // tab 字号 px tabColor: "#5b6169", // tab 常态颜色 barHeight: 2, // 滑动指示条高度 px tabRise: 6, // 浮现时上浮距离 px modeFontSize: 15, // 模式徽章字号 px modeOffsetY: 0, // 模式/任务徽章整体偏移 px

sidebarFontSize: 16, // 左侧栏字号 px

columnMaxWidth: 1400, // 正文列最大宽度 px columnRatio: 0.96, // 正文列占父宽比例

featherStart: -16, // 顶沿羽化：相对 header 底边的起点 px featherEnd: 46, // 羽化终点 px

composerGap: 8, // 隐藏状态行时：输入卡到底部的留白 px statsRowGap: 12, // 显示状态行时：它上下的对称留白 px composerHeight: 72, // 输入区最小高度 px

/* 底部状态行：features.hideStats = true 时整行隐藏；否则只显示 stats 里勾选的项，三项全不选也等于隐藏整行。 /
stats: { speed: true, cache: true, context: true },

/ 右上角五个工具按钮：true = 显示，false = 隐藏 /
topButtons: { explorer: true, more: true, sidebar: true, bottomPanel: true, diagnostics: true },

features: {
hoverTabs: true, // 平时隐藏 tab，悬停 header 才浮现 hideOnCollision: true, // 与标题将碰撞时淡出 tab feather: true, // 顶沿羽化 widerColumn: true, // 加宽正文列 sidebarFont: true, // 放大侧栏字号 hideStats: true, // 隐藏整行底部状态行 hidePtcChip: true, // 隐藏「PTC 模式」「创造模式」「标准模式」等徽章 hideTaskChip: false, // 隐藏「N 个后台任务运行中」徽章 hideViewMore: true, // 隐藏会话视图「更多」 hideMoreNav: true, // 隐藏 rc.3 侧栏「更多」 composerWidth: true // 输入卡与正文列同宽 } };

不想要某个效果，把对应的 features 开关设成 false 即可；想调数值就改上面的常量。

常用开关不必改代码：在 GUI 里按 Ctrl+Alt+L 打开浮动面板，拖动滑块 / 勾选复选框即时生效；配置保存在本机 localStorage。面板顶部是预设行：

- 默认外观 —— 插件不做任何改动（只保留这个面板），等于安装前的 DSH
- 作者预设 —— 作者调过的一整套参数（42px 顶栏、1.65 行高、370 字重、980px 正文列……）
- 自定义 —— 你自己的参数；拖动任意滑块后会自动归到这里

调参面板上半 · 预设 / 顶部按钮 / 滑块

调参面板下半 · 开关 / 状态行 / 默认按钮

切换预设会刷新页面，因为只有重载才能干净地撤掉已经写进 DOM 的内联样式。状态行那一段是：

- ☑ 隐藏整行 —— 勾上就整行隐藏（作者预设默认隐藏）
- 不隐藏时显示：输出速度 tok/s、缓存命中率、上下文占比，任选若干项；三项全部不勾等于隐藏整行
- 状态行上下留白 —— 显示状态行时的单参数滑块：它上面（与输入卡之间）和下面（到窗口底）的留白保持相等（默认 12px，可 0–40）
- 隐藏时下留白 —— 隐藏状态行时输入卡到底部的距离（默认 8px，可 0–30）
- 输入框高度 —— 发送框输入区的最小高度（默认 72px，可 36–160）；调大后输入卡会变高
- 隐藏模式徽章 —— 隐藏「PTC 模式」「创造模式」「标准模式」等徽章；取消勾选即显示
- 隐藏后台任务 —— 「N 个后台任务运行中」单独开关；鼠标移到 header 显示 tab 时，模式徽章和任务徽章会暂时让位隐藏，tab 收起后恢复

顶部按钮那一段是逐项开关（勾选 = 显示）：

- 文件资源管理器（含更多打开方式）、更多操作、打开右侧边栏、展开底部面板、上下文诊断
- 全部可以只留其中几个；隐藏「打开右侧边栏」后，仍可用 Ctrl+Alt+L 打开面板把它勾回来
- 这五个就是会话标题右侧那一排按钮；右侧栏自己的 分栏 / 全屏 / 收起 不在这组里，别混淆

兼容性

- 已验证：DSH 0.2.1-rc.3（Electron 44）/ Windows 11 / 浅色 + 深色主题；同时启用 dsh-ops、dshmarket、dsh-better-sidebar、dsh-context、wallpaper-engine 做过联调
- 未验证：其它 DSH 版本、macOS、Linux、英文/其它语言界面
- 插件靠宿主 DOM 工作：data-slot、data-composer-、data-conversation- 等属性，以及 _markdown_、headerActions、headerUtilities、_split 等类名后缀。宿主改结构或改文案时，对应功能可能静默失效（不会报错，也不会卡住页面）
- 顶部五个按钮（含文件夹 / 更多打开方式）按中文可访问名匹配；非中文界面可能不生效
- 状态行依赖宿主的两块统计（activity / usage）和末尾的上下文占用环；宿主调整统计结构时会失效

已知限制

- 切换预设、以及"恢复默认"会刷新页面；这是移除内联样式最可靠的方式
- 中途禁用插件不会自动撤销已经写进 DOM 的内联样式，需要刷新页面/重启后才会恢复宿主原样
- 「标准模式」徽章和某些 tab 悬停底色由宿主自己的渲染层绘制，不在页面 DOM 内，插件无法隐藏
- 浮动面板只覆盖常用项；其余常量仍需改 lib/client.js 后重启
- 侧栏「更多」由 features.hideMoreNav 控制（默认开，不在面板里；作者预设为关闭）
- 面板文案目前只有中文

安全说明

插件只做两件事：注入一个 标签、设置元素的内联样式与少量元素显隐。
不读取、不上传任何会话内容，不发起网络请求。

一个纯客户端 DSH 插件，重绘 Web GUI 的会话界面外观：50px 紧凑顶栏、悬停才现身的视图标签页配 2px 细滑动指示条、顶部羽化边缘、更克制的 markdown 排版、正文栏与输入框同宽、16px 侧栏标签、可选的输入框状态行，以及逐个按钮的顶栏工具项——内置预设，可选原版外观、作者外观，或你自己的调校。

状态：0.2.x beta。 仅在 Windows 上针对 DSH 0.2.1-rc.3 构建并测试。这是 DOM 层面的主题，宿主一旦改版，个别功能可能静默失效。

预设（面板：Ctrl+Alt+L）

- 默认外观 / Stock — 插件什么都不做（只留面板）；这就是安装前的 DSH 外观
- 作者预设 / Author — 插件构建时调好的快照（42px 顶栏、1.65 行高、370 字重、980px 正文栏、72px 输入框等）
- 自定义 / Custom — 你自己的取值；拖动任意滑块即切到此项
- 切换预设会刷新页面：只有刷新才能干净地移除每一处内联调整

顶栏、标签页与输入框

- 右上角五个工具项——文件资源管理器（含更多打开方式）、更多操作、 打开右侧边栏、展开底部面板、上下文诊断——在面板里各有一个显示/隐藏复选框。
右侧栏自己的 分栏 / 全屏 / 收起 不属于这一组。
- 标签页：对话 / 轨迹 是 DSH 自带的；上下文 / 编队 由 dsh-context 注册。
悬停隐藏作用于整条标签栏，第三方标签页也在内；没装 dsh-context 时只有前两个。
- 输入框卡片按正文栏测量，保持同宽；面板里有「输入框与正文同宽」开关。
- 输入框最小高度可在面板里调（「输入框高度」，36–160px，默认 72）。
- 模式徽章（PTC 模式、创造模式、标准模式）可用「隐藏模式徽章」隐藏或显示； N 个后台任务运行中 标签有独立的「隐藏后台任务」开关。两者在悬停顶栏、标签栏现身时都会隐藏，收起后恢复。
- 标签指示条为 2px（可通过 barHeight 调整）。

安装

sh
dsh plugin --profile desktop add github:Sumnyte/dsh-clean-ui

安装或修改后，完全重启 DSH（托盘 → 退出）——客户端插件在启动时打包。

卸载 sh
dsh plugin --profile desktop remove dsh-clean-ui

兼容性与限制

- 已验证：DSH 0.2.1-rc.3（Electron 44）/ Windows 11 / 浅色和深色主题，同时搭配 dsh-ops、dshmarket、dsh-better-sidebar、dsh-context 和 wallpaper-engine。
- 未验证：其他 DSH 版本、macOS、Linux、非中文界面。
- 主题依赖宿主 DOM 属性（data-slot、data-composer-、data-conversation-*）和几个类名后缀（_markdown_、headerActions、headerUtilities、_split）。
宿主结构或文案一变，功能可能静默失效（不报错，也不卡死）。
- 有几条隐藏规则匹配的是中文无障碍名称，所以在其他语言环境下可能不生效。
- 会话中途禁用插件，不会撤销它已经写入的内联调整；重新加载或重启才能恢复宿主外观。
Stock 预设是官方支持的做法。
- 部分由宿主渲染的外壳（「标准模式」徽标、标签悬停胶囊）位于页面 DOM 之外，插件无法隐藏。
- 面板文案目前只有中文。

隐私： 只注入一个 标签，只切换内联样式——不访问网络，不读取也不上传会话数据。

MIT Licensed。