输出样式
切换内置或自定义写作方式,理解持久范围、信任检查与系统提示关系。
输出样式调整语气、解释量和协作方式,不改变工具权限。它附加到内置 system prompt,并逐轮提醒以维持长会话风格。
内置样式
| 名称 | 行为 |
|---|---|
| default | 不附加额外样式 |
| Concise | 先给结果,减少前言、叙述和收尾;保留完整错误和必要确认 |
| Proactive | 低风险决策倾向说明假设后行动,审批规则仍适用 |
| Explanatory | 加入简短 Insight 教学说明 |
| Learning | 留 TODO(human) 让用户完成部分代码并等待;无头跳过 |
/output-style Concise
/output-style default不带名称打开选择器。切换立即重建当前提示并保存;受信任项目已拥有 general.outputStyle 时更新项目设置,否则更新用户设置。名称不区分大小写。
手工改 general.outputStyle 需下次启动才应用,--output-style 可单次覆盖。中途切换会让缓存前缀失效一次,之后恢复正常缓存。
自定义文件
用户样式放 ~/.qwen/output-styles/
---
name: Reviewer
description: Explain concrete findings before suggesting changes
keep-coding-instructions: true
---
Present findings in order of impact. Describe the affected behavior and the evidence for each finding.frontmatter 可省略:name 默认文件名去 .md,description 默认正文第一行;default 是保留名称。
keep-coding-instructions=true 保留软件工程流程章节,false 只移除该章节,身份、权限和工具指导仍在。覆盖内置同名样式时,未写该值会继承内置值;全新样式未写则默认 false。
覆盖与加载
同名优先级为项目 → 用户 → 内置。打开选择器或按名称选择时重新读文件,新建文件不需重启。
空正文、无效名称、超过 25kB、非 UTF-8 或正文仅 HTML 注释的文件会跳过并写 debug 日志;正文 HTML 注释会移除,不发送模型。
项目 symlink 跳过;用户 symlink 只允许指向自己的 home 内,两个范围都拒绝硬链接。
不生效的情况
--system-prompt 或 QWEN_SYSTEM_MD 完全替换内置提示时,样式与逐轮提醒不应用。bare/safe-mode 忽略配置且不允许 /output-style 更改,自定义样式也不加载。
样式只控制主对话,subagent 有自己的提示;Arena peer 仅在样式保留编码指导时继承。长期项目约定用 QWEN.md,单次附加要求用 --append-system-prompt。