QoderWake深色模式配置含四步：一、启用系统级深色模式同步；二、强制加载QDarkStyleSheet主题包；三、自定义CSS微调低蓝光参数；四、禁用动态亮度调节模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake时感到界面刺眼或长时间操作后视觉疲劳，则可能是当前配色方案未适配低亮度环境。以下是针对QoderWake保护视力的深色模式配置方法：
一、启用系统级深色模式同步
该方法通过操作系统底层信号触发QoderWake UI组件自动适配，避免手动设置偏差，确保所有面板（包括侧边栏、对话气泡、代码预览区）统一响应深色上下文。
1、Windows系统：打开“设置”→“个性化”→“颜色”，在“选择颜色”下拉菜单中选择“深色”。
2、macOS系统：点击苹果菜单→“系统设置”→“外观”，将选项切换为“深色”。
3、Linux（GNOME/KDE）：进入“设置”→“外观”或“通用”，启用“深色主题”开关，并确认窗口管理器已加载dark variant。
4、重启QoderWake客户端，等待约8秒直至状态栏右下角出现深色齿轮图标闪烁三次，表示系统级配色已注入完成。
二、强制加载QDarkStyleSheet主题包
当系统级同步失效或需更高对比度控制时，可直接注入QDarkStyleSheet深色样式表，该方案覆盖全部Qt控件渲染层，对文本框、按钮、滚动条、树形结构等提供医学级护眼灰阶（#2a2e33主背景 + #d0d0d0正文）。
1、下载qdarkstyle v3.13.1+版本：执行命令 pip install qdarkstyle --upgrade --force-reinstall。
2、定位QoderWake安装目录下的config.py文件，用文本编辑器打开。
3、在import语句块末尾添加：import qdarkstyle。
4、在主窗口初始化代码段（如MainWindow.__init__内）插入：self.setStyleSheet(qdarkstyle.load_stylesheet(qt_api='pyside6'))。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
5、保存并重启应用，检查工具栏图标是否呈现哑光质感而非高光反光，以此验证主题注入成功。
三、自定义CSS注入微调参数
针对特定高敏感用户（如偏头痛患者或视网膜色素变性使用者），可通过注入轻量CSS规则进一步降低蓝光峰值与边缘锐度，重点抑制450–495nm波段刺激。
1、在QoderWake安装目录新建文件夹：themes/lowblue/。
2、在该文件夹内创建custom.css，写入以下内容：* { -qt-foreground-role: WindowText; text-rendering: optimizeLegibility; image-rendering: -webkit-optimize-contrast; } QPlainTextEdit { background-color: #1e2227; color: #c0c5ce; }
3、返回config.py，在样式设置行下方新增：with open('themes/lowblue/custom.css', 'r') as f: self.setStyleSheet(f.read())。
4、启动时按住Shift+Ctrl键不放，直到主界面左上角显示“LowBlue Mode Active”浮层，松开按键即完成激活。
四、禁用动态亮度调节模块
部分QoderWake版本默认启用基于环境光传感器的实时亮度补偿，该功能在室内恒定光照下反而引发频闪感知，加剧视疲劳。关闭后可锁定稳定灰阶输出。
1、启动QoderWake后，按Ctrl+K呼出命令面板。
2、输入toggle ambient brightness control并回车。
3、观察状态栏右侧是否移除太阳图标，若图标消失且无任何闪烁提示，则模块已停用。
4、关闭并重新打开任意对话窗口，确认新窗口标题栏颜色与主窗口完全一致，无明暗渐变过渡。
