Skip to content

安装、启动与更新排障 ​

适用症状 ​

安装包打不开、应用启动后立即退出、更新后找不到工作区、首次启动卡住、系统安全提示阻止运行,或只有某个项目打开失败,都先按“程序、环境、工作区”三层区分。不要把应用打不开直接判断成资料损坏。

快速诊断 ​

先记录系统版本、芯片架构、客户端版本、安装包来源、磁盘空间、发生时间和完整错误。判断问题是否只发生在一个账号、一个项目或一台设备;用当前官方入口获取的匹配安装包和一个空测试工作区做对照。

检查清单 ​

  1. 确认安装包来自当前官方入口,文件类型与系统/架构匹配;不运行群聊转发、未知网盘或修改版文件。
  2. 确认磁盘空间、安装权限、系统时间和安全软件提示;公司设备先按 IT 规定处理,不自行关闭防护。
  3. 完全退出 WorkBuddy,包括托盘和后台进程;记录是否有更新、迁移或任务正在运行。
  4. 用空测试目录启动,区分“程序不能启动”和“某个工作区/配置导致启动异常”。
  5. 如果准备更新,先备份重要产物、记录工作区路径、当前版本和自定义 Skill;不要先删除旧版本或旧目录。

安全恢复路径 ​

安装失败 ​

保留安装错误、系统提示和安装包信息,重新核对来源和版本,不要连续运行多个来源不同的安装包。公司电脑提示权限不足时,交给设备管理员确认。

启动失败或闪退 ​

先用空工作区和新测试账号做最小对照。若空工作区可以启动,再逐项恢复项目目录、Skill 和连接器配置;每次只恢复一项。若所有工作区都失败,保留诊断材料并联系当前官方支持。

更新后异常 ​

不要立即覆盖旧环境。确认新版本、工作区路径和账号是否一致,用脱敏样本完成打开、读取、保存和导出测试;通过后再恢复真实任务。若迁移了设备或账号,改看账号与工作区迁移。

验证是否恢复 ​

  • 应用可以从可信入口安装并正常启动;
  • 测试账号能进入正确的工作区,路径和权限与预期一致;
  • 一个脱敏文件可以读取、生成草稿并保存到目标目录;
  • 原有产物仍可读取,旧环境和备份没有被覆盖;
  • 更新后的版本、连接器和 Skill 都经过单独验证,没有把启动成功当成全量可用。

不要做什么 ​

  • 不要为排障先删除工作区、清理全部缓存或卸载客户端;
  • 不要关闭系统安全软件、绕过组织安装策略或运行未知脚本;
  • 不要把密码、Token、Cookie、私有下载链接和完整客户资料贴到支持群;
  • 不要同时换账号、换版本、换目录和扩大权限,导致无法判断真正原因。

停止与求助信息 ​

如果启动过程出现数据损坏、资料丢失、未知进程、可疑安装包、反复崩溃、权限绕过要求或更新后产生重复写入,立即停止。向当前官方支持、企业 IT 或管理员提供脱敏诊断摘要:系统、版本、来源、时间、错误、工作区、复现步骤、影响和期望结果。

相关内容 ​

来源与版本说明 ​

  • SRC-UPSTREAM-CH02:安装、登录、更新和环境核对的基础资料。
  • SRC-UPSTREAM-CH03:工作区、任务和文件范围的排查边界。
  • 内容版本:0.1.0
  • 最后核对日期:2026-09-26