workbuddy安装中断需清理残留、重载缓存、切静默模式或用web版诊断修复。具体包括：结束相关进程、删除临时文件与残余目录；windows执行/ncrc参数重用缓存，macos锁定.app后重试；windows用/s静默安装，macos用installer命令；或通过web版扫码登录、导出诊断报告并触发重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果WorkBuddy安装过程在下载组件、解压文件或配置环境阶段突然中断，界面停滞或进程消失，则可能是因网络波动、磁盘空间不足或系统权限回收导致安装流程无法继续。WorkBuddy安装程序本身不支持传统意义上的断点续传，需通过特定方式识别中断状态并重建有效安装路径。以下是恢复安装的可行操作：
一、识别中断阶段并清理残留状态
安装中断后残留的临时文件、未完成的注册表项或半写入的应用目录会干扰重试，必须清除已知污染源才能重新建立干净安装上下文。
1、Windows用户打开任务管理器，结束所有名称含“WorkBuddySetup”或“NSIS”的进程。
2、删除以下路径中全部内容：C:\Users\%USERNAME%\AppData\Local\Temp\WorkBuddy_*（%USERNAME%替换为当前用户名）。
3、检查安装目标路径（如C:\Program Files\WorkBuddy），若存在空文件夹或仅含“uninstall.exe”“app.asar”等零散文件，直接彻底删除该文件夹。
4、macOS用户在终端执行：rm -rf ~/Library/Caches/com.workbuddy.* /tmp/WorkBuddy_*，并前往“应用程序”确认无残余WorkBuddy.app图标。
二、强制启用离线缓存重载机制
WorkBuddy安装程序内置本地资源缓存校验逻辑，当检测到前次中断发生在资源下载阶段时，可通过手动触发缓存重载跳过重复下载，缩短恢复时间。
1、Windows用户以管理员身份运行命令提示符，进入安装包所在目录，执行：WorkBuddySetup.exe /NCRC（/NCRC参数强制忽略校验并重用现有缓存）。
2、macOS用户双击.dmg后，不要拖入应用程序，而是先在挂载的磁盘映像内右键WorkBuddy.app → 显示简介 → 勾选“通用”页签下的“锁定”选项，再关闭窗口后双击启动安装器。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、安装向导出现后，立即点击“下一步”跳过欢迎页，此时程序将自动扫描临时目录并尝试复用已下载的资源包。
三、切换至静默安装模式绕过UI阻塞
图形界面在低内存或高DPI缩放场景下易发生渲染卡死，改用命令行静默安装可规避UI层异常，确保核心安装逻辑完整执行。
1、Windows用户以管理员身份运行PowerShell，执行：Start-Process WorkBuddySetup.exe -ArgumentList '/S','/D=C:\Program Files\WorkBuddy' -Wait（/S表示静默，/D指定路径）。
2、macOS用户在终端中执行：sudo installer -pkg "/Volumes/WorkBuddy/WorkBuddy.pkg" -target /（需先挂载.dmg并确认.pkg路径）。
3、静默安装过程中不弹出任何窗口，进度通过系统托盘图标变化指示；完成后检查C:\Program Files\WorkBuddy\resources\app.asar.unpacked\status.json是否存在且包含"completed:true"字段。
四、使用Web版临时接管并同步安装进度
当本地安装反复失败且急需使用时，可借助Web版维持工作流连续性，同时后台修复安装环境，实现功能与状态的无缝过渡。
1、打开浏览器访问：https://workbuddy.codebuddy.cn/web，使用与本地计划绑定的同一微信账号扫码登录。
2、在Web版Claw界面输入指令：“导出当前设备安装状态报告”，系统将生成含磁盘空间、权限状态、网络连通性等12项指标的诊断快照。
3、将快照中标识为“FAIL”的条目（如“辅助功能授权缺失”“完全磁盘访问未启用”）逐项修复，修复完成后返回Web版执行“触发本地安装重试”指令，自动唤醒已就绪的安装进程。
