按现象排查问题

按你看到的现象查找原因和处理办法，覆盖聊天、ZAI 的提示、资源和控制台。

先确认实际结果，而不是只看某个中间步骤显示成功。下面每张表的第一列是你看到的现象；ZAI 的状态表情各表示什么，见你会看到什么。

聊天里的现象

发起、跟进与结果

如果你看到	这表示	这样做
在频道里发了消息，ZAI 没有开始工作	没有 @zai 的消息不会开始新任务；或者这个消息列已被静音	发消息时 @zai；在被静音的消息列里 @zai 或发送 `@zai !unmute` 即可恢复，见静音。同一个请求不要同时发到多个消息列
补充要求没有进入原来的任务	补充发在了频道里，没有发在原消息列里	回到 ZAI 回复所在的消息列里重新发送
命令的回复说要在消息列内发送	停止、重启和静音只对一个消息列生效	进入要处理的那个消息列再发送，见命令速查
ZAI 回复「一次性 Engine 命令请作为新消息发送，不能放在已有消息列中。」	`@zai !codex` 和 `@zai !claude` 这类一次性命令只能开始新的消息列	在频道里另发一条新消息，见命令速查
其他组织的成员发的命令没有任何反应	ZAI 只执行本组织成员发的命令，访客发的命令同样不执行	请本组织的成员发送
ZAI 只回了文字，没有你要的附件	ZAI 可能没有把文件发回，或者文件超过了单个文件的大小上限；Slack 收不下的文件，原处会有一条「……没有发出：……」的说明	让 ZAI 把文件作为附件发回当前消息列；文件太大时让它压缩或拆分，上限见常用限制；有说明时按说明的原因处理，见失败时怎么做
ZAI 说取不到你发的附件	文件可能超过了单个文件的大小上限	压缩或拆分后重发，或者把关键内容直接发给它，见常用限制
ZAI 读不到频道历史或附件	ZAI 可能已不在这个频道里，或者应用缺少读取权限	确认 ZAI 还在频道里；仍然读不到时，请应用的管理者核对权限：Slack 工作区管理员或 Z Tag 管理员，见应用配置
这个 Session 还在用更新前的插件	正在回复的那一轮开始时加载的是旧版本，或另一个插件里的同名技能优先	等这一轮回复完再发一条消息；仍不生效，请插件的管理者检查它在哪些范围启用、技能是否放在插件结构读得到的位置（见内容要求），以及控制台侧栏的使用范围里它是否标为被遮蔽，见同名技能用哪一个
定时任务或事件订阅没有发出结果	定时任务和事件订阅默认只在有变化或异常时汇报，检查确认没有变化、也没有要处理的事时不发消息；也可能 ZAI 已被移出频道，或者频道被归档、删除，应用被卸载，或频道与其他组织共享、有访客	让 ZAI 查看任务或订阅最近的运行记录；想每次都收到汇报，请它在任务说明里写明“每次都汇报，包括没有变化时”，见什么时候汇报与处理事件；ZAI 被移出时，按ZAI 被移出时的说明恢复，恢复后之后的计划和事件自动继续，错过的不会补做
服务中断后，错过的几次定时任务只补做了一次	服务中断期间错过多次计划时，恢复后只补做最近一次	属预期行为，见定时任务
任务失败，提示「模型服务暂时不可用，自动重试期间未恢复，请稍后重试。」	ZAI 用的模型服务出错、繁忙或连不上，自动重试了一段时间仍未恢复	稍后重试（按提示在消息列里 @zai），或发一条新消息；一直出现时按反馈问题反馈

沙箱的提示

如果你看到	这表示	这样做
「沙箱启动得比平时慢，任务会在启动后开始，请稍候。」	你等待的任务要用的沙箱还在启动	等待即可，启动后任务自动开始；不想等可以发送 `@zai !stop`
任务失败，提示「沙箱未能启动，请稍后重试。」	ZAI 没能准备好沙箱	稍后重试（按提示在消息列里 @zai），或发一条新消息；一直出现时按反馈问题反馈
任务失败，提示「沙箱意外中断，请重试。」	任务进行中沙箱中断，这项任务没有完成，也不会自动重做	先确认它是否已经改动了外部系统，再重试；没发回的临时文件不会保留，见沙箱启动失败或中断时
「之前的上下文没能恢复，任务会从这条消息重新开始；需要之前的内容时请重新说明。」	ZAI 没能接上之前的上下文（多在沙箱中断或更换之后），从这条消息重新开始	之前讨论过、现在仍然需要的内容，请在消息列里重新说明；见沙箱启动失败或中断时

命令在独立执行沙箱或远程设备上时

沙箱配置把命令放到独立执行沙箱或远程设备上时（见命令在哪里执行），可能看到下面的提示。它们都只让这一轮失败，不会改在沙箱中执行；等待多久、什么时候不等待，见沙箱启动失败或中断时。

如果你看到	这表示	这样做
「执行命令的远程设备离线。请确认设备已开机、没有休眠、网络正常并在运行 Z Tag Device，然后重试。」	这一轮开始执行前，设备一直没有连上或没有应答	请设备所在电脑的用户确认电脑开机、没有休眠、网络正常、设备程序在运行，见维护远程设备，然后重试
「执行命令的远程设备正在更新 Z Tag Device，请稍后重试。」	设备程序正在安装更新	等更新完成后重试，见自动更新
「执行命令的远程设备同时执行的任务已达上限，请稍后重试。」	这台设备同时为太多沙箱执行命令	稍后重试；经常出现时，让一部分频道或成员改选其他设备，上限见限制
「执行命令的远程设备上的 Z Tag Device 版本过低。请升级 Z Tag Device 后重试。」	要求升级的截止时间已过，设备程序仍低于要求的版本	在设备所在的电脑上安装要求的版本，见自动更新，然后重试
「这台远程设备不能执行命令：……」	设备程序太旧，还不支持执行命令；设备的系统或登录用户不受支持（只支持 Linux 和 macOS，安装用户不能是 root，用户主目录要在 `/home` 或 `/Users` 下）；或者 Z Tag 管理员关闭了在远程设备上执行命令	更新设备程序，或为沙箱配置改选符合条件的设备，见哪些设备可以选；仍不能执行时联系 Z Tag 管理员
「执行命令的远程设备已被停用。……」	沙箱配置选的设备在控制台被停用	请有这台设备管理权限的人选择更多 → 启用，见停用、撤销与删除
「执行命令的远程设备还没有接入，或已撤销关联。……」	设备处于待接入	在设备详情点获取安装命令，在原来的电脑上重新接入；换一台电脑接入时，Session 在新电脑的空工作目录里继续，见工作目录与文件
「执行命令的远程设备不在这个聊天的设备使用范围内。……」	沙箱配置选了这台设备，但设备没有授权到这个频道或私信；选设备本身不授权	在设备的使用范围里加上这个范围，见哪些设备可以选
「沙箱配置已不再使用这台远程设备执行命令，本轮已停止。……」	沙箱配置改了运行方式或设备，或者设备被删除，进行中的一轮随之停止	重新发送消息，ZAI 在新的 Session 里按现在的设置执行；需要旧 Session 里的内容时请重新说明
「与执行命令的远程设备的连接中断，本轮未完成。请确认设备在线后重试。」	执行中设备断开，一段时间内没有回来	先确认这一轮已经改动了什么，再在设备恢复后重试
「执行环境暂时不可用，请稍后重试。」	执行命令的一侧没能准备好，这一轮什么都没执行	稍后重试
「执行环境中断，本轮未完成，请重试。」	执行中独立执行沙箱中断	先确认它是否已经改动了外部系统，再重试；之前没发回的文件可能不再保留
「这个 Session 所用的 Engine 不支持沙箱配置的运行方式。……」	这段工作所用的 Engine 不能按沙箱配置选的运行方式执行，重试同样会失败	用 `@zai !engine` 换用其他 Engine 后发新消息（见查看或切换模型），或为沙箱配置改选运行方式；仍不行时联系 Z Tag 管理员
「这个 Session 的运行方式已停用。重试时平台会在沙箱中新开 Session 执行。」	这套 Z Tag 服务关闭了运行方式，而这段工作是按其他运行方式开始的	重试或发新消息，ZAI 在沙箱中的新 Session 里执行；之前在执行命令一侧的文件和后台程序不会带过来

访客、命令写法、删除与按钮

如果你看到	这表示	这样做
@zai 后只收到「我不在与其他组织共享的聊天里工作，请在本组织的频道或私信里找我。」或「这个频道里有访客，我不在含访客的频道里回复。」	频道与其他组织共享（Slack Connect，包括等待批准的共享），或者有访客	改在只有本组织成员的频道或私信里发起，见访客与 Slack Connect
@zai 后只收到「我无法确认这个频道里有哪些成员（成员很多的频道会出现这种情况），这次不作回答。请在成员较少的频道或私信里找我。」	ZAI 无法确认频道里有哪些成员，成员很多的频道常会这样	改在成员较少的频道或私信里发起
私信 ZAI 时收到「其他组织的成员不能私信使用我，我也不在与其他组织共享的频道里工作。需要协助时，请本组织的成员在本组织的频道里 @我。」	你不属于 ZAI 所在的 Slack 工作区	请本组织的成员在本组织的频道里 @zai
私信 ZAI 时收到「访客账号暂不能私信使用。」	你是这个 Slack 工作区的访客	请本组织的成员在频道里代为发起
命令没有生效	频道里命令前没有 @zai，或者私信里用了以 `/` 开头的写法	频道里写成 `@zai !stop` 这样；私信里写成 `!status` 这样，见命令速查
消息列里只收到「这个消息列的首条消息已被删除，这个消息列已关闭。请另开一个消息列继续。」	这个消息列的首条消息被删除了	在频道里重新发一条 @zai 的消息开始，见编辑与删除
删除提问后，ZAI 仍在工作	删除一条消息只取消它触发的、还没开始的工作；已经开始的会继续	在消息列里发送 `@zai !stop`；删除消息列的首条消息会停止这个消息列里的全部工作
编辑消息后 ZAI 没有反应	消息列当时空闲，编辑不会触发处理	在消息列里发一条新回复说明更正，见编辑与删除
消息列底部没有运行指示	工作区没有显示 Slack 的运行指示，例如受方案限制，或被 Slack 工作区管理员隐藏	点进度消息上的停止，或在消息列里发送 `@zai !stop`，见停止任务
读不到较早的消息或文件	免费版工作区只能读最近一段时间的内容	属预期限制；需要时把关键内容重新发给 ZAI，见能读到的历史
频道里 ZAI 没有发出回答，可能只看到失败表情	频道限制了谁能发言	请频道管理者或 Slack 工作区管理员允许 ZAI 在这个频道发言，或改在私信里提问，见ZAI 不能在频道里发言时
点按钮时提示「我已不在这个聊天中，无法继续这项操作。」	ZAI 已不在这个频道里：被移出，或频道被归档、删除	把 ZAI 重新邀请进频道后再操作（归档的频道取消归档后自动恢复），见ZAI 被移出时
点按钮时提示「暂时无法确认这个聊天的成员，请稍后重试。」	ZAI 暂时没能确认你是这里的成员	稍后重试
点按钮时提示「无法读取这个聊天的完整成员列表，这项操作在这里不可用。」	ZAI 读不全这里的成员名单，无法确认你的身份	改为直接 @zai 说明你的需要

所有聊天里 ZAI 都不回复

可能是 Z Tag 应用被卸载或停用，见卸载与重新安装；商店版 ZAI 见卸载、重装与断开。也可能是接收方式出了故障，见常见故障。自建应用请 Slack 工作区管理员和 Z Tag 管理员处理。卸载期间发出的消息不会补答，恢复后请重新发送。

Artifact 打不开或显示不正常

Artifact 的查看页会直接写明原因。下表第一列是页面上的文字或你遇到的情况。

如果你看到	这表示	这样做
「无法查看这个 Artifact」	你登录的账号不是这个组织的成员，或这次登录没有被接受	你属于这个组织时，先在自己的 Slack 里向 ZAI 发送 `!organization` 打开一次控制台，再重新打开链接；访客和已停用的账号不能登录。你不属于这个组织时，请对方把文件作为附件发给你
「这个 Artifact 已被移除」或「链接无效」	这个 Artifact 已经被移除，或者链接不完整	需要内容时，请联系当时请求发布的人，或在原来的聊天里让 ZAI 重新发布；移除不能撤销
「Artifact 未开启」	这项功能没有开启	请 Z Tag 管理员确认
页面停在「需要登录」，写着「没有完成自动登录。」	自动跳转到 Slack 登录没有完成	点页面上的登录按钮；仍不行时点「在浏览器中打开」
「登录未完成」	登录被取消，或在登录页停留太久	点「重新登录」；一直失败时点「在浏览器中打开」
「登录状态没有保存」	当前浏览器没有保存登录状态	点「在浏览器中打开」
「无法在线预览」	网络较慢、预览没有加载完，或这个浏览器显示不了 PDF、Word 或 PowerPoint 的预览	点「下载」后查看，或点「在浏览器中打开」
「这个文件需要下载后查看。」	这种文件没有在线预览，例如 Excel 和打开需要密码的 PDF	点「下载」
「内容加载失败」	页面打开太久，或加载时网络中断	点「重新加载」
「内容服务器暂时连不上」	当前网络访问不到存放内容的服务器，可能被所在网络拦截	换一个网络后点「重新加载」；一直如此时请 Z Tag 管理员确认
网页空白或缺图，或页面上方写着「页面仍在加载外部资源。……」	页面要从其他网站加载内容，而你的网络访问不到或很慢	稍等片刻，或点「下载」后查看；也可以请发布它的人让 ZAI 把用到的库和图片放进页面重新发布，见网页里来自其他网站的内容
停在「下载已开始」，文件没有下载	当前的浏览器没有开始下载	点页面上的「下载没有开始？在浏览器中打开」，文件在新窗口里下载，不需要再登录
ZAI 的回复里有 Artifact 链接，后面没有 Artifact 消息	这个消息列里已经附过一次；或者链接是成员自己贴的、是别处发布的 Artifact；也可能是这一次没有发送成功，ZAI 只尝试一次	链接照常可以打开，见它什么时候出现
Artifact 消息上没有预览图	发布时要求不附预览图，或者没能生成，例如第一屏是空白或 PDF 打开需要密码	不影响打开；需要预览图时让 ZAI 更新这个 Artifact
ZAI 说没有生成链接，改发了附件	这项功能没有开启、文件类型不能发布、文件超过大小上限，或这一次是免确认介入的回复	类型和上限见Artifact 的限制；需要链接时直接 @zai 说明
ZAI 说找不到你提到的 Artifact	它是在别的频道或群聊或私信里发布的，或者已经被移除	回到发布它的地方让 ZAI 处理，见谁可以要求更新或移除

下载链接打不开

下载链接的页面会直接写明原因。下表第一列是页面上的文字或你遇到的情况。

如果你看到	这表示	这样做
「下载链接未开启」	这项功能没有开启	请 Z Tag 管理员确认
「需要登录」，写着你上次经 IM 登录已经过去较久	距你最近一次经 Slack 登录太久，需要重新登录，期限见下载链接的访问	等页面跳到登录页，登录后下载
「无法下载这个文件」，写着你登录的账号还不是这个组织的成员	你登录的账号不是这个组织的成员，或这次登录没有被接受	你属于这个组织时，先在自己的 Slack 里向 ZAI 发送 `!organization` 打开一次控制台，再重新打开链接；访客和已停用的账号不能登录。你不属于这个组织时，请对方把文件作为附件发给你
「无法下载这个文件」，写着所在聊天的设置不允许下载或转发	文件所在的聊天，或这份文件到过的聊天，设置了不允许下载或转发	在原来的聊天里取附件；需要转给别人时先和聊天里的人确认
「这个文件已不可用」	文件在原来的聊天里已经读不到，例如带文件的消息被删除，或文件被下线	需要时请联系发给你链接的人
「暂时无法下载这个文件」	ZAI 已不在这个文件所在的聊天里，或这个聊天已归档或解散	见ZAI 被移出频道时
「下载没有开始？」	当前的浏览器没有开始下载	点「在浏览器中下载」，或点「复制页面地址」在系统浏览器里打开，登录后下载
「登录状态没有保存」	当前浏览器没有保存登录状态	换一个浏览器（例如系统浏览器）打开
「下载的人较多，请稍后再试。」	同时下载的人太多	稍后再点「下载」
ZAI 只发了文件没有发出的说明，没有链接	文件被 Slack 的设置或审查拒收、被平台移除，所在聊天不允许下载或转发，或这一次是免确认介入的回复；也可能这项功能没有开启	照说明处理；需要链接时直接 @zai 说明。被拒收的文件换名字重发也拿不到链接
ZAI 说读不到别人贴来的下载链接	链接对应的文件在这个聊天里读不到，例如它是在别的聊天里给出的	自己打开链接下载，再把文件附到这里

资源与控制台

如果你看到	这表示	这样做
找不到资源，或者 ZAI 说用不了某个资源	资源没有配置给当前频道，也没有授权给你	发送 `@zai !organization` 打开控制台，在资源详情的使用范围里核对；需要时让 ZAI 帮你申请，见申请使用资源
请求用了错误的凭证	几个凭证的访问目标、请求规则或优先级有重叠，匹配到了别的凭证	请连接器的管理者收窄各凭证的访问目标或请求规则，避免多个凭证同时匹配，再用最小的请求重试，见服务与凭证配置
远程设备不可操作	设备处于待接入、已停用或离线	待接入（包括撤销关联后）：在设备详情点获取安装命令，接入过的设备显示为重新接入；已停用：点启用；离线：确认设备上的程序在运行、电脑没有休眠。状态说明见远程设备与网络隧道
网络隧道显示已撤销	撤销后不能恢复	新建一个网络隧道并接入，再把连接器、内网路由或模型上游改为指定新隧道，见远程设备与网络隧道
网络隧道显示在线，访问仍然失败	在线只说明隧道连上了 Z Tag，不代表目标可以访问	沿完整路径逐项检查：生效的沙箱配置、内网路由、企业 DNS、目标服务和业务认证，见沙箱配置与网络隧道
控制台提示「ZAI 已被移出频道……」「频道已归档……」或「频道已删除……」	这项操作依赖的频道里已经没有 ZAI，例如 Webhook 所属的频道	让 ZAI 回到这个频道后重试（归档的频道取消归档后自动恢复）；频道已不存在时，请组织 Owner / Admin 处理，见Webhook 与事件

资源状态各表示什么，见资源状态。

建议的排查顺序

聊天：确认请求发在了正确的频道或私信里，以及正确的消息列里。
来源：在资源详情的使用范围里，看它配置在整个组织、Workspace、Channel、成员还是全体成员上。
状态：配置、凭证、设备、隧道和插件同步各自是否正常。
操作：用只读或最小的请求验证真实链路。
结果：以 ZAI 发回的结果消息、附件和目标系统里的实际变化为准。

反馈问题

错误信息通常会给出下一步。反馈问题时，提供失败消息上的「错误代码」、发生时间和不含敏感信息的上下文；不要把令牌、安装命令、cookie 或完整的私密响应粘贴到频道里或反馈中。

本页目录