Skip to content

dsh-ui-optimize

Verified

@moonsand/dsh-ui-optimize · v0.11.10 · MIT · Web UI

Switches that tune how DeepSeek Harness looks and behaves across the whole interface, not just a few screens — each works on its own and more arrive as the shell grows: an eight-theme minimalist gallery, sidebar panel folding, and reload/restart buttons a

Install

dsh plugin add @moonsand/dsh-ui-optimize

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

Source

Tags

Readme

dsh-ui-optimize

English | 中文

一组用来调 DeepSeek Harness 观感与操作的开关——管的是整套界面,不是某几块屏幕。每个开关单独生效,宿主长出新能力时会继续增加。

目前包含:主题画廊(8 套极简主题,浅色与深色各定义一组配色)、侧栏收纳(面板行收成一个「面板」入口,点开是两列启动面板),以及侧栏底部的桌面刷新/重启按钮。

配色只通过 ctx.theme.overrideTokens 以单层覆盖主题变量,不注入任何结构性 CSS、不读写其他插件的 DOM,所以宿主改版最多让颜色不生效,不会把界面layout弄坏。

安装

dsh plugin 或 GUI 插件管理:安装 @moonsand/dsh-ui-optimize

要求 engines.dsh >= 0.2.1-rc.3。

使用

打开 设置 → 界面优化。

主题

主题 风格
青瓷 冷调青绿,克制安静
亚麻 暖调棕褐,像未漂白的布
奶油 淡黄暖白,柔和护眼
石墨 近单色中性,冷静克制
靛蓝 近白画布配冷靛强调
雾蓝 蓝灰中性,现代后台的默认脸
苔绿 低饱和绿,比青瓷更松弛
玫瑰 灰调玫瑰,暖而不吵

选「默认」恢复原生外观。每套主题为浅色与深色各定义一组配色,切换「外观」里的浅色/深色时自动跟随,不需要为两种模式各选一次。

桌面操作

两个开关分别控制侧栏底部的「刷新界面」与「重启应用」按钮:

  • 刷新界面:只重新加载页面与客户端插件,Host 与正在跑的任务不受影响。仅桌面端:飞牛这类网页外壳自带刷新入口,网页端这个开关保持关闭且无法开启
  • 重启应用:重启整个应用(含 Host),会中断当前对话。仅桌面端:网页会话没有可重启的进程

侧栏

一个开关把左侧竖栏里的面板行收成一个「面板」入口。点开是两列启动面板:图标、标题与数量、面板多于 7 个时出现搜索框,并支持键盘操作(↑ ↓ 移动、回车打开、Esc 关闭)。之后才注册的面板——包括其他插件加进来的——在下次打开时自动出现,不会漏。

入口走宿主自己的面板选中接口,不伪造点击。挂载后与每次缩放时都有一个看门狗在量尺寸:量不到就把开关自动关掉、还原原生侧栏,而不是留一根空栏。

「更多」保持独立一行。把它也收进去试过并放弃了:宿主的溢出菜单只认真实点击,插件造不出来;而伪造的指针事件又会被宿主的「点外部即关闭」吃掉,刚打开的弹层立刻被关掉。

启动面板的做法参考社区插件 dsh-sidebar-shelf:注册一根真实的竖栏行、用一条 scoped CSS 规则隐藏其余行、通过槽位 API 枚举条目,并用宿主自己的接口选中面板,而不是伪造点击。

更新

插件页多一个「更新」页签。已装清单取自宿主自带的插件管理服务,最新版与发布时间直接从 npm registry 读——不依赖任何插件市场——再通过同一个宿主服务一键更新整批够格的版本。

只装发布满 24 小时的版本;更年轻的会列出剩余时间并跳过——刚发几小时的版本还可能被撤回或补丁。读不到发布时间的同样跳过:规则无法确认,就不假装确认过。宿主判定与当前 DSH 版本不兼容的版本(engines.dsh 或某个 DSH peer 包不满足)单列一区,写明它要求的版本,并且永远不被「一键更新」带上——刚升级完 DSH 时,页签告诉你是哪些插件还没跟上,而不是等你点下去才失败。

更新走宿主插件管理服务,和你手点单个插件的更新是同一条路径;进度与失败码由它回报。更新完刷新页面:新的客户端代码只在重新加载时生效。

宿主的插件管理服务拿不到时,页签直接说明查不了,不会假装在检查。

已知限制

  • 主题选择保存在浏览器 localStorage,换机器或清站点数据会丢失
  • 刷新与重启都是桌面端专属:网页端两个开关都会被禁用,侧栏底部也不会渲染这组按钮——飞牛外壳本身就带刷新与重启入口
  • 重启动作为进程级操作,无法在自动化测试中验证,只能人工点一次确认
  • 「更多」没有收进弹层,仍在原生竖栏里
  • 弹层沿用宿主自己的面板顺序,不排序、不置顶、不重排
  • 侧栏收纳与 dsh-sidebar-shelf 改的是同一根竖栏,两个只能开一个

开发

node scripts/smoke.mjs

冒烟只验证装配契约:三个运行时文件可解析、主题表结构完整(8 套 × 10 个变量 × 浅/深两组)、包身份与 engines.dsh 完好。它不验证配色观感,也不验证侧栏弹层能否正常打开。

许可

MIT