🤖 WorkBuddy & CodeBuddy 使用手册

🤖一、WorkBuddy — AI 工作台

1.1 什么是 WorkBuddy

WorkBuddy 是一款 AI Agent 工作台，主打动手执行——不是只会回答问题，而是能直接读取文件、写代码、执行命令、抓取网页、生成图片视频、部署站点。它的设计理念是："你说我做，别让我分析来分析去"。

适用于：

• 技术运维——查日志、清缓存、部署更新、数据库操作
• 内容创作——写报告、做 PPT、生成海报视频
• 数据分析——跑 SQL、建图表、做报表
• 开发辅助——搭项目、重构代码、写测试
• 自动化工作流——定时任务、监控告警、批量操作

1.2 三种工作模式

WorkBuddy 提供三种模式，对应不同的使用场景：

1.3 核心能力清单

1.4 上手操作

基本对话

直接输入需求即可。WorkBuddy 的风格是实干、直接、不废话。不需要客套，直接说需求：

> 帮我查一下服务器磁盘空间
> 读一下这个文件的前 50 行
> 把这个 HTML 页面部署到服务器

文件操作

三种核心文件工具：

• Read — 读取文件内容。支持代码、图片、PDF、Jupyter Notebook。
• Write — 创建新文件。覆盖写入，适合一次性生成。
• Edit — 精确替换文件中的指定字符串。不改动不相关的内容。

搜索与检索

• Glob — 按文件名模式匹配（如 **/*.html）
• Grep — 按文件内容搜索（支持正则表达式）
• WebFetch — 抓取网页内容并提取关键信息
• WebSearch — 联网搜索最新信息

1.5 高级功能

Skills（技能包）

Skills 是预封装的专业能力模块，通过 /skill-name 加载。比如：

• agnes-image — 文生图
• agnes-video — 文生视频
• tencent-docs — 腾讯文档操作
• github — GitHub Issue/PR/CI 操作
• wechat-miniprogram — 微信小程序开发

简单一句话就能加载，比如"生成一张海报"就会自动调用图像生成技能。

Experts（专家包）

Experts 是带领域知识的 AI 专家，可以从左侧栏"专家"入口进入。涵盖设计、法律、金融、编程等 100+ 领域。

Automations（自动化任务）

用定时任务来处理重复性工作：

# 示例：每天早上 9 点生成站点访问报告
schedule: "DAILY"
rrule: "FREQ=DAILY;BYHOUR=9;BYMINUTE=0"
prompt: "读取今日日志，汇总关键指标并生成报告"

支持的调度模式：

• Recurring（循环）——按 RRULE 规则重复执行（每天、每周、每小时等）
• Once（一次性）——在指定时刻只执行一次
• 有效期（validFrom / validUntil）——限定任务的活跃时间段

MCP 连接器

MCP（Model Context Protocol）是 AI 与外部服务的标准化接口。已支持：

• 钉钉、飞书、企业微信
• GitHub、TAPD
• 腾讯文档、腾讯会议、腾讯问卷
• 腾讯自选股、通达信
• 乐享知识库、微云、金山文档
• 企查查、天眼查、智慧芽
• 等 50+ 连接器

Memory（记忆系统）

WorkBuddy 有三层记忆：

• 云端记忆— 长期用户画像，自动注入（只读）
• 用户级本地记忆— 跨项目的个人偏好文件 ~/.workbuddy/MEMORY.md
• 项目级工作记忆— 当前项目的日誌和笔记 .workbuddy/memory/

1.6 使用技巧与边界

高效使用技巧

• 任务管理：复杂任务用 TaskCreate 拆分步骤，系统自动跟踪进度
• 批量操作：多个独立文件操作可以并行发出指令
• 代理协作：用 Agent 工具启动子代理，并行处理独立任务
• 演示输出：完成结果用 present_files 提供预览，HTML 文件可边看边调

安全边界

• 沙箱隔离：代码执行在受限环境中运行
• 高危操作需用户授权（涉及个人文件、系统目录等）
• Skills 安装前自动进行安全检查
• @（提及）语法用于直接引用指定文件或上下文

💻二、CodeBuddy — AI 编程助手

2.1 CodeBuddy 产品家族

CodeBuddy 是腾讯推出的 AI 编程辅助产品，包含以下形态：

2.2 CodeBuddy Code CLI 安装与配置

安装

1. 通过 npm 全局安装

   npm install -g @cursorai/codebuddy-code

2. 验证安装

   codebuddy --version

3. 启动

   codebuddy

   在项目目录中启动交互式对话。
4. 配置 API Key

   codebuddy config set api-key "your-api-key-here"

   或者设置环境变量 CODEBUDDY_API_KEY。

基本使用

在项目目录中运行 codebuddy 启动终端对话：

# 进入项目目录
cd my-project

# 启动 CodeBuddy 对话
codebuddy

# 然后直接输入你的需求，比如：
> 帮我重构这个 API 接口，把逻辑拆到 service 层
> 给我写一个单元测试
> 解释一下这段代码是干什么的

常用命令：

2.3 自定义模型配置

CodeBuddy Code 支持配置多个自定义模型，通过 chatLanguageModels.json 文件管理。

# 配置文件路径
~/.codebuddy/chatLanguageModels.json

示例配置：

{
  "deepseek-v4-flash": {
    "provider": "deepseek",
    "model": "deepseek-chat",
    "apiKey": "sk-xxx"
  },
  "gemma-4-31b-it": {
    "provider": "openai-compatible",
    "baseUrl": "https://integrate.api.nvidia.com/v1",
    "model": "google/gemma-4-31b-it",
    "apiKey": "nvapi-xxx"
  }
}

支持的模型协议：

• OpenAI 兼容协议 — 可对接 NVIDIA NIM、DeepSeek、Ollama 等
• 自定义 baseUrl — 可指向内网部署的模型服务
• 多 API Key — 不同模型使用不同的凭证

2.4 最佳实践

• 明确上下文：用 @ 引用文件，让 AI 知道你在说什么
• 分步推进：复杂功能拆成小步骤，逐步完成
• 代码审查：用 /review 命令让 AI 检查当前改动
• 规则文件：在项目根目录创建 .cursorrules 或 .codebuddy/rules/ 来约束 AI 行为
• Skills：安装社区 Skills 扩展能力，通过 /skill-name 调用

📄三、WorkBuddy vs CodeBuddy 对比

两款工具定位不同，但可以互补使用：

配合使用建议

最佳组合方式：

• WorkBuddy 做"外围"：部署环境、管理数据、写文档、生成图片、定时巡检
• CodeBuddy 做"核心"：写代码、重构、调试、Code Review
• 共享知识：在 WorkBuddy 中配置的自定义模型和 Skills，CodeBuddy 也能复用

🌟附：学习路径建议

如果你是第一次接触：

1. 从 WorkBuddy 开始 — 先让它帮你做一些简单任务：读文件、查日志、生成一个表格
2. 尝试 Skills — 加载图像生成技能做海报，或加载腾讯文档技能操作云文档
3. 配置 CodeBuddy — 安装 CLI，配置 API Key，在项目中用起来
4. 连接 MCP — 把钉钉、GitHub、腾讯文档等常用服务连上
5. 设置自动化 — 把重复工作交给 Automations

📝 本手册持续更新 · 最后更新 2026-07-14