若使用QoderWake出现眼干、视物模糊等视觉疲劳，需配置抗疲劳字体：一、系统级注入Fira Code Retina等专用等宽字体；二、在settings.json中设fontFamily、fontSize=14、lineHeight=21、letterSpacing=0.8；三、通过QSS对keyword/function/type启用font-weight:500；四、安装AutoScale Font插件并校准光照阈值与字号浮动范围。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake进行长时间编码时出现眼干、视物模糊或聚焦困难等视觉疲劳症状，则可能是当前编辑器字体未适配高密度代码阅读场景。以下是专为QoderWake设计的抗疲劳字体配置方法：
一、启用系统级等宽字体注入
该方法通过操作系统底层字体注册机制，使QoderWake直接调用已预装的高可读性等宽字体，避免渲染层二次缩放导致的字形失真与边缘锯齿，显著降低视网膜微扫视负担。
1、Windows系统：下载并安装Fira Code Retina字体包（含连字支持），解压后右键所有.ttf文件→“为所有用户安装”。
2、macOS系统：打开“字体册”，点击左下角“+”号，选择已下载的JetBrains Mono NL字体文件（NL版本含加宽字间距，专为防串行优化）。
3、Linux系统（GNOME）：将Cascadia Code PL字体文件复制至~/.local/share/fonts/，执行fc-cache -fv刷新字体缓存。
4、重启QoderWake，在设置中进入“字体配置”，于Editor → Font Family字段手动输入对应字体名称（如Fira Code Retina），不加引号。
二、强制应用抗疲劳字体参数组合
单一字体不足以应对全天候编码需求，需同步调整字号、行高、字符间距三者构成的视觉节奏单元。本方案基于ISO/IEC 9241-303人因工效学标准，采用1.45倍黄金行高比与0.08em正向字间距，抑制代码列对齐错觉引发的睫状肌持续紧张。
1、打开QoderWake命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入>open settings json并回车。
2、在settings.json中添加以下字段（确保逗号分隔正确）：
"editor.fontFamily": "Fira Code Retina, JetBrains Mono NL, Cascadia Code PL, 'Cascadia Code', monospace",
"editor.fontSize": 14,
"editor.lineHeight": 21,
"editor.letterSpacing": 0.8
3、保存文件后，执行>developer: reload window强制重载渲染上下文。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、启用语法感知字体加粗策略
传统全字体加粗会加剧视觉重量感，本方案仅对关键词、函数名、类型标识符三类语法节点启用半粗（font-weight: 500）渲染，利用格式塔原则强化语义区块识别，减少大脑语法解析耗能。
1、在QoderWake管理后台「高级样式」页面启用「自定义QSS编辑模式」。
2、粘贴如下QSS规则段落：
QPlainTextEdit[role="editor"] .token.keyword { font-weight: 500; }
QPlainTextEdit[role="editor"] .token.function { font-weight: 500; }
QPlainTextEdit[role="editor"] .token.type { font-weight: 500; }
3、点击「验证语法」确认无错误提示，再执行「热重载」。
4、打开任意.py或.ts文件，观察def、interface、Promise等标识符是否呈现清晰半粗效果，而普通变量名保持常规字重。
四、部署动态字号调节插件
固定字号无法适配不同环境光照强度与屏幕距离变化，本插件依据系统亮度传感器数据实时微调编辑器字号，在2px范围内平滑浮动，维持恒定视角字符高度，防止瞳孔反复调节引发睫状肌痉挛。
1、打开QoderWake扩展市场，搜索并安装AutoScale Font v2.3+（仅兼容QoderWake v0.0.9+）。
2、安装完成后，在命令面板输入>auto-scale: configure启动配置向导。
3、按提示校准最低环境照度阈值（建议设为45 lux，对应台灯直射桌面典型值）与最高字号上限（推荐16px）。
4、启用「夜间模式降字号补偿」开关，确保深色主题下字号自动-1px以平衡对比度提升带来的视觉膨胀感。
