WorkBuddy必须下载安装桌面客户端才能使用，不支持网页版；需按系统下载官网正版安装包，Windows需以管理员身份运行，macOS需手动授权启动；登录时仅授权“桌面”“文档”“下载”三目录；完成安装后输入指令测试转换功能验证是否就绪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy官网入口打开后，你看到的不是网页版应用，而是一个引导你下载桌面客户端的落地页——它不支持浏览器直接使用，必须安装本地程序才能执行文件处理、自动化任务等核心功能。
第一步：确认系统并下载正确客户端
进入官网 https://www.codebuddy.cn/work/ 后，页面会自动识别你的操作系统（Windows 或 macOS），直接点击「免费下载」按钮即可。不要手动复制链接或从第三方渠道下载，【非官网下载的安装包可能被系统拦截或缺少关键权限】。
Windows 用户将获得 WorkBuddySetup.exe（约170MB）；macOS 用户下载的是 WorkBuddy.dmg 文件。两者都需完整下载完毕再操作，中途断连会导致安装失败且无错误提示。
第二步：安装时避开路径和权限陷阱
Windows 用户双击 exe 文件后，务必右键选择「以管理员身份运行」——否则后续调用 Office 插件、PDF 转换器等功能会因权限不足静默失败。
macOS 用户拖入「应用程序」文件夹后，若首次启动提示「无法打开」，需手动前往「系统设置 → 隐私与安全 → 安全性」，点击「仍要打开」。这一步不可跳过，否则客户端根本无法启动。
安装路径请保持默认英文路径（如 C:\Program Files\WorkBuddy），【切勿手动改成中文路径，否则技能包加载时会报错“找不到模块”】。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第三步：扫码登录并精准授权工作空间
安装完成后自动启动，界面弹出微信二维码。用微信「扫一扫」扫码，跳转授权页后勾选「允许访问我的文件」——这里必须手动点击「选择文件夹」，只勾选「桌面」「文档」「下载」三个目录，不要点「全部文件」。
全盘授权不仅存在隐私风险，还会导致 WorkBuddy 在扫描硬盘时卡死长达2～3分钟，首次加载时间从10秒拉长到近5分钟。
登录成功后，你会看到左侧任务栏+中间对话区的双栏界面，此时才算真正进入可用状态。
第四步：立刻测试一个真实任务验证是否就绪
在对话框输入：“把桌面上最近修改的 Word 文件转成 PDF”，按下回车。
如果3秒内出现“正在查找文件…→已定位XXX.docx→正在转换→已完成，PDF已保存至原文件夹”，说明安装、权限、网络全部正常；如果卡在“正在查找文件…”超过10秒，大概率是工作空间授权没生效，需退出重登并重新选择文件夹。
