必须确认三件事：一、执行brew tap add tencent/workbuddy添加官方tap；二、macOS版本≥12.0（Monterey）；三、卸载旧版WorkBuddy（如/Applications/WorkBuddy.app），避免brew静默跳过安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Homebrew 安装 WorkBuddy 前必须确认的三件事
brew install --cask workbuddy 看似一行命令就能搞定，但实际执行前常因环境缺失直接报错。不是 Homebrew 本身有问题，而是 WorkBuddy 的官方 cask 并未默认收录在主仓库中——它托管在腾讯维护的独立 tap 里。
- 必须先执行
brew tap add tencent/workbuddy，否则brew install --cask workbuddy会提示Error: Cask 'workbuddy' is unavailable - macOS 版本需 ≥ 12.0（Monterey），低于此版本会卡在签名验证阶段，即使加了 tap 也安装失败
- 如果系统已装过非 Homebrew 方式部署的 WorkBuddy（比如拖拽 .dmg 安装），建议先手动删掉
/Applications/WorkBuddy.app，否则brew install会静默跳过，看似成功实则没更新
macOS M1/M2/M3 芯片用户要额外处理隔离属性
Apple Silicon 设备对从网络下载的 App 启动有更严格的 quarantine 标签限制。即使 brew install 成功，首次双击启动时仍可能弹出“已损坏，无法打开”或“无法验证开发者”。
- 不要依赖图形界面点“仍要打开”——Homebrew 安装后，App 实际路径是
/opt/homebrew/Caskroom/workbuddy/latest/WorkBuddy.app（ARM64）或/usr/local/Caskroom/workbuddy/latest/WorkBuddy.app（Intel） - 正确做法是在终端运行：
xattr -d com.apple.quarantine /opt/homebrew/Caskroom/workbuddy/latest/WorkBuddy.app - 若不确定路径，可用
brew --cask-prefix workbuddy查看当前 cask 安装根目录，再拼接latest/WorkBuddy.app
用 brew 升级或重装时容易忽略的关键动作
brew upgrade workbuddy 不会自动触发重签名或权限重置；升级后若出现功能异常（如文件访问拒绝、技能加载空白），大概率是残留的旧签名或辅助功能授权失效。
WorkBuddy 会议助手——会议价值不该散会就流失。它把会议的采集、提炼、确认、分发串成一条流水线：从腾讯会议 / IMA / 企业微信多端取料，按 15 类场景模板自动提炼成结构化纪要，你过目确认后一键分发到钉钉、飞书、腾讯文档或企业微信。全程由 workflow 工作流编排驱动，只抽取不编造、先预览后推群、自动去重。 触发：「把会议纪要做一下发钉钉」「总结 IMA 里的 XX 录音」「按面试模板整理这场会」「把这场复盘发飞书」「发到腾讯文档让我手动改」「整理企业微信里的会议纪要」。 能力：腾讯
- 升级后务必重启 WorkBuddy，并在系统设置中检查：「系统设置 → 隐私与安全性 → 辅助功能」和「完全磁盘访问」两项里，
WorkBuddy.app是否仍被勾选 - 若未勾选，需手动添加——注意添加的是
/opt/homebrew/Caskroom/workbuddy/latest/WorkBuddy.app，不是别处的快捷方式或别名 - 想彻底重装？别只跑
brew uninstall workbuddy，还要手动清空：rm -rf ~/Library/Application\ Support/WorkBuddy和rm -rf ~/Library/Preferences/cn.codebuddy.WorkBuddy.plist，否则旧配置可能干扰新版本行为
为什么不用 brew install --cask workbuddy 就直接失败
根本原因在于：WorkBuddy 的 cask formula 依赖动态 URL 和校验逻辑，且每次发布都带平台+架构后缀（如 -darwin-arm64-1.8.2.pkg）。Homebrew 默认不缓存或预解析这类地址，一旦官网 CDN 响应延迟或临时变更路径，brew install 就会卡在 download 阶段，日志里只显示 Downloading... (0 B/s)，无错误提示。
- 临时解法：加
--verbose参数观察真实下载地址，复制到浏览器手动下载，再用brew install --cask --no-quarantine /path/to/downloaded.pkg强制安装 - 长期建议：把
tencent/workbuddytap 加入定期同步列表，执行brew tap-sync tencent/workbuddy可提前拉取最新 formula，避免安装时现场解析失败
Homebrew 安装 WorkBuddy 最难的不是命令本身，而是理解它背后混合了 Apple 的签名机制、Homebrew 的 tap 管理模型、以及腾讯对发布包路径的动态控制——这三个层面只要一个没对齐，就会表现为“命令没报错，但软件打不开”或者“看起来装好了，技能全灰”。
