AI 增强模式

定义 AI 如何后处理你的转录文本。

工作原理

语音 -> ASR 转录 -> 增强模式 (LLM) -> 最终文本

启动时，闻字会确保内置模式文件存在于模式目录中。缺失的内置文件会自动重新创建；已有文件不会被覆盖。
目录中所有 .md 文件会被加载并显示在 AI Enhance 菜单中。
当增强模式处于激活状态时，转录文本会被发送到已配置的 LLM，模式的提示词作为系统消息。

文件格式

每个 .md 文件使用简单的 YAML front matter，后跟提示词正文：

---
label: 显示名称
order: 50
---
系统提示词内容写在这里。
可以使用多行。

字段	必填	说明
`label`	否	菜单中显示的名称。默认使用文件名
`order`	否	菜单排序权重。默认为 `50`。数值越小，在菜单中位置越靠前
`steps`	否	逗号分隔的模式 ID 列表，用于链式执行（参见链式模式）
正文	是	发送给 LLM 的系统提示词。第二个 `---` 之后的所有内容

文件名（不含 .md）作为模式 ID，必须与 config.json 中的 mode 值匹配。仅使用字母、数字、连字符和下划线。

保留模式 ID off 用于禁用增强功能，不对应任何文件。

链式模式

链式模式按顺序运行多个增强步骤，将每个步骤的输出作为下一个步骤的输入。这对于将现有模式组合成流水线非常有用，无需重复编写提示词。

要创建链式模式，添加 steps 字段，列出按顺序执行的模式 ID：

---
label: Translate EN+ (Proofread → Translate)
order: 25
steps: proofread, translate_en
---
此模式先对文本进行纠错润色，然后翻译为英文。

工作方式：

输入文本被发送到第一个步骤（proofread），使用该模式的提示词。
步骤 1 的输出成为步骤 2（translate_en）的输入。
最终输出是最后一个步骤的结果。

在预览模式下，每个步骤的输出会以分隔符显示，各步骤的思考文本会被累积。最终结果字段仅显示最后一个步骤的输出。

在直接模式下，流式覆盖层会显示步骤进度（例如 "Step 1/2: 纠错润色"）并实时更新。

注意： 链式模式文件的提示词正文不会被发送给 LLM——每个步骤使用其自身模式的提示词。正文仅用于文档说明。

链式模式示例

cat > ~/.config/WenZi/enhance_modes/translate_en_plus.md << 'EOF'
---
label: Translate EN+ (纠错→翻译)
order: 25
steps: proofread, translate_en
---
Proofread first, then translate to English.
This prompt body is not used — each step uses its own mode's prompt.
EOF

内置模式

以下 4 个模式在首次启动时自动创建：

文件	标签	排序	类型	说明
`proofread.md`	纠错润色	10	单步	修正错别字、语法和标点
`translate_en.md`	翻译为英文	20	单步	将中文翻译为英文
`translate_en_plus.md`	润色+翻译EN	25	链式 (proofread → translate_en)	先纠错润色，再翻译为英文
`commandline_master.md`	命令行大神	30	单步	将自然语言转换为 shell 命令

添加新模式

方式 A：从菜单添加

打开 Settings... → AI 标签页。
点击 Add Mode...。
在对话框中编辑模板并点击 Save。
输入模式 ID（例如 summarize）并确认。
新模式会立即出现在菜单中。

方式 B：手动创建文件

在模式目录中创建新的 .md 文件：

cat > ~/.config/WenZi/enhance_modes/summarize.md << 'EOF'
---
label: Summarize
order: 55
---
You are a text summarization assistant.
Condense the user's input into a brief summary of 1-3 sentences.
Preserve the key information and original meaning.
Output only the summary without any explanation.
EOF

重启应用以加载新模式。

示例：正式邮件模式

cat > ~/.config/WenZi/enhance_modes/formal_email.md << 'EOF'
---
label: Formal Email
order: 60
---
You are a professional email writing assistant.
Rewrite the user's input as a formal, polished email body.
Use appropriate greetings and closings if context suggests an email.
Maintain the original intent and key information.
Output only the email text without any explanation.
EOF

示例：翻译为日文

cat > ~/.config/WenZi/enhance_modes/translate_ja.md << 'EOF'
---
label: Translate to Japanese
order: 70
---
You are a Chinese-to-Japanese translator.
Translate the user's Chinese input into natural, fluent Japanese.
Preserve the original meaning and tone.
Output only the translated text without any explanation.
EOF

编辑现有模式

使用任意文本编辑器直接打开文件：

# 使用你偏好的编辑器
open -e ~/.config/WenZi/enhance_modes/proofread.md
# 或者
vim ~/.config/WenZi/enhance_modes/proofread.md

更改在重启应用后生效。

内置模式文件可以自由编辑。闻字不会覆盖已存在的文件。

删除模式

删除对应的 .md 文件并重启：

rm ~/.config/WenZi/enhance_modes/summarize.md

注意： 如果删除内置模式文件（例如 proofread.md），它会在下次启动时以默认内容重新创建。要永久禁用内置模式，请将其提示词替换为直通指令：

---
label: (Disabled) Proofread
order: 999
---
Output the user's input exactly as-is, without any changes.

使用技巧

排序：使用有间隔的 order 值（10, 20, 30...），这样可以在现有模式之间插入新模式而无需重新编号。
提示词质量：在提示词中要具体明确。告诉 LLM 该做什么以及不该做什么。始终以"仅输出处理后的文本，不要附加任何解释"结尾，以避免不必要的说明文字。
配置兼容性：~/.config/WenZi/config.json 中的 mode 字段存储模式 ID（文件名）。如果模式文件被删除但配置仍引用它，应用会回退到第一个可用的模式。
非 .md 文件会被忽略：你可以安全地在模式目录中保留笔记（.txt）或备份（.bak）。

更多灵感请参见增强模式示例 —— 一组即用型模板，涵盖写作、翻译、开发工具等场景。

← 配置参考

所有配置选项详解。

增强模式示例 →

即用型增强模式模板。