AI工具►使用指南

WorkBuddy 全指南：腾讯全场景 AI 智能体工作台完全解析

WorkBuddy 全指南

本文档系统介绍 WorkBuddy 的核心概念、功能特性、工作流程和使用建议。

目录

  1. WorkBuddy 是什么？
  2. 解决什么问题？
  3. 快速上手
  4. 工作流程
  5. 目录结构
  6. 记忆系统
  7. 安全边界
  8. 学习资料

1. WorkBuddy 是什么？

WorkBuddy 是腾讯推出的全场景职场 AI 智能体桌面工作台，面向各类职能角色设计。它的定位是让 AI 真正成为可以干活的数字同事——用自然语言下达任务，WorkBuddy 会自主规划步骤、执行操作、交付结果。

与传统 AI 的核心差异

对比维度 传统 AI WorkBuddy
能力边界 聊天、给建议 实际执行任务
文件操作 手动操作 自动读写本地文件
任务复杂度 单一步骤 多步骤复杂任务
输出形式 文字回复 交付可验收的产物

WorkBuddy 填补了”AI 建议”到”AI 执行”之间的鸿沟。

2. 解决什么问题？

WorkBuddy 核心解决的是从”AI 建议”到”AI 执行”的最后一公里：

场景 说明
📄 文档处理 生成报告、邮件、周报、纪要，无需手动排版
📊 数据分析 上传数据文件，自动分析并可视化
📊 PPT / 报告生成 从需求描述直接产出可演示的文档
🔍 深度调研 对复杂问题进行系统性研究，输出完整报告
🗂️ 批量文件操作 自动整理、重命名、格式转换

一句话：你能用电脑做的事，WorkBuddy 都能帮你做。

3. 快速上手

快速上手五步法

1
2
3
4
5
Step 1 → 打开 WorkBuddy，进入主界面
Step 2 → 创建任务（输入任务描述，选择工作模式）
Step 3 → 等待执行，查看右侧结果区的产物
Step 4 → 在对话区追问或补充上下文
Step 5 → 验收结果，下载或直接使用

三种工作模式

模式 英文 适用场景
执行模式 Craft 明确知道要做什么，直接干活
规划模式 Plan 复杂任务，先设计路线图再行动
对话模式 Ask 纯问答，不修改任何文件

官方推荐的阅读顺序

1
2
3
4
5
1. 快速开始 → 了解如何进入 WorkBuddy、发起第一个任务、界面基本结构
2. 创建任务 → 了解如何选择工作模式、填写任务内容和补充上下文
3. 任务管理 → 了解如何查看任务列表、按状态筛选、继续处理已有任务
4. 任务对话 → 了解如何在对话区持续追问、上传文件、使用顶部操作
5. 结果查看 → 了解如何在右侧结果区查看产物、全部文件、变更和预览

4. 工作流程

完整工作流程

1
2
3
4
5
6
7
8
9
10
11
12
用户下达任务
    ↓
WorkBuddy 分析任务意图与当前上下文
    ↓
选择工作模式
    ├── Craft（执行模式）→ 直接执行，产出结果
    ├── Plan（规划模式） → 设计方案，用户确认后再执行
    └── Ask（对话模式） → 仅回答，不操作文件
    ↓
交付产物（文档 / 表格 / 代码 / 图表 / 视频等）
    ↓
用户验收，可追问或补充

Agent Loop（执行循环）

WorkBuddy 在执行模式下的内部循环：

1
2
3
4
5
6
7
1. 分析上下文 — 理解用户意图和当前状态
2. 思考 — 推理是否需要调整计划、推进阶段或采取行动
3. 选择工具 — 根据计划选取下一个要执行的工具
4. 执行操作 — 工具在沙盒环境中执行
5. 接收观察 — 操作结果作为新观察附加到上下文中
6. 迭代循环 — 重复以上步骤直至任务完成
7. 呈现结果 — 通过消息和预览工具向用户交付结果

5. 目录结构

WorkBuddy 在本地有两个层级的核心目录：

用户级配置（~/.workbuddy/）

全局生效，适用于所有项目。

1
2
3
4
5
6
7
8
~/.workbuddy/
├── SOUL.md            # AI 的灵魂定义（行为准则、价值观）
├── IDENTITY.md        # AI 的身份档案（名字、风格、emoji）
├── USER.md            # 用户档案（用户信息、偏好）
├── BOOTSTRAP.md       # 初始化脚本（首次运行时填充上述三个文件，完成后删除）
├── skills/            # 用户级技能库（所有项目通用）
├── mcp.json           # MCP 服务器配置
└── workbuddy.db       # 自动化任务数据库（SQLite）

工作台区（每个项目独立）

1
2
3
4
5
6
7
{工作区}/
├── .workbuddy/
│   ├── memory/
│   │   ├── YYYY-MM-DD.md     # 每日日志（追加写入）
│   │   └── MEMORY.md         # 长期记忆（持续更新）
│   └── skills/              # 项目级技能库（仅本项目生效）
└── [项目文件...]

记忆文件详解

文件 位置 性质 内容类型
SOUL.md 用户级 持久化 AI 行为准则、价值观、边界
IDENTITY.md 用户级 持久化 AI 名字、风格、Emoji
USER.md 用户级 持久化 用户背景、偏好、项目上下文
YYYY-MM-DD.md 工作区级 追加写入 当天工作记录、决策、重要结果
MEMORY.md 工作区级 持续更新 提炼后的长期知识、偏好、约定

6. 记忆系统

这是 WorkBuddy 最核心的设计之一——记忆外化为文件系统。

三层记忆架构

1
2
3
第1层 · 长期记忆 ──→ MEMORY.md       持久化，提炼精华，跨会话复用
第2层 · 每日日志 ──→ YYYY-MM-DD.md   追加写入，30天后提炼进 MEMORY.md
第3层 · 身份档案 ──→ SOUL/IDENTITY/USER.md  稳定不变，除非主动修改

记忆工作流

1
2
3
4
5
6
7
8
9
新会话开始
    ↓ 读取 MEMORY.md + 今日/昨日日志
恢复上下文
    ↓
执行任务
    ↓ 完成实质性工作后立即写入
写入今日日志（+ 必要时更新 MEMORY.md）
    ↓
会话结束

什么会被记忆？

会写入记忆的内容（有持久价值的）：

  • ✅ 构建 / 修改了某个应用或功能
  • ✅ 修复了 Bug
  • ✅ 选择了某个技术方案（框架、设计模式）
  • ✅ 用户告知的项目约定或个人偏好
  • ✅ 重要决策与背景

不会写入记忆的内容（临时性的）：

  • ❌ 中间搜索结果
  • ❌ 临时文件路径
  • ❌ 工具调用错误
  • ❌ 纯闲聊 / 简单问答

记忆维护规则

  • 每日文件超过 30 天 → 提炼进 MEMORY.md，原文件删除
  • MEMORY.md 保持精炼 → 遇到冲突时原地更新并注明日期
  • 手动可控 → 可直接打开 .workbuddy/memory/ 文件夹查看、编辑或删除 AI 的记忆

7. 安全边界

操作风险分级

WorkBuddy 将文件操作按风险程度分为三个级别：

级别 区域 操作限制
🔴 高风险 Desktop、Downloads、Documents、Home 扫描只读，操作需逐项确认
🟡 中风险 项目目录 可执行，但批量操作有保护
🟢 低风险 .workbuddy 配置目录 受保护，不受误删影响

安全操作规则

规则 说明
强制警告 对个人目录的破坏性操作必须显示警告并要求确认
逐项确认 删除 / 重命名操作列出所有受影响文件路径
先备份再操作 对个人目录的移动 / 删除必须先创建备份
使用回收站 优先使用系统回收站，而非直接删除
小批量操作 每次最多 10 个文件，验证后再继续
禁止危险路径 C:\、/System、AppData、/Library 等系统目录禁止递归删除

外部操作原则

  • 内部操作（读文件、整理、分析） → 大胆执行
  • 外部行动（发邮件、发消息、发社交媒体） → 先问再做，不确定时谨慎处理
  • 私密信息 → 绝对保密，不对外泄露

8. 学习资料

资料 地址
📖 官方文档首页 https://www.codebuddy.cn/docs/workbuddy/Overview
⚡ 快速开始 https://www.codebuddy.cn/docs/workbuddy/QuickStart
🛠️ 技能市场 内置 100+ 领域专家，从左侧”专家”入口进入
🔌 MCP 连接器 支持腾讯文档、微云、腾讯会议、腾讯乐享、QQ邮箱、TAPD 等
🤖 专家中心 可与各领域专家对话，获取专业帮助

快速上手建议

你现在处于初始化阶段——BOOTSTRAP.md 还存在，身份档案（IDENTITY / USER）都是空的。建议按以下顺序上手：

  1. 走一遍初始化 — 把 AI 的名字、风格、你的背景填进去，建立稳定的身份档案
  2. 发一个实际任务 — 感受三种工作模式（Craft / Plan / Ask）的差异
  3. 观察记忆文件 — 查看 .workbuddy/memory/ 里写了什么，理解记忆是如何工作的

本文档由 WorkBuddy AI 整理，供用户参考。