WorkBuddy提供五种脚本化部署方法：一、Windows PowerShell一键部署；二、macOS Shell+AppleScript自动化；三、跨平台Python协调器；四、Docker容器化（实验性）；五、企业级Ansible编排。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望快速完成WorkBuddy的部署并实现自动化配置，但手动执行安装、登录、插件安装及IM集成等步骤耗时较长，则可能是由于缺乏标准化的初始化流程。以下是多种可复用的WorkBuddy脚本化部署方法：
一、Windows PowerShell一键部署脚本
该方法适用于批量部署场景，通过预置参数自动完成安装、静默配置与首次登录跳过，避免图形界面交互阻塞。脚本依赖系统已启用PowerShell执行策略，并具备管理员权限。
1、以管理员身份打开PowerShell终端。
2、执行命令下载并运行官方安装包：Invoke-WebRequest -Uri "https://www.codebuddy.cn/work/WorkBuddySetup.exe" -OutFile "$env:TEMP\WorkBuddySetup.exe"。
3、调用静默安装命令：Start-Process "$env:TEMP\WorkBuddySetup.exe" -ArgumentList "/S" -Wait。
4、写入预配置JSON至%APPDATA%\WorkBuddy\config.json，包含默认登录方式（手机号）与插件市场自动启用开关。
5、启动客户端并注入初始会话令牌（需配合腾讯云OAuth2临时Code接口获取）。
二、macOS Shell + AppleScript自动化流程
该方法解决macOS Gatekeeper拦截与辅助功能授权问题，通过Shell触发安装流程，再使用AppleScript模拟用户授权操作，确保后续文件系统与自动化任务权限就绪。
1、下载DMG镜像：curl -L https://www.codebuddy.cn/work/WorkBuddy-darwin-arm64.dmg -o /tmp/WorkBuddy.dmg。
2、挂载并拷贝应用：hdiutil attach /tmp/WorkBuddy.dmg; cp -R "/Volumes/WorkBuddy/WorkBuddy.app" /Applications/; hdiutil detach "/Volumes/WorkBuddy"。
3、启用辅助功能权限：tccutil reset Accessibility; osascript -e 'tell application "System Events" to set UI elements enabled to true'。
4、预设Claw集成配置：向~/Library/Application Support/WorkBuddy/claw_config.yaml写入QQ机器人AppID与Webhook地址模板。
5、首次启动时自动触发微信扫码登录窗口，并保持前台聚焦。
三、跨平台Python部署协调器
该方法面向IT运维人员，利用Python统一调度不同操作系统下的部署动作，支持参数化配置（如企业微信CorpID、机器人Token），并内置校验逻辑确保每步执行成功后才进入下一阶段。
1、安装依赖：pip install requests pyobjc pyautogui psutil（macOS需pyobjc，Windows需pyautogui）。
2、读取部署配置文件deploy.yml，解析目标平台、IM通道类型、插件列表及本地路径映射规则。
3、根据OS类型调用对应子模块：Windows走PowerShell静默流，macOS走Shell+AppleScript组合流，Linux暂不支持（当前无原生客户端）。
4、在WorkBuddy启动后，轮询其HTTP健康端口http://127.0.0.1:8080/health，直至返回{"status":"ready"}。
5、通过本地APIPOST /v1/plugins/install批量提交插件ID列表，触发后台安装队列。
四、Docker容器化封装方案（实验性）
该方案将WorkBuddy客户端运行于轻量级Linux容器中，通过X11转发或VNC暴露GUI界面，适用于远程桌面统一纳管环境，所有配置通过环境变量注入，符合不可变基础设施原则。
1、构建基础镜像：基于ubuntu:24.04，安装libx11-6 libxext6 libxrender1 libxrandr2 libglib2.0-0等GUI依赖。
2、复制预下载的WorkBuddy安装包并执行dpkg -i安装（需转换为.deb格式或使用--force-depends绕过部分检查）。
3、设置环境变量：WORKBUDDY_QQ_APPID=xxx WORKBUDDY_WEBHOOK_URL=https://xxx。
4、启动时挂载宿主机/tmp/.X11-unix并传递DISPLAY，或启用内置noVNC服务暴露6080端口。
5、容器内执行workbuddy --no-sandbox --disable-gpu --disable-dev-shm-usage启动客户端进程。
五、企业级Ansible Playbook编排
该方案适用于数百台终端的集中部署，通过Ansible控制节点下发Playbook，自动识别终端OS版本、架构（x64/ARM64）、网络策略，并差异化执行安装与安全基线加固。
1、定义主任务清单workbuddy-deploy.yml，包含gather_facts与条件判断块。
2、对Windows目标调用win_package模块安装EXE，设置product_id与log_path用于审计追踪。
3、对macOS目标使用community.general.homebrew_cask（若已配置Homebrew Cask Tap）或ansible.builtin.unarchive解压DMG内容。
4、统一执行权限加固任务：禁用WorkBuddy自动更新（defaults write com.tencent.WorkBuddy AutoUpdate -bool false），重定向日志至/var/log/workbuddy。
5、集成Claw配置任务：使用community.general.xml模块修改plist或yaml配置文件中的channel_token字段值。
