CodeWhale TUI 无障碍：如何为读屏与低视觉用户配置 low_motion 与 ASCII 安全模式

CodeWhale TUI 无障碍如何为读屏与低视觉用户配置 low_motion 与 ASCII 安全模式【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodewhaleCodeWhale 是一个运行在终端里的编码代理TUI 的动画、装饰性 Unicode 和状态指示对读屏软件VoiceOver、Orca和低视觉用户可能构成干扰。本文的目标是完成两件事把 TUI 切到low_motion低动效模式并开启CODEWHALE_ASCII_SAFEASCII 安全渲染档位让转录文本保持纯文字、重绘节奏足够慢读屏软件可以逐行跟随模型输出而不是每次刷新都重读整屏。前提是你能正常启动 CodeWhale TUI所有配置都来自 docs/ACCESSIBILITY.md不需要改源码。先了解两个配置入口及其优先级同一组开关有两条配置路径无障碍文档明确了它们的生效关系环境变量启动时生效NO_ANIMATIONS1会在启动时强制low_motion true且fancy_animations false覆盖settings.toml里保存的任何值CODEWHALE_ASCII_SAFE1则开启 ASCII 安全档位。TUI 内/config命令持久化写入~/.codewhale/settings.toml旧安装的~/.deepseek/settings.toml作为兼容回退。关键规则只要NO_ANIMATIONS已设置启动时它总是赢想让你保存的设置生效就要在 shell 里取消该环境变量。另外环境变量只在启动时读取一次会话中途修改变量没有效果必须下一次启动才生效。路径一用 /config 持久化低动效设置在 TUI 命令面板里执行文档给出的原样命令/config low_motion on --save /config fancy_animations off --save /config calm_mode on --save各开关的作用默认值见 docs/ACCESSIBILITY.md 的快速参考表low_motion默认false冻结装饰性动画和状态动画不改变模型文本本身的投递页脚水纹条带由fancy_animations单独控制。fancy_animations默认true设为false可让实时回合的状态装饰保持静止。calm_mode默认true默认折叠工具输出细节并精简状态消息对会播报每一次重绘的读屏软件特别有用。如果还嫌头部标记的动画多余可以追加/config status_indicator off --save该设置默认值为cw静态排版标记dots是旧版动画off完全隐藏。验证命令带--save后会持久化到~/.codewhale/settings.toml直接打开该文件确认low_motion等字段已写入即可。行为上low_motion开启后文档描述的效果是空闲重绘循环被放慢到约每帧 120ms状态标记被冻结但模型文本不做合成或节流——这是你应当观察到的表现。路径二用环境变量一次性强制生效适合不想逐条改设置、或希望覆盖整台机器所有会话的场景。按 无障碍文档 的写法在 shell profile 里导出# 强制低动效 关闭花哨动画 export NO_ANIMATIONS1 # 强制终端安全的 ASCII 渲染档位 export CODEWHALE_ASCII_SAFE1 # 可选遵循更广的终端配色约定 export NO_COLOR1取值与生效条件均出自文档不是推测NO_ANIMATIONS接受1、true、yes、on不区分大小写其他任何取值0、false、空、未设置都不动你已保存的设置。CODEWHALE_ASCII_SAFE1在终端后端层面把装饰性 Unicode 和制表符box-drawing替换为窄 ASCII标签、焦点、状态和控件全部保留。NO_COLOR1由底层 ratatui 后端遵循。环境变量改完后必须重新启动 TUI 才生效。为读屏用户推荐的组合及其原理无障碍文档专门有一段说明给读屏用户看low_motion与calm_mode组合后的实际效果是重绘速率被压低到足以让 VoiceOver / Orca 的播报与模型输出线性跟踪而不是每个 tick 重读整屏。转录内容是纯文本——没有图片或 canvas 渲染——所以任何与平台无障碍服务集成的终端文档举例macOS Terminal.app、iTerm2、Ghostty、Windows Terminal都会把渲染内容原样传给读屏软件。也就是说面向读屏用户的最短配置就是low_motion oncalm_mode on再按终端情况叠加CODEWHALE_ASCII_SAFE1。关于颜色文档的边界说得很清楚调色板在绘制时把每个文本单元提升到 4.5:1 对比度且每个状态都同时带字形和文字标签颜色从不作为唯一信息通道ASCII 档位保留了标签、焦点和状态这套非颜色冗余在最简渲染下依然成立。透明主题 Terminal 是设计上的豁免项——它使用宿主终端自己的配色审计跳过而非宣称通过。已知限制与排查边界启动时覆盖NO_ANIMATIONS已设置时/config --save写入的值在启动瞬间仍会被环境变量压过。如果你的预期是保存的设置生效先确认 shell 里没有导出这个变量。会话中途无效环境变量只在启动时应用一次设置也只在下一次启动时重新读取。改完配置看不到变化先确认是否重启过 TUI。VTE 终端的自动低动效Tilix 和 Terminator 会话会自动以低动效模式启动因为这两个基于 VTE 的终端在活跃回合中报告过可见的重绘闪烁如果你用的版本渲染正常仍可在启动后用/config覆盖保存的设置。动效策略的三档docs/MOTION_CONTRACT.md 记录了内部实现——设置会派生为Full/Reduced/Still三种运动策略装饰环境、状态 spinner、流式显示各不同。这是源码层的说明读者只需知道low_motion与fancy_animations两个开关共同决定落在哪一档。仍出现动效文档明确说如果low_motion true下仍发现某个界面在动应带着截图或终端录屏向仓库提交 issue对应无障碍文档引用的 issue #450而不是自行猜测原因。下一步两个路径可以并存环境变量用于机器级强制/config --save用于持久化个人偏好唯一要记住的优先级是NO_ANIMATIONS在启动时压过保存的设置。完成配置并重启 TUI 后验证落到两点~/.codewhale/settings.toml或环境变量确认了开关状态且界面表现为装饰动画冻结、状态标记静止、模型文本照常投递。更多配置项如show_thinking、inline_diffs等进一步降低信息密度的开关可继续在同一 docs/ACCESSIBILITY.md 的快速参考表中查看环境变量全量清单见 docs/CONFIGURATION.md。【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/Codewhale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考