【免费下载链接】stenoai
StenographAI is the secure privacy-first AI notepad & notetaker for confidential conversations in government & defence sectors. On Windows, Linux & MacOS.
StenoAI（StenographAI）是一款隐私优先的本地 AI 笔记本，支持录音、语音转写和会议摘要生成，录音、转写与摘要全部在设备本地完成，音频与笔记默认不上传云端，适合处理政府、国防等高保密场景。本文是 StenoAI 常见问题速查清单：按"录音 → 转写 → 摘要"三大流程，逐一给出故障现象与排查步骤，帮你快速定位并解决 StenoAI 录音失败、转写为空、摘要报错等典型问题。
一、先认识 StenoAI 的工作流程
StenoAI 的本地处理流水线分四步：录音（Record）→ 转写（Transcribe）→ 摘要（Summarize）→ 问答（Query）。遇到问题时，先判断故障卡在哪个环节，再对号入座查下面三章。
官方对流程的完整说明见 docs/getting-started/what-is-steno.mdx。
二、排查前必做：确认数据存放位置
所有数据都保存在本地，排查问题时先看文件是否真的写入了：
| 数据类型 | macOS 路径 | Windows 路径 |
|---|---|---|
| 原始录音（.webm） | ~/Library/Application Support/stenoai/recordings/ | %APPDATA%\stenoai\recordings\ |
| 转写文本 | ~/Library/Application Support/stenoai/transcripts/ | %APPDATA%\stenoai\transcripts\ |
| 摘要笔记（.md） | ~/Library/Application Support/stenoai/output/ | %APPDATA%\stenoai\output\ |
- 录音目录有文件、但转写目录没有 → 故障在转写环节
- 转写有、摘要没有 → 故障在 Ollama 摘要服务
- 录音目录就是空的 → 故障在录音权限或输入设备
更细的文件位置说明见 docs/getting-started/first-recording.mdx。
三、录音故障排查：麦克风、系统音频与权限 🔴
3.1 录音无法开始或完全无声
- 检查麦克风权限：首次录音时 macOS 会弹出麦克风授权提示，需点击Allow；Windows 请在系统设置中确认麦克风权限已开启。
- 检查磁盘空间：磁盘写满会导致录音无法开始或提前停止。
- Linux 用户：系统音频回环依赖 PipeWire（Ubuntu 22.10 及以上默认自带）；纯 PulseAudio 或无头环境下系统音频开关会提示不支持，录音会回退为仅麦克风。
- AppImage 安装用户：必须手动安装 PortAudio，否则启动检查会报
OSError: PortAudio library not found：
sudo apt install libportaudio23.2 macOS 拦截应用无法打开（Gatekeeper）
StenoAI 在 Mac App Store 之外分发，首次启动可能被拦截。一次性解决步骤：
- 打开下载好的 DMG 文件
- 将 Steno 图标拖入 Applications 文件夹
- 打开系统设置 → 隐私与安全性，点击 Steno 旁边的"Open Anyway"（仍要打开）
也可以右键应用选择 "Open"，或在终端执行xattr -cr /Applications/StenoAI.app。详见 docs/getting-started/installation.mdx。
3.3 录不到对方声音 / 没有 [You] 与 [Others] 说话人标签
如果你只录到自己，说明没启用系统音频采集（对方声音走系统音频通道）：
一次性设置方法（macOS）：
- 点击录音按钮旁的···展开录音选项，打开Record system audio（录制系统音频）
- 打开系统设置 → 隐私与安全性 → 屏幕与系统音频录制
- 启用 Steno（如提示则重启应用）
⚠️ 注意：录制系统音频不需要屏幕录制权限，只需"屏幕与系统音频录制"权限。此设置只需做一次，之后开关会保持开启。
StenoAI 不会以机器人身份加入会议，也不通知其他与会者；录音合规责任由使用者自行管理。设置细节见 docs/features/recording.mdx。
3.4 stenoai:// 快捷指令不生效
确保安装后至少完整启动过一次 StenoAI，URL 协议才会注册成功。若仍失败，查看终端日志中Protocol handler registration相关输出。
四、转写故障排查：空转写、慢转写与语言问题 📝
4.1 转写结果为空
常见原因是引擎未检测到语音。按顺序检查：
- 录音时说话音量是否足够，麦克风输入电平是否正常（可先录一段 30-60 秒的测试音频验证）
- 是否录到了静音轨道：只开系统音频而没人说话时，转写会是空的
- 在安静环境重录一段验证
4.2 转写慢或语言不对
StenoAI 提供两个本地转写引擎，在Settings → Transcribe中切换：
| 引擎 | 特点 | 适用场景 |
|---|---|---|
| Parakeet（默认，约 572MB） | Apple Silicon 上速度快，边录边显示实时转写 | 25 种欧洲语言（英语、法语、德语等） |
| Whisper（可选，约 1.6GB） | 覆盖 99 种语言、自动检测语言 | 中文、日语、韩语、阿拉伯语等 |
- 转写变慢？切回Parakeet通常更快——Whisper 只在停止录音后才开始转写
- 需要中文等语言？切到Whisper，它会自动从音频检测语言
- 引擎切换只对未来录音生效，已处理的录音不会自动重转写
模型对比详见 docs/models/transcription-models.mdx，实时转写原理见 docs/features/live-transcription.mdx。
五、摘要故障排查："Processing failed" 与笔记质量 🤖
5.1 提示 "Processing failed"（处理失败）
这几乎都是Ollama 服务或摘要模型的问题：
- 打开应用内Settings → Setup Check跑一次自检，它会验证转写模型、Ollama 服务、模型加载与存储路径写入
- 确认摘要模型已完整下载（默认
gemma4:e2b-it-qat约 4.3GB，安装时预留约 8GB 磁盘） - 仍失败则从终端启动应用查看完整日志（见下一章）
5.2 摘要缺少要点、质量不佳
- 换更大的摘要模型：Settings → AI中切换到
qwen3.5:9b、gemma4:12b-it-qat或gpt-oss:20b，大模型输出更详细准确 - 在录音详情页点击Regenerate notes重新生成摘要（换模型后执行效果更好）
- 转写本身就是空的或语言识别错误，摘要质量必然差——先回到第四章解决转写问题
模型选择见 docs/models/summarization-models.mdx，摘要与重新生成说明见 docs/features/summaries.mdx。
5.3 摘要生成特别慢
长录音属正常现象，Ollama 是 CPU 密集型任务。Windows alpha 版仅 CPU 推理，速度较慢属预期行为。如果慢得不正常，换回更轻量的gemma4:e2b-it-qat（最轻最快）。
六、高频 FAQ 速查表 📋
| 问题 | 快速答案 |
|---|---|
| 更新下载了但没生效 | 自动更新在下次退出时安装。请从StenoAI → Quit菜单彻底退出（不是关窗口）再打开 |
| 能否离线使用 | 可以。首次模型下载完成后，转写与摘要完全离线运行 |
| 数据安全吗 | 默认不上传任何音频/转写/摘要；匿名使用统计可在Settings → Advanced关闭 |
| 支持哪些平台 | macOS 14.4+（Apple Silicon，Intel Mac 自 v0.4.0 起不再支持）；Windows 10/11 x64 为 alpha |
| Windows SmartScreen 警告 | alpha 版未签名，点击More info → Run anyway即可 |
| 如何卸载并清除数据 | 删除应用后，再删除~/Library/Application Support/stenoai/（macOS）或%APPDATA%\stenoai\（Windows） |
完整问答见 docs/faq.mdx。
七、终极手段：查看调试日志 🛠️
遇到上面都没覆盖的问题，日志是最好的答案来源：
- 终端启动法（推荐）：从终端启动应用可流式输出所有日志（Python 子进程、Whisper 转写、Ollama API 流量、错误堆栈）：
/Applications/StenoAI.app/Contents/MacOS/StenoAI- macOS 系统控制台：
# 查看最近10分钟的StenoAI相关日志 log show --last 10m --predicate 'process CONTAINS "StenoAI" OR eventMessage CONTAINS "ollama"' --info- 设置向导调试台：首次设置时可展开调试控制台面板，实时查看模型下载与服务启动日志。
日志位置与更多排查项汇总在 README.md 的 Troubleshooting 章节。
小结
排查 StenoAI 问题的黄金路径：先看文件落盘位置定位故障环节 → 按录音/转写/摘要三章对号入座 → 用 Setup Check 自检 → 终端日志兜底。绝大多数故障都出在权限、Ollama 服务和转写引擎选择这三处，照本清单操作基本都能快速恢复。
【免费下载链接】stenoai
StenographAI is the secure privacy-first AI notepad & notetaker for confidential conversations in government & defence sectors. On Windows, Linux & MacOS.
相关推荐
LangChain4j如何让Java应用通过自然语言直接查询数据库
LangChain4j如何让Java应用通过自然语言直接查询数据库 在当今数据驱动的业务环境中，非技术用户经常需要访问数据库信息却受限于SQL技能门槛。Lang
人工智能AI 应用RAGAI Agent工具调用终极Azkaban故障排查手册：15个常见问题与解决方案的完整清单
终极Azkaban故障排查手册：15个常见问题与解决方案的完整清单 Azkaban作为一款强大的工作流管理器，在日常使用中难免会遇到各种故障。本文将为新手和普通
任务调度后端LitePan 故障排查清单：部署与网盘接入 10 个常见问题速查
LitePan 故障排查清单：部署与网盘接入 10 个常见问题速查 LitePan 是一款多网盘聚合挂载工具，支持 WebDAV、STRM 播放、媒体整理、FU
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
