调整回复的语气、详略与结构；仅在系统提示之上叠加说明，不改变 Qoder 的核心身份与安全约束
输出风格（Output Style）用于调整 Qoder CLI 回复的语气、详略和组织方式。例如你可能希望回复更简洁、更偏教学、或带有特定的结构。通过选择或自定义输出风格，你可以让 Qoder 的表达方式更贴合个人或团队习惯，而无需在每次对话里反复说明。
输出风格只影响“表达方式”，不会改变 Qoder 的核心身份和安全约束——它只能在系统提示之上叠加附加说明，而不能替换或绕过内置的行为准则。
输出风格通过配置项
也兼容写在
参数仅对本次会话生效，优先级高于配置项，也无需重启。完整参数见 CLI 命令与参数。
如果不设置该项，或将其设为默认风格，Qoder 使用内置的默认表达方式，不额外叠加任何风格。
输出风格可以来自多个来源。当同名风格出现在多个来源时，按以下优先级合并，后者覆盖前者：
除了使用内置和插件提供的风格，你也可以定义自己的风格，把常用的表达偏好固化下来复用。
自定义风格是放在指定目录下的 Markdown 文件（
创建后在配置中通过
编写自定义风格时的建议：
如何设置
输出风格通过配置项 outputStyle 指定（顶层键），值为风格名称：
general.outputStyle 下；两处都配置时以顶层为准。
修改 outputStyle 后需要重启 Qoder CLI 才能生效。
如果只想临时使用某个风格，可以在启动时用 --output-style 参数指定：
风格来源与优先级
输出风格可以来自多个来源。当同名风格出现在多个来源时，按以下优先级合并，后者覆盖前者：
- 内置风格：随 Qoder CLI 提供的预置风格。
- 插件提供的风格：已启用插件声明的风格。
- 用户级风格：来自用户级配置的风格。
- 项目级风格：来自项目级配置的风格。
outputStyle 指定的风格生效；若有多个强制风格，第一个生效并记录提示。
自定义输出风格
除了使用内置和插件提供的风格，你也可以定义自己的风格，把常用的表达偏好固化下来复用。
定义方式
自定义风格是放在指定目录下的 Markdown 文件（.md），每个文件定义一个风格：
- 用户级：
~/.qoder/output-styles/，对所有项目生效。 - 项目级：
<项目>/.qoder/output-styles/，仅当前项目生效。
| frontmatter 字段 | 必填 | 说明 |
|---|---|---|
name | 否 | 风格名称；缺省时使用文件名（去掉 .md）。 |
description | 否 | 风格描述；缺省时取正文第一个非标题行。 |
outputStyle 引用其名称即可启用（需重启生效）。插件提供的风格引用时带插件前缀，形如 插件名:风格名。
编写建议
编写自定义风格时的建议：
- 聚焦表达方式：描述语气、详略、结构等表达层面的偏好，而不是任务逻辑。
- 保持简洁：风格说明会叠加到系统提示中，过长会占用上下文。
- 不要试图覆盖安全约束：风格只能扩展表达方式，无法改变 Qoder 的身份与安全准则。
与其他机制的关系
- 与语言设置：
language控制回复使用的语言，outputStyle控制表达方式，二者可以叠加使用。 - 与项目说明：项目说明文件（
AGENTS.md）描述“在这个项目里怎么做事”，属于项目约定；输出风格描述“怎么表达”，属于表达偏好。两者分工不同，见 记忆。 - 与界面设置：输出风格影响回复文本本身，界面主题、状态栏等影响的是显示层，见 界面与快捷键。