命令速查

命令以 ! 开头。在频道和群聊里先 @zai，例如 @zai !status；在私信里直接发送 !status，不用 @。ZAI 收到命令后直接处理并回复，不会把它当作任务交给模型。

命令速查

下表的命令在频道和群聊里都写在 @zai 后面，在私信里直接发送。

访客和其他组织的成员在频道或群聊里发的命令不会执行，也不会收到回复（商店版 ZAI 的工作区还没有连接组织时例外，见连接 Z Tag 组织）；在私信里发送，只会收到一句不能使用的说明。!connect 只有商店版 ZAI（从 Z Tag 提供的安装链接装进工作区的 ZAI，见安装商店版 ZAI）支持；Z Tag 管理员配置的自建应用里，发送 !connect 只会收到帮助。

怎样输入命令

• 命令紧跟在 @zai 后面，写在消息开头，例如 @zai !status；私信里不用 @，直接发 !status。频道、私人频道和群聊里都要先 @zai。
• 不要把命令放进代码格式或引用里，否则它不会被当作命令。
• ! 也可以写成 /，但同样要先 @zai。私信里不带 @、以 / 开头的消息会被 Slack 当作它自己的斜杠命令，到不了 ZAI，所以私信里请用 !。
• ! 和 / 使用相同的识别规则。命令词写错或只记得开头时，例如 !hepl、!organiz，ZAI 会显示帮助，不执行相近的命令。匹配时不区分大小写：命令词是某个已知命令的前缀，或增删、替换少于 5 个字符就能得到已知命令，都会显示帮助；其他不相近的词按普通消息处理。
• 频道里不以 @zai 开头的 ! 消息只是普通消息；在 ZAI 参与的消息列里，它会像其他回复一样打断正在进行的任务，由 ZAI 从这条消息接着处理。
• ZAI 的回复里提到命令时，沿用你发命令时的写法。
• 中文输入法打出的全角 ！、／ 与半角的 !、/ 相同，回复里写成半角。!codex、!claude 后面可以不加空格直接写中文，例如 @zai !codex帮我整理这份周报，见只用一次指定的 Engine。

发送 @zai !help（私信里发送 !help）可以查看可用命令及简短用途。频道、群聊和私信里的帮助只列出各自可用的命令。

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

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

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

!stop、!restart、!mute、!exit 和 !unmute 后面不能多写字，多写了不会执行，只显示帮助；!help、!status、!organization 和 !configure 会忽略后面多写的字。

!connect 后面多写了字不会获取配对码：工作区还没有连接时只收到「本工作区还没有连接 Z Tag 组织」开头的说明，已经连接时只显示帮助。

与其他组织共享、有访客，或 ZAI 无法确认成员的频道里，大多数请求和命令只会得到一句说明，停止、静音和关闭后台能力的命令照常生效，见访客与 Slack Connect。

打开控制台

发送 @zai !organization（也可写 !configure；私信里直接发 !organization），ZAI 回复「组织在 Z Tag 控制台中管理：」和「打开控制台」入口，点它即可进入组织的控制台。你自己的连接器、远程设备、插件等资源都在控制台里管理，见在控制台管理自己的资源。

查看或切换模型

以下写法用于频道和群聊；在私信里去掉开头的 @zai。

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

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

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

只用一次指定的 Engine

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

ZAI 只去掉开头的 @zai 和命令，消息的其余部分与不带命令时一样交给它：任务说明里的换行、代码块、列表、链接和 @ 的人，以及这条消息附带的文件和分享的消息。

在频道和群聊里要发一条新的顶层消息，不能在已有的消息列里发送；在已有消息列里发送只会收到「一次性 Engine 命令请作为新消息发送，不能放在已有消息列中。」

在回复里显示用量

@zai !usage 或 @zai !usage status 查看用量展示的设置，@zai !usage on 开启，@zai !usage off 关闭；在私信里去掉开头的 @zai。开启后，回复的页脚多出耗时、tokens 和工具调用统计；页脚平时写什么、什么时候不发，见回复、页脚与失败。

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

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

查看运行状态

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

• 在消息列里发送，查看这个消息列；在频道或群聊的消息列里，回复里还会说明 ZAI 是否在自动跟进它。
• 在私信里、不在消息列内发送 !status，查看你和 ZAI 的整个私信。
• 在频道或群聊里、不在消息列内发送，查看这里有几个消息列正在处理。

回复只说明是否仍在工作、已经进行了多久，不复述任务内容；查询不会打断正在进行的工作，也不会开始新任务。频道和群聊里的回复只有你能看到：这是 Slack 只对你显示的临时消息，不会保留，刷新或换设备后就消失，你不在线时可能收不到。私信里是普通回复。

停止正在进行的任务

ZAI 工作时，消息列底部会显示 Slack 的运行指示，点上面的停止按钮就能结束这次处理；私信里也有这个按钮。也可以在消息列里发送 @zai !stop（私信里是 !stop）。ZAI 会结束这个消息列里正在进行的工作，包括已经排队、还没开始处理的补充消息。

• 工作区没有显示运行指示时，运行中的进度消息末尾有一个「停止」按钮；任务结束或被停止后按钮消失。点已经结束的任务上残留的按钮，只会提示「任务已经结束。」没有进度消息的任务，请用 !stop。
• 等待审批期间，运行指示不再显示为处理中；批准后 ZAI 接着做。
• 发送 !stop 时，ZAI 回复「已停止。已经发出的消息和已完成的操作不受影响。」点停止按钮后，消息列里的说明会 @ 你，写明是你停止了本次处理，并同样说明已经发出的消息和已完成的操作不受影响。
• 在私信里、不在消息列内发送 !stop，会停止你和 ZAI 私信里所有正在进行的工作；在频道或群聊里、不在消息列内发送，只会收到「!stop 用于停止消息列里正在进行的任务，请在该消息列内发送。」
• 只有能在这里向 ZAI 提出请求的人才能停止任务。访客和其他组织的成员点了不生效，进度消息上的停止按钮会给他们一条只有自己看得到的说明「只有能在这里向我提出请求的人才能停止这项任务。」

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

让消息列重新开始

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

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

静音消息列

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

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

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

!mute、!exit 和 !unmute 只在频道和群聊的消息列里有效，不适用于消息列外的消息和私信；发错地方只会收到「!mute 只用于频道和群聊里的消息列，请在该消息列内发送。」

消息列的首条消息被删除后，这个消息列已经关闭：!restart、!mute 和 !unmute 都只会收到「这个消息列的首条消息已被删除，这个消息列已关闭。请另开一个消息列继续。」请在频道里重新发一条消息开始，见编辑与删除。

响应其他应用的 @

@zai !apps 或 @zai !apps status 查看，@zai !apps on、@zai !apps off 切换这个频道或群聊是否响应其他应用（机器人、工作流程）对 ZAI 的 @，默认开启。开启时，ZAI 在那条消息的消息列里回复。

频道和群聊里本组织的成员都可以切换；访客和其他组织的成员发送时不执行。在私信里发送只会收到「其他应用的 @ 只在频道和群聊里生效。」其他应用 @zai 时 ZAI 怎样处理，见其他应用的 @。

连接 Z Tag 组织

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

1. 本工作区的 Slack 工作区管理员（工作区的管理员、所有者或主所有者）在私信里向 ZAI 发送 !connect。ZAI 在消息列里回复一条「连接 Z Tag 组织」配对码消息，上面有工作区名、配对码和 在控制台连接 按钮。配对码 15 分钟内有效，只能使用一次；再次发送 !connect 会换一个新码，旧码随即失效。
2. 点 在控制台连接，用 Slack 登录控制台，选择 新建组织（只有获取配对码的人可以）。要连接到你已担任 Owner 的组织，先在同一个浏览器里从那个组织的 IM 入口登录控制台，再点 在控制台连接。也可以把配对码交给要连接本工作区的组织 Owner，由他在控制台的 IM 接入 里粘贴连接，见用配对码连接。
3. 连接后，获取配对码的人会在私信里收到「本工作区已连接到一个 Z Tag 组织」的通知。

持有配对码的任何组织 Owner 都能连接本工作区，请只交给信任的人；怀疑配对码泄露时，再次发送 !connect 换掉它，或从工作区移除 ZAI。

• 工作区还没有连接时，在频道或群聊里发送 @zai !connect，配对码或说明私信发给你，频道里只有你看得到一句「已私信回复你，请在私信里查看。」
• 不是工作区管理员的人发送 !connect，ZAI 回复只有工作区管理员可以获取配对码。
• 工作区还没有连接时，访客在频道里发送 @zai !connect，只收到一句只有自己看得到的不能使用的说明；在频道里 @zai 发其他命令，与普通的 @ 一样收到「本工作区还没有连接 Z Tag 组织」开头的说明。
• 工作区已经连接时，发送 !connect（频道里 @zai !connect，回复只有你看得到），ZAI 回复本工作区连接的组织，回复里有 连接我的账号，见连接我的账号。工作区这一侧不能断开连接；要断开或改连到其他组织，须由所连组织的 Owner 在控制台断开，见断开与本组织的连接。