命令速查

命令以 / 开头，例如 /status。ZAI 收到命令后直接处理并回复，不会把它当作任务交给模型。

命令速查

其他组织的成员在群里发的命令不会执行，也不会收到回复。/connect 只有商店版 ZAI（从飞书应用中心安装的 ZAI，见安装商店版 ZAI）支持；企业自建的 ZAI 由 Z Tag 管理员配置，发送 /connect 只会收到帮助。

怎样输入命令

命令作为一条纯文字消息发送，可以在开头 @ZAI 一次；在话题里回复也可以发命令。带格式或代码块的富文本、图片和文件消息不算命令。除了 /codex、/claude 后面要做的事，命令不接受自然语言参数。

中文输入法打出的全角 ／ 和半角 / 一样算命令，ZAI 回复里提到命令时仍写半角 /。/codex、/claude 后面可以不加空格直接写中文，例如 /codex帮我整理这份周报，见只用一次指定的 Engine。

在 ZAI 所在的群里，命令即使没有 @ 它也能使用。发送 /help 可以查看可用命令及简短用途；群里和私聊里的帮助分别列出群里和私聊里的命令。

命令词写错或只记得开头时，例如 /hepl、/organiz，ZAI 会显示帮助，不执行相近的命令。匹配时不区分大小写：命令词是某个已知命令的前缀，或增删、替换少于 5 个字符就能得到已知命令，都会显示帮助。其他不相近的词按普通消息处理。

以下情况不触发命令或拼写帮助：

• 首个命令词超过 20 个字符。这个长度包含 /，不包含后面的参数，所以长模型名和任务说明仍然可以使用。
• 带目录分隔符、扩展名或查询片段的文件、网址路径，例如 /tmp/report.txt、/api/v1、/status?plain=1；常见的单段路径（如 /tmp、/etc、/api）也不会触发。
• 代码格式中的内容，以及包含多行文字的控制命令。/codex、/claude 后面的任务说明可以换行。
• 除 /codex、/claude 外，命令词后面不加空格直接接着中文，例如 /model是什么、/status怎么样；写错的命令词这样接上中文也一样，例如 /code目录。

普通消息仍按所在聊天的 @ 和自动跟进规则处理。其他单段路径可能与命令或拼写帮助重合（例如 /status），请用代码格式表明它是路径。

/stop、/restart、/mute、/exit、/unmute 和 /connect 后面不能多写字，多写了不会执行，ZAI 会回复可用命令列表；/help、/status、/organization 和 /configure 会忽略后面多写的字；/brief 的参数写错时不执行，ZAI 回复它的用法。

打开控制台

发送 /organization（也可写 /configure），ZAI 回复一张「组织控制台」卡片，点「打开控制台」即可进入组织的控制台。你自己的连接器、远程设备、插件等资源都在控制台里管理，见在控制台管理自己的资源。

查看或切换模型

• /engine 查看现在用的 Engine 与 Model。
• /engine codex [model-name] 或 /engine claude [model-name] 切换 Engine，可以同时指定 Model。省略 Model 时，如果现在用的就是这个 Engine，沿用它的 Model；否则用这个 Engine 的系统默认 Model。
• /model 查看现在的 Model，/model <model-name> 只换 Model。还没有生效的 Engine 时，ZAI 会提示先用 /engine。

在群里发送，改的是这个群；在私聊里发送，改的是你自己。群里任何本组织成员都可以改这个群的 Engine 与 Model，组织 Owner 和 Admin 也能在控制台的模型路由里查看和修改，见配置模型路由与回复审阅。

已经开始的话题继续用原来的设置；新话题、/restart 之后，或话题空闲一段时间后再继续时，才用新设置，见ZAI 会记住一个话题多久。ZAI 回复里的「配置将在新 Session 生效」说的就是这个意思。

只用一次指定的 Engine

/codex [model-name] -- prompt 和 /claude [model-name] -- prompt 用指定的 Engine 开始一次新任务，不改变这里的设置。省略 Model 时写 /codex -- prompt，Model 的选法与 /engine 相同。不写 --、要做的事又多于一个词时，第一个词会被当作 Model 名称；命令后面不加空格直接写中文时（/codex帮我整理这份周报），紧跟着的整段文字都是要做的事，不会被当作 Model 名称。

ZAI 只去掉开头的 @ZAI 和命令，任务说明里的换行、缩进和 @ 的人都原样交给它。

在群里要作为一条新消息发送（话题群里新建一个话题），不能在已有话题里回复；在已有话题里发送只会收到「一次性 Engine 命令请作为新消息发送，不能放在已有话题中。」

在回复里显示用量

ZAI 回复里的耗时、tokens 和工具调用统计默认不显示。/usage 或 /usage status 查看，/usage on 开启，/usage off 关闭。

设置作用于这个群或这段私聊的全部话题。群里由组织 Owner / Admin 修改，私聊里你自己可以修改；没有权限的人修改时会收到「你没有修改当前群用量展示的权限。群由组织 Owner/Admin 设置，私聊本人也可设置。」

开启后，任务结束时，ZAI 在普通结果消息底部加一条短分割线和耗时、tokens、工具调用统计；卡片里的统计位于可展开的「本次用量」中，普通消息、回复卡片和失败卡片共用这个开关。关闭后，失败说明和失败卡片上的「重试本次请求」按钮照常显示。只添加表情回复或保持安静时，不会另发用量。回复的其他组成见文件、图片与任务结果。

设置对之后完成的任务生效，正在进行的话题不用重新开始；已经发出的消息不会改。不管开不开，用量都会照常记录，见在控制台管理自己的资源。

查看运行状态

ZAI 没有回复、你想确认它是否还在处理时，发送 /status：

• 在话题里发送，查看这个话题；在群里，回复里还会说明 ZAI 是否在自动跟进这个话题。
• 在私聊里、不在话题内发送，查看你和 ZAI 的整个私聊。
• 在群里、不在话题内发送，查看群里有几个话题正在处理。

回复只说明是否仍在工作、已经进行了多久，不复述任务内容；查询不会打断正在进行的工作，也不会开始新任务。回复公开显示在命令所在的话题或消息下，群里其他人也看得到。

停止正在进行的任务

在任务所在的话题里发送 /stop，或点进度卡上的「停止任务」，ZAI 会结束这个话题里正在进行的工作，包括已经排队、还没开始处理的补充消息。发送 /stop 时，ZAI 回复「已停止。已经发出的消息和已完成的操作不会撤回。」

• 在私聊里、不在话题内发送 /stop，会停止你和 ZAI 私聊里所有正在进行的工作。
• 在群里、不在话题内发送，只会收到「/stop 用于停止话题里正在进行的任务，请在该话题内发送。」
• 只有能在这里向 ZAI 提出请求的人才能停止任务。
• 进度卡已经无法操作时，点「停止任务」会提示「这张进度卡已无法操作。如需停止任务，请在它所在的话题或私聊里发送 /stop。」

停止只结束这一次的工作，不会静音话题；之后在话题里继续发言，会开始新的一轮。停止后表情怎样变化，见你会看到什么。

让话题重新开始

ZAI 在某个话题里卡住，或你想让它不带之前的工作进度重新开始时，在话题里发送 /restart。ZAI 会重启这个话题的 Session，并回复「已重启这个话题的 Session。下一条请求会开启新的 Session，并重新读取话题内容。」话题里还有进行中的工作时，它会先停下这些工作，回复改为以「已停止进行中的任务，并重启这个话题的 Session。」开头。

下一条请求会重新读取话题里的消息，之前说过的内容 ZAI 仍然看得到；没发回话题的临时文件不再保留。已经发出的消息和已经完成的操作不会撤回。在话题外发送只会收到用法提示。Session 的意思见你会看到的词。

静音话题

在群里的话题中发送 /mute（也可写 /exit），ZAI 回复「已静音这个话题：我不再自动跟进，也不在这里发言。带请求 @ 我或发送 /unmute 可以恢复；需要停止进行中的任务请用 /stop。」之后它不再跟进这个话题里没有 @ 它的发言。

正在进行的工作会继续做完，但结果不会发到这个话题里：ZAI 不再在这里发消息、修改消息或添加表情回复。命令的回复照常发送，进度卡和状态表情也照常更新。还想收到这次的结果，请在它做完之前发送 /unmute；要让它停下，发送 /stop。

在话题里 @ZAI 提出请求，它会处理这条请求并恢复跟进；发送 /unmute 也可以恢复。/status 等命令不会解除静音，可以用 /status 确认这个话题是否已静音。静音不会结束这个话题，之后 @ZAI 仍能接着之前的内容继续；话题空闲很久之后再回来，静音也仍然有效。

/mute、/exit 和 /unmute 只在群里已有话题内的回复中有效，不适用于群里话题外的消息、话题群里新话题的首条消息和私聊；发错地方只会收到「/mute 只用于群里的话题，请在该话题内发送。」

个人提醒

/brief 管理 ZAI 在私聊里发给你的晨报、日报和个人协助：

• 在私聊里发送，查看或修改你自己的设置：/brief 查看状态，/brief morning off 关闭晨报，/brief pause 3 暂停三天，/brief all reset 恢复默认。
• 在群里发送 /brief off，这个群退出所有成员的个人提醒，/brief on 恢复；其他个人设置在群里只会收到「你的个人提醒设置请在和我的私聊里修改。……」。
• 组织 Owner / Admin 在任意群或私聊里发送 /brief org all forbid 等命令，为整个组织设置。

参数、默认发给谁和读取哪些内容见个人提醒。

连接 Z Tag 组织

商店版 ZAI 装进企业后，要先把企业连接到一个 Z Tag 组织，大家才能使用它。

1. 本企业的应用管理员（在飞书管理后台审核和管理应用的管理员）在私聊里向 ZAI 发送 /connect。ZAI 回复一张配对码卡片，上面有企业名、配对码和 在控制台连接 按钮。配对码 15 分钟内有效，只能使用一次；再次发送 /connect 会换一个新码，旧码随即失效。
2. 点 在控制台连接，用飞书登录控制台，选择 新建组织（只有获取配对码的人可以），或连接到你担任 Owner 的组织。也可以把配对码交给要连接本企业的组织 Owner，由他在控制台的 IM 接入 里粘贴连接，见用配对码连接。
3. 连接后，获取配对码的人会在私聊里收到「本企业已连接到一个 Z Tag 组织」的通知。

持有配对码的任何组织 Owner 都能连接本企业，请只交给信任的人；怀疑配对码泄露时，再次发送 /connect 换掉它，或在飞书管理后台停用 ZAI。

• 不是应用管理员的人发送 /connect，ZAI 回复只有应用管理员可以获取配对码。
• 在群里发送 /connect，ZAI 提示改在私聊里发送。
• 企业已经连接时，在群里或私聊里发送 /connect，ZAI 回复本企业连接的组织，回复上有 连接我的账号，见连接我的账号。企业这一侧不能断开连接；要断开或改连到其他组织，须由所连组织的 Owner 在控制台断开，见断开与本组织的连接。