常见问题与排障

先判断问题发生在哪一步，再处理对应环节。保留当前任务与文件，不要把删除账号、清空资料或反复重新安装当作第一步。

快速定位

问题	先检查	继续阅读
安装包打不开	系统与芯片是否匹配、文件是否来自官网	安装与更新
客户端无法登录	原始登录窗口、账号身份、验证提示与网络	账号与费用
发任务前提示余额不足	账号余额、充值订单状态	账号与费用
员工不可选或能力不符	是否已部署、工作区与权限	数字员工
知识库搜不到文件	工作区、索引状态、搜索范围与内容预览	使用知识库
渠道显示连接错误	当前账号的凭据、网络与平台配置	个人微信、企业微信、飞书
已连接却不执行	发送者配对、工作区、群聊 @	连接与配对
无法远程操作电脑	Windows 状态、会话授权和任务是否明确	远程电脑操作
桌面完成但手机没文件	交付状态与客户端附件能力	文件与附件

渠道排查顺序

1. 看账号：在“消息渠道”确认目标账号已连接，没有停用或错误。
2. 看发送者：在“待配对”或“已配对会话”核对来源身份。群里每个成员都要配对。
3. 看工作区：绑定目录存在且可用，没有切到错误项目。
4. 看任务：通过“打开本机会话”查看收到的消息、执行过程、权限请求和错误。
5. 看交付：如果任务完成，检查平台接收或附件状态，再到手机核对。

常见疑问

关闭电脑后能继续处理手机任务吗？

渠道任务由这台电脑执行，客户端需要运行并联网。关机、休眠或断网会影响接收与处理；恢复后先查看状态，避免马上重复发送。

能把一个飞书应用连接到多台电脑吗？

建议每个独立连接账号使用独立应用。同一个应用的多个长连接可能分摊事件，导致任务出现在另一台电脑。

已连接为什么还要配对？

连接确认平台账号可用，配对决定谁可以向你的工作区发任务。远程电脑操作还需要额外授权，三个状态不能互相替代。

停止按钮会撤销刚才的操作吗？

停止终止后续执行，不会恢复已修改文件、撤回已发送内容或取消已经产生的消费。重要文件用备份恢复。

删掉配对会删除历史吗？

删除配对会移除成员批准和远程权限，保留本地会话历史。下一次发消息需要重新配对。删除渠道账号还会停止连接并移除该账号凭据，因此不要为单个联系人的问题删除整个账号。

反馈问题时提供什么

通过你现有的支持渠道提交以下信息，截图前隐藏个人身份、文件内容与密钥：

客户端版本：
操作系统与芯片：
出问题的入口或消息渠道：
发生时间：
我执行的步骤：
预期结果：
实际结果与错误文字：
是否能稳定复现：

订单问题另外提供订单号、金额与支付时间。不要提交账号密码、App Secret、机器人 Secret、验证码或完整聊天历史。