Skip to content

WorkBuddy 排障总览 ​

先做三件事 ​

排障的第一目标是缩小范围并保护资料,不是立刻“修好”。先保存完整错误、发生时间、客户端版本、系统、账号类型、工作区路径、最近一次成功操作和已经尝试过的步骤。截图、日志和复制文本都要脱敏,不包含密码、Token、Cookie、私有链接、客户资料或内部地址。

然后停止可能扩大影响的动作:自动化、外部写入、发送、发布、删除和反复重试。最后用低风险、可回退的样本判断问题属于哪一层。

快速分流 ​

现象先看哪一页第一动作
安装包打不开、启动闪退、更新后异常安装、启动与更新排障记录版本、系统和安装来源,保留工作区
登录回跳失败、账号不对、企业认证异常登录、账号与企业认证排障区分浏览器、账号、组织和网络,不重复提交凭证
找不到文件、路径错误、产物不见或无法保存文件、工作区、路径与产物排障确认实际工作区、文件存在性和读写权限
Connector 授权成功但读取失败、自动化重复或超时连接器与自动化失败排障暂停写入和外发,先查身份、范围、状态和重复

通用诊断卡 ​

每次排障至少留下以下字段:

字段示例要求
环境系统、客户端版本、浏览器、网络环境
身份账号类型、组织/租户、是否刚转岗或换设备
范围单个文件、单个任务、单个连接器还是全局
时间线首次发生、最近成功、重试次数和配置变更
错误完整原文、错误码、截图上下文和脱敏日志
影响是否读不到、写入、发送、重复、丢失或泄露
已做动作每一步及其结果,避免支持人员重复操作

推荐排障顺序 ​

  1. 确认是否可复现: 用脱敏样本、测试目录或测试账号重复一次;不要直接对生产资料试错。
  2. 缩小层级: 判断是客户端、浏览器/网络、账号/组织、工作区/文件、连接器还是自动化状态。
  3. 回到最小动作: 先读一个已知文件、打开一个空测试任务或查询一个测试对象。
  4. 逐项恢复: 每次只改一个条件,记录前后差异;不要同时更新客户端、扩大权限和更换账号。
  5. 验证并收尾: 用原失败用例和一个低风险成功用例各验证一次,关闭临时权限,保存诊断摘要。

必须停止并升级 ​

遇到账号被锁、身份或组织映射不明、数据疑似丢失、重复写入/发送、未知扣费、凭证泄露、越权读取、服务端持续错误或需要内部权限时,停止继续猜测。把环境、时间、版本、错误、影响、已做步骤和期望结果交给当前官方支持、企业管理员或数据负责人。

不要通过关闭安全软件、删除工作区、清理缓存、扩大权限、运行未知脚本或反复重试来“验证”问题。

相关工作方法 ​

来源与版本说明 ​

本站只整理用户和管理员可以安全执行的公开诊断顺序,不公开内部售后系统、账号、路由、Secret、工单或组织 SOP。安装、登录、权限、连接器、自动化和错误入口以当前产品版本、官方文档、企业策略和实际账号为准。

  • 内容版本:0.1.0
  • 最后核对日期:2026-09-26
  • 来源提交版本:6b5e2403f0f2ad5d3f7ab7a67e9c4d4113583ff3