命令行

meetcap 命令在终端里做 app 能做的事，智能体用的也是这套命令。这一页列出每条命令和它的选项；全部规则见 meetcap <命令> --help。

meetcap start
meetcap stop
meetcap status --all

命令行用会议库的语言。要换语言，运行 meetcap setup --lang zh 或 --lang en。

通用的选项和参数

每条命令都能用这几个选项：

选项	作用
--json	只输出一个 JSON 对象，不输出给人读的句子。
--quiet	长命令运行时不显示进度。
--library <路径>	用这个文件夹里的会议库。默认是 setup --library 设定的那个。
-h、--help	显示这条命令的选项和规则。
-V、--version	显示版本号，只能跟在 meetcap 后面直接用。

要写 <会议> 的命令，写会议的标题、文件夹名或文件夹路径都可以。几场会议标题相同时，命令会列出这几场会议，退出码是 2，这时改写文件夹名。相对路径从当前目录算，. 就是当前所在的文件夹。写路径时，MeetCap 用这个文件夹所在的会议库。

这些命令不加 --confirm 只报出会做什么：delete、audio clear、audio gc、people rename、people forget、setup --move-library、models remove、uninstall、diagnose 和 feedback。有几条删除类命令不用 --confirm，立即生效，比如 glossary remove、schedule remove、schedule off 和 config set audio_retention。

退出码

退出码	含义
0	完成。
1	其他错误，或者你中途打断了。已录制的内容都已保存。
2	命令或设置写错了。
3	当前状态不允许，例如已经有一场会在录制。
4	缺少权限；或者还没有同意《使用条款》；或者还没有同意把会议的文字发到服务地址。
5	语音识别模型或本地模型缺失，或已损坏。
6	纪要生成失败（MeetCap 会留着这项任务，运行 meetcap doctor 会再试一次）；或者连不上服务、密钥不对；或者反馈没发出去（已存成文件）。
7	这场会议的文件夹损坏，或正被其他程序占用。

录制

start

开始录制一场会议。

meetcap start [--title <标题>] [--source mic|system|both] [--until <时间>]

选项	作用
--title <标题>	给这场会议起名。默认按开始时间命名。
--source <来源>	录 mic（麦克风）、system（这台电脑的全部声音，MeetCap 自己的声音除外）或 both（两者都录）。默认 both。只录 system 时麦克风一开始是关着的，可以用 meetcap mic on 打开。
--until <时间>	到这个时间自动停止，必须是将来的时间。写成 +90m、+2h、+30s 或 YYYY-MM-DD HH:MM。默认一直录到你停止。
--participants <人数>	这场会最多有几位说话人，1 到 50 之间。用 --source both 录制时不使用。默认自动判断。
--follow	开录后留在终端里，每转出一句、每写出一条小结就显示出来。按 Ctrl-C 只停止显示，录音继续。
--summaries	与 --follow 一起用，只显示小结。
--stats	把字幕延迟、处理速度、CPU 和内存记进会议文件夹。

有一路声音没有录音权限时，MeetCap 只录另一路，并说明到系统设置里打开哪一项。两路都没有权限时，不开始录制。已有的录音用 transcribe 转写。

stop

停止正在录制的会议并保存。

meetcap stop [<会议>] [--wait]

选项	作用
<会议>	停止哪一场。默认是正在录制的那场。
--wait	等这场会议保存完成再退出。默认发出停止请求后就退出。
--discard	只用于正在转写的录音文件：立即停止，什么都不保存，把这场会议移到废纸篓。原来的录音文件不动。

pause 和 resume

暂停正在录制的会议，或继续录制。

meetcap pause [<会议>]
meetcap resume [<会议>]

暂停期间什么都不录，也不出字幕、不写小结；暂停的那段不算进会议时长。停止录制、到 --until 设定的时间自动停止仍然有效。转写已有录音的会议不能暂停。继续录制时如果没有录音权限，会议仍然暂停。

mic

在正在录制的会议里关闭或打开 MeetCap 的麦克风。

meetcap mic off|on [<会议>]

关闭后，MeetCap 不再录你这边的声音；会议软件仍正常使用麦克风，对方仍然听得到你。on 需要使用麦克风的权限，还没问过时会先询问。

status

查看一场会议在做什么，或上一场是怎么结束的。

meetcap status [<会议>] [--all] [--follow]

选项	作用
<会议>	查看哪一场。默认是正在录制的那场，没有就是最近的一场。
--all	列出会议库里的所有会议，从新到旧。
--follow	一句一句地显示这场会：在录的边录边显示，已经结束的全部显示。不能与 --all 一起用。
--summaries	与 --follow 一起用，只显示小结。

会议

transcribe

把已有的录音转成文字。

meetcap transcribe <录音> [--title <标题>]

选项	作用
<录音>	要转写的文件：wav、m4a、mp4、mov、aiff 或 mp3。
--title <标题>	给这场会议起名。默认用文件名，不含扩展名。
--out <名称>	会议的文件夹名称，只能是名称，不能带路径。默认按会议的名称生成。
--participants <人数>	录音里最多有几位说话人，1 到 50 之间。默认自动判断。
--realtime	按录制时的速度读入录音，像开会时那样边读边出字幕。默认按这台电脑的最快速度读完。
--stats	把处理速度、CPU 和内存记进会议文件夹，转写完时报出来。

文件在云盘里、还没下载到这台电脑时，transcribe 会等它下载，见云端文件。

retranscribe

用这场会议的录音重新转写整段，补齐逐字稿。

meetcap retranscribe <会议>

录音意外中断、逐字稿只写到一小段时用它。它只用这台电脑上的录音，会议要已经结束。补齐后，还没有纪要的会议会生成纪要，已有的纪要不变。

rename

修改一场会议的标题。

meetcap rename <会议> <标题>

标题要有 1 到 200 个字。会议笔记和逐字稿开头的标题跟着改，会议的文件夹名不变。正在录制的会议也可以改。

label

给一个说话人起名，这场会议和以后的会议都会用它。

meetcap label <会议> <编号> <名字>

选项	作用
<编号>	说话人在这场会里的编号，例如 S1。把同一个名字给两个编号，这场会里他们就是同一个人。
<名字>	64 个字以内；不能以空格开头或结尾，不能以点结尾，也不能有 / \ : * ? " < > |。
--line <标识>	给说这一句的人起名，写逐字稿里这一句的标识，例如 u000123。
--no-enroll	只改这场会里的名字，不记住声音。默认会记住。

要记住声音，这个人得在这场会里清楚地说满约 30 秒，见说话人与声音。

minutes

给一场已结束的会议写纪要，按「设置 › 纪要」里选的方式生成。

meetcap minutes <会议> [--lang zh|en]

选项	作用
--lang <语言>	用 zh 或 en 写。已有一种语言的纪要时，另一种语言由它翻译过来；还没有纪要时，只能写会议库的语言。默认是会议库的语言。

纠正逐字稿里的人名和术语，和写纪要是同一项任务。选了「与智能体对话」时，这条命令只把任务排给你的智能体。

export

把一场会议导出成可以交给别人的文件，会议本身不变。

meetcap export <会议> --to md|docx|pdf|vtt [--out <路径>]

选项	作用
--to <格式>	md 把会议笔记、逐字稿和会中小结复制进一个新文件夹；docx 和 pdf 由纪要和逐字稿生成；vtt 是逐字稿做成的字幕。必须写。
--lang <语言>	只用于 docx 和 pdf：导出 zh 还是 en 的纪要。默认是会议库的语言。还没有纪要的会议改用会中小结，只能用会议库的语言；用另一种语言时，这场会要已有那种语言的纪要（用 meetcap minutes --lang 生成）。
--out <路径>	导出放到哪里。给一个已有的文件夹，就放进去、用会议的名称命名，不覆盖任何文件。给一个还不存在的路径，就用它作名字，它所在的文件夹要已经存在。给一个已有的 docx、pdf 或 vtt 文件，就替换它。不能放进会议库。默认是当前目录。

有会中小结的会议，导出 docx 和 pdf 时另出一个小结文件。正在录制或整理的会议，整理完成后才能导出。见导出。

delete

把会议移到废纸篓，连同它在这台电脑上的录音。

meetcap delete <会议>... [--confirm]

选项	作用
<会议>...	要删除的会议，可以写几场。
--confirm	真的移到废纸篓。不加时只报出会移走几场会议、文字和录音各多大。

正在录制或整理的会议会先停止再移走。记住的声音不删，其他电脑上的录音也不动。

会议库

people

查看会议库记住了哪些人的声音，给其中一人改名，或者忘掉其中一人。

meetcap people
meetcap people rename <名字> <新名字> [--confirm]
meetcap people forget <名字> [--confirm]

命令	作用
people、people list	列出每个人出现在几场会议里、最近一次是哪场，以及存了他多少秒的声音。
people rename <名字> <新名字>	给这个人改名，会议库里每场会议的名字也一起改。新名字已是认得的人时，两人合并成一个，合并后无法拆分。新名字的规则与 label 相同。
people forget <名字>	删除这个人的声音记录。以后的会议不再认出他，过去会议里的名字不变。

glossary

查看会议库的术语表，或添加、删除术语。识别时会优先认出这些写法，小结和纪要也按它们来写。

meetcap glossary
meetcap glossary add <写法> [--alias <别名,别名>] [--note <备注>]
meetcap glossary remove <写法>

选项	作用
<写法>	这个词的正确写法，不能有 | 或换行。表里已有这个写法时不重复添加，不分大小写和全角半角。
--alias <别名,别名>	它常被听错成的写法，用逗号隔开。默认没有。
--note <备注>	关于它的一句备注，不能有 | 或换行。默认没有。

含有数字、符号或生僻字的写法不用于字幕和转写，小结和纪要仍会用到。要让术语在某场会的逐字稿里用上，在会议结束前或开始转写录音前添加。

schedule

管理这台电脑上的定时录制。定时只在这台电脑上，不跟着会议库走。

meetcap schedule add <定时> [--title <标题>]
meetcap schedule list
meetcap schedule remove <编号>
meetcap schedule off

命令或选项	作用
schedule add <定时>	到点开始录，录够时长停止。写成 [星期,星期… ]HH:MM[+时长]，例如 mon,thu 09:30+90m。星期写 mon 到 sun，不写表示每天；时长写 +90m、+2h 或 +30s，默认 1 小时。
--title <标题>	这条定时录下的会议叫什么，1 到 200 个字。默认按每场的开始时间命名。
schedule list	列出定时：编号、标题、什么时候录、下一次是哪天。
schedule remove <编号>	删除一条定时，写 schedule list 显示的编号。
schedule off	删除这台电脑上的全部定时。

定时录进添加它时正在使用的会议库。这个会议库之后换了位置，定时会跟着录到新位置。见定时开录。

audio

管理这台电脑上的录音。

meetcap audio clear [--confirm]
meetcap audio gc [--confirm]

命令	作用
audio clear	清除会议库里所有会议在这台电脑上的录音，逐字稿和纪要都留着。还用得着录音的会议会跳过并说明。
audio gc	把多余的录音移到废纸篓：已删除的会议留下的录音，以及断掉后无法修复的录音片段。

两条命令不加 --confirm 时都只报出涉及几场会议、多大。见录音只留在这台电脑上。

config

列出这台电脑和会议库的设置：每项的值和怎么改。

meetcap config
meetcap config get <键>
meetcap config set <键> <值>

键	可以写的值
default_tags	每场新会议的笔记默认带上的标签，用逗号或顿号分隔，例如 周会,产品；写 "" 清除。
summary_interval_min	会中每隔几分钟写一条小结：2、3、5、10 或 15。默认 5。
minutes_both_langs	每场会的纪要是否同时出中英两份：on 或 off。默认 off。已有的会议不补。
audio_retention	录音保留多久：1m（30 天）、3m（91 天）、6m（182 天）或 off（一直保留）。默认 off。设定后立即按它清除一次。

会议库的位置、语言和纪要怎么生成用 setup 改。见设置项。

设置与检查

setup

设置 MeetCap，或者更改会议库、它的语言、纪要怎么生成。

meetcap setup

不带选项时，按 app 里的顺序问同样的问题，最后请求麦克风和系统声音权限。带选项时只改给出的那几项，不请求权限。

选项	作用
--library <路径>	使用或新建这个文件夹里的会议库，并把它设为这台电脑用的会议库。
--lang <语言>	设定会议库的语言：zh 或 en。新建会议库时默认跟随系统语言。
--mode <方式>	小结和纪要由谁生成。byok 是自己的 API 密钥，同时给出 --endpoint；harness 是由 MeetCap 启动的智能体，同时给出 --agent；skill 是与智能体对话；local 是在这台电脑上生成，本地模型尚未下载时也会保存，并说明怎么下载。hosted（MeetCap 账号）暂未开放。
--agent <名称>	与 --mode harness 一起用：用哪个智能体，写 meetcap agents 列出的名称。它要装在这台电脑上，版本够新。
--model <模型>	与 --mode harness 一起用：智能体用的模型，默认用智能体自己的设置。与 --mode byok 一起用：服务上的模型，保存时必须写。
--effort <强度>	与 --mode harness 一起用：这个智能体提供的推理强度。默认用智能体自己的设置。
--endpoint <地址>	与 --mode byok 一起用：服务地址，以 https:// 或 http:// 开头。之后 MeetCap 会请你输入 API 密钥，密钥只保存在这台电脑上。
--test	与 --mode byok 一起用：只测试连接、列出服务的模型，什么都不保存。
--accept-terms	同意《使用条款》和《隐私说明》。每台电脑只需同意一次，在 app 或命令行里同意均可。不加时会在终端里询问；无法询问时（比如由智能体运行），什么都不设置，退出码是 4。
--agree	与 --mode byok 一起用：同意把会议的文字发到这个服务地址。不加时会在终端里询问；无法询问时（比如由智能体运行），不保存，退出码是 4。
--move-library <路径>	把会议库连同认得的人、术语表和设置移到这个文件夹，录音不移动。有会议正在录制、转写、整理，或正在生成纪要时不能移动。
--confirm	与 --move-library 一起用：真的移动。不加时只报出会移动几场会议、多大、从哪里移到哪里。

见首次设置和换会议库位置。

models

下载语音识别或本地模型，查看下载多大，或删除本地模型。

meetcap models get
meetcap models plan
meetcap models get --local
meetcap models remove --local

命令	作用
models get	下载语音模型：下载约 420 MB，装好后约占 500 MB。MeetCap 先从最快的来源下载，比如中国大陆用 ModelScope，其他地区用 GitHub 与 Hugging Face。一个来源下载不了，就换下一个。
models plan	只报出要下载多少、装好后约占多少空间，什么都不下载。加 --local 只报本地模型。
models get --local	只下载「在这台电脑上生成」用的本地模型。只有选了「在这台电脑上生成」或运行这条命令时，MeetCap 才会下载它。下载完成后，排着等它的小结和纪要会开始生成。见在这台电脑上生成。
models remove --local	只报出删除本地模型能腾出多少空间；加 --confirm 才删除。会议库正在用「在这台电脑上生成」，或本地模型正在写小结或纪要时，带不带 --confirm 都不删除，只说明要先做什么。已生成的小结和纪要都会留着。

permissions

查看 MeetCap 能不能使用麦克风、录制这台电脑播放的声音。

meetcap permissions
meetcap permissions ask

permissions 只查看，不弹出询问。permissions ask 请 macOS 允许这两项权限，并一直等到你回答；它不录音。有一项没有允许时，会说明到系统设置里打开哪一项。见授权。

doctor

检查会议库、语音识别和磁盘。

meetcap doctor

doctor 还会清除超过「录音保留多久」的录音，并在后台开始补写已结束的会议还缺的小结和纪要。用自己的 API 密钥时，这些会议的文字会发到你设的服务地址；选了「与智能体对话」时，doctor 只报出还有几项。见用 doctor 检查。

diagnose

保存诊断信息，出了问题时发给我们。不需要会议库。

meetcap diagnose [--confirm]

选项	作用
--confirm	保存诊断信息，并显示文件存在哪里。不加时只列出里面会有什么。

诊断信息包括近期的运行记录、意外退出的记录和 doctor 的检查结果，不含录音、逐字稿、纪要、会议标题、人名和密钥。MeetCap 只保留最新的 3 份。

logs

临时打开详细日志，用来排查问题。不需要会议库。

meetcap logs debug on [--for <时长>]
meetcap logs debug off

命令或选项	作用
logs debug on	这台电脑上的 MeetCap 多记一些细节，正在录制的会议也一样。到时间自动恢复平时的记录。
--for <时长>	与 on 一起用：打开多久，写成 30m 或 2h，最长 24 小时。再打开一次会重新计时。默认 60 分钟。
logs debug off	立即恢复平时的记录。

日志里不记会议说了什么、会议标题和人名。

feedback

把问题的描述发给我们，默认附上诊断信息。不需要会议库。

meetcap feedback --message <描述> [--contact <联系方式>] [--no-diagnostics] [--confirm]

选项	作用
--message <描述>	问题的描述，去掉首尾空白后 1 到 5000 个字。写 - 表示从标准输入读。必须写。
--contact <联系方式>	我们怎么联系你，例如电子邮件地址，最多 200 个字。默认不留。
--no-diagnostics	不附诊断信息。默认附上。
--confirm	发送反馈。不加时只列出会发送什么。

无法发送时，反馈会存成文件，并说明存在哪里，可以用电子邮件发给我们。发送成功后会给出一个编号，要我们删除这份反馈时提供它。

agents

列出这台电脑上可以生成小结和纪要的智能体。

meetcap agents [--try <名称>]

选项	作用
--try <名称>	给这个智能体发一条简短的测试提示词，确认它能用，最多等 3 分钟。写列表里每行开头的名称，例如 claude。
--model <模型>	与 --try 一起用：测试哪个模型，要是这个智能体提供的。默认用智能体自己的设置。
--effort <强度>	与 --try 一起用：测试哪档推理强度，要是这个智能体提供的。默认用智能体自己的设置。
--fresh	重新向每个智能体查询可选的模型和推理强度，约需 10 秒。不能与 --try 一起用。

uninstall

移除 MeetCap 添加到这台电脑上的内容。会议库和 app 本身不会移除。不需要会议库。

meetcap uninstall [--confirm]

选项	作用
--confirm	真的移除。不加时只列出会移除什么、在哪里、多大。

移除的内容会移到废纸篓，其中包括语音识别模型和只存在这台电脑上的录音。MeetCap app 开着或还在处理会议时，不会移除任何内容。见卸载。

主要给智能体用的命令

你在对话里让智能体写小结和纪要、补充一场会的资料时，智能体用的是下面这几条命令，你自己很少用到。见和智能体一起用。

命令	作用
summarize <会议>	在会议录制中小结其中一段。--range <开始:结束> 用秒数指定一段，例如 300:600，默认是上一条小结之后到现在；--lang zh|en 指定语言。
context <会议>	查看一场会的资料：参会人、议程、用到的术语、上一次会议谈到了哪里。--set <文件> 用文件里的内容替换现有的，写 - 从标准输入读。
prompt <会议> <任务>	输出一项任务的完整提示词：summary、minutes、translate 或 names。每种生成方式交给 AI 的都是这一份。--out <文件> 写进文件。
submit <会议> <任务> [文件]	交回一项任务的结果，一个 JSON 对象。每项检查都通过，MeetCap 才保存。不写文件或写 - 时从标准输入读。

各项任务的结果格式见 meetcap submit --help。