断电导致workbuddy安装异常时，需先彻底清理残留文件与注册表项，再校验修复本地sqlite数据库及权限配置，确保服务正常启动与功能可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果WorkBuddy安装过程中遭遇突然断电，可能导致安装文件写入不完整、注册表项损坏、辅助功能权限未配置或本地服务数据库异常，进而引发后续启动失败、服务无法注册、报错“invalid request parameters”或“辅助功能被拒绝”等问题。以下是针对性补救步骤：
一、强制清理残留安装状态与损坏文件
断电易导致安装程序中途终止，遗留半成品文件及错误注册信息，需彻底清除以避免冲突。该步骤为后续修复的前提。
1、Windows用户：打开文件资源管理器，删除以下全部路径（若存在）：C:\Program Files\WorkBuddy、%LOCALAPPDATA%\WorkBuddy、%APPDATA%\WorkBuddy。
2、Windows用户：按 Win + R 输入 regedit，定位并删除注册表项：HKEY_CURRENT_USER\Software\Tencent\WorkBuddy 与 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Tencent\WorkBuddy。
3、macOS用户：在终端中逐条执行以下命令，彻底移除残留：
sudo rm -rf /Applications/WorkBuddy.app
rm -rf ~/Library/Application\ Support/WorkBuddy
rm -rf ~/Library/Preferences/com.tencent.workbuddy.plist。
二、修复本地服务数据库与权限状态
WorkBuddy依赖本地SQLite数据库存储任务队列、权限配置及设备绑定信息；断电易致数据库文件损坏或锁表，需手动校验与重建。
1、Windows用户：进入 %LOCALAPPDATA%\WorkBuddy\database\，确认是否存在 workbuddy.db 文件；若文件大小为0KB或无法打开，将其重命名为 workbuddy.db.corrupted。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、Windows用户：以管理员身份运行PowerShell，执行：sqlite3 "$env:LOCALAPPDATA\WorkBuddy\database\workbuddy.db" "PRAGMA integrity_check;"；若返回非“ok”，说明数据库已损，需跳至下一步重建。
3、macOS用户：在终端中执行：sqlite3 ~/Library/Application\ Support/WorkBuddy/database/workbuddy.db "PRAGMA journal_mode = WAL; VACUUM;"；若提示 Error: unable to open database file，则需手动创建目录并初始化：mkdir -p ~/Library/Application\ Support/WorkBuddy/database && sqlite3 ~/Library/Application\ Support/WorkBuddy/database/workbuddy.db 。
三、重装核心服务组件并重置系统级权限
断电可能中断辅助功能、屏幕录制、输入监控等系统级权限的注册流程，必须重新触发授权链并确保服务进程可被正确加载。
1、Windows用户：下载最新版 WorkBuddySetup.exe 后，右键 → “属性” → 勾选“解除锁定”，再右键 → “以管理员身份运行”。
2、Windows用户：安装过程中，当出现“正在配置辅助功能”进度条时，**立即前往“设置 → 蓝牙和其他设备 → 更多设备和配件设置 → 输入 → 输入监控”**，手动开启 WorkBuddyService.exe 的开关；若未出现该选项，需先在“隐私 → 其他权限”中启用“允许应用访问输入监控”。
3、macOS用户：安装完成后，首次双击启动前，先在终端执行：sudo chmod 755 /Applications/WorkBuddy.app/Contents/MacOS/WorkBuddy；随后前往“系统设置 → 隐私与安全性 → 辅助功能”，点击左下角“+”号，添加 /Applications/WorkBuddy.app；再重复此操作，在“屏幕录制”与“全盘访问”列表中同样添加该应用。
