For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /manual/client/window-mode.md.

窗口模式

客户端窗口支持三种窗口行为特性,适应教室白板的特殊使用场景。

窗口置顶

窗口始终保持在屏幕最顶层,不会被其他窗口(如浏览器、PPT)遮挡。默认开启,可通过托盘菜单开关。

点击穿透

窗口默认对鼠标事件透明 —— 鼠标可以直接穿透课表窗口操作其下方的应用程序(如电子白板软件、浏览器)。这个特性 总是 被应用,无法手动开关。此机制确保课表显示不干扰白板的正常使用。

窗口透明度

窗口采用透明背景(transparent: true),课表元素的背景不透明度由 CSS 变量 --global-bg-opacity 控制(默认 0.3),需在管理端修改。鼠标悬停在课表区域时透明度会进一步降低,避免遮挡课件等内容。鼠标移开后效果恢复。

窗口配置

窗口配置
主窗口无边框、透明、置顶、不可调整大小
倒数日窗口无边框、透明、不可移动、鼠标穿透
托盘菜单左键/右键点击打开

主窗口交互

  • 鼠标悬停:将鼠标移动到课表区域(课程、倒计时、侧边栏等元素)上方时,窗口透明度降低。
  • 鼠标移出:鼠标离开课表区域后,窗口恢复高透明度。
  • 窗口失焦:窗口失去焦点时自动恢复默认透明度。

倒数日窗口交互

  • 切换按钮:点击右上角的 按钮在展开模式和最小化模式之间切换。
  • 悬停按钮:鼠标悬停在切换按钮上时临时关闭点击穿透,移开后恢复。

系统事件

  • 系统挂起/关机:Windows 进入睡眠或关机时,客户端自动退出,避免恢复后状态异常。
  • 单实例锁:客户端使用 Electron 的单实例锁机制,防止同时运行多个实例。再次启动时自动聚焦到已有窗口。

键盘交互

客户端没有自定义全局快捷键。键盘输入主要用于以下场景:

  • 托盘菜单弹窗中的输入框(如「云端服务」「所在班级」「当前地区」「调试输入」)
  • 主窗口不接收键盘事件(窗口默认鼠标穿透、无焦点),全部交互通过鼠标完成