不需要再额外渲染什么。写这篇教程其实是被不少朋友问烦了。CodeBuddy 出来的时候大家还只是当个 AI 编程插件看结果腾讯这边直接把 WorkBuddy 推了出来定位明显不是“帮你写代码”这么简单而是想做成一个包住日常办公和开发流程的智能工作台。我身边好几个同事第一次打开官网都懵了下载按钮倒是很显眼但选 Windows 还是 macOS、装完要不要配环境变量、登录之后怎么调出侧边栏、为什么 Mac 上提示“已损坏”、为什么 Windows 上双击没反应……这些细碎问题基本在社区里散得到处都是没人正儿八经整理过。我把最近在 Windows 11 和 macOS Sequoia 两台机器上完整安装、配置、跑通 WorkBuddy 的整个过程重新走了一遍每一步都截图记下来踩过的坑也全部标出来了。这篇文章不求花哨就是照着操作能装成功、能让它正常干活。阅读之前建议先把下面的“认知澄清”看一下这会帮你节省很多折腾时间。1. 安装前的准备先搞清楚你装的到底是什么1.1 WorkBuddy 是什么能做什么安装之前先把概念梳理清楚。官方对 WorkBuddy 的定位是“智能工作伙伴”说人话就是一个把 AI 对话、任务自动执行、工作流编排、代码调试、内容生成全部糅进同一个界面的桌面应用。它和 CodeBuddy 的关系要注意区分。CodeBuddy 更偏向“AI 程序员”主要场景是 IDE 里的代码补全、仓库理解、单元测试生成。WorkBuddy 则更像一个“总控台”既能聊天又能连工具还能把任务拆成一系列动作去执行。比如你可以让它直接操作文件系统、调用命令行、搜索本地文档、整理会议纪要、生成日报甚至配合腾讯文档或企业微信做信息流转。正因为它的能力横跨办公和开发安装配置的复杂度也高了一截。所以如果你是下面这几类人这篇教程直接照做就行日常用 Windows 或 macOS 办公想把 AI 助手接入到本地文件、任务和办公流程中已经用过 CodeBuddy想进一步体验 WorkBuddy 的多任务编排能力公司内网或本地环境对软件安装有权限限制需要一套合规的安装路径纯粹对 AI 工作台感兴趣想先装好再慢慢探索。1.2 系统要求与账号准备官方给的基础配置要求不算苛刻但安装前还是花两分钟核对一下自己的机器能避免后面白折腾项目Windows 要求macOS 要求操作系统Windows 10 1903 及以上版本推荐 Windows 11macOS 12 Monterey 及以上推荐升级到最新版处理器x64 架构支持虚拟化的 Intel 或 AMD CPUApple SiliconM1/M2/M3/M4或 Intel 款 Mac内存8GB 起步16GB 更稳同左8GB 起步16GB 更稳硬盘空间安装包约 300MB安装后占用约 1.5GB另留缓存空间同左网络安装时必须保持联网后续部分功能也需要在线调用模型同左另外要提前确认你的账号归属。WorkBuddy 登录一般来说支持微信扫码、手机号验证码、以及腾讯云/企业微信相关账号体系。建议提前想好用哪个账号作为主账号因为后续绑定工作区和同步配置都跟这个账号走。如果单位有企业微信优先用企业微信账号登录团队内部的协作授权会顺很多个人体验则用微信或手机号即可。1.3 先扫掉几个常见误解省得后面绕弯路它不是网页套壳。WorkBuddy 虽然不少功能要在线调用模型但它有完整的本地服务进程、本地配置目录、缓存索引等不是一个浏览器壳子。所以你安装完成后会看到后台有多个 WorkBuddy 相关进程在跑这是正常的不要当成病毒处理。安装时不需要额外装 Git 或 Python。很多人把 CodeBuddy 的安装习惯带过来了以为要预装环境。WorkBuddy 的安装包会自包含所需的基础运行时。非要说需要的话那也得到你后续真正运行自动化脚本、处理特定仓库时才可能需要 Git安装阶段不需要。Windows 版和 macOS 版的安装包不通用两者下载渠道、安装方式、权限处理完全不同。这篇教程分开写就是因为这两套系统的坑完全不在一个维度上。2. Windows 完整安装流程从下载到跑通2.1 下载安装包认准两个点别下到杂牌渠道第一步反而是很多人最容易出问题的环节。请直接去腾讯官方渠道下载不要用搜索引擎里排在前面的第三方下载站。这类工具类软件被捆绑全家桶、或者被改包的风险太高了。下载时认准两个关键点官网有明确的 Windows 版本下载入口文件名通常会包含 win、x64 这类字样后缀是 .exe 或 .msi安装包的体积至少在 200MB 以上。如果你下载下来的文件只有几十兆那大概率不是完整包。下载完成后建议先右键点击安装包选择“属性”在“数字签名”选项卡里确认一下签名信息。正常情况下应该能显示腾讯相关的合法签名。这一步不能省很多魔改包就是在这个环节被拦下来的。2.2 执行安装一路 Next 之外这几个选项要留意安装包下载完成后直接双击运行。如果你的系统是 Windows 11大概率会遇到 SmartScreen 的蓝色弹窗提示“Windows 已保护你的电脑”。这种情况不用慌点击“更多信息”然后选择“仍要运行”即可。进入安装向导后大体流程是选择安装语言默认简体中文阅读并勾选用户协议选择安装路径。这里我建议不要默认装在 C 盘系统盘符下可以单独建一个目录比如D:\WorkBuddy。原因是 WorkBuddy 运行后会产生缓存、日志和本地索引放在独立目录里后续备份和清理都方便选择是否创建桌面快捷方式和开机自启。这里我的建议是桌面快捷方式可以勾选开机自启除非你每天一开工就要用否则别勾能明显缩短开机速度点击“安装”等待进度条走完。整个安装过程在我的机器上大约花了 3–5 分钟具体时长取决于硬盘速度。如果安装卡在某一步超过十分钟没动静不要急着强杀进程先打开任务管理器看看是不是还在写文件。实在不行再结束进程重试但重装前记得把安装目录里的临时文件清掉。2.3 登录与首次启动这一步决定后续能不能正常用安装完成后桌面上会出现 WorkBuddy 的快捷方式。第一次启动时会经历一个“初始化工作区”的过程这个过程包括创建本地配置目录、下载基础模型配置、建立本地服务端口等。整个过程差不多 1–2 分钟界面上会显示初始化进度。初始化结束后会进入登录页。常见的登录方式有扫码登录用微信或企业微信扫码确认手机号验证码输入手机号接收验证码后登录账号密码登录适合已经注册过腾讯云或相关平台账号的用户。我这里强烈建议如果你所在的公司已经在用企业微信直接用企业微信扫码后续配置“工作区共享”和“团队知识库”时能省掉很多授权环节。登录成功后界面一般会弹出几个授权确认窗口包括允许 WorkBuddy 访问本地文件允许 WorkBuddy 使用系统命令行工具允许 WorkBuddy 读取剪贴板内容。这里要逐项看清楚再点“允许”。如果你希望 WorkBuddy 帮你整理文件、写脚本、跑命令那这些权限都是必须的。但如果某些权限你暂时用不上可以先拒绝后续在设置里按需开启。这一步没有“唯一正确答案”按自己的使用场景选就行。2.4 验证安装是否真正成功很多朋友以为登录进去就算装好了其实不然。登录成功只是第一步还得花一分钟确认核心功能正常。我常用的验证方式如下看右下角系统托盘区。如果托盘里有 WorkBuddy 的图标说明后台服务正常驻留在对话框里输入一个最简单的指令比如“你好介绍一下你能做什么”。如果它能正常回答说明在线服务通道没问题试着让它执行一个本地操作比如“帮我列出当前用户目录下的文件”。如果它能返回列表说明本地工具调用链是通的点击 WorkBuddy 主界面右上角的设置按钮进入“关于”页面查看版本号。记下这个版本号后续提问或排查报错时有备无患。到这里你这台 Windows 机器上的 WorkBuddy 算是真正能干活了。3. macOS 完整安装流程一步步绕过苹果的安全机制3.1 下载与基础安装dmg 打开后直接拖进去macOS 版的下载流程和 Windows 类似同样从官方渠道获取安装包。下载完成后得到一个 .dmg 磁盘映像文件。双击打开 dmg 文件系统会挂载出一个安装窗口里面有 WorkBuddy 的应用图标和一个 Applications 文件夹的快捷方式。操作非常简单把 WorkBuddy 图标拖进 Applications 文件夹里。这里有个细节容易被忽略拖拽结束后不要直接双击打开应用先把 dmg 窗口关掉然后在“启动台”或“应用程序”文件夹里找到 WorkBuddy再尝试运行。如果 dmg 还挂着就直接启动某些版本会报“应用已磨损”或“无法打开”原因就是系统对未弹出磁盘上的应用校验逻辑不同。3.2 处理 Gatekeeper 拦截Mac 上绕不开的一环这是 macOS 安装第三方应用时最常见的问题。当你双击 WorkBuddy 图标系统大概率会弹出一个提示“WorkBuddy”已损坏无法打开你应该将它移到废纸篓。或者提示“无法打开因为无法验证开发者”。先澄清一个误区看到“已损坏”不代表软件真的坏了。绝大多数情况下这是 macOS 的 Gatekeeper 机制在拦截未经 App Store 审核的应用。处理方式有两种选一种你觉得顺手的方法一右键打开。在“应用程序”文件夹里找到 WorkBuddy 图标按住 Control 键单击或者直接右键点击选择“打开”。这时系统会再次弹出确认框但会多出一个“打开”按钮点击它就能绕过第一层拦截。方法二系统设置允许。打开“系统设置” → “隐私与安全性”滚动到“安全性”区域。如果 Gatekeeper 拦截过 WorkBuddy这里会出现一条提示“已阻止使用 WorkBuddy因为来自身份不明的开发者”。点击“仍要打开”然后输入 Mac 的管理员密码确认即可。如果以上两种方法都不行才需要用到终端命令。打开“终端”输入sudo xattr -rd com.apple.quarantine /Applications/WorkBuddy.app输入管理员密码后回车。这个命令的作用是去掉应用的“隔离属性”相当于告诉系统这个应用我信任不用再查。命令执行完成后重新双击 WorkBuddy 就能正常打开了。注意终端命令这种方式能不用就不用。它绕过了系统的安全校验机制只适用于你确认安装包确实从官方渠道下载的情况。如果安装包来源不明千万不要执行这条命令。3.3 Apple Silicon 芯片的额外授权流程如果你用的是 M1/M2/M3/M4 芯片的 Mac首次启动 WorkBuddy 时可能还会遇到两类额外的权限请求。第一类是“辅助功能”权限。WorkBuddy 如果要模拟键盘输入、控制鼠标操作、或者读取其他应用界面内容就需要在“系统设置” → “隐私与安全性” → “辅助功能”里勾选 WorkBuddy。第二类是“屏幕录制”权限。如果 WorkBuddy 需要识别屏幕上的内容、帮你操作其他软件就需要这个权限。授权方法也是在“系统设置”对应的菜单里勾选勾选后系统会要求你重新启动应用这个步骤别跳过。还有一点如果 WorkBuddy 在启动时提示“检测到系统扩展被阻止”通常需要你重启一次 Mac然后在开机过程中按住电源键进入“启动安全性实用工具”把安全策略从“完整安全性”调整为“降低安全性”。这一步比较少见但我在一台 M2 设备上确实遇到过。如果你也走到这一步操作前务必确认你清楚修改系统安全策略的含义。3.4 登录、钥匙串与首次配置macOS 版登录和 Windows 版基本一致扫码、验证码、账号密码三种方式任选。但登录后macOS 版大概率还会弹出一个钥匙串访问请求内容是“WorkBuddy 想要访问您的钥匙串中的机密信息”。这个弹窗很容易被人忽视直接点“拒绝”。拒绝之后WorkBuddy 每次调取凭证时都会重新弹一次而且部分云端同步功能会出错。正确做法是点击“始终允许”这样后续不会再被打扰同步也顺畅。首次初始化时macOS 版同样会创建本地目录和索引路径通常在~/Library/Application Support/WorkBuddy下。想备份配置的话直接备份这个目录即可。如果想彻底清理重装也是删这个目录而不是简单的把应用拖进废纸篓。4. 安装后的必要配置与上手建议4.1 设置工作目录与本地权限粒度装好之后先别急着聊花几分钟把工作目录和权限配好。这决定了你后续用起来是顺手还是别扭。WorkBuddy 默认的工作目录一般是你当前用户的主目录。这意味着它能读到你的整个用户文件夹包括文档、下载、桌面等。如果你希望它的操作范围更聚焦建议在设置里新建一个专用工作目录比如在 D 盘或 Mac 的文稿目录下建一个名为WorkBuddySpace的文件夹然后把默认路径指向这里。具体操作路径是设置 → 通用 → 工作目录 → 选择文件夹。选好之后WorkBuddy 的文件操作会被严格限制在这个目录里既能降低误操作风险又方便统一管理它创建的所有文件。权限配置方面建议保持“最小够用”原则。能用工作目录解决的就不要给它整个磁盘的访问权。尤其是公司电脑权限给太宽容易出合规问题。4.2 自定义指令把常用动作固化成命令WorkBuddy 最值钱的功能之一就是自定义指令。它允许你把一段复杂的要求保存成一个短命令下次一句话就能触发。这个功能不配好等于白白浪费了这个工具一多半的潜力。我举一个我自己在用的例子。我每周都要写周报原来的流程是打开聊天窗口输入一大段话比如“请根据我这周的工作内容生成一份周报格式包括本周完成、遇到的问题、下周计划三部分语气正式控制在三百字以内”然后它才开始干活。配置自定义指令后我只需要输入“周报”它就能按预设执行。设置路径是打开 WorkBuddy 主界面 → 找到指令或技能Skill管理入口 → 新建指令 → 填写触发词和具体指令内容。建议刚开始用的时候先配置三个最常用的周报预设格式和语气直接生成整理桌面让它读取指定目录按文件类型建文件夹并归档会议纪要把剪贴板或粘贴进来的会议转写内容自动提炼成待办事项这里有一个经验自定义指令的内容写越具体效果越好。不要写“写周报”两个字要写清格式、风格、字数、甚至要不要包含数据指标。指令的文本质量最终决定输出质量。4.3 与 CodeBuddy、腾讯云账号体系的联动如果你之前用过 CodeBuddy安装 WorkBuddy 后可能希望两者协同工作。这个配置比想象中简单。WorkBuddy 的设置里通常有“关联账号”或“服务集成”入口。在这里可以绑定 CodeBuddy 账号、腾讯云账号或企业微信账号。绑定之后WorkBuddy 可以直接调用 CodeBuddy 的代码分析能力来读代码、定位 bug也可以通过腾讯云账号获取云端资源信息。配置企业微信时建议直接扫码授权不要手动输入账号密码。扫码后选好可见的通讯录范围WorkBuddy 就能读取到你被授权的同事列表后续发消息、拉人进任务流会方便很多。如果绑定后没有生效先检查一下账号对应的权限是否开启再看一下设置里的“服务状态”是不是显示已连接。不要一上来就重装多数情况下只是授权过期。5. 常见问题排查与避坑经验实录5.1 下载速度慢或安装包校验失败我实测下来下载慢最常见的原因不是网络本身而是下载工具的问题。有些朋友习惯用浏览器多线程下载插件或第三方下载工具反而容易触发 CDN 的限速机制。最简单的处理方式直接用系统浏览器默认下载不用插件不走第三方工具速度通常反而更稳定。如果下载完成后提示“安装包校验失败”或“安装包损坏”先确认是不是下载过程中断了。排查方法很简单看文件大小和官网标注是否一致通常会在下载页或文档里注明“安装包约 XXX MB”。大小对不上就重新下载不要用“重新下载断点续传”去碰运气很多校验失败就是断点续传导致的。5.2 Windows 上双击没反应或安装卡在初始化界面Windows 上双击安装包后没反应大概率是 SmartScreen 拦截后你点了“不运行”。处理方式前面讲过右键属性里看数字签名没问题就用“更多信息 → 仍要运行”的方式强制启动一次。另一种情况是安装过程顺利但首次启动卡在初始化界面。我排查两次后确认基本都是本地端口被占用导致的。WorkBuddy 需要在本地开启一个服务端口来做进程间通信如果这个端口被其他软件占用初始化就会无限等待。排查方法是打开命令提示符执行netstat -ano | findstr 端口号把 WorkBuddy 文档里标注的端口号填进去查。如果查出来占用进程不是 WorkBuddy 自己就在任务管理器里找到对应进程结束掉然后重新启动 WorkBuddy。如果查完发现没有进程占用还是卡住就直接把 WorkBuddy 安装目录下logs文件夹里的日志翻出来看日志里会写明卡在哪一步。这一步虽然看起来麻烦但比反复卸载重装高效十倍。5.3 macOS 上提示“已损坏”或“无法打开”这个问题在 macOS 版用户里出现频率极高前面已经讲了处理方式这里只补几个容易被忽略的细节。如果你已经用了sudo xattr -rd com.apple.quarantine命令但应用还是打不开建议排查两个点命令里的路径是否写对了。注意大小写macOS 文件系统虽然默认不区分大小写但路径拼接错了依然找不到文件应用是否真的在“应用程序”文件夹里。如果你是在 dmg 里直接运行的那应用还带隔离属性命令自然不生效。处理完隔离属性还是提示损坏那就去“系统设置” → “隐私与安全性”里手动允许一次。这个入口比终端命令更保险因为每次系统更新后安全策略可能会重置终端命令设置的豁免不一定还能保留。5.4 登录失败、验证码收不到或扫码无响应验证码收不到的情况先检查手机短信拦截规则。现在很多手机系统自带的骚扰拦截会把验证码短信吞掉。把 WorkBuddy 的服务号码加入白名单再试一次。扫码无响应则大概率是网络连接问题。WorkBuddy 的登录二维码需要拉到云端校验如果本地网络有问题二维码页面会滞后甚至空白。处理方式是打开系统浏览器访问一个正常的网站测试网络情况。确定网络正常后重启 WorkBuddy 再试。还有一类情况是企业微信账号登录时提示“未绑定员工身份”。这种一般是因为企业微信管理后台的可见范围设置导致。你需要在企业微信的管理后台里确保 WorkBuddy 对应应用的可见范围包含你本人。这一步不是你能在客户端侧改的需要找管理员在管理后台配置。5.5 闪退、白屏与高 CPU 占用闪退问题在 Windows 和 macOS 上都可能出现但诱因不太一样。Windows 上闪退多发生于显卡驱动版本过老WorkBuddy 的界面动画渲染依赖 GPU 加速驱动不兼容就直接崩。处理方式是更新显卡驱动到最新版本或者在 WorkBuddy 设置里关闭硬件加速。macOS 上闪退多和权限不足有关。如果应用之前被拒过某些权限后续版本更新后访问同一资源时可能直接异常退出。处理方式是检查系统设置中所有涉及 WorkBuddy 的权限项逐个开启。白屏问题一般是本地服务进程没起来。在 Windows 上打开任务管理器macOS 上打开活动监视器确认有 WorkBuddy 相关的后台进程在运行。如果进程不存在说明服务挂了完全退出应用重新启动即可。高 CPU 占用则发生在首次启动或大目录索引时。WorkBuddy 会在后台建立本地文件索引期间 CPU 占用飙升是正常现象。但如果你已经用了一周CPU 还长期高占用就要检查是不是有异常的任务循环。这种情况直接把复杂任务停了或者重启一次应用多半能缓解。5.6 更新与重装的正确姿势WorkBuddy 会不定期推送版本更新。更新时提醒一句在点“立即更新”之前先手动退出所有正在运行的任务尤其是自动执行类任务。我遇到过更新过程中任务还在跑导致更新完成后工作区锁死的情况。如果更新失败不要急着卸载重装先尝试重启电脑再打开应用看它是否自动恢复下载。多数更新失败是文件占用或网络抖动导致的重启后都能解决。真正需要重装时Windows 用户可以去“设置” → “应用”里正常卸载但卸载后要手动清理%APPDATA%\WorkBuddy目录不然重装后配置残留会导致新旧版本冲突。macOS 用户则只需要把应用拖入废纸篓同时删除~/Library/Application Support/WorkBuddy和~/Library/Preferences下相关配置文件。配置清理干净后再重新下载安装才能得到真正干净的环境。6. 一些个人感触与实用建议装过一遍 Windows 和 macOS 两个版本之后我最大的感触是这类 AI 工作台的安装门槛其实不在“装”本身而在于你愿不愿意静下心去处理系统权限和配置。Windows 的坑更多集中在安装包的来源和 SmartScreen 的拦截上只要顺着检查签名、选择“仍要运行”基本能顺利装完后续权限弹窗也比 mac 少很多。mac 的安装包本身没问题几乎所有时间都花在对付 Gatekeeper 和授权弹窗上。但只要理解了“隔离属性”这个概念后面就算系统升级导致拦截策略变化你也能举一反三自己解决。最后分享一个小习惯每次更新 WorkBuddy 之后我都会顺手看一眼“设置”里的“工作目录”和“权限”有没有被重置。这两项在部分版本升级后会悄悄恢复成默认值特别是公司电脑有统一安全策略推送的情况下权限被重置的概率更高。养成这个检查习惯后你在使用中遇到的很多“为什么突然不能读取文件了”“为什么不能执行命令了”这类问题大概率都能当场定位。如果你在安装过程中遇到了上面没提到的问题不妨先去日志里找线索。Windows 看安装目录下的 logs 文件夹mac 看~/Library/Logs/WorkBuddy。日志文件虽然看着枯燥但报错信息永远比记忆靠谱。拿日志里的关键词去搜索通常能找到你要的答案。