终端显示与日常设置
配置语言、工具详情、滚动、自动更新、会话录制与数据清理。
This page has not been translated into English yet. The original Chinese version is shown below.
显示设置可减少界面噪声,但不改变工具审批。示例使用嵌套 JSON,点路径在下表仅用于标识字段。
常用开关
| 字段 | 当前默认 |
|---|---|
| general.vimMode | false |
| general.language / general.outputLanguage | auto |
| general.terminalBell | true |
| general.enableAutoUpdate | true |
| general.defaultFileEncoding | utf-8 |
| output.format | text |
| output.showTimestamps | false |
| ui.theme | Qwen Dark |
| ui.showLineNumbers | true |
| ui.renderMode | render |
| ui.showCitations | false |
界面语言和模型输出语言分别配置,修改需重启;自定义界面 locale 可放到 ~/.qwen/locales/。utf-8-bom 仅在项目确实需要 BOM 时选择。
general.preventSystemSleep 默认 true,仅在模型流输出或工具执行时阻止休眠,空闲输入及等待审批不阻止,启动时读取。
工具详情与历史
ui.compactMode 已退役,ui.compactInline 已移除,旧值不再切换布局。Ctrl+O 展开/折叠思考与工具细节;ui.showToolCallDetails 默认 true,false 时普通调用只显示摘要,审批和聚焦交互 shell 仍保持展开。
ui.showToolCallArgs 默认 false;启用可显示原始参数行,但通常上限 2 行、1000 字符,Ctrl+O 再展开。并行 subagent roster 与 daemon 附加会话有例外,Web Shell 不受此 TUI 设置影响。
ui.shellOutputMaxLines 默认 5,0 取消上限;错误、用户 ! shell、待确认或聚焦 shell 不受普通截断显示限制。
ui.history.collapseOnResume 默认 false。collapsePreviewCount 默认 0,启用折叠时保留的最近用户轮数由此控制;-1 显示全部恢复历史。
鼠标与 Markdown
ui.useTerminalBuffer、ui.mouseTracking 默认 true,使用应用内历史和鼠标操作。要恢复终端原生滚动与鼠标,需分别关闭两项;具体按键与 tmux 问题见运行时排障。屏幕阅读器和非交互输出使用追加式终端输出。
ui.renderMode 可设 raw 显示 Markdown 源文本,或 render 显示富预览;Alt/Option+M 临时切换,macOS 终端需将 Option 作为 Meta。
记录、更新和归属
general.chatRecording 默认 true;关闭后不保存聊天,--continue 和 --resume 也不能使用,需重启。
general.cleanupPeriodDays 默认 30,清理 ~/.qwen/file-history/ 会话备份及 runtime debug 日志,后台最多每日一轮。0 代表约一小时最短保留,仍保留最近触及和当前会话,不是关闭清理。
general.gitCoAuthor.commit 默认 true,同时给提交添加 Co-authored-by 和每文件 AI attribution note;pr 默认 true,在 gh pr create 描述追加归属行。关闭 commit 项会同时跳过 trailer 与 note。
输出格式与回顾
output.format 支持 text、json、stream-json。设置 stream-json 后,有 prompt 的运行会按 headless 处理;但在 argv 阶段校验的 --include-partial-messages、--input-format stream-json 仍要求显式 --output-format stream-json,不能只改配置。
general.showSessionRecap 默认 false;启用后离开终端达到 sessionRecapAwayThresholdMinutes(默认 5)再返回时显示一行回顾。/recap 可手工调用,与自动开关无关。