WorkBuddy入门手册橙皮书-从安装到自动化全链路系统指南_56页_8mb

报告摘要

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 配置示例：

{
    "mcpServers": {
        "wecom": {
            "command": "uvx",
            "args": ["wecom-bot-mcp-server"],
            "env": {
                "WECOM_WEBHOOK_URL": "your-webhook-url"
            }
        }
    }
}

{
    "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 工作流通常包括以下步骤：

需求输入：用自然语言描述需求，明确输入来源、输出格式、具体字段、保存位置。
模式选择：根据任务复杂度选择 Ask、Plan 或 Craft 模式。
Skill / 专家匹配：根据触发词加载 Skill，或根据任务领域召唤专家。
执行计划：Plan 模式下，AI 会先制定执行计划，再开始执行。
任务执行：AI 按照计划执行任务，用户可实时查看进度、中途介入或提供补充信息。
结果验证：AI 展示执行结果，用户需验证是否符合预期，必要时进行修正。
交付与记忆更新：将结果交付到指定位置，并更新 Workspace Memory，记录关键信息。

实战案例库

办公自动化：如生成日报、周报，处理 Excel 文件。
数据分析：如分析销售数据，生成图表与报告。
内容创作：如公众号文章、小红书文案、PPT 演示文稿。
代码审查：使用 code-review Skill 自动审查代码。
竞品监控：如监控行业动态、分析市场趋势。

附录与建议

推荐阅读路线：快速上手路线（0.使用说明→第一篇→第二篇→第四篇→选读实战案例）
省积分技巧：轻量任务使用轻量模型，重度任务使用 reasoning 模型但频率降低。
权限模式配置：建议日常使用 Plan 模式，重要任务使用 Craft 模式前进行备份。
工作空间设置：建议修改默认存储路径，避免 C 盘空间不足。
自动化注意事项：确保客户端保持运行，正确设置工作目录和时间规则，避免任务触发失败。

适用人群

零基础用户：适合从入门到使用 WorkBuddy 的全流程
办公人员：适合处理文档、数据分析、内容创作等任务
开发者：适合代码审查、文档生成等任务
自动化需求者：适合搭建 AI 自动化流程，执行定时任务

工作流模板

数据处理模板：
- 读取【文件路径】，按【分类字段】汇总【数值字段】
- 生成柱状图
- 输出为 Excel 文件，保存至【输出路径】
日报/周报生成模板：
- 读取【数据来源】
- 提取以下信息并生成【日报/周报】：
  1. 已完成的事项（标注负责人）
  2. 遇到的阻塞问题
  3. 今日/本周计划做的事
- 输出格式：
```
## 【日报/周报】 - [日期]
### 已完成
- [事项1]（负责人：XXX）
### 阻塞问题
- [问题描述]
### 今日计划
- [计划事项]
```