企业官网建设流程全解析

Hex 是一款 Local-first 的语音转写工具，按住快捷键说话、松手即可把文字粘贴到任意应用。装好 Hex 之后，你还可以直接用hex history与hex meetings这两条 CLI 命令，在终端里快速查询转写历史与会议记录，配合--json输出还能轻松接入脚本和 AI Agent。

为什么要在终端查转写历史？

图形界面里的 History 面板适合"翻一翻"，而终端命令适合精确查询：

• 按时间、应用、关键词过滤某几条记录；
• 直接输出 Markdown / JSON，方便复制、归档或喂给脚本；
• 全程只读：不启动麦克风、不加载模型、不发起网络请求，也不会改动任何数据（说明见 docs/transcript-cli.md）。

找到 hex 命令：最快配置方法

macOS 版本将hex命令内置在 App 里，hex不一定在你的 PATH 中，直接用完整路径最稳妥：

/Applications/Hex.app/Contents/MacOS/hex history --since 3d /Applications/Hex.app/Contents/MacOS/hex meetings list --since 7d

两点提示：

• 这些只读查询命令当前主要面向 macOS 版本；Linux 版本目前提供dictation、status等控制命令，两者命令面不同（参见 docs/cli.md 与 docs/linux.md）。
• 命令无需先启动 Hex 的录音功能，数据来自本地~/Library/Application Support/hex，查询不会改变 App 状态。

hex history 使用指南：时间、应用、关键词三种过滤

hex history返回的是成功保留的转写结果（包括 Send 和 Voice Action），每条记录包含：时间戳、来源应用、处理模式、最终文本。

时间写法非常灵活：3d、36h、90m、2w、today、yesterday、now，也可以直接写日期或 Unix 毫秒时间戳。

几个容易踩坑的细节：

• --until是不包含当天的次日零点，--until 2026-10-20会包含 10 月 20 日全天；
• --grep是字面量匹配，不是正则；想容错拼写（比如bord匹配到board），用--search；
• 结果始终受保留期设置约束：过期条目在查询阶段就被过滤，Hex 不会静默扩大保留窗口。

一条常用组合：

hex history --since 7d --app Slack --grep deploy --json hex history --search 'problems board' --json

hex meetings 四大操作：list、show、search、chapters

会议命令与history使用相同的时间语法，支持--since/--until/--limit/--json。

1. meetings list：列出最近会议

hex meetings list --since 7d --json

默认 20 条（上限 200），按最新在前排序；正在录制的会议也会被列出并带标记。

2. meetings show：查看单条会议转写

hex meetings show latest --md hex meetings show 1790000500000-1002 --json hex meetings show latest --from 113:03 --to 120:43 --md

• 会议可以用完整 ID、至少 6 个字符的不含糊前缀、或latest（最新一场，包括正在进行的）指定；
• --md输出带元数据、笔记和发言人分段的 Markdown；--json输出相对毫秒时间戳的转写条目；
• --from/--to支持mm:ss（分钟可超过 59，如113:03）、h:mm:ss或秒数（90、90s、1.5m），只取会议的某一段。

3. meetings chapters：按章节读取

开启live-chapters实验的会议会记录章节，chapters子命令列出章节号、时间区间、模型生成的标题和一行摘要：

hex meetings chapters latest --json hex meetings show latest --chapter 2

没有章节的会议会如实告知，Hex 不会临时生成。

4. meetings search：全文检索会议

hex meetings search 'release schedule'

与history --search共用同一套词干化 + 模糊 BM25 排序，引号内短语按精确匹配处理。实战套路是：先 search 找到时间戳，再用show --from/--to读取前后文。

--json 输出格式：一行接入脚本

每条 JSON 响应都带整数version: 1，未知字段应当忽略，方便下游消费：

• history --json：entries数组含timestamp_ms、application、final_text，加--raw才有raw_text，加--search才有score/snippet；
• meetings show --json：meeting元信息 +notes+entries转写条目（source区分麦克风与系统声音）。

完整类型定义见 docs/transcript-cli.md。

三个实用工作流

1. 定位"某应用里的某句话"hex history --since 3d --app Slack --search 'deploy failed' --json
2. 把最新会议导出成 Markdown 归档hex meetings show latest --md > meeting-notes.md
3. 让 AI Agent 帮忙总结：--json输出是稳定格式，Agent 或脚本可以直接解析；OpenCode 会话中调用本地命令的样子如下图所示。

延伸阅读与隐私说明

• 命令完整参考：docs/transcript-cli.md
• 控制类命令（dictation / settings / model 等）：docs/cli.md
• 功能特性文档：docs/features/README.md

最后提醒：所有转写都在本地完成，历史记录默认保留 7 天，并且受 10,000 条 / 16 MiB 的硬上限约束；history、meetings查询是纯只读操作，不产生任何文件或网络请求，可以放心用在自动化脚本里。