Agent之Harness：WorkBuddy的简介、安装和使用方法、案例应用之详细攻略

WorkBuddy 是腾讯推出的全场景 AI 办公工作台，面向日常办公、代码开发、设计创意等多类工作场景。其核心交互方式是通过自然语言描述需求，由 WorkBuddy 自动拆解任务、规划执行步骤并完成实际操作，同时交付文档、表格、PPT 等可验收的结果。与传统主要用于问答和建议的 AI 对话方式相比，WorkBuddy 的定位更加偏向"执行任务并交付成果"，并支持对用户授权的本地文件进行读取、处理和批量操作。

从功能范围看，WorkBuddy 覆盖文档生成、数据分析与可视化、PPT/报告生成、深度研究、邮件编辑、周报生成以及批量文件处理等办公任务；在代码开发场景中，还可以用于代码生成、代码审查、Bug 修复、重构优化、陌生代码库理解以及网站和应用开发；在设计创意场景中，则可以完成界面设计稿、组件设计、交互原型、品牌设计和海报等任务。产品同时支持多任务并行，每个任务具有独立的工作空间和上下文。

WorkBuddy 的工作界面主要由任务列表、对话区和结果区组成：侧边栏用于查看、搜索和管理任务；对话区是核心交互区域，用于输入需求、持续追问和上传文件；结果区用于查看 Agent 生成的产物、全部文件、变更以及预览内容。针对涉及本地文件、脚本或外部程序的操作，WorkBuddy 还提供"默认权限"和"完全访问权限"两种权限模式，在默认权限下，高风险操作会要求用户确认。

WorkBuddy权威官网 ：WorkBuddy - AI Agent for Everyday Office Work

CodeBuddy简介 ：CodeBuddy - AI 智能编程助手 | 腾讯云代码助手 CodeBuddy -- AI 代码编辑器

WorkBuddy简介 ：WorkBuddy 简介 | 腾讯云代码助手 CodeBuddy -- AI 代码编辑器

WorkBuddy概述 ：WorkBuddy

1 、特点

|------------|---------------------------------------------------------------------------|
| 特点 | 详细说明 |
| 自然语言下达任务 | 用户可以直接用一句话描述工作需求，不需要按照复杂的操作步骤进行配置。 |
| 自主规划与执行 | WorkBuddy 可以自动拆解任务、规划步骤并执行操作，面向多步骤复杂任务提供完整执行过程。 |
| 多任务并行 | 支持同时发起和管理多个任务，每个对话对应一个独立任务，并拥有独立工作空间和上下文。 |
| 本地文件处理 | 在获得相应权限后，可以读取授权的本地文件夹，并进行批量处理、整理和重命名等操作。 |
| 多模态任务处理 | 支持文档、表格、PPT、数据分析等多种类型的工作任务。 |
| 结果可验收 | 任务完成后，可以在结果区查看生成产物、文件、变更和预览，生成的文档、表格、PPT 等可以直接查看和继续处理。 |
| 技能扩展 | WorkBuddy 提供 Skills 机制扩展任务能力，页面列举了 PPT 制作、海报生成、自动化报表等技能示例，并支持创建自定义 Skill。 |
| 第三方应用连接 | 可以通过连接器管理并接入外部服务，从而扩展 WorkBuddy 的任务处理能力。 |
| 自动化执行 | 自动化任务可以按预设条件触发，目前文档说明的触发形态为定时执行，并支持执行指定 Prompt 后推送通知。 |
| 权限与安全控制 | 提供默认权限和完全访问权限两种模式；默认权限下，涉及敏感路径、重要删除、脚本命令或网络等风险操作时会要求用户确认。 |
| 远程任务 | 支持通过微信、企业微信、QQ、钉钉、飞书等平台接入助理，实现远程下达任务和查看执行结果。 |
| 本地应用生成 | 在代码开发模式下，可以用自然语言设计、生成、调试并持续升级本地应用。 |

2 、WorkBuddy与CodeBuddy的区别

WorkBuddy 和 CodeBuddy 都属于腾讯 AI 工具体系，但官方文档对两者的产品定位有所区分。

WorkBuddy 的定位是全场景 AI 办公工作台，重点覆盖职场办公、文件处理、数据分析、报告与 PPT、研究、邮件以及设计创意等任务，同时也提供代码开发模式。其核心使用方式是通过任务对话让 AI 自主规划并执行工作。

CodeBuddy 则被定义为基于 AI 的全流程智能编程工具，目标是打通从产品构思、需求分析、设计、研发到部署的开发流程，并提供 IDE、插件和 CLI 三种产品形态。官方文档将 CodeBuddy IDE 定位为"对话即编程"的开发工作台，将 CodeBuddy 插件用于融入既有 IDE 工作流，将 CodeBuddy Code 定义为面向专业工程师的 AI CLI 工具。

从使用范围来看，WorkBuddy 更强调"职场任务和成果交付"的全场景执行，而 CodeBuddy 更强调"软件产品开发和工程研发"的全流程能力。两者在代码开发方面存在交集，但产品的主要使用入口和任务重心不同。

WorkBuddy的安装和使用方法

1、安装

Windows 安装

官方文档要求 Windows 10 及以上版本，不支持 Windows 7、Windows 8 和 Windows 8.1；不满足这一要求时无法启动 WorkBuddy。安装步骤如下：

访问 WorkBuddy 官网，点击"立即下载"并等待安装包下载完成。

双击下载的安装包启动安装程序。

勾选"我同意此协议"，点击"下一步"。

选择安装路径，默认路径可以直接继续。

确认开始菜单文件夹。

建议勾选"创建桌面快捷方式"。

确认安装配置后点击"安装"。

安装结束后点击"完成"。

登录时，启动 WorkBuddy 后点击"登录"，勾选《服务条款》和《隐私协议》，使用微信扫码完成登录；登录成功后会自动返回客户端。

Windows 安装不需要执行命令行代码，官方文档提供的是图形化安装流程。

macOS 安装

Mac 版本要求为 macOS 12（Monterey）及以上。下载时需要根据芯片类型选择安装版本：M 系列芯片选择 Mac ARM64，Intel 芯片选择 Mac X64。

安装步骤如下：

访问 WorkBuddy 官网并点击"下载 WorkBuddy"。

根据 Mac 芯片类型选择 Mac ARM64 或 Mac X64。

允许浏览器下载并等待安装包完成。

双击 .dmg 文件打开安装窗口。

将 WorkBuddy 图标拖入 Applications 文件夹。

等待复制完成。

推出已经挂载的 WorkBuddy 磁盘映像；不再需要时可以删除下载目录中的 .dmg 文件。

从启动台或通过 Command + 空格搜索打开 WorkBuddy。

点击"登录"，浏览器将自动打开登录页面。

勾选《服务条款》和《隐私协议》，使用微信扫码完成登录。

同样，官方 WorkBuddy 安装文档没有提供需要在终端执行的安装命令，因此不应补充未经页面给出的 CLI 安装代码。

2、使用方法

在线使用： https://www.workbuddy.cn/app

**本地使用：**下载APP后即可使用

第一步：创建任务

打开 WorkBuddy 后，从主界面选择"新建任务"。如果没有提前指定目录，系统可以自动创建独立工作目录；随后输入任务内容，并选择工作目录和模型后发送。每个对话对应一个独立任务，任务之间互不影响，并维护独立的工作空间和上下文。

第二步：用自然语言描述任务

WorkBuddy 的核心交互方式是自然语言。用户可以直接说明目标、处理对象、输出形式和要求，例如要求读取文件、整理数据、生成文档或制作图表。对于文件任务，可以把文件夹设置为工作空间，也可以直接将文件拖入对话框。

第三步：根据需要选择权限

WorkBuddy 提供"默认权限"和"完全访问权限"两种模式。默认权限适合日常使用，遇到敏感文件路径、删除、脚本命令或网络等风险操作时，会暂停并请求确认；完全访问权限则减少确认步骤，使 WorkBuddy 可以直接执行更多操作。

第四步：查看执行结果

任务执行过程中，可以在对话区域继续追问或补充要求；执行完成后，在右侧结果区查看产物、全部文件、变更与预览内容。

第五步：使用 Skills 和连接器扩展能力

WorkBuddy 可以通过 Skills 扩展特定工作能力，也可以使用连接器接入第三方应用。官方页面给出的 Skill 示例包括 PPT 制作、海报生成和自动化报表；同时，WorkBuddy 支持通过自然语言创建自定义 Skill，将重复出现的工作流程和处理逻辑沉淀成可复用能力。

第六步：使用自动化任务

对于重复出现的工作，可以创建自动化任务。官方文档说明，自动化属于一种特殊任务形式，与普通任务一样会运行一次对话和执行流程，但触发方式变成按预设条件自动触发；当前文档列明的触发方式为定时执行。

WorkBuddy的案例应用

案例一：批量整理和重命名文件

官方案例以"批量重命名文件"为例，适用于文件夹中存在大量命名混乱的图片、合同、票据或资料，需要按照统一规则重新命名的场景。

首先，将需要处理的文件夹设置为工作空间，或者直接将文件拖入 WorkBuddy 对话框。随后可以使用如下任务指令：

请读取这个文件夹里的文件内容或属性，按「日期 + 主题 + 类型」的规则批量重命名，先展示重命名预览，确认后再执行。

WorkBuddy 可以依据文件内容、创建或修改时间、原标题等信息生成新的文件名，并在真正执行改名之前输出重命名对照表。用户确认执行后，系统才会真正进行重命名，并反馈完成数量以及被跳过的文件。

案例二：一句话生成并修改 Word 文档

官方"文档生成与编辑"案例展示了如何使用 WorkBuddy 生成和修改 Word 文档以及 PPT。适用场景包括方案撰写、通知、申请、制度和汇报材料制作。

例如，可以直接向 WorkBuddy 提出：

请帮我生成一份正式的公司年会策划方案，包含活动目标、基本信息、流程安排、节目策划和预算，整体语气正式，适合提交给管理层审批。

生成文档之后，不需要重新编写完整 Prompt，可以继续直接描述修改意见，例如"预算清单需要更详细""请为每个流程环节补充一条注意事项""整体语气再正式一些，适合给老板审批"。WorkBuddy 会基于已有内容继续修改。

案例三：Excel 数据分析与可视化

WorkBuddy 的官方实践案例支持对 Excel、CSV 等数据文件进行统计分析并生成图表。

使用时，可以直接把 Excel 或 CSV 文件拖入对话，或者告诉 WorkBuddy 文件所在路径；之后在任务描述中明确需要分析的指标、图表类型、统计维度或时间范围，以及是否需要生成报告。

示例任务指令为：

请读取这份销售数据，按月份统计各产品线的销售额和利润，分别生成柱状图与折线图，并补充一段结论说明。

WorkBuddy 会根据要求读取数据、完成统计并生成相应图表。

案例四：每日自动推送资讯简报

官方案例展示了通过连接器接入 QQ 邮箱后，让 WorkBuddy 生成并发送每日资讯简报。

首先通过连接器完成 QQ 邮箱与 WorkBuddy 的对接，然后先手动执行一次任务，验证简报生成、发送过程和邮箱接收是否正常。例如：

请生成今天的资讯简报，包含本地天气、AI 行业动态、重点新闻和我的任务摘要，并发送到我的 QQ 邮箱。

确认流程运行正常后，可以进一步创建自动化任务，例如：

请创建一个自动化任务，每天早上 8 点 30 分为我生成资讯简报并发送到 QQ 邮箱，内容包括天气、行业资讯和任务摘要。

创建完成后，可以在左侧边栏的自动化目录中管理定时任务。简报内容还可以继续通过自然语言调整，例如限定工作日发送、只保留财经或 AI 新闻，以及改变表达风格。

案例五：零代码制作本地应用

官方案例展示了如何通过自然语言设计、生成、调试和持续升级本地应用。使用时建议在新建任务时选择"代码开发模式"。

示例需求为：

请帮我设计一个本地可运行的知识管理小工具，支持新增、搜索、编辑和分类，界面简洁，适合个人日常记录使用，并直接生成可运行的代码。

WorkBuddy 会理解需求、生成完整代码并尝试运行。应用运行过程中出现异常时，还可以继续在对话中描述观察到的报错现象，让 WorkBuddy 基于当前上下文继续排查。

案例六：创建自己的 Skill

官方案例提出，可以把固定的个人工作习惯、知识处理流程和任务逻辑沉淀成可复用的 Skill。例如，针对灵感记录、笔记整理等重复工作，可以创建一个专用 Skill。

可以直接在对话框中描述能力、触发方式和期望输出，例如：

请帮我创建一个用于记录灵感的自定义 Skill。当我输入灵感、想法或待验证创意时，自动识别内容类型，整理成结构化记录，并保存到指定目录。

执行完成后，在技能栏的已安装目录中即可查看新创建的 Skill。