先找到与你当前提示相近的小节，再按顺序检查。遇到问题时先保存或复制仍可见的文字；不要把重装、清空数据或连续重新生成作为第一步。
安装与更新
安装包无法打开
- 确认安装包来自下载页，平台和设备架构正确，下载已经完成。
- 重新下载当前可用版本。系统阻止启动时，核对来源和系统提示，使用系统提供的正常安装与打开流程。
- macOS 检查是否已放入“应用程序”；Linux AppImage 检查是否允许作为程序执行。
- 页面未提供当前平台或架构的包时，使用帮助与反馈询问，不要改用另一平台的包。
恢复后按快速开始准备模型。各平台与架构的安装包是否可用，以下载页当前显示为准。
更新检查失败或没有新版本
进入“设置” → “软件更新”，检查网络后重新检查。没有新版本提示时继续使用当前版本；下载或安装失败时保留当前可用软件，再按页面提示重试。更新前结束正在进行的录音或文件任务，避免处理中断。
模型与下载
已下载，但仍提示没有模型
进入“模型”，确认所选模型支持当前任务且文件检查已完成，再点击“使用”。录音需要“录音转写”能力，文件任务需要“文件转写”能力。对应的默认标记必须已经出现，完整步骤见模型管理。
下载暂停、失败或校验不通过
- 暂停状态先恢复网络并“继续下载”；检查磁盘空间和模型下载大小。
- 下载失败时使用页面的重试入口。文件不完整、损坏或无法读取时，按提示重新下载。
- 当前默认模型需要删除重下时，先改用另一可用模型，结束正在进行的录音或转写，再删除原版本。
“可用内存不足”时先关闭占内存程序，或改用设备能运行的模型；“处理器要求不满足”时按卡片要求更换适合的模型。重复下载不能解决硬件不满足要求的问题。
离线时无法下载
离线时不能下载或继续下载新模型。已安装且可用的本地模型仍可处理录音或音频文件；AI、搜索和云端操作需要网络，三者与本地转写分开检查。
麦克风与录音
没有设备或没有检测到声音
- 连接麦克风，检查物理静音和系统输入音量。
- 到“设置” → “语音与快捷键”重新打开输入设备列表，选择当前可用设备；原设备拔出后不要继续沿用失效选择。
- 使用“测试麦克风”，靠近设备说几句话。测试在 10 秒内自动完成，不保存测试录音。
- 权限不足时进入系统麦克风权限设置。允许后重新测试，仍不可用时重新打开应用。
检测到声音后再试一段短录音。操作入口和各系统检查位置见检查麦克风。
没有识别到文字或识别错误
确认录音模型支持所说语言，检查麦克风选择，减少环境噪声后再试。实时录音由所选模型自动识别；文件转写仅在模型支持时可指定音频语言。只切换软件界面语言不会改变识别语言；需要用另一种语言解释、总结或提取要点时，选择对应的 AI 操作并设置输出语言；音频语言只用于识别原音频中的语言。
快捷键与直输
快捷键没有反应
- 打开“设置” → “语音与快捷键”，检查该快捷键是否成功注册，还是显示不可用或冲突。
- 如发生占用，换一组组合键并等待保存成功，再从目标应用测试。
- Linux 桌面环境可能限制全局按键；媒体按键也可能被系统或其他软件占用。先用首页或悬浮麦克风按钮确认基本录音是否正常。
- 触发了另一种模式时，检查你使用的是指定模式的快捷键，还是使用默认模式的点击或媒体按键入口。
各平台默认值与设置步骤见快捷键与耳机按键。
直输没有写入，或提示先点击输入框
先点击一个可编辑的目标输入框并放好光标，再使用直输快捷键。若应用已进入等待选择目标的状态，按提示选定输入框。录音期间保持该目标，不切换窗口或光标位置。
系统权限不足时，使用“管理直输系统权限”并完成当前系统要求；macOS 按提示检查辅助功能访问。目标应用不接受写入时，先改用编辑模式检查文字并复制粘贴，保留内容后再排查直输。
Esc 没有立即隐藏窗口
Esc 根据当前状态先处理弹层、AI 结果与原文切换，再处理收起。需要隐藏悬浮窗或退出应用时使用对应入口；关闭提示要求处理录音或保存时，先按提示完成。见结束录音、收起、隐藏与退出。
文件转写
文件无法添加或无法开始
检查文件是否属于 WAV、MP3、FLAC、OGG、M4A、MP4，是否非空且不超过 2 GB，每次是否超过 100 个文件。移除不符合要求的文件，再确认已选择支持文件转写的本地模型和音频语言。
文件改名、移动、外部修改或待选列表失效后，重新选择文件。文件扩展名符合要求但仍无法读取时，检查它能否正常播放、是否包含音轨，以及是否受损。
任务失败、中断或没有正文
- 查看该任务的错误提示，先处理模型、文件和系统资源问题。
- 失败任务点击“重新转写”。上次处理中断时，重新启动需要的任务。
- 任务已完成但没有识别到文字时，检查原音频是否有清晰语音，换用正确的音频语言和合适模型后再试。
“取消任务”只在对应任务状态提供；“清理已完成”整理任务列表，不替代删除历史。完整操作见音频文件转写。当前版本不支持说话人区分。
AI 与积分
提示需要登录或积分不足
在账号菜单确认已登录预期账户，查看可用积分。需要购买时打开个人中心，完成后核对积分明细，再返回桌面端等待账户信息更新。在积分和 AI 服务可用时执行操作。
本地转写完成后，执行 AI 操作仍需要登录、联网和可用积分。
服务不可用、输入过长或处理失败
- AI 服务不可用时，点击“重新加载”，或稍后重试。
- 输入超限时缩短文字或分段处理，再查看当前操作的积分提示。
- 网络中断、限流或平台繁忙时稍后重试；当前请求还在处理中或核对中，先等待状态更新。
- 结果已经可见时先复制保存。“重试”尝试恢复原请求；“重新执行”会创建新操作，可能再次扣除积分。
步骤和输出语言规则见AI 文本操作。无法确认积分变化时，查看账户的积分明细并提交反馈，不要连续重新生成来验证是否恢复。
登录与记录
Google 登录未返回应用
确认系统默认浏览器能打开登录页，并在同一个登录流程中完成账户选择。浏览器提示返回 VokeLine 时按提示打开应用；中途取消或超时后回到账号菜单重新发起。网络不可用或 Google 登录暂不可用时，先处理提示中的原因，或使用菜单实际提供的其他方式。
登录被替换或恢复失败
同一账户在另一个客户端的新登录会替换当前桌面会话。选择本次要使用的客户端重新登录，避免两边连续互相替换。恢复登录失败时先用账号菜单“重试”；仍失效则重新登录。见登录与会话。
登录后找不到原本的本机历史
确认记录属于访客、当前账户还是另一个账户，并确认是在同一台设备产生。本机历史按身份和设备分开；切换身份只改变当前显示的本机记录，不会自动迁移记录。跨设备需要事先保存到云端。
云端记录没有出现或保存失败
确认账户一致、已经主动保存并且网络可用，再刷新云端记录，检查“未分类”和对应标签。后续列表加载失败时，保留已加载内容并重试；达到上限时，先清理不需要的记录或标签。
编辑冲突时保留草稿并比较最新记录；本机和云端删除互不替代。清空后无法恢复的数据范围见清理记录。
帮助与反馈
入口： 从桌面“账号”菜单打开“个人中心”，再进入网站的“帮助与反馈”；需要时先登录。
- 写明软件版本、操作系统、所用功能，以及你执行了什么、预期看到什么、实际发生了什么。
- 附上准确的提示文字；模型问题补充模型名称，文件问题补充格式和大小，积分问题补充对应订单或积分记录时间。
- 如需截图，先遮挡邮箱、个人文字、付款信息等不必要内容。不要提交密码、登录令牌或服务密钥。
- 提交后在同一反馈中查看回复并补充信息，避免为同一问题重复创建多个反馈。
提交前若仍有可见文字，先复制到安全位置。出现保存失败或处理状态未确认时，保留当前数据，按具体提示处理后再重试。