> **来源：[研报客](https://pc.yanbaoke.cn)** # WorkBuddy 入门手册总结 ## 核心内容 WorkBuddy 是腾讯推出的全场景 AI Agent 桌面工作台，具备自主规划、执行任务、操作本地文件、连接外部工具等能力。它不仅是对话式 AI 助手，更是一个可执行任务的工程执行者，适合办公、开发、内容创作等多种场景。 ## 主要观点 - **WorkBuddy 的定位**：不同于传统 AI 聊天工具，WorkBuddy 能够直接操作电脑上的真实文件，执行多步骤任务，并支持自动化定时任务。 - **三种工作模式**：Ask（仅对话）、Plan（先计划后执行）、Craft（可读写+执行），适用于不同信任程度和任务复杂度。 - **Skill 系统**：提供结构化的操作流程，增强 AI 的执行能力，支持图形化界面、YAML 模板和指令反向生成三种创建方式。 - **专家系统**：内置 100+ 领域专家，可按需召唤，增强 AI 在特定领域的专业能力。 - **记忆系统**：通过 Cloud Memory、User-level Local、Workspace 三层架构，实现 AI 对用户偏好和历史的记录。 - **自动化功能**：通过定时触发和任务编排，将重复性任务交给 AI 执行，节省时间和精力。 - **连接器（MCP）**：支持腾讯文档、QQ 邮箱、飞书、企业微信等，实现跨平台操作，提升协作效率。 - **远程助理功能**：通过微信、QQ、飞书、钉钉等远程控制 WorkBuddy，执行任务并接收结果。 ## 关键信息 ### 产品定位与核心能力 - **产品定位**：全场景 AI Agent 桌面工作台 - **核心能力**： - 一句话任务指派 - 自主规划与执行 - 并行多任务处理 - 本地文件操作 - 可验证的结果 - Skill 扩展 - 专家系统 - 自动化 - 连接器 ### 三大工作模式 | 模式 | 权限等级 | 行为 | 典型场景 | |------|----------|------|----------| | Ask | 最低 | 只回答问题，完全不碰文件 | 咨询、概念解释、文案起草 | | Plan | 中 | 先出执行计划，逐条确认后执行 | 多步骤任务、文件处理 | | Craft | 最高 | 直接操作文件、运行代码，每步仍需确认 | 批量处理、写代码 | ### Skill 系统 - **Skill 是什么**：结构化的操作手册，指导 AI 如何处理特定任务。 - **Skill 创建方式**： - 图形化界面（适合新手） - 导入 YAML 模板（适合有定制需求） - 指令反向生成（适合所有用户） - **推荐 Skill**：包括 Excel 处理、PPT 制作、文档生成、股票查询、内容创作等。 - **Skill 管理建议**： - 保留常用 10-20 个 Skill - 关闭不用的 Skill - 同一操作重复 3 次以上可封装为 Skill ### 专家系统 - **专家是什么**：AI 顾问，具备特定领域的知识体系、工作习惯和输出标准。 - **专家类型**： - **Agent 型专家**：单一领域的 AI 角色（如财务专家、抖音策略师） - **Team 型专家**：协作团队，自动拆解任务，支持并行执行（如“三只虾流水线”） - **专家使用方式**： - 从专家广场召唤 - 创建专属专家团，通过交互式问答明确需求后自动生成配置 ### 记忆系统 - **记忆是什么**：记录用户偏好和历史，使 AI 越用越懂你。 - **三层架构**： - **Cloud Memory**：跨项目，跟随账号 - **User-level Local**：所有项目，存储于 `~/.workbuddy/MEMORY.md` - **Workspace**：当前项目，存储于 `{workspace}/.workbuddy/memory/` - **记忆管理建议**： - 控制在 20 条以内 - 每周清理一次 - 注意项目间记忆隔离问题 ### 自动化系统 - **自动化是什么**：定时触发器 + 任务编排，将重复性任务交给 AI 执行。 - **自动化配置字段**： - **Name**：任务名称 - **Prompt**：AI 执行的具体指令 - **Schedule Type**：周期（recurring）或一次性（once） - **RRULE**：周期规则（如 `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`） - **scheduledAt**：一次性任务的执行时间（ISO 8601 格式） - **Workspace (CWD)**：工作目录路径 - **Status**：ACTIVE 或 PAUSED - **Expert ID**：指定执行专家 - **Model ID**：指定执行模型 - **validFrom / validUntil**：任务有效期 - **常见周期规则**： - 每天早上 9 点：`FREQ=DAILY;BYHOUR=9;BYMINUTE=0` - 每周日晚上 22 点：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=10` - **省积分技巧**： - 轻量任务（消息提炼、格式转换）使用轻量模型（MiniMax / GLM） - 重度任务（代码分析、长报告）使用 reasoning 模型，但频率建议为 WEEKLY ### 连接器（MCP） - **连接器是什么**：WorkBuddy 与外部系统的桥梁，基于 MCP 协议。 - **支持的连接器**： - 腾讯文档 - QQ 邮箱 - 腾讯乐享 - GitHub - 飞书 - 企业微信 - Notion - Wolai - Obsidian - 滴答清单 - Flomo - **MCP 配置示例**： ```json { "mcpServers": { "wecom": { "command": "uvx", "args": ["wecom-bot-mcp-server"], "env": { "WECOM_WEBHOOK_URL": "your-webhook-url" } } } } ``` ```json { "mcpServers": { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxx" } } } } ``` ### 助理（远程操控） - **助理是什么**：通过微信、QQ、飞书、钉钉等远程操控 WorkBuddy。 - **助理任务 vs 普通任务**： | 对比项 | 普通任务 | 助理(远程) | |--------|----------|------------| | 工作目录 | 自由指定 | 固定使用助理专属文件夹 | | 新建对话 | 支持多个并行任务 | 仅一个会话，远程指令集中处理 | | 上下文管理 | 可清空历史 | 保留完整对话历史 | | 适用场景 | 坐在电脑前操作 | 外出、通勤、不在电脑旁 | ### 多工作区管理 - **工作空间（Workspace）**：每个工作空间独立管理任务和文件。 - **多工作区建议**： - 多个项目同时推进 → 为每个项目创建独立工作空间 - 工作和个人项目分离 → 两个独立工作空间 - 自动化任务 → 指定专属工作空间（默认 `automation-claw-xxxx`） - **本地文件权限管理**：仅授权工作相关目录，隔离工作区与非工作区文件。 ### 结果面板与文件管理 - **结果面板功能**： - Artifacts：显示 AI 生成的可交互内容（图表、网页、PPT） - 所有文件：本次任务生成和修改的所有文件列表 - 变更预览：显示文件的具体修改内容（diff 视图） - 文件预览：直接预览生成的文件内容 - **文件管理建议**： - 指定统一的输出目录 - 重要文件建议人工验收后再使用 - 定期清理临时文件 ## 标准工作流 一个完整的 WorkBuddy 工作流通常包括以下步骤： 1. **需求输入**：用自然语言描述需求，明确输入来源、输出格式、具体字段、保存位置。 2. **模式选择**：根据任务复杂度选择 Ask、Plan 或 Craft 模式。 3. **Skill / 专家匹配**：根据触发词加载 Skill，或根据任务领域召唤专家。 4. **执行计划**：Plan 模式下，AI 会先制定执行计划，再开始执行。 5. **任务执行**：AI 按照计划执行任务，用户可实时查看进度、中途介入或提供补充信息。 6. **结果验证**：AI 展示执行结果，用户需验证是否符合预期，必要时进行修正。 7. **交付与记忆更新**：将结果交付到指定位置，并更新 Workspace Memory，记录关键信息。 ## 实战案例库 - **办公自动化**：如生成日报、周报，处理 Excel 文件。 - **数据分析**：如分析销售数据，生成图表与报告。 - **内容创作**：如公众号文章、小红书文案、PPT 演示文稿。 - **代码审查**：使用 code-review Skill 自动审查代码。 - **竞品监控**：如监控行业动态、分析市场趋势。 ## 附录与建议 - **推荐阅读路线**：快速上手路线（0.使用说明→第一篇→第二篇→第四篇→选读实战案例） - **省积分技巧**：轻量任务使用轻量模型，重度任务使用 reasoning 模型但频率降低。 - **权限模式配置**：建议日常使用 Plan 模式，重要任务使用 Craft 模式前进行备份。 - **工作空间设置**：建议修改默认存储路径，避免 C 盘空间不足。 - **自动化注意事项**：确保客户端保持运行，正确设置工作目录和时间规则，避免任务触发失败。 --- ### 推荐使用场景 - **日常办公**：文档生成、数据分析、会议纪要整理 - **代码开发**：代码生成、审查、文档编写 - **内容创作**：公众号文章、小红书文案、PPT 制作 - **自动化任务**：定时任务、日报/周报生成、数据汇总 ### 适用人群 - **零基础用户**：适合从入门到使用 WorkBuddy 的全流程 - **办公人员**：适合处理文档、数据分析、内容创作等任务 - **开发者**：适合代码审查、文档生成等任务 - **自动化需求者**：适合搭建 AI 自动化流程，执行定时任务 --- ### 工作流模板 - **数据处理模板**： - 读取【文件路径】，按【分类字段】汇总【数值字段】 - 生成柱状图 - 输出为 Excel 文件，保存至【输出路径】 - **日报/周报生成模板**： - 读取【数据来源】 - 提取以下信息并生成【日报/周报】： 1. 已完成的事项（标注负责人） 2. 遇到的阻塞问题 3. 今日/本周计划做的事 - 输出格式： ```markdown ## 【日报/周报】 - [日期] ### 已完成 - [事项1]（负责人：XXX） ### 阻塞问题 - [问题描述] ### 今日计划 - [计划事项] ``` --- ### 使用建议 - **日常任务**：优先使用 Plan 模式，确保可控性 - **咨询讨论**：使用 Ask 模式，省去不必要的确认步骤 - **批量处理**：使用 Craft 模式，提升效率但需密切监控 - **自动化任务**：使用自动化功能，定时执行任务，减少人工干预 - **远程操控**：使用助理功能，方便在外出时远程操作 WorkBuddy - **文件管理**：建议指定统一的输出目录，重要文件需人工验收 - **记忆管理**：控制记忆条数，定期清理，避免 AI 分散注意力