用 doctor 检查

meetcap doctor 检查会议库、两项权限、语音识别和磁盘空间，每项检查显示一行。写着「正常」的行不用处理；写着「有问题」的行会说明怎么处理。

运行 doctor

1. 打开「终端」。

2. 运行下面这条命令。

   meetcap doctor

终端提示找不到命令时，运行 ~/.local/bin/meetcap doctor。

一切正常时，结果如下：

会议库：正常。/Users/you/Library/Mobile Documents/com~apple~CloudDocs/MeetCap
权限：麦克风：已允许。
权限：系统声音：已允许。
语音识别：正常。这个会议库用的已下载。
模型文件：正常。5 个都已下载。
模型共占 494 MB，放在 /Users/you/Library/Application Support/MeetCap/models。要腾出空间可以删掉这个文件夹；删掉后仍能录音，但要运行 meetcap models get 重新下载后才有逐字稿。
录音文件夹：正常。/Users/you/Library/Application Support/MeetCap/audio
磁盘：正常。还有 353.1 GB。

doctor 会改动什么

doctor 主要只做检查，另外会按你的设置做两件事：

• 在「设置 › 存储」里设了「录音保留多久」的，清除超过保留期的录音。
• 在后台开始补写已结束的会议还没生成的小结和纪要，不等写完。文字发给你选的 AI，和平时会后一样。选了「与智能体对话」的，doctor 只报还有几项。

每一行的意思

下面几行每次都有：

行	检查什么	有问题时怎么办
会议库	会议库在不在，MeetCap 能不能写入。	按这一行说的做。还没有会议库的，先完成首次设置。
权限	麦克风和系统声音各一行。	见授权。
语音识别	这个会议库用的语音识别已经下载。	运行 meetcap models get。
模型文件	语音识别要用的文件都已下载、完整无缺。下一行写明这些文件放在哪里、占多少空间。	运行 meetcap models get，它只下载缺少或损坏的文件。
录音文件夹	MeetCap 能把录音存进这台电脑的录音文件夹。	这一行说那是一个文件的，把这个文件移到别处；说无法写入的，调整这个文件夹的权限。
磁盘	存录音的磁盘至少还有 2 GB 可用空间，不到 2 GB 无法开始录音。	腾出空间。要清除旧录音，打开「设置 › 存储」。

这台电脑上有录音时，还有一行说明录音占多少空间、最早一场是什么时候。

下面几行只在相关时出现：

行	意思	怎么办
会议库设置	会议库的 config.json 里有一项设置无法使用，这一行会点名。	修改或删掉那一项。
语言	会议库的语言设置无法使用，暂时用另一种语言。	在「设置 › 通用」里重新选择语言。
下载	有下载没有完成，留下了文件。	运行 meetcap models get，它会先清理这些文件。
下载来源	文件从哪里下载，以及哪个来源失败了。	有问题时，先检查网络，再运行一次 meetcap models get。
记住的声音	记住的声音来自另一版语音识别，现在认不出以前记住的人。	运行 meetcap models get。
术语	语音识别缺少一个文件或文件已损坏，识别时不会参考术语表里的写法；录音不受影响。	运行 meetcap models get。
模型列表	这份 MeetCap 安装不完整。	重新安装 MeetCap。
写小结和纪要的智能体	选了「由 MeetCap 启动的智能体」时出现，检查那个智能体在这台电脑上、版本够新。	安装或更新这个智能体，或在「设置 › 纪要」里换一个。
本地模型	选了「在这台电脑上生成」时出现，检查本地模型已下载且完整，并写明它占用多少磁盘空间。	运行 meetcap models get --local。
待生成的小结和纪要	已结束的会议还没生成的小结和纪要。	一般不用处理。某一项失败 3 次后不再自动重试，运行这一行给出的命令再试一次，会说明原因。

反馈问题

遇到问题时，可以直接在 MeetCap 里反馈给我们。

1. 右键点按菜单栏里的 MeetCap 图标，选「反馈问题」。也可以在「帮助」菜单里选。
2. 描述发生了什么。
3. 点「发送」。

反馈会附上诊断信息，帮我们找到原因。诊断信息不含录音、逐字稿、纪要和人名。想在发送前查看，点「显示详细信息」。

发送不成功时，MeetCap 会把反馈存成文件，按反馈页上的邮箱发给我们。

只想保存诊断信息、不发反馈，在同一个菜单里选「保存诊断信息」。

在终端里，用 meetcap feedback 和 meetcap diagnose。

报问题时附上结果

在 GitHub 上报问题时，表单会要 meetcap doctor 的结果：

1. 运行 meetcap doctor。
2. 把显示的内容全部复制，贴进表单。

meetcap doctor 的结果里有电脑上的文件夹路径，不想公开的可以删掉。Issue 是公开的，不要附录音，也不要贴逐字稿原文。