dsh-oled-guard

为 DeepSeek Harness（DSH）的输入区和固定 UI 浮层做闲置自动隐藏，减少 QD-OLED 屏幕的静态高亮区域，降低烧屏风险。

非官方社区插件，与 DeepSeek 无隶属关系。

完整中文使用指南：docs/使用指南.md。

效果

• 输入区闲置 4 秒后，整个 composer 下滑淡出
• 鼠标移到窗口底部约 96px 内，输入区自动升起
• 点进输入框、正在输入、或模型选择菜单打开时，不会隐藏
• 新建会话时居中的输入框（hero 输入框）保持原样
• 其他固定/粘性 UI（侧边栏、顶栏、用量环、徽章、通知等）也在闲置时淡出，鼠标一动就恢复
• Alt+Shift+O：临时开关全部保护（状态保存在 localStorage）
• Alt+Shift+P：只开关“固定浮层保护”，输入框/鲸鱼逻辑不受影响

上图：鼠标移到底部时输入框显示；下图：空闲 4 秒后输入框自动隐藏（截图仅保留输入框区域，未包含聊天内容）。固定浮层使用同一套空闲逻辑，效果类似。

设置面板与自定义热键

按 Alt+Shift+K 打开设置面板：

默认热键	作用
Alt+Shift+O	总开关（输入框 / 鲸鱼 / 浮层）
Alt+Shift+P	只开关固定浮层保护
Alt+Shift+K	打开设置面板

面板里可以：

• 开关总保护、开关固定浮层保护
• 点击快捷键输入框后直接按新组合键（字母键必须带 Ctrl/Alt/Shift/Meta）
• 保存后立即生效，配置保存在本机 localStorage

忘记自定义热键时，在控制台执行 window.__dshOledGuard.openSettings() 即可重新打开设置。

安装

方式一：npm（发布后可用）

dsh plugin add dsh-oled-guard

方式二：从源码本地链接

git clone https://github.com/wangzimu2007/dsh-oled-guard.git
dsh plugin add "link:$(pwd)/dsh-oled-guard"

或者手动把 "dsh-oled-guard": "link:<绝对路径>" 加进 profile 的 package.json，并把 dsh-oled-guard 加进 dsh.profile.bundles，然后运行 dsh plugin --profile desktop install。

安装后重启 DSH 生效。

工作原理

插件是纯客户端插件，不改 DSH 源码，只依赖 DSH 客户端里稳定的 DOM 钩子：

钩子/机制	用途
[data-composer-seat]	输入区容器（data-conversation-region="composer"）
[data-composer-input]	可编辑输入框（用于判断焦点）
[role="menu"]	菜单打开时暂停隐藏
.dshwv-root	右下角鲸鱼组件
运行时扫描 position: fixed / sticky	其他固定 UI 浮层（面积小于视口 60%，全屏背景/遮罩不处理）

通过 getBoundingClientRect() 区分"底部停靠"和"新建会话居中"两种布局；居中时不隐藏。

固定浮层的排除规则

以下元素不会被自动隐藏：

• 全屏或超过视口面积 60% 的层（背景、壁纸、遮罩）
• [role="menu"]、[role="dialog"]、[role="alertdialog"]、[role="tooltip"]
• 常见 UI 组件弹层（.el-popper、.el-overlay、.ant-popover、.ant-modal 等）
• 包含当前焦点的元素
• 带 data-dsh-oled-keep 属性的元素及其子树
• 输入区和鲸鱼自身

自定义选择器

如果在某些版本里侧边栏/顶栏不是 fixed/sticky，或者想额外隐藏某个组件：

// 强制包含（即使不是 fixed/sticky）
localStorage.setItem("dsh-oled-guard-extra", JSON.stringify([".my-sidebar", "#my-badge"]));
// 强制排除
localStorage.setItem("dsh-oled-guard-exclude", JSON.stringify([".keep-visible"]));

改完刷新 DSH 窗口生效。也可以用 data-dsh-oled-keep 保护单个元素。

兼容性与限制

• 在 DSH desktop 44.7.0（runtime 0.2.1-rc.2）上验证通过
• DSH 更新后 DOM 钩子可能变化；届时插件会自动放行（fail-open），不会破坏界面
• 纯本地、无网络请求、无遥测
• 只影响 DSH 输入区和固定浮层，不改变消息内容区的渲染

目录结构

dsh-oled-guard/
├── package.json
├── cordis.patch.yml
├── lib/
│   ├── index.js     # 宿主半边（空逻辑，让插件成为 cordis 树上的条目）
│   └── client.js    # 客户端半边（CSS + 鼠标/焦点监听）
├── LICENSE
└── README.md

免责声明

插件按"现状"提供，不保证适配所有 DSH 版本。使用前请自行确认不会影响你的工作流；若出现异常，按 Alt+Shift+O 关闭，或从 profile 中移除插件。

License

MIT