Skip to content

dsh-ui-alt

Verified

dsh-ui-alt · v0.2.89 · MIT · Web UI

在保持原版 UI 大体布局不变的情况下,进行减小圆角、紧凑化、整洁化、高效化改进,使 UI 视觉更加冷静、专业、高效。同时添加余额显示。大部分改动可在设置中单独开关。

Install

dsh plugin add dsh-ui-alt

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

dsh-ui-alt

在保持原版 UI 大体布局不变的情况下,进行减小圆角、紧凑化、整洁化、高效化改进,使 UI 视觉更加冷静、专业、高效。同时添加余额显示。大部分改动可在设置中单独开关。

插件由 CSS 覆盖加少量 DOM 注入组成,所有改动都可以在 设置 →「UI 改进」里逐项开关;关掉开关即恢复原版外观。

功能

外观

开关 默认 效果
隐藏左上角 Logo 关 隐藏侧栏顶部的 Logo
Windows 默认微软雅黑字体 关 将 Windows 端默认字体改为微软雅黑。微软雅黑带有 hinting,使文字在显示设置低于 200% 缩放比例下,更加锐利清晰。若手动设置了字体,或使用 macOS 端,则不受影响

布局

开关 默认 效果
减小圆角与间距 开 缩小全局圆角、缩小侧栏部分字号、收紧间距,使界面更高效
会话标题栏紧凑化 开 紧凑化会话标题栏,使会话内容可视范围更大
统一新会话按钮样式 开 新会话按钮样式改为与导航按钮一致
折叠侧栏导航功能 开 折叠侧栏导航,点击箭头展开收起
弱化工作区名称 开 工作区名称弱化,使工作区和会话更易区分
会话前圆点 开 会话前显示一个圆点
移除工作区与会话悬停提示 开 悬停在侧栏工作区、会话上时不再显示详情卡片,使滚动更流畅
隐藏会话悬停多余按钮 开 悬停会话行时只保留菜单和置顶,其余按钮(含插件添加的)隐藏;若有插件按钮未在右键菜单中,可关闭
设置面板全屏 开 使用非窗口化的设置页面

性能与用量信息

开关 默认 效果
优化布局 开 优化输入框下方性能与用量布局,将数据分布在左右两侧平衡视觉重心
显示余额 开 在输入框下方性能与用量中显示账户余额
余额警告阈值 3 余额低于此值将变为红色,最小为 0
余额小数位数 2 余额显示的小数位数

规范化

开关 默认 效果
指针样式规范化 开 遵循桌面软件的指针样式规范,仅链接等跳转性元素会更改指针样式为「手形」
文本可选中限制 开 遵循桌面软件的规范,使 UI 界面元素的文本不可被选中;消息正文、会话标题与输入框仍可选中

另有一些不挂开关的固定样式:设置导航列宽 220px、归档会话标题画删除线、选择题选中项的序号反色高亮、浅色主题下选中会话背景加强、工作区行悬停时保持文件夹图标。

安装

在 DeepSeek Harness 里用插件管理器安装本仓库目录:

plugin_manager install_bundle  target=<本仓库绝对路径>

安装后刷新 Web 页面,设置里会出现「UI 改进」一栏,侧栏设置导航同时出现对应图标。

插件以 link 方式登记到 profile,因此本仓库目录需要保留在原位;移动或删除目录前请先卸载。

设置项与持久化

开关状态存放在 localStorage 的 dsh-ui-alt:prefs:v1 键下,写成 html[data-dcc-*] 属性驱动样式:

属性 取值
data-dcc-radius on / off
data-dcc-new on / off
data-dcc-nav collapsed / expanded
data-dcc-dim on / off
data-dcc-logo hidden / shown
data-dcc-dot on / off
data-dcc-font on / off
data-dcc-full on / off
data-dcc-hover on / off
data-dcc-row-buttons on / off
data-dcc-compact-header on / off
data-dcc-stats on / off
data-dcc-balance on / off
data-dcc-pointer on / off
data-dcc-select on / off

目录结构

dsh-ui-alt/
├── package.json      ← 名称/版本/exports/files/dsh 清单
├── cordis.patch.yml  ← 插入行:id/name = dsh-ui-alt
├── index.js          ← Host 半(空 apply,无 Host 逻辑)
├── client.js         ← 全部功能:CSS 覆盖 + 少量 DOM 注入
├── locale/
│   ├── zh.json       ← 插件管理器标题/描述
│   └── en.json
└── icon.svg          ← 设置页导航图标 + 插件图标

client.js 内部:

  • 预置数据:STORAGE_KEY、DEFAULTS、readPrefs() / applyPrefs() / savePrefs()。
  • 一大段 css 字符串,全部按 html[data-dcc-*] 条件生效;设置页自身样式用 .dcc-* 前缀。
  • 三个 DOM 注入函数,各带一个监听 body 的 MutationObserver(350–400ms 防抖)兜底宿主重渲染:
    • installNewSessionRow():克隆宿主的「新会话」按钮成导航行,点击转发给原按钮。
    • installNavToggle():导航下方插入展开/收起箭头,点击切换 data-dcc-nav 并写回偏好。
    • installSettingsBackButton():设置面板左上角插入返回按钮,点击触发原关闭按钮。
  • 设置页组件:Section(标题 + 说明 + 开关行)、Switch、Row、SectionIcon。

开发

node --check client.js
node --check index.js
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8'))"

修改 client.js 后需要重新安装插件并刷新页面,新代码才会被加载:

plugin_manager remove_bundle  target=dsh-ui-alt
plugin_manager install_bundle target=<本仓库绝对路径>

依赖的宿主实现

下面这些宿主细节升级后可能失效,失效时表现为对应的那一条样式不再生效,不会报错:

  • CSS module 类名后缀:_sessionRow、_projectRow、_title、_dialog_、_menu_、_navCell、_navTitle、_close、_optionRow 等。
  • 设置面板 DOM:_overlay / _panel / _navTitle / _navList / _navCell / _header / _close。
  • Windows 变量:--dsh-windows-titlebar-height、--dsh-windows-content-radius。
  • 主题 token:--dsw-alias-*、--dsw-radius-*、--dsw-corner-shape。
  • 第三方兼容:仅当安装了 @michengai/dsh-archive-manager 时,dsham_starSlot / dsham_rowStar 规则才命中,用于圆点与收藏星标的避让。

已知限制

  • 克隆出来的新会话行没有原按钮的 Tooltip 与快捷键提示(点击行为已转发,功能正常)。
  • 设置返回按钮依赖宿主的 _navTitle / _close 类名。
  • 「统一新会话按钮」关闭时,折叠导航的首位是隐藏的克隆行,计数偏移一项;显示效果正常。
  • 侧栏悬停与滚动的开销主要来自宿主自身的样式重算(实测渲染占 60% 以上,脚本仅 4%),插件已在事件层拦掉了悬停卡片,但无法消除宿主这一层的成本。
  • 余额取自宿主账户接口,未登录或接口不可用时该项不显示;余额每分钟刷新一次。
  • 余额警告阈值只接受非负数值,负数或非法输入会被归零。
  • 余额用伪元素渲染(这样余额刷新时不会闪),因此图标只能用 background-image 贴上去、颜色写死为中灰;低于阈值时也是整段变红,做不到只染数字。
  • 「指针样式规范化」会把拖拽、缩放手柄的 grab / resize 光标一并压成箭头(拖拽功能本身不受影响)。
  • 「文本可选中限制」依赖宿主的 _action / _time 等类名片段来排除操作栏;宿主若改名,可能需要补充排除项。

License

MIT