前言¶
DeepSeek Harness(DSH)客户端里,会话区、侧边栏、菜单和弹窗等多处都带滚动条。官方主题用一条 CSS 变量 --dsh-scrollbar-width 统一控制宽度,默认约 5px,在高分屏或长时间阅读时,轨道偏细时不易点中。改系统或浏览器滚动条样式无法只作用于 DSH 窗口;在主题里手写覆盖又容易和后续客户端更新冲突。
dsh-client-ui-thick-scrollbar 是社区插件,在客户端插件页安装后,通过给 <body> 设置内联的 --dsh-scrollbar-width 全局加粗滚动条,并在插件设置里把宽度调到 4–20px,关闭插件即恢复官方默认,不替换官方样式表。
这是什么¶
- 名称:
dsh-client-ui-thick-scrollbar(npm 包名与安装标识一致) - 维护者:Self-Identity
- 分类:趣味换装(SkillHub 目录)
- 许可:MIT;与 DeepSeek 官方无隶属关系
- 定位:Global scrollbar thickness tuner for the DeepSeek Harness client——全局加粗 DSH 客户端滚动条,宽度可在插件页调节(4–20px,默认 8px)
插件只改一个 CSS 变量,无 Host 服务、无网络请求、不写文件。目标客户端版本为 0.2.1-rc.2(package.json 中 engines.dsh 为 >=0.2.1-rc.2 <0.3.0)。
工作原理(与官方主题的关系)¶
DSH 主题在 body 级定义滚动条宽度,例如:
body { --dsh-scrollbar-width: 5px; }
::-webkit-scrollbar { width: var(--dsh-scrollbar-width); }
本插件把 --dsh-scrollbar-width 写成 <body> 的内联自定义属性,因此所有沿用官方滚动条样式的区域会一起变宽;卸载或关闭插件时移除内联属性,立即恢复官方宽度。插件不修改官方组件实现。
横向滚动条使用同一变量,会同步变粗。若某组件显式隐藏滚动条(例如标签条的 scrollbar-width: none),仍保持隐藏。滑块颜色、圆角与 hover 效果继续跟随官方主题。
安装与启用¶
安装标识须使用资料中的包名与版本,不要自行拼接 GitHub 安装命令。
- 打开客户端左侧 插件 页 → 添加插件;
- 填写安装标识:
dsh-client-ui-thick-scrollbar@1.0.0
也可选择本地源码目录安装(开发场景)。
- 点击 安装 → 立即启用;若提示「改动在下次启动生效」,重启客户端;
- 插件卡片显示 已启用 / 已挂载 即表示已生效。
调节滚动条宽度¶
- 在 插件 → 已安装插件 中打开本插件;
- 在描述与行列表之间找到 滚动条宽度 配置卡片;
- 选择预设 6 / 8 / 10 / 12 px,或在 自定义宽度 中输入 4–20 的整数;
- 保存 后立即生效;恢复默认 回到 8px。
配置界面文案跟随客户端语言(插件提供 locale/zh.json 与 locale/en.json)。
配置存储与升级¶
当前设置保存在渲染进程 localStorage,键名为:
dsh-client-ui-thick-scrollbar.settings.v1
重启客户端后仍保留;清除站点存储会回到默认 8px。从旧包名 dsh-client-ui-scrollbar-tuner 升级时,插件会在首次加载时把旧键迁移到新键,一般无需重新设置宽度。
适用场景与注意¶
适合:希望在 DSH 客户端内统一加粗滚动条、并按个人习惯微调宽度,且不想动官方主题文件的用户。
限制:
- 加粗的是轨道宽度(滑块与轨道一起变宽),不改变官方配色逻辑。
- 插件依赖主题仍使用
--dsh-scrollbar-width这一约定;若未来客户端改名或移除该变量,插件会静默失效,通常不会破坏界面。 - DSH 插件在客户端进程内运行,安装前建议在 GitHub 查看源码与 MIT 许可证,确认符合你的使用环境。
社区插件目录(如 SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系;本文事实以仓库 README 与 package.json 为准。
链接¶
- 目录页:https://www.skillhub.cn/plugins/Self-Identity/dsh-client-ui-thick-scrollbar
- 源码与说明:https://github.com/Self-Identity/dsh-client-ui-thick-scrollbar