前言¶
DeepSeek Harness(DSH)的 Web 客户端侧栏、设置页和会话列表,在日常长时间使用时,圆角偏大、间距偏松、悬停卡片频繁弹出,会让视线难以快速扫过工作区与会话。换一套完全不同的主题往往成本高,也难和后续宿主升级对齐。dsh-ui-alt 针对的是这类「还想保留原版气质,只想更冷静、更紧凑」的需求:用 CSS 覆盖加少量 DOM 注入,在设置里逐项开关,关掉即回原版外观。
这是什么¶
dsh-ui-alt 由维护者 AomiRaku 发布,在社区目录中归类为「趣味换装」。当前 package.json 版本为 0.2.13,许可证 MIT。插件不改变 DSH 的业务逻辑,只调整 Web 端可见的排版与交互细节,并在 设置 →「UI 改进」 中为多数改动提供独立开关。
实现上,Host 侧 index.js 的 apply 为空;客户端逻辑集中在 client.js:一大段按 html[data-dcc-*] 条件生效的 CSS,以及三个带 MutationObserver 防抖兜底的 DOM 注入(新会话行、侧栏折叠箭头、设置页返回按钮)。
核心功能¶
下面按 README 中的开关分组说明;默认值以资料为准。
外观¶
| 开关 | 默认 | 效果 |
|---|---|---|
| 隐藏左上角 Logo | 关 | 隐藏侧栏顶部的 Logo |
| Windows 默认微软雅黑字体 | 关 | Windows 端默认字体改为微软雅黑;低分辨率、200% 以下缩放带 hinting;手动设置字体或 macOS 不受影响 |
布局¶
| 开关 | 默认 | 效果 |
|---|---|---|
| 减小圆角与紧凑界面 | 开 | 缩小全局圆角、侧栏部分字号与间距 |
| 统一新会话按钮样式 | 开 | 新会话按钮样式与导航按钮一致 |
| 折叠侧栏导航功能 | 开 | 侧栏导航可点击箭头展开收起 |
| 弱化工作区名称 | 开 | 工作区名称弱化,便于与会话区分 |
| 会话前圆点 | 开 | 会话行前显示圆点 |
| 移除工作区与会话悬停提示 | 开 | 悬停侧栏工作区、会话时不再弹出详情卡片 |
| 隐藏会话悬停多余按钮 | 开 | 悬停会话行仅保留菜单和置顶;若某插件按钮不在右键菜单中可关闭此项 |
| 设置面板全屏 | 开 | 使用非窗口化的设置页面 |
另有一些不挂开关的固定样式,例如设置导航列宽 220px、归档会话标题删除线、浅色主题下选中会话背景加强等。若同时安装了 @michengai/dsh-archive-manager,插件内有与收藏星标避让相关的 CSS 规则才会生效。
安装与启用¶
DSH 以 link 方式将本仓库登记到 profile,目录需保留在原绝对路径;移动或删除前请先卸载。
在 DeepSeek Harness 插件管理器中,对本仓库目录执行:
plugin_manager install_bundle target=<本仓库绝对路径>
安装后刷新 Web 页面。设置里会出现「UI 改进」一栏,侧栏设置导航会出现对应图标。
本地修改 client.js 后需重新安装并刷新,例如:
plugin_manager remove_bundle target=dsh-ui-alt
plugin_manager install_bundle target=<本仓库绝对路径>
典型用法¶
- 完成安装并刷新页面后,打开 设置,进入 UI 改进。
- 按需开关「减小圆角与紧凑界面」「折叠侧栏导航功能」等项;每项关闭后对应区域恢复宿主默认外观。
- 若侧栏滚动仍因宿主 HoverCard 预览感到卡顿,可开启「移除工作区与会话悬停提示」;滚动时鼠标划过会话行仍可能触发宿主预览,插件未干预该行为。
开关状态写在浏览器 localStorage 的键 dsh-ui-alt:prefs:v1 下,并映射到 html 上的 data-dcc-* 属性,例如 data-dcc-radius、data-dcc-nav(collapsed / expanded)等,供 CSS 选择器使用。
适用场景与注意¶
适合长期用 DSH Web 界面写提示词、切换会话、整理工作区的开发者,希望界面更专业、易读,又不愿整体换肤。
安装前建议自行阅读 GitHub 仓库 源码与 MIT 许可证。插件在 当前 DSH 进程权限 下运行,属于客户端 UI 注入,不替代对宿主版本与安全策略的判断。
已知限制(来自 README):克隆出的新会话行没有原按钮的 Tooltip 与快捷键提示,点击已转发至原按钮;关闭「统一新会话按钮」时,折叠导航计数可能偏移一项,显示仍正常;样式依赖宿主 CSS module 类名、设置面板 DOM 结构及 --dsw-* 等主题 token,宿主大版本升级后个别条目可能静默失效。
结尾¶
dsh-ui-alt 在保留原版 UI 大风格的前提下,用可逐项回退的改动收紧侧栏与设置页。目录与源码可从社区页 dsh-ui-alt 与 GitHub 获取。