企业官网建设流程全解析

FluidVoice转写历史管理指南：检索、导出与ChatHistory回顾

【免费下载链接】FluidVoiceFastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows pre-build available! A local Wispr Flow alternative. DM us on X exclusive model access! 😉 - https://x.com/fluidvoiceapp项目地址: https://gitcode.com/GitHub_Trending/fl/FluidVoice

FluidVoice 是一款专注本地运行的 macOS 语音转文字（Dictation）应用，它的转写历史管理功能让每一条语音记录都可查、可复制、可导出。本指南面向新手，带你快速掌握 FluidVoice 转写历史的三大核心能力：按关键词检索历史记录、一键导出文本与音频 ZIP、回顾 Command Mode 的 ChatHistory 对话。所有数据默认保存在本机，隐私无忧。

一、30 秒认识 History 历史界面 🕘

打开 FluidVoice 主窗口，点击左侧边栏的History即可进入转写历史页。界面分为左右两栏：

• 左栏：按时间倒序排列的历史条目列表，顶部是搜索框，底部显示条目总数与「Clear All」按钮
• 右栏：选中条目的详情面板，展示最终文本、原始转写、应用/窗口等元数据

每一条转写记录都由 TranscriptionHistoryStore.swift 定义的数据模型保存，包含时间戳、原始文本（rawText）、处理后的文本（processedText）、当时所在的应用与窗口标题、字数，以及 AI 增强状态等字段。

二、转写历史检索：四字段全文搜索 🔍

在顶部搜索框输入关键词，列表会实时过滤。搜索是不区分大小写的全文匹配，同时覆盖四个字段（见 search 方法）：

小技巧：用应用名 + 时间组合定位效率最高——先搜应用名缩小范围，再在列表里按右侧的相对时间（如「5m ago」）快速扫视。点击条目即可在右栏查看完整内容。

三、逐条阅读：原始文本 vs AI 增强文本 📝

详情面板会同时展示两个区块：

• FINAL TEXT：最终输入到光标处的文本，若经过 AI 增强会打上「AI Enhanced」徽章
• ORIGINAL TRANSCRIPTION：语音识别的原始输出（仅 AI 处理过且两者不同时显示）

列表条目上还有几枚值得注意的徽章图标（见 TranscriptionHistoryView.swift）：

• 🎙waveform 波形图标：该条转写附有本地保存的音频
• ⚠️橙色感叹号：AI 增强失败，系统已回退输入原始转写（悬停可查看错误原因）
• ASR / AI 耗时、tokens/sec 徽章：需在设置中开启「Show History Performance Metrics」后显示

四、导出与复制：三种姿势把内容带走 📤

1. 复制文本右键任一条目，可选择：

• Copy AI Text：复制 AI 增强后的文本
• Copy Raw Text：复制原始转写
• Copy Both：两段一起复制

2. 导出单条音频（Export Pair）若该条附有音频，右键选择Export Pair...或点击详情面板的按钮，会导出一个 ZIP（含 manifest 元数据 + WAV 音频），方便留档或提交反馈（实现见 DictationAudioHistoryStore.swift）。同一菜单里还有Reveal Audio，直接在访达中定位音频文件。

3. 批量导出音频 ZIP进入Preferences → Audio History，点击Export ZIP，所有带音频的历史记录会被打包成一个包含manifest.jsonl与 WAV 音频的压缩包（见 exportAudioZip）。

4. 整机备份与恢复Preferences 中的Backup & Restore可一键 Export/Import 设置、提示词配置、转写历史与统计（API 密钥除外），换机迁移时非常实用，备份格式定义在 BackupService.swift。

五、音频历史管理：预算、修剪与删除 🎧

音频历史完全可选。在Preferences → Audio Storage面板中（见 audioHistoryControls）：

• Budget：设置音频存储上限（GB），超过预算时会自动从最旧的录音开始修剪，但保留文字记录
• Delete Audio：只删除所有已存音频，文字历史不受影响
• 面板顶部还会显示「已用 / 预算」进度条，容量一目了然

想彻底不记录音频？在偏好中关闭「Save audio with transcription history」即可，历史条目里也不再出现波形图标。

六、ChatHistory 回顾：Command Mode 的对话档案 💬

FluidVoice 的 Command Mode 可以用语音控制 Mac，每次执行过程的完整对话都会存入ChatHistory（实现见 ChatHistoryStore.swift）。回顾方式：

• 会话标题自动生成：取第一条语音指令的前 50 个字符作为标题，一眼认出内容
• 下拉切换历史对话：按最近更新时间排序，随时切回旧会话
• 新建 / 删除 / 清空：New Chat 开新会话；删除会话后自动切到最近一条；Clear 只清当前会话消息、保留会话壳

需要注意的是，ChatHistory自动保留最近 30 条会话，更早的会被淘汰；它只保存在本机用户配置中，不包含在整机备份文件里。

七、删除与清理：从单条到全清 🧹

• 删除单条：右键条目 → Delete，或详情面板底部的红色Delete Entry按钮（若条目含音频，音频文件会一并删除）
• 清空全部：左栏底部Clear All，二次确认后永久删除所有条目及音频
• 停止记录：偏好中关闭「Save transcription history」后，新转写不再入库

历史数据还会驱动Stats页的统计：今日字数、连续使用天数（streak）、节省的时间等，均由 TranscriptionHistoryStore 计算，删改历史会即时反映到统计里。

常见问题 FAQ

Q：搜索不到刚转写的内容？先确认偏好中开启了「Save transcription history」；刚完成的转写会插入列表最顶部。

Q：备份文件里会有 API 密钥吗？不会。Backup 明确排除密钥，只含设置、提示词、历史与统计。

Q：导出 ZIP 打不开？批量导出要求至少一条历史记录带有音频，否则按钮会提示无音频可导出。

Q：删除会话和删除转写历史有什么关系？两者独立：ChatHistory 属于 Command Mode 对话，转写历史属于语音输入记录，互不影响。

小结

FluidVoice 的转写历史管理围绕「本地、可控、可检索」设计：全文搜索帮你找回任何一句话，多种导出姿势（复制 / 单条 ZIP / 全量 ZIP / 整机备份）覆盖不同需求，音频预算机制让磁盘占用始终可控，而 Command Mode 的 ChatHistory 则让你随时回看每一次语音操控。配合本文的检索与导出技巧，你的每一条语音记录都不会"白说"。

【免费下载链接】FluidVoiceFastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows pre-build available! A local Wispr Flow alternative. DM us on X exclusive model access! 😉 - https://x.com/fluidvoiceapp项目地址: https://gitcode.com/GitHub_Trending/fl/FluidVoice