如何配置Hex Modes功能：按应用上下文自动润色改写转写文本的5个实用场景-尧图网站建设

如何配置Hex Modes功能：按应用上下文自动润色改写转写文本的5个实用场景

【免费下载链接】hexLocal voice dictation for mac, windows and linux项目地址: https://gitcode.com/GitHub_Trending/hex19/hex

Hex 是一款本地优先的语音听写工具：按住快捷键说话，松手后文本就会粘贴进任意应用。而Hex Modes是它的"按应用自动润色"功能——当你在 Slack、邮件或终端等不同应用间切换时，Hex 会自动挑选对应的处理配置，对本地转写出的文本做纠错、AI 改写和格式变换，再粘贴到当前焦点位置。本指南带你从零配置 Modes，并给出 5 个立即可用的实用场景。

什么是 Hex Modes？工作原理

Modes 的思路是"一次听写，按场景自动加工"。每次转写完成后，Hex 会识别最前面的应用（前台窗口），按以下优先级匹配处理配置：

匹配的浏览器网站（browser host）
匹配的桌面应用
兜底的Global全局模式

匹配到某个模式后，文本会依次经过三段流水线：

转写文本 →Corrections 纠错替换→OpenCode AI 改写（可选）→Transformations 文本变换→ 粘贴或发送

其中任何一个阶段失败，Hex 都会保留上一阶段的完整结果，不会出现"改了一半"的乱文。语音转写本身始终在本地完成，只有开启 AI 改写时才把文本发送给配置好的 OpenCode 服务商。

官方功能地图见 docs/features/README.md 的 "Process Text With Modes" 章节，处理入口实现在 src/dictation_processor.rs，界面逻辑在 src/rune_ui/modes.rs。

一键启用：打开 Modes 实验开关

Modes 目前是一个默认关闭的实验功能，需要先开启：

hex experiments enable modes

然后重启 Hex。开启后侧边栏会出现Modes面板；此前保存过的模式设置也会原样恢复。实验功能说明见 docs/features/experiments.md。

创建模式并绑定应用：最快配置方法

进入 Settings → Modes，点击右上角＋新建一个模式，然后完成两步：

① 命名模式：比如Chat、Terminal、Email。

② 绑定触发应用：在 Applications 一行点击＋，从搜索列表里勾选应用（如 Firefox、Slack、WezTerm）。找不到目标应用时，可点 "Choose a file…" 用系统文件对话框直接指定。注意两点：

一个应用同一时间只能属于一个模式，重复绑定会被拒绝并提示冲突；
Linux 上 Wayland 不报告前台应用，应用匹配只在 X11 下生效。

配置三段处理：纠错、变换与AI改写

添加 Corrections 纠错替换

点击 Corrections 的＋，录入"转写常错的词 → 正确写法"的成对替换，例如open code → OpenCode、hex app → Hex。这些替换按字面匹配，开销极低，适合修正专有名词、产品名。

勾选 Transformations 文本变换

Hex 内置了三个变换，可多选并拖拽调整执行顺序：

Lowercase：全部转小写
SpongeBob case：交替大小写的"泡芙风格"
No trailing punctuation：去掉句末连续标点（保留引号、括号内的标点）

打开 OpenCode transformation AI 改写

这是真正"润色"的一步：打开开关后可配置模型（如 Claude Sonnet 4.5）、思考深度（Thinking）和超时（Deadline，秒），并在 Instructions 中写一段系统提示，比如"Rewrite the transcript into clear, natural text while preserving the speaker's intended meaning."改写结果会保留你的原意，只优化表达。

5个实用场景：按应用上下文自动润色

场景 1 💬 聊天软件里：简洁口语 + 去掉句末标点

在Slack / 企业微信里说话往往比较碎。给这些应用建一个Chat模式：关闭 AI 改写（保速度），勾选No trailing punctuation，把语气词写成 Corrections 替换（如嗯就是 → 就是）。粘贴出来的文字干净利落，不用事后删句号。

场景 2 ✉️ 工作邮件：AI 自动改写成正式商务语气

邮件应用（Mail、Outlook）绑定一个Email模式，打开 OpenCode transformation，Instructions 写成"Rewrite as a polite, concise business email"，Thinking 设为 high。你口语化地说完，Hex 交付的是一封措辞得体的邮件草稿。

场景 3 💻 终端里：技术术语零出错

终端（WezTerm、iTerm）的听写最怕术语被听错。建一个Terminal模式，Corrections 里集中维护你的术语表：open code → OpenCode、rust lang → Rust、git push → git push。终端模式不必开 AI 改写，本地替换更快也更可控。

场景 4 🎨 社交媒体：趣味风格一键套用

发微博、X、短视频文案时，建一个Social模式，变换选SpongeBob case或Lowercase，再配一句轻快的 AI 提示词。同一段话，发到不同平台自动呈现不同风格，切换应用即可，无需手动重剪。

场景 5 📚 浏览器网站：按站点定制文档风格

Modes 还能匹配浏览器网站（目前支持 Brave 的站点上下文）。比如给技术文档站建一个模式，AI 提示词写成"输出为条理清晰的文档风格，保留代码与专有名词"——在浏览器里听写笔记时，文字自动整理成适合归档的格式。

进阶：用一行配置注册自定义变换

内置变换不够用？可以在配置文件里注册自己的文本函数，它会出现在每个模式的 Transformations 列表中。文件位于~/.config/hex/hex.config.ts，保存后约 0.3 秒自动热重载，无需安装 Node 或 npm：

transformations: { "trim-whitespace": { name: "Trim whitespace", description: "Remove leading and trailing whitespace", transform: (text) => text.trim(), }, },

仓库中的示例配置见 src/personal_commands/hex.config.ts，完整契约与信任边界说明见 docs/plans/personal-commands.md。注意lowercase、spongebob-case、no-trailing-punctuation是内置 ID，不要重复占用。

常见问题

❓ 侧边栏看不到 Modes 面板？实验开关没开，执行hex experiments enable modes后重启。

❓ Linux 上应用模式不切换？Wayland 不向上报告前台应用，应用匹配仅在 X11 下生效；Global 模式不受影响。

❓ AI 改写失败会把文字弄坏吗？不会。任一处理阶段失败时，Hex 保留该阶段输入前的完整文本，绝不粘贴半成品。

资讯详情

如何配置Hex Modes功能：按应用上下文自动润色改写转写文本的5个实用场景