PowerShell脚本部署WorkBuddy需满足三前提：执行策略设为RemoteSigned、以管理员身份运行、网络可访问codebuddy.cn；策略未放开时Invoke-WebRequest将报错被阻止，且config.json须UTF-8无BOM编码、字段严格匹配v2.4+协议、写入后延迟2秒再启动客户端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
PowerShell 脚本能直接部署 WorkBuddy，但必须满足三个硬性前提：执行策略已解除、运行权限为管理员、网络可访问 codebuddy.cn 域名。
执行策略不放开，Invoke-WebRequest 会直接报错被阻止
PowerShell 默认策略是 Restricted，任何远程脚本或下载操作都会被拦截。错误信息通常是：Execution policies are scoped to the current user or the local machine. Execution of scripts is disabled on this system.
- 临时生效（仅当前会话）：运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 永久生效（需管理员）：运行
Set-ExecutionPolicy RemoteSigned -Scope LocalMachine - 别用
Bypass，它绕过所有检查，企业环境会被安全策略拒绝 - 执行后可用
Get-ExecutionPolicy -List确认当前各作用域策略
Start-Process 静默安装失败的常见原因
看似只有一行命令，但 Start-Process "$env:TEMP\WorkBuddySetup.exe" -ArgumentList "/S" -Wait 实际依赖多个隐含条件：
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 安装包必须已完整下载完毕，
Invoke-WebRequest缺少-Wait或未检查$LASTEXITCODE可能导致启动空文件 -
/S是 NSIS 打包器的静默参数，不是所有 Windows 安装器都支持；WorkBuddy 当前版本只认这个，/quiet或/silent会失败 - 必须加
-Wait，否则脚本会立即往下执行，跳过配置写入步骤 - 若提示“无法找到指定的文件”，大概率是路径中含空格或中文，建议统一用
$env:TEMP而非自定义路径
预配置 config.json 的字段必须严格匹配 v2.4+ 协议
从 2026 年 3 月起，WorkBuddy 强制校验 config.json 中的字段结构。写错一个 key 就会导致首次启动卡在登录页，且无明确错误提示。
- 必需字段包括：
"login_method"（值只能是"phone"或"wechat"）、"claw_auto_enable"（布尔值，不能写字符串"true"） - 手机号登录需额外提供
"default_phone"，格式为带国家码的纯数字，如"+8613800138000" - 文件编码必须是 UTF-8 无 BOM，用记事本另存时容易选错；推荐用 VS Code 或 PowerShell 的
ConvertTo-Json | Out-File -Encoding utf8生成 - 路径必须是
$env:APPDATA\WorkBuddy\config.json，不能是$env:LOCALAPPDATA或其他位置
最常被忽略的是：配置写入后必须等待至少 2 秒再调用 Start-Process 启动客户端，否则 WorkBuddy 进程可能读到空或残缺的配置文件——这个延迟不是 bug，是 v2.4.1 版本引入的初始化竞态修复机制。
