Qoder暗黑模式需按运行环境分别启用：VSCode通过颜色主题设置、JetBrains IDE在外观中选Darcula、魔搭创空间在个人设置切换深色模式、QoderWake可安装QDarkStyleSheet或使用内置编辑器实时调整参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder时发现界面亮度过高、夜间操作刺眼或长时间编码后视觉疲劳，则可能是当前主题未启用暗黑模式。以下是针对不同运行环境切换Qoder暗黑模式的具体操作方法：
一、在VSCode中启用Qoder暗黑模式
该方法通过修改VSCode整体颜色主题实现，Qoder插件的聊天面板、代码块及侧边栏UI将同步继承深色配色，无需额外配置插件内部主题。
1、按下快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS） 打开命令面板。
2、在输入框中键入 Preferences: Color Theme 并回车执行。
3、从下拉列表中选择任一深色主题，例如 Dark+、One Dark Pro 或 GitHub Dark Default。
4、确认选择后，VSCode主界面与Qoder聊天窗口将立即应用新主题，包括背景、文字、按钮及代码预览区。
二、在JetBrains IDE中切换Qoder暗黑主题
JetBrains系列IDE（如IntelliJ IDEA、PyCharm）通过统一的外观设置控制所有插件UI风格，Qoder作为集成插件会自动响应系统级主题变更。
1、点击菜单栏 File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）。
2、导航至 Appearance & Behavior → Appearance。
3、在Theme下拉菜单中选择 Darcula 或其他已安装的深色主题。
4、点击 OK 保存设置，Qoder面板、消息气泡及代码片段区域将同步变为暗色背景。
三、在魔搭创空间Web平台启用Qoder深色模式
Web版Qoder依赖平台级主题开关，其暗黑模式由魔搭创空间统一管理，切换后所有用户界面组件（含对话框、编辑器嵌入区、状态栏）均按深色规范渲染。
1、登录魔搭创空间后，点击右上角头像进入 个人设置。
2、在左侧菜单中选择 外观（Appearance） 或 主题（Theme） 选项卡。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、将主题模式切换为 深色（Dark Mode），部分版本显示为月亮图标按钮。
4、页面自动刷新，Qoder聊天界面背景色变为#1e1e1e级别灰黑，文字与交互元素对比度提升。
四、在QoderWake客户端强制启用QDarkStyleSheet深色样式
当系统级同步失效或需医学级护眼参数时，可绕过操作系统信号，直接注入QDarkStyleSheet主题包，覆盖全部Qt控件渲染层，确保滚动条、树形结构、按钮等元素均采用低蓝光灰阶配色。
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'))。
5、保存文件并重启QoderWake客户端，观察工具栏图标是否呈现哑光质感，确认主题注入成功。
五、通过QoderWake内置主题编辑器实时调整暗黑参数
该方式不依赖外部库或重启操作，直接修改运行时UI变量，适用于需要微调背景灰度、强调色饱和度或文字亮度的场景，所有变更即时生效于当前会话。
1、启动QoderWake桌面客户端，点击右上角用户头像，进入 设置 → 外观与主题。
2、开启 高级主题编辑器 开关，加载当前UI组件树。
3、在颜色映射区拖拽调整以下三项：Surface Color（主背景）、Foreground Color（正文）、Accent Color（交互强调）。
4、将Surface Color设为 #19232D，Foreground Color设为 #F0F0F0，Accent Color设为 #2A7BDE。
5、点击 保存并应用至全部Agent会话，所有已打开的QoderWake窗口立即更新配色。
