Buddy 1.5线专项面试指南
编制日期:2026年5月15日 | 版本:v1.0 | 目标字数:50,000+
目录
第一篇:产品全景认知
第一章:WorkBuddy 产品深度解析
1.1 产品定位与核心价值
WorkBuddy 是腾讯推出的全场景职场 AI 智能体桌面工作台。其核心定位可以用一句话概括:用自然语言描述需求,系统自主规划和执行复杂任务。
WorkBuddy 的三大核心特征:
| 特征 | 说明 | 与传统工具的区别 |
|---|---|---|
| 一句话下达任务 | 用自然语言描述需求,无需复杂操作 | 传统工具需要手动操作多个步骤 |
| 自主规划执行 | 自动拆解任务、规划步骤、完成交付 | 传统工具只能执行单一指令 |
| 多任务并行 | 支持同时发起和管理多个任务 | 传统工具多为单线程操作 |
面试关键话术:WorkBuddy 不仅仅是"听懂人话",更能"带脑子思考"并"实际操作本地文件"。这使得它从单纯的对话AI升级为职场执行型Agent。
1.2 适用场景矩阵
WorkBuddy 支持两种工作模式,覆盖不同用户群体:
工作模式(默认)—— 职场通用
| 场景类别 | 具体场景 | 输入示例 |
|---|---|---|
| 文档生成 | 工作报告、技术文档、README | “帮我根据这份会议纪要生成本周工作周报” |
| 数据分析 | 上传数据文件,自动分析和可视化 | “分析这份销售数据,生成图表报告” |
| PPT/报告 | 从需求描述生成演示文稿 | “根据这份需求文档生成项目汇报PPT” |
| 深度研究 | 对复杂问题进行深度调研 | “调研2026年AI行业趋势,写一份报告” |
| 办公自动化 | 邮件编辑、周报生成 | “帮我整理这封邮件的要点并回复” |
| 批量文件处理 | 自动整理、重命名、转换格式 | “整理Downloads文件夹里的图片按日期分类” |
编程模式 —— 代码开发
| 场景类别 | 具体场景 | 输入示例 |
|---|---|---|
| 日常编码辅助 | 代码生成、审查、Bug修复 | “帮我审查这段Python代码” |
| 项目理解 | 快速了解陌生代码库 | “分析这个项目的架构和逻辑” |
| 网站/应用开发 | 从需求到代码全流程 | “帮我写一个Vue前端页面” |
1.3 系统架构与技术栈
环境要求
- 网络:需要网络连接以调用AI模型服务
- 操作系统:Windows / macOS
- 安装包大小:150-180 MB
安装方式
| 平台 | 安装文件 | 安装方式 |
|---|---|---|
| Windows | WorkBuddySetup.exe | 下载安装程序,双击运行 |
| macOS | WorkBuddy.dmg | 下载后拖拽到应用程序文件夹 |
界面架构(三区域布局)
| 区域 | 位置 | 功能 |
|---|---|---|
| 侧边栏 | 左侧 | 任务列表(按文件夹分组)、搜索管理、用户头像 |
| 对话区 | 中间 | 核心交互区域:任务标题栏、消息列表、输入框 |
| 结果区 | 右侧 | 产物、全部文件、变更、预览等视图面板 |
工作目录机制
- WorkBuddy 在指定工作目录中读取和保存文件
- 未指定路径时,系统自动创建独立目录
- Windows 默认路径:
C:\Users\用户名\WorkBuddy\ - 最佳实践:按任务类型分别建立目录(如
发票整理、周报、待处理照片)
1.4 三种工作模式详解
这是面试中极其重要的知识点,必须烂熟于心:
| 模式 | 英文名 | 执行权限 | 适用场景 | 风险等级 |
|---|---|---|---|---|
| 问一问 | Ask | 仅问答与信息查看,不修改文件 | 了解内容、确认需求 | 🟢 无风险 |
| 做一做 | Craft | 直接执行任务并修改文件 | 文档生成、表格处理、文件整理 | 🟡 中风险 |
| 想一想 | Plan | 先生成执行计划,确认后再操作 | 多步骤任务、需审阅改动范围 | 🟢 低风险 |
面试要点:
- 首次使用建议选择 Ask 模式
- 处理重要文件前务必先备份
- Plan 模式适合复杂任务——AI 先出方案,用户确认后再执行
- Craft 模式效率最高但需注意文件安全
1.5 内置模型体系
| 模型名称 | 定位 | 可用功能 | 推荐场景 |
|---|---|---|---|
| Auto | 平衡效果与速度 | 图片输入 | 日常通用 |
| Hy3 preview | 混元思考模型,增强推理 | 图片输入/推理模型 | 复杂推理任务 |
| GLM-5.0 | 能力均衡 | 图片输入/推理模型 | 日常使用 |
| GLM-5.0-Turbo | Agent场景深度优化 | 图片输入/推理模型 | Agent场景 |
| GLM-5v-Turbo | 原生多模态 | 图片输入/推理模型 | 多模态处理 |
| GLM-4.7 | 能力均衡 | 图片输入 | 日常使用 |
| MiniMax-M2.7 | 能力均衡 | 图片输入 | 日常使用 |
| MiniMax-M2.5 | Excel/PPT专长 | 图片输入 | 数据分析、PPT |
| Kimi-K2.5 | 多模态 | 图片输入/推理模型 | 截图分析、图片转文档 |
| Kimi-K2.6 | 多模态升级 | 图片输入/推理模型 | 视觉类任务 |
| DeepSeek-V3.2 | 响应快、成本低 | 图片输入/推理模型 | 日常问答、文案 |
| Hunyuan-2.0-Thinking | 腾讯自研思考模型 | 推理模型 | 中文写作、会议纪要 |
面试速记:
- 推理能力优先 → Hy3 preview / Hunyuan-2.0-Thinking
- 多模态处理 → GLM-5v-Turbo / Kimi-K2.5 / Kimi-K2.6
- Agent场景优化 → GLM-5.0-Turbo
- Excel/PPT → MiniMax-M2.5
- 中文写作 → 腾讯混元
- 性价比 → DeepSeek-V3.2
1.6 自定义模型配置
WorkBuddy 支持四种模型接入方式:
1. 提供商接入
从提供商列表中选择,系统自动填充URL、模型列表、能力标记,仅需补全 API Key 即可。
2. Token Plan(按用量计费)
- 选择腾讯云 Token Plan 作为鉴权方式
- 支持模型:混元2.0、MiniMax、Kimi、GLM等
- 使用腾讯云账号体系完成鉴权与计费
3. Coding Plan(AI编码专属套餐)
- 支持:腾讯云 Coding Plan、智谱 Coding Plan、Kimi Coding Plan
4. 自定义 API
- 内置主流厂商预设入口
- 不在列表中可选"自定义/Custom",手动填写URL、API Key、模型名
5. 本地部署(Ollama)
- 开源本地大模型运行工具
- 默认监听 HTTP 端口 11434
- 兼容 OpenAI 协议
- 适用场景:数据隐私/内网合规、零成本试用、离线可用
配置文件兼容:已通过 ~/.codebuddy/models.json 配置的自定义模型在UI升级后仍可正常使用。
1.7 平台接入生态
WorkBuddy 支持7大即时通讯平台远程控制:
| 平台 | 接入方式 | 推荐程度 |
|---|---|---|
| 微信 ClawBot | 扫码绑定 | ⭐⭐⭐⭐⭐ 推荐 |
| 微信服务号 | 服务号配置 | ⭐⭐⭐ |
| 企业微信 | 应用配置 | ⭐⭐⭐⭐ |
| 机器人配置 | ⭐⭐⭐ | |
| 元宝派 | 平台集成 | ⭐⭐⭐ |
| 飞书 | 应用配置 | ⭐⭐⭐ |
| 钉钉 | 应用配置 | ⭐⭐⭐ |
Claw 核心工作原理:手机发消息 → 电脑WorkBuddy自动执行 → 结果回复到手机
第二章:CodeBuddy 产品深度解析
2.1 产品定位与核心价值
CodeBuddy 是腾讯云推出的 AI 驱动的全流程智能编程工具,致力于构建产品、设计、开发和部署之间的无缝协作共生环境。
核心定位:一站式高效交付平台,从产品构想到产品发布
2.2 三种产品形态
这是面试必考点,需要清楚区分三种形态:
| 产品形态 | 目标用户 | 核心特性 | 运行环境 |
|---|---|---|---|
| CodeBuddy IDE | 产品经理/设计师/全栈开发者/初学者 | 集成产品-设计-开发工作台,可视化调试,“对话即编程” | 独立IDE |
| CodeBuddy Plugin | 日常编码开发者/特定IDE用户 | 即插即用,零学习成本,集成到现有工作流 | VS Code/JetBrains插件 |
| CodeBuddy Code (CLI) | DevOps/运维/SRE/高级开发者 | 命令行工具,Shell/File/Network操作,强大任务编排 | 终端 |
2.3 全流程能力矩阵
CodeBuddy 覆盖从产品构想到上线的四个阶段:
产品阶段:从想法到需求
- 智能需求分析:自然语言 → 结构化PRD文档
- 需求优化建议:AI辅助改进产品需求
设计阶段:从需求到原型
- 自然语言转交互原型
- 手绘草图转高保真设计稿
- 基于组件库快速组装
- AI视觉优化:自然语言实时调整设计风格
开发阶段:从设计到代码
- 一键设计转代码(内置Figma功能)
- 智能补全和错误修复
- 自动生成单元测试
- 代码理解与审查
- 工程结构分析(
@workspace和#Codebase)
部署阶段:从代码到上线
- 一键部署到沙箱环境
- 生成公开访问链接
- CloudStudio / EdgeOne Pages 部署
2.4 支持的编程语言与框架
| 类别 | 支持的技术 |
|---|---|
| 前端 | HTML, JavaScript, CSS, Vue, React, Bootstrap |
| 后端 | Node.js, Python, Java, C#, Ruby, PHP |
| 客户端 | Java, Kotlin, Swift, Objective-C, C# |
| 其他 | C++, Go, Rust, TypeScript, Shell, PowerShell, R, MATLAB |
特点:理论上对代码语言无限制,支持主流开发技术栈。
2.5 IDE 版本支持
| IDE | 最低版本要求 |
|---|---|
| Visual Studio Code | 1.82 |
| IntelliJ IDEA | 2022.2 |
| PyCharm | 2022.2 |
| GoLand | 2022.2 |
| CLion | 2022.2 |
| PhpStorm | 2022.2 |
| Android Studio | Flamingo | 2022.2.1 |
| 微信开发者工具 IDE | 1.06.2409140 |
| Xcode | 14.0 |
| Visual Studio | 17.0 (Visual Studio 2022) |
2.6 CodeBuddy Code (CLI) 核心功能
| 功能 | 说明 |
|---|---|
| Plan 模式 | AI只分析不修改,生成实施方案 |
| Build 模式 | AI直接修改代码,适合明确的小改动 |
| Auto 模式 | AI全自主执行,适合信任度高的重复性任务 |
| Memory 功能 | 项目级记忆,记住编码风格和项目约定 |
| MCP 扩展 | 支持 Model Context Protocol,连接外部工具 |
| 文件引用 | 用 @ 符号引用文件进行分析 |
CLI 安装方式
| 方式 | 命令 | 前置条件 |
|---|---|---|
| npm(推荐) | npm install -g @tencent-ai/codebuddy-code |
Node.js 18.20+ |
| Homebrew | brew install codebuddy-code |
无需Node.js |
| 原生二进制 | curl -fsSL https://copilot.tencent.com/cli/install.sh | bash |
单文件可执行 |
2.7 生态服务集成
| 类别 | 支持的服务 |
|---|---|
| BaaS 服务 | Supabase、腾讯 CloudBase |
| 一键部署 | CloudStudio、EdgeOne Pages |
| 组件库 | TDesign、MUI、Shadcn |
| 项目级配置 | .codebuddy/rules 配置文件 |
第三章:WorkBuddy 与 CodeBuddy 全维度对比
这是面试中最核心的知识点之一,务必熟练掌握。
3.1 核心定位对比
| 维度 | WorkBuddy | CodeBuddy |
|---|---|---|
| 产品定位 | AI 办公桌面 Agent | AI 编程工具 |
| 核心功能 | 文件处理、任务自动化 | 代码编写、项目开发 |
| 运行环境 | 桌面客户端 | IDE、CLI、插件 |
| 主要用户 | 职场人士、办公人员 | 开发者、产品经理、设计师 |
| 交互方式 | 自然语言对话 | 对话+代码编辑器 |
| 文件操作 | 本地文件读写、批量处理 | 代码文件读写、项目管理 |
| 模型选择 | 支持多模型切换 | 主要使用腾讯自研模型 |
面试核心话术:CodeBuddy 专注写代码,WorkBuddy 专注干杂活。两者共享同一套账号与Credits体系。
3.2 功能对比详表
| 功能维度 | WorkBuddy | CodeBuddy |
|---|---|---|
| 文件处理 | ✅ 批量处理文件、生成文档报表 | ✅ 代码文件读写 |
| 远程控制 | ✅ Claw远程控制(7平台) | ❌ 不支持 |
| 定时任务 | ✅ 自动化任务定时执行 | ❌ 不支持 |
| Skill系统 | ✅ 兼容OpenClaw社区技能生态 | ✅ MCP扩展 |
| 多模型支持 | ✅ 支持切换多种大模型 | ⚠️ 有限支持 |
| 沙箱执行 | ✅ 隔离执行环境 | ⚠️ 项目级权限 |
| 代码补全 | ❌ 不支持 | ✅ 智能补全 |
| 设计转代码 | ❌ 不支持 | ✅ 内置Figma功能 |
| 单元测试 | ❌ 不支持 | ✅ 自动生成 |
| 一键部署 | ❌ 不支持 | ✅ CloudStudio/EdgeOne |
3.3 账号体系与共享机制
核心要点:两者共享基础设施!
| 共享项 | 说明 |
|---|---|
| 底层模型 | 使用同一个底层模型和技能生态 |
| 账号登录 | 使用腾讯账号(企业微信/QQ) |
| Credits系统 | 同一账号积分可共享使用 |
| CloudBase集成 | 两者都支持腾讯云CloudBase |
3.4 适用场景对比
| 场景 | WorkBuddy | CodeBuddy |
|---|---|---|
| 周报自动生成 | ✅ 最佳选择 | ❌ |
| Excel数据分析 | ✅ 最佳选择 | ❌ |
| 远程代码管理 | ✅ 通过Claw | ❌ |
| 定时自动化 | ✅ 最佳选择 | ❌ |
| Spring Boot API开发 | ❌ | ✅ 最佳选择 |
| 代码审查优化 | ❌ | ✅ 最佳选择 |
| 终端开发工作流 | ❌ | ✅ 最佳选择(CLI) |
3.5 联动场景(面试加分项)
场景1:开发 + 文档一体化
- 用 CodeBuddy Code 在终端开发功能
- 开发完成后,用 WorkBuddy 自动生成API文档和测试报告
- WorkBuddy 把文档发到企业微信群
场景2:CloudBase 全链路
- CodeBuddy IDE 里写云函数
- 直接管理 CloudBase 数据库
- WorkBuddy 定时导出数据报表
场景3:跨设备协作
- 公司电脑用 CodeBuddy 写代码
- 下班后用手机通过 WorkBuddy 远程触发测试
- 测试结果推送到手机
3.6 选择决策树
需要AI辅助编程? ─── 是 ─── CodeBuddy
│
否
│
需要办公自动化? ─── 是 ─── WorkBuddy
│
否
│
两者都需要? ─── 是 ─── 同时使用
第二篇:官方文档与API调用
第四章:WorkBuddy 文档体系与导航
4.1 文档结构总览
WorkBuddy 官方文档共 60+ 篇,分为4大类:
| 大类 | 子类数量 | 文档数 |
|---|---|---|
| 入门指南 | 6篇 | 6 |
| 从入门到精通指南 | 4小类 | 40+ |
| 平台接入指南 | 7平台 | 7 |
| 账号管理 | 5项 | 5 |
4.2 入门指南
| 文档 | URL路径 | 核心内容 |
|---|---|---|
| 简介 | /docs/workbuddy/Overview | 产品介绍 |
| 快速开始 | /docs/workbuddy/Quickstart | 发起第一个任务 |
| 更新日志 | /docs/workbuddy/Changelog | 版本更新记录 |
| Claw远程控制 | /docs/workbuddy/Claw | 远程控制说明 |
| 创建任务 | /docs/workbuddy/Create-Task | 工作模式、任务内容 |
| 任务管理 | /docs/workbuddy/Task-Management | 任务列表、状态筛选 |
| 任务对话 | /docs/workbuddy/Conversation | 对话区使用 |
| 结果查看 | /docs/workbuddy/Results | 产物和文件查看 |
| 第一个任务 | /docs/workbuddy/FirstTask | 实践指南 |
4.3 从入门到精通指南
安装指南
- Windows安装指南
- Mac安装指南
功能说明(14个模块)
| 功能模块 | 路径关键词 | 面试重要性 |
|---|---|---|
| 新建任务栏 | Task-Bar | ⭐⭐⭐⭐⭐ |
| Claw | Claw-Guide | ⭐⭐⭐⭐ |
| 专家中心 | Expert-Center | ⭐⭐⭐⭐⭐ |
| 技能市场 | Skills-Market | ⭐⭐⭐⭐⭐ |
| 探索 | Exploration | ⭐⭐⭐ |
| 连接器 | Connector | ⭐⭐⭐⭐⭐ |
| 资料库 | Knowledge-Base | ⭐⭐⭐⭐ |
| 自动化 | Automation-Guide | ⭐⭐⭐⭐ |
| 右侧边栏 | Right-Sidebar | ⭐⭐⭐ |
| 系统设置 | Setting | ⭐⭐⭐ |
| 记忆 | Memory | ⭐⭐⭐⭐ |
| 模型配置 | Model | ⭐⭐⭐⭐⭐ |
| 数据管理 | Data | ⭐⭐⭐ |
| 帮助与反馈 | Feedback | ⭐⭐ |
实践案例(12个养虾实践)
| 序号 | 案例名称 | 核心技能点 |
|---|---|---|
| 1 | 文件内容识别与处理 | 文件读取、格式转换 |
| 2 | 文档生成与编辑 | 自动化文档生成 |
| 3 | 数据分析并可视化 | Excel处理、图表生成 |
| 4 | 自媒体运营 | 内容创作、发布流程 |
| 5 | 每日自动推送资讯简报 | 自动化+定时任务 |
| 6 | 远程遥控龙虾 | Claw远程控制 |
| 7 | 零代码制作本地应用 | 无代码开发 |
| 8 | 自我进化—创建Skills | Skill开发 |
| 9 | AI自驱动 | 自主执行 |
| 10 | 管理你的所有会议 | 会议管理自动化 |
| 11 | 管理你的腾讯文档 | 文档管理集成 |
零成本Skill精选10个
| Skill名称 | 功能 |
|---|---|
| Agent Browser | 浏览器代理 |
| 办公文档四件套 | 文档处理 |
| Local Whisper | 本地语音识别 |
| yt-dlp-downloader | 视频下载 |
| Web Search | 网络搜索 |
| Obsidian | 笔记管理 |
| Skill Scanner | 技能扫描 |
| self-improvement | 自我提升 |
| Find Skills | 技能查找 |
| Frontend Design | 前端设计 |
4.4 平台接入指南(7个平台)
| 平台 | 路径 | 推荐程度 |
|---|---|---|
| 微信ClawBot | WeixinBot-Guide | ⭐⭐⭐⭐⭐ |
| 微信服务号 | Wechat-Guide | ⭐⭐⭐ |
| 企业微信 | Wecom-Guide | ⭐⭐⭐⭐ |
| QQ-Guide | ⭐⭐⭐ | |
| 元宝派 | YuanBaoPai-Guide | ⭐⭐⭐ |
| 飞书 | Feishu-Guide | ⭐⭐⭐ |
| 钉钉 | Dingtalk-Guide | ⭐⭐⭐ |
4.5 账号管理文档
| 文档 | 路径 | 核心内容 |
|---|---|---|
| 定价 | Pricing | 产品定价方案 |
| 积分 | Credits | 积分系统说明 |
| 用量 | Usage | 使用量统计 |
| 账单 | Billing | 账单管理 |
| 发票 | Invoice | 发票申请 |
4.6 文档导航快速定位技巧(面试实用)
面对用户问题时的文档定位策略:
| 用户问题类型 | 首选文档 | 备选文档 |
|---|---|---|
| 不会用/怎么操作 | Quickstart + 功能说明 | 实践案例 |
| 功能报错/异常 | FAQ | Changelog |
| 计费/退款/发票 | Pricing + Billing + Invoice | Credits + Usage |
| 平台接入问题 | 对应平台Guide | Claw文档 |
| Skill相关问题 | Skills-Market | Skill创建实践 |
| 模型问题 | Model | 自定义模型配置 |
| 远程控制问题 | Claw-Guide | 对应平台Guide |
第五章:CodeBuddy 开放平台与API接口
5.1 开放平台概述
CodeBuddy 开放平台提供 RESTful API 接口,支持第三方服务与企业系统的集成。主要适用于 CodeBuddy 专享版和企业版。
5.2 第三方开发集成 —— 组织架构同步
这是API调用的核心场景之一,需要重点掌握。
集成三步流程
步骤一:开发第三方服务(实现固定REST接口)
↓
步骤二:在企业管理后台配置(开放与集成 > 组织架构同步)
↓
步骤三:效果验证(查看组织架构,手动关联成员)
配置入口
企业管理后台地址:<企业id>.copilot.qq.com/admin
路径:开放与集成 → 组织架构同步 → 第三方系统
配置项
| 必填字段 | 说明 |
|---|---|
base_url |
自定义组织服务的根地址 |
enterprise_id |
企业ID |
auth_token |
鉴权Token |
| 可选字段 | 说明 | 默认值 |
|---|---|---|
timeout_seconds |
请求超时时间 | 15秒 |
auth_header |
鉴权头名称 | Authorization |
bearer_token |
是否使用Bearer方式 | true |
success_code |
响应成功代码 | 0 |
config_header |
配置头名称 | X-Custom-Config |
5.3 API接口列表
核心数据结构
OrgNode(组织节点):
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 节点唯一标识 |
name |
string | 节点名称 |
display_name |
string | 展示名称 |
parent_id |
string | 父节点ID |
full_path |
string | 节点完整路径 |
has_child |
boolean | 是否有子节点 |
member_count |
integer | 成员数量 |
attributes |
object | 自定义属性 |
OrgMember(成员):
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 成员唯一标识 |
name |
string | 用户名/昵称 |
display_name |
string | 展示名称 |
email |
string | 邮箱 |
mobile |
string | 手机号 |
employee_number |
string | 工号 |
title |
string | 职级/职位 |
department_path |
array | 部门名称路径 |
is_leader |
boolean | 是否负责人 |
status |
string | 状态(active/disabled) |
完整API接口
| 接口 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 健康检查 | GET | /org/health |
校验服务可用性 |
| 获取部门树 | GET | /org/nodes |
获取组织架构树 |
| 获取单个部门 | GET | /org/nodes/{id} |
获取指定部门详情 |
| 批量获取部门 | POST | /org/nodes/batch |
批量获取部门信息 |
| 子部门列表 | GET | /org/nodes/{id}/children |
获取子部门列表 |
| 部门成员列表 | GET | /org/nodes/{id}/members |
获取部门成员 |
| 路径解析节点 | GET | /org/path |
根据路径解析节点 |
| 搜索 | GET | /org/search |
搜索部门或用户 |
| 用户详情 | GET | /org/users/{id} |
获取用户详情 |
| 刷新缓存 | POST | /org/cache/refresh |
刷新组织架构缓存 |
| 同步状态 | GET | /org/sync/status |
获取同步状态 |
| 解析成员ID | POST | /org/members/resolve |
根据信息解析成员 |
请求公共规则
请求头:
Authorization: Bearer <auth_token>(当auth_token非空时)X-Custom-Config: <base64(config-json)>(完整配置的Base64编码)extra_headers中的所有键值对
查询参数拼装规则:
- 布尔值:仅当
true时追加 - 整数值:仅当
> 0时追加 - 字符串:trim后非空才追加
- 切片:逗号拼接
- 默认追加
enterprise_id
响应格式(两种):
方式一:直接返回
{ ...OrgNode... }
方式二:包装结构
{
"code": 0,
"message": "ok",
"data": { ... }
}
健康检查示例
请求:
GET /org/health
响应:
{
"enterprise_id": "ent-xxx",
"provider": "custom",
"status": "healthy",
"message": "",
"last_synced_at": "2024-01-01T00:00:00Z",
"cache_refreshed_at": "2024-01-01T00:00:00Z"
}
搜索示例
请求:
GET /org/search?type=user&keyword=zhangsan&fuzzy=true&limit=10
响应:
{
"users": [ ...OrgMember... ],
"next_offset": 10,
"next_token": "xxx",
"total": 100,
"exhausted": false
}
5.4 关联规则
支持三种用户匹配方式:
- 用户ID匹配
- 邮箱匹配
- 手机号匹配
第六章:腾讯云控制台与API鉴权机制
6.1 腾讯云API通用鉴权方式
腾讯云API支持多种鉴权方式,Buddy产品主要涉及:
| 鉴权方式 | 适用场景 | 说明 |
|---|---|---|
| API Key | 第三方服务集成 | 简单直接,适合服务端调用 |
| Bearer Token | CodeBuddy开放平台 | 标准OAuth2方式 |
| 腾讯云CAM | 腾讯云控制台操作 | 基于角色的访问控制 |
| Token Plan | CodeBuddy模型调用 | 按用量计费的鉴权方式 |
6.2 Bearer Token 鉴权流程
1. 获取 auth_token
↓
2. 在请求头添加 Authorization: Bearer <auth_token>
↓
3. 服务端验证Token有效性
↓
4. 返回授权资源
6.3 腾讯云CAM鉴权(扩展知识)
CAM(Cloud Access Management)是腾讯云的访问管理服务:
| 概念 | 说明 |
|---|---|
| 主账号 | 腾讯云注册账号,拥有所有权限 |
| 子账号 | 主账号创建,可分配特定权限 |
| 角色 | 虚拟身份,可被策略绑定 |
| 策略 | 权限规则定义(允许/拒绝+资源+操作) |
面试要点:CAM鉴权遵循默认拒绝原则——除非显式允许,否则一律拒绝。
6.4 CodeBuddy专享版鉴权架构
专享版/企业版支持自定义组织架构服务对接,鉴权链路:
用户请求 → CodeBuddy网关 → Bearer Token验证 → 自定义组织服务 → 返回用户/组织信息
配置字段中的关键安全参数:
auth_token:鉴权密钥auth_header:自定义鉴权头名称bearer_token:是否使用标准Bearer方式extra_headers:附加安全头
第三篇:Skill系统完全指南
第七章:Skill基础概念与分类
7.1 什么是Skill?
Skill是WorkBuddy的能力扩展单元,让AI能够完成特定类型的任务。可以理解为"给AI装上的工具"。
核心类比:
- Skill = 能力(让AI能做某件事)
- 专家 = 能力 + 经验(懂某个领域的AI角色)
- 专家团 = 多位专家 + 协作流程(自动拆解、并行执行、完整交付)
7.2 Skill分类体系
按存储位置分类
| 类型 | 存储路径 | 作用范围 | 说明 |
|---|---|---|---|
| User-level Skill | ~/.workbuddy/skills/ |
跨项目,个人全局 | 个人技能,所有项目可用 |
| Project-level Skill | {workspace}/.workbuddy/skills/ |
项目内共享 | 项目特定技能,团队成员共享 |
面试要点:安装Skill时默认安装到user-level,除非用户明确要求project-level。
按来源分类
| 来源 | 说明 | 安全等级 |
|---|---|---|
| 内置技能市场 | 官方审核的技能 | 🟢 安全 |
| OpenClaw社区 | 社区贡献的技能 | 🟡 需审查 |
| 上传技能包 | 本地技能包导入 | 🟡 需审查 |
| 自然语言创建 | AI自动生成技能 | 🟢 相对安全 |
| 自定义开发 | 用户手动编写SKILL.md | 🟢 可控 |
7.3 Skill vs 专家 vs 专家团 vs 探索
这是面试高频对比题:
| 维度 | Skill | 专家 | 专家团 | 探索 |
|---|---|---|---|---|
| 本质 | 工具能力 | AI顾问 | AI协作团队 | 成果模板 |
| 解决的问题 | AI能做什么 | 谁能帮我做 | 多角色怎么配合 | 做出了什么 |
| 适用场景 | 需要特定工具功能 | 单一领域问题 | 复杂多维度任务 | 不知道从何开始 |
| 积分消耗 | 低 | 中 | 高(数倍于单专家) | 依案例而定 |
| 能力层级 | 能力 | 能力+经验 | 多专家+协作 | 最佳实践 |
7.4 零成本Skill Top 10
| 排名 | Skill名称 | 功能 | 典型用例 |
|---|---|---|---|
| 1 | Agent Browser | 浏览器代理 | 网页自动化操作 |
| 2 | 办公文档四件套 | 文档处理 | Word/Excel/PPT/PDF生成 |
| 3 | Local Whisper | 本地语音识别 | 语音转文字 |
| 4 | yt-dlp-downloader | 视频下载 | YouTube等视频下载 |
| 5 | Web Search | 网络搜索 | 联网搜索信息 |
| 6 | Obsidian | 笔记管理 | Obsidian笔记集成 |
| 7 | Skill Scanner | 技能扫描 | 安全审查技能 |
| 8 | self-improvement | 自我提升 | 从错误中学习 |
| 9 | Find Skills | 技能查找 | 搜索发现新技能 |
| 10 | Frontend Design | 前端设计 | 网页UI设计 |
第八章:Skill生命周期管理
8.1 完整生命周期
发现 → 安装 → 启用 → 使用 → 禁用/卸载
↑ │
└──────── 更新/重新安装 ←───────┘
8.2 安装方式详解
方式一:技能市场安装
- 进入左侧边栏"技能"
- 浏览推荐技能或搜索
- 点击安装
方式二:查找技能
- 选择"查找技能"
- 输入任务描述
- WorkBuddy自动查找相关技能
方式三:创建技能
- 选择"创建技能"
- 输入任务描述
- WorkBuddy自动创建相关技能
方式四:上传技能
- 选择"上传技能"
- 拖拽或点击选择文件
- 选中本地技能包
- 系统自动完成配置
方式五:find-skills技能搜索
当现有技能不满足需求时:
- 调用 find-skills 技能
- 搜索社区可用技能
- 安装匹配的技能
8.3 Skill管理操作
| 操作 | 说明 | 注意事项 |
|---|---|---|
| 启用 | 已安装技能可随时启用 | 建议仅启用当前任务所需技能 |
| 关闭 | 无需卸载即可禁用 | 关闭后不会被对话调用 |
| 搜索 | 通过关键词快速定位 | 适用于技能数量较多场景 |
| 卸载 | 单个或批量卸载 | 完全移除技能 |
| 更新 | 通过重新安装更新 | 部分技能支持自动更新 |
面试要点:建议仅启用当前任务所需的技能,减少无关干扰并降低误调用概率。
8.4 Skill安全审查机制
安装新技能时的安全审查流程:
- 自动检测:上传Skill后系统自动进行安全检测
- 风险分级:
- 🟢 非高风险:自动继续安装(简洁模式开启时)
- 🔴 高风险:始终需要手动确认
- 安全扫描:使用Skill Scanner技能进行安全审查
- 人工确认:高风险操作必须用户明确确认
8.5 Skill页面结构
| 区域 | 内容 | 功能 |
|---|---|---|
| 上半部分 | 已安装的本地技能 | 可直接在对话中调用 |
| 下半部分 | 推荐技能 | 可按需一键安装 |
第九章:Skill开发与SKILL.md规范
9.1 SKILL.md文件格式
每个Skill的核心是 SKILL.md 文件,定义了技能的全部行为。
Frontmatter字段
---
name: skill-name # 技能名称
description: 技能描述 # 简短描述
trigger: 触发条件 # 何时触发此技能
allowed-tools: # 允许使用的工具
- Read
- Write
- Bash
agent_created: true # 是否由Agent创建
---
关键frontmatter字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
name |
string | 是 | 技能唯一标识名 |
description |
string | 是 | 技能功能简述 |
trigger |
string | 否 | 触发条件描述 |
allowed-tools |
list | 否 | 允许使用的工具列表 |
agent_created |
boolean | 否 | 是否由Agent创建(影响可编辑性) |
9.2 Skill目录结构
~/.workbuddy/skills/
└── my-skill/
├── SKILL.md # 技能定义文件(必需)
├── scripts/ # 辅助脚本(可选)
├── references/ # 参考文档(可选)
└── assets/ # 静态资源(可选)
9.3 Skill开发最佳实践
| 原则 | 说明 |
|---|---|
| 单一职责 | 每个Skill专注一个明确的任务 |
| 明确的触发词 | 在description中包含关键词,便于匹配 |
| 工具最小化 | 只声明必要的allowed-tools |
| 文档完备 | SKILL.md中包含完整的使用说明 |
| 错误处理 | 脚本中包含异常处理逻辑 |
| 幂等性 | 重复执行结果一致 |
9.4 Agent创建的Skill管理
重要规则:只有 agent_created: true 的Skill才能通过SkillManage工具修改或删除。
验证方式:
- 检查SKILL.md的frontmatter中
agent_created: true - 检查
agent-created-skills.json注册表
第十章:MCP协议与连接器系统
10.1 MCP协议概述
MCP(Model Context Protocol) 是一种标准化协议,用于将外部服务的能力引入AI工作流,实现数据互通与能力扩展。
核心价值:无需手动切换工具即可完成跨平台操作。
10.2 连接器类型与应用场景
| 场景 | 说明 | 示例 |
|---|---|---|
| 数据查询 | 从外部数据源获取信息 | 查询数据库、检索文档 |
| 服务调用 | 调用第三方API完成操作 | 发送邮件、创建日程 |
| 文件管理 | 访问云端存储与文件系统 | 读取网盘文件、上传附件 |
| 消息通知 | 与即时通讯工具集成 | 发送企业微信/飞书消息 |
10.3 内置连接器(5个)
| 连接器 | 功能 | 认证方式 |
|---|---|---|
| QQ邮箱 | 收发/搜索/整理邮件 | QQ邮箱App扫码授权 |
| 腾讯乐享 | 搜索/创建/管理知识库文档 | 微信/手机号/企业微信登录 |
| 腾讯文档 | 文档管理与协作 | 微信/QQ扫码登录 |
| TAPD | 项目管理与追踪 | 账号授权 |
| 微云 | 云端存储与文件管理 | 账号授权 |
10.4 QQ邮箱连接器配置流程
步骤1:点击添加 → 找到QQ邮箱卡片,点击+按钮
↓
步骤2:扫码授权 → 使用QQ邮箱App(7.1.5+/鸿蒙0.2.9+)扫码
↓
步骤3:确认权限 → 账号信息+读取邮件+发送邮件+删除邮件(可选)
↓
步骤4:授权成功 → 手机端显示"授权成功"
↓
步骤5:连接完成 → 卡片名称旁出现绿色圆点
授权权限详情:
- 账号信息:获取邮箱账号基础信息
- 读取邮件:读取收件箱内近一个月的邮件
- 发送邮件:代为发送邮件
- 删除邮件(可选):已删除邮件移入"已删除"文件夹
10.5 腾讯乐享连接器配置流程
步骤1:点击添加
↓
步骤2:登录乐享知识库(微信/手机号/企业微信)
↓
步骤3:确认授权 → WorkBuddy可搜索/查询/创建/管理知识库内容
↓
步骤4:授权成功 → "Authentication Successful"
↓
步骤5:连接完成 → 绿色圆点+启用/禁用开关
10.6 自定义连接器配置
- 点击连接器管理页面右上角的"自定义连接器"按钮
- 按照引导配置自定义的MCP连接器
- 配置方式与MCP配置类似
10.7 MCP配置文件
MCP服务器配置存储在 ~/.workbuddy/mcp.json:
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["@playwright/mcp@latest"],
"env": {}
}
}
}
配置原则:
- 新增服务器时,合并到
mcpServers,不要覆盖其他服务器 - 按照提供商官方文档填写
command、args、env - 凭证信息写在
env字段中
10.8 连接器断开流程
步骤1:点击开关 → 在已连接的连接器卡片上点击启用/禁用开关
↓
步骤2:确认断开 → 弹窗"确定要断开连接器吗?"→ 点击"断开"
↓
步骤3:断开完成 → 提示"连接器已断开",恢复未连接状态
10.9 安全注意事项
- ✅ 连接器需要相应服务的访问权限,确保授权信息正确
- ✅ 授权后可随时通过开关禁用或断开连接器
- ✅ 撤销QQ邮箱授权:QQ邮箱App → 设置 → 账号 → 安全管理 → 应用授权
- ✅ 建议定期检查连接器状态
第四篇:售后技能与退款流程
第十一章:Buddy产品定价与计费体系
11.1 定价方案总览(2026年5月15日起执行)
| 版本 | 月付 | 年付 | 最低购买 | Credits/月 |
|---|---|---|---|---|
| 个人体验版 | 免费 | - | - | 500 |
| 个人专业版 | 58元/人/月 | 696元/人/年 | - | 2,000 |
| SaaS企业版(旗舰版) | 198元/人/月 | 2,376元/人/年 | 1坐席起 | 2,000/人 |
| 专有云企业版(专享版) | 316元/人/月 | 3,792元/人/年 | 100坐席起 | 2,000/人 |
面试关键数字:58、198、316 — 个人版/旗舰版/专享版月价
11.2 各版本权益对比
| 权益 | 个人体验版 | 个人专业版 | SaaS企业版 | 专有云企业版 |
|---|---|---|---|---|
| Credits/月 | 500 | 2,000 | 2,000/人 | 2,000/人 |
| Credits共享 | ❌ | ❌ | ✅ 团队内共享 | ✅ 团队内共享 |
| 对话问答频限 | 有限制 | 不限频 | 不限频 | 不限频 |
| 坐席起购 | - | - | 1个 | 100个 |
11.3 Credits系统详解
Credits是什么?
Credits是CodeBuddy采用的基于资源配额的管理机制,用于:
- 合理调配高级大语言模型的计算资源
- 衡量AI任务执行过程中的资源消耗量
- 在WorkBuddy中管理所有对话相关请求的成本
Credits消耗因素
| 因素 | 说明 |
|---|---|
| 模型Token定价 | 不同模型消耗Credits不同;高级模型推理能力更强但单价更高 |
| 任务复杂度 | 简单任务(短问答)消耗少;复杂任务(长代码分析、多轮对话、知识库检索)消耗多 |
Credits扣减优先级
个人版用户:
- 个人体验版 Credits 额度(优先使用)
- 最先到期的 Credits(包括个人专业版、个人加量包等)
SaaS企业版/专有云企业版:
- 最先到期的 Credits(优先使用)
- 包括月固定用量、企业加量包等各类资源包
11.4 加量包方案
个人加量包(仅个人专业版)
| 有效期 | 规格 | 价格 |
|---|---|---|
| 1个月 | 1,000 Credits | 38元 |
企业加量包(旗舰版、专享版)
| 有效期 | 规格 | 价格 |
|---|---|---|
| 6个月 | 2,000 Credits | 100元 |
| 6个月 | 5,000 Credits | 245元 |
| 6个月 | 10,000 Credits | 480元 |
| 6个月 | 50,000 Credits | 2,375元 |
| 6个月 | 200,000 Credits | 9,200元 |
11.5 企业版优惠政策
2026年5月15日-8月14日期间购买SaaS企业版,首月每个付费license额外赠送2,000 Credits。
11.6 WorkBuddy与CodeBuddy积分共享
核心规则:WorkBuddy和CodeBuddy 同一账号的积分可共享使用。
这意味着:
- 在WorkBuddy中消耗的Credits会同步扣减
- 在CodeBuddy中消耗的Credits也会同步扣减
- 两者的Credits余额是统一的
11.7 用量查看方式
| 用户类型 | 查看路径 |
|---|---|
| 个人/企业成员 | 官网 → 右上角头像 → 个人主页/用量管理 |
| 企业管理员 | 企业管理后台 → 左侧导航栏 → 用量管理/成员用量 |
可查看内容:
- 当前订阅情况
- 资源包中可用与已使用的Credits信息
- 企业成员的Credits使用情况
第十二章:退款政策与操作流程
12.1 五天无理由退款政策
这是售后中最核心的知识点,必须倒背如流。
| 规则项 | 详细说明 |
|---|---|
| 退款时限 | 购买后5天内支持无理由退还 |
| 适用范围 | 每个主体仅限首次退还操作 |
| 退款方式 | 返还至腾讯云账号余额 |
| 金额计算 | 未消耗用量→全额;存在消耗→扣除实际用量后退还 |
| 不予退还 | 购买时享有的折扣、使用的代金券 |
12.2 退款限制条件
| 限制 | 说明 |
|---|---|
| 一次性限制 | 五天无理由自助退还仅支持每个主体下的首次退还操作 |
| 异常拒绝权 | 如出现疑似异常/恶意退货,腾讯云有权拒绝退货申请 |
| 不满足条件 | 不满足五天无理由退货规则的订单不允许退款 |
| 用量扣费 | 购买后如存在用量消耗,将根据实际消耗扣除退款金额 |
12.3 两种退款方式
方式一:自助退款
步骤1:登录腾讯云控制台
↓
步骤2:进入对应的产品资源控制台
↓
步骤3:找到目标订单
↓
步骤4:提交自助退款申请
↓
步骤5:等待系统处理
方式二:工单退款
步骤1:确认是否满足退费条件
↓
步骤2:登录腾讯云官网 → 提交工单页面
↓
步骤3:选择需要退款的产品分类
↓
步骤4:填写退还原因和问题描述
↓
步骤5:提交工单
↓
步骤6:等待审核(2个工作日内处理)
↓
步骤7:审核通过→执行退货
↓
步骤8:查看退款结果
12.4 退款状态确认
| 查看项 | 路径 |
|---|---|
| 订单状态 | 订单管理 → 显示"已退款" |
| 退款款项 | 费用中心 |
| 审核不通过 | 工单中查看审核结果 |
12.5 特殊退款场景处理
| 场景 | 处理方式 |
|---|---|
| 用户要求退款但超过5天 | 需提交工单,由客服评估是否可退 |
| 已消耗部分Credits | 按实际消耗扣除后退还剩余金额 |
| 使用了代金券购买 | 代金券部分不予退还 |
| 享受折扣购买 | 折扣部分不予退还 |
| 推广奖励渠道订单 | 不支持自助退款,需提交工单 |
12.6 退款金额计算示例
示例1:个人专业版月付退款
- 购买价格:58元
- 已消耗Credits:500(月总量2000的25%)
- 退款金额:58 × (2000-500)/2000 = 43.5元
示例2:企业加量包退款
- 购买价格:480元(10,000 Credits)
- 已消耗Credits:2,000
- 退款金额:480 × (10000-2000)/10000 = 384元
示例3:使用代金券购买
- 购买价格:58元(其中代金券抵扣20元,实际支付38元)
- 退款金额:38元(代金券部分不退)
第十三章:售后工单与常见问题处理
13.1 1.5线售后定位
1.5线是用户与产品之间的桥梁,职责包括:
- 用户问题初步诊断与分类
- 常见问题的快速解决
- 复杂问题的升级与转交
- 退款/计费等售后流程处理
- 产品使用指导与最佳实践推荐
13.2 售后问题分类与处理矩阵
| 问题类别 | 占比(估) | 处理方式 | 升级条件 |
|---|---|---|---|
| 使用指导 | 30% | 直接解答/引导文档 | 用户反复无法理解 |
| 计费/退款 | 25% | 按退款流程处理 | 超出政策范围 |
| 功能异常/故障 | 20% | 排查+切换模型/重连 | 确认为产品Bug |
| 平台接入 | 10% | 引导对应平台文档 | 配置后仍无法连接 |
| 安装/登录 | 10% | 按FAQ处理 | 疑似系统兼容性问题 |
| 其他 | 5% | 评估后处理 | 无法确定归属 |
13.3 常见售后场景话术
场景1:用户要求退款
客服话术模板:
"您好,关于退款事宜,我们的政策是购买后5天内支持无理由退款。
请问您是哪天购买的?我先帮您确认是否在退款时限内。
另外,您的账号是否有使用过Credits?如果有消耗,退款金额会扣除已使用部分。"
处理流程:
- 确认购买日期(是否在5天内)
- 确认是否首次退款
- 查看Credits消耗情况
- 引导自助退款或提交工单
- 告知退款到账时间
场景2:用户反馈Credits消耗过快
客服话术模板:
"您好,Credits的消耗与任务复杂度和所选模型有关。
复杂任务(如长文档分析、多轮对话)消耗较多,简单问答消耗较少。
建议您:1)在简单任务中选择性价比更高的模型;2)将复杂任务拆分为小步骤执行。
您可以在官网个人主页查看详细的用量信息。"
场景3:用户反馈无法登录
客服话术模板:
"您好,登录问题通常有以下几种原因:
1)未设置默认浏览器(Windows)— 请将Chrome设为默认浏览器
2)账号权限问题 — 请检查WorkBuddy账号文件夹的读写权限
3)网络问题 — 请确认网络连接正常
请问您遇到的具体情况是哪种?"
场景4:用户反馈功能不工作
客服话术模板:
"您好,建议您尝试以下排查步骤:
1)切换模型后重新测试
2)检查相关Skill是否已启用
3)检查连接器是否已连接(绿色圆点表示已连接)
4)如仍无法解决,请提供错误码和截图,我们进一步排查。"
13.4 常见错误码速查表
| 错误码 | 分类 | 原因 | 处理方式 |
|---|---|---|---|
| 14003 | 模型侧 | 模型状态异常 | 切换模型重试 |
| 11133 | 模型侧 | 模型状态异常 | 切换模型重试 |
| 1001 | 模型侧 | 模型状态异常 | 切换模型重试 |
| 3002 | 网络侧 | 网络环境问题 | 检查网络/联系IT |
| 3003 | 网络侧 | 网络环境问题 | 检查网络/联系IT |
| 400 | 网络侧 | 请求错误 | 检查网络 |
| 401 | 网络侧 | 认证失败 | 重新登录 |
| 504 | 网络侧 | 网关超时 | 检查网络 |
| 6003 | 频率限制 | 请求频率受限 | 切换模型/稍后重试 |
错误码分类原则:
- 14003/11133/1001 → 模型问题 → 切换模型
- 3002/3003/400/401/504 → 网络问题 → 检查网络
- 6003 → 频率限制 → 切换模型/等待
13.5 工单处理流程
用户提交问题
↓
1.5线初步诊断
↓
├── 常见问题 → 直接解决 → 关闭工单
├── 退款/计费 → 按退款流程处理 → 跟进退款状态
├── 功能Bug → 收集信息 → 升级至2线/研发
└── 无法判断 → 收集详细信息 → 升级处理
1.5线必须收集的信息:
- 错误码(如有)
- 报错截图
- 系统版本(Windows/Mac,具体版本号)
- 网络环境(公司网络/家庭网络)
- 发生时间
- 复现步骤
13.6 联系方式
| 渠道 | 用途 |
|---|---|
| 邮箱 codebuddy@tencent.com | 技术问题反馈 |
| 腾讯云工单 | 退款/计费问题 |
| 产品内帮助与反馈 | 使用问题 |
第十四章:发票与账单管理
14.1 账单查看方式
| 用户类型 | 查看路径 |
|---|---|
| 个人版 | 官网 → 右上角头像 → 个人主页/账单与发票 |
| SaaS企业版 | 企业管理后台 → 左侧导航栏 → 订单管理 |
| 专有云企业版 | 企业管理后台 → 左侧导航栏 → 订单管理 |
14.2 发票申请流程
个人版发票
步骤1:登录WorkBuddy官网 → 个人主页
↓
步骤2:左侧导航栏 → 账单与发票
↓
步骤3:点击"查看发票"
↓
步骤4:前往腾讯云控制台发票管理页面
↓
步骤5:申请开票
企业版发票
步骤1:登录WorkBuddy企业管理后台
↓
步骤2:左侧导航栏 → 订单管理
↓
步骤3:点击"发票管理"
↓
步骤4:前往腾讯云控制台查看发票
↓
步骤5:需使用企业绑定的腾讯云UIN登录
重要提示:企业版用户必须使用企业绑定的腾讯云UIN登录腾讯云控制台。
14.3 发票相关常见问题
| 问题 | 回答 |
|---|---|
| 开什么类型的发票? | 通过腾讯云控制台开票,支持增值税普通发票和专用发票 |
| 发票多久能开出来? | 按腾讯云发票流程,通常3-5个工作日 |
| 可以合并开票吗? | 可以,在腾讯云控制台选择多个订单合并开票 |
| 发票信息填错了怎么办? | 联系腾讯云客服修改 |
14.4 数据管理功能
| 功能 | 入口 | 操作 |
|---|---|---|
| 我分享的文件 | 头像→设置→数据管理 | 复制链接/下载/取消分享 |
| 已归档任务 | 头像→设置→数据管理 | 删除/取消归档 |
第五篇:文档产品功能详解
第十五章:WorkBuddy核心功能模块
15.1 任务创建与上下文
添加上下文的四种方式
| 方式 | 操作 | 说明 |
|---|---|---|
| 引用上下文 | 通过@引用 |
引用文件、文档、规则等信息 |
| 粘贴截图 | Ctrl/Cmd+V | 直接粘贴剪贴板中的图片 |
| 上传文件 | 上传按钮/拖拽 | 上传文件到任务上下文 |
| 补充说明 | 在描述中明确 | 目标、范围、约束、预期输出 |
建议补充的信息
| 信息类型 | 示例 |
|---|---|
| 目标 | 要生成什么内容 |
| 输入 | 需要分析的数据 |
| 输出格式 | Word/Excel/PPT |
| 约束条件 | 风格要求、字数限制 |
15.2 任务管理
- 每个对话对应一个独立任务
- 任务之间互不影响
- 支持多任务并行处理
- 执行中的任务显示在左侧边栏
- 任务可归档管理
15.3 结果查看(右侧边栏)
| 标签页 | 功能 | 操作 |
|---|---|---|
| 产物 | 新生成的文件 | 点击预览、打开文件位置 |
| 全部文件 | 树状结构展示工作目录 | 浏览和管理文件 |
| 变更 | AI对文件的修改 | 差异对比查看 |
| 预览 | 预览开发中的网页 | 内置浏览器预览 |
15.4 系统设置
| 设置项 | 说明 |
|---|---|
| 语言 | 中文(简体)/English |
| 字体大小 | 可调整 |
| 简洁模式 | 默认开启,隐藏装饰性元素,折叠工具调用信息 |
| 非高风险自动安装 | 非高风险Skill自动安装 |
| 防休眠 | 开启后电脑不休眠,便于远程控制和自动化 |
15.5 资料库(知识库)
核心工作流
搜索文件 → 添加到任务 → AI处理加工 → 产物存回资料库
支持的文件格式
| 类型 | 格式 |
|---|---|
| 在线文档 | 腾讯文档原生格式 |
| 本地文件 | Word、Excel、PPT、PDF |
配置流程
步骤1:左侧边栏 → 资料库 → 选择腾讯文档
↓
步骤2:点击"立即前往授权"
↓
步骤3:微信/QQ扫码登录
↓
步骤4:授权完成 → 可搜索/引用/存回文档
两种搜索方式
- 语义搜索:在任务中用自然语言描述需要的文档
- 关键词搜索:在资料库搜索框输入关键词(支持搜索标题/所有者)
15.6 探索功能
与其他功能的区别
| 模块 | 角色 | 回答的问题 |
|---|---|---|
| Skill | 能力 | 能做什么 |
| 专家 | 能力 | 谁能帮我做 |
| 探索 | 成果 | 做出了什么 |
四步使用流程
步骤1:打开探索 → 浏览精选案例
↓
步骤2:选择案例 → 查看预览和工具集
↓
步骤3:点击"制作我的版本" → 自动预填Prompt+加载Skill和专家
↓
步骤4:查看成果 → 右侧产物页面
探索的价值:
- 一键复刻:自动预填Prompt和加载配置
- 成本优化:精调案例上下文,减少冗余消耗
- 社区智慧:复用高手经验
第十六章:专家中心与专家团
16.1 专家与专家团概念
专家(Expert)
- 拥有独立的人设、方法论和工具链
- 针对所在领域的典型工作场景深度打磨
- 召唤谁,就像真的请到了那个岗位的资深从业者
专家团(Expert Team)
- 多Agent协作团队
- 具有团长、分工、协作机制
- 工作流程:自动拆解任务→分配给最合适的团员→并行执行→整合交付
16.2 使用流程
步骤1:左侧边栏 → 专家
↓
步骤2:浏览专家/专家团 → 查看能力介绍、擅长领域、任务示例
↓
步骤3:点击召唤按钮 → 进入对话界面
↓
步骤4:描述任务
├── 专家模式:按该角色的专业视角和方法完成
└── 专家团模式:团长自动拆解、分配、执行、返回结果
16.3 积分消耗注意
| 类型 | 消耗水平 | 说明 |
|---|---|---|
| 单个专家 | 中等 | 正常消耗 |
| 专家团 | 高(数倍) | 可能调用多位专家协同执行 |
面试要点:使用专家团前需确保账户积分充足。
16.4 专家卡片信息
专家卡片:
- 能力介绍
- 擅长领域
- 任务示例
专家团卡片:
- 能力介绍
- 擅长领域
- 团队成员
- 任务示例
16.5 重要提醒
- 专家团收集和整理信息,AI生成内容仅供参考
- 无法替代专业判断
- 不构成决策和投资建议
第十七章:自动化与Claw远程控制
17.1 自动化功能
适用场景
- 每日简报
- 周报汇总
- 定时数据整理
创建自动化任务
| 配置项 | 说明 |
|---|---|
| 名称 | 区分不同自动化任务 |
| 工作空间 | 默认 automation-claw-xxxx |
| 提示词 | 描述任务目标和输出要求 |
| 选择模型和技能 | 指定执行任务的模型和技能 |
| 定时规则 | 执行频率和生效日期区间 |
| 推送到小程序 | 开启后结果同步到WorkBuddy小程序 |
任务模板
提供现成模板覆盖常见场景:
- 新闻推送
- 周报生成
- 体检预约
- 学习计划
推送到小程序
- 开启后,任务执行完成自动将结果发送至WorkBuddy小程序
- 通过安全链路同步数据到云端
- 便于第一时间查看执行结果
17.2 Claw远程控制
核心原理
手机发送消息 → 电脑WorkBuddy自动执行 → 结果回复到手机
使用场景
| 场景 | 说明 |
|---|---|
| 出门在外 | 用手机让电脑处理文件 |
| 会议中 | 快速生成会议纪要 |
| 通勤路上 | 提前准备工作材料 |
| 临时需求 | 随时随地发送任务 |
前置条件
- 电脑需要保持开机并运行WorkBuddy
- 确保网络连接正常
- 需要完成平台接入配置
17.3 微信ClawBot接入(推荐方式)
微信ClawBot是最便捷的远程控制方式,支持直接扫码绑定。
第十八章:记忆系统与数据管理
18.1 记忆功能概述
记忆功能让WorkBuddy记住用户的偏好和习惯,对话越多,系统越了解用户。
18.2 生成对话记忆
- 状态:默认开启
- 功能:从对话中提取并记住相关上下文
- 用途:在未来对话中提供更好的个性化服务
- 隐私保护:遵循WorkBuddy隐私政策,仅用户本人可见
18.3 记忆管理
| 操作 | 说明 |
|---|---|
| 查看记忆 | 点击已生成的记忆查看内容 |
| 编辑记忆 | 支持编辑记忆内容 |
| 告诉AI记住/忘记 | 通过对话方式管理 |
| 自动重生成 | 记忆摘要每晚自动重新生成 |
18.4 导入记忆
支持从其他AI产品同步使用习惯:
步骤1:点击"开始导入"
↓
步骤2:复制示例提示词到其他AI产品
↓
步骤3:将结果粘贴回来
↓
步骤4:点击"添加到记忆"完成导入
18.5 工作记忆文件(内部机制)
WorkBuddy使用工作记忆文件实现跨会话持久化:
| 文件 | 用途 | 位置 |
|---|---|---|
MEMORY.md |
长期记忆 | .workbuddy/memory/ |
YYYY-MM-DD.md |
每日日志 | .workbuddy/memory/ |
SOUL.md |
AI身份定义 | .workbuddy/ |
IDENTITY.md |
AI身份记录 | .workbuddy/ |
USER.md |
用户信息 | .workbuddy/ |
18.6 Bootstrap机制
首次对话时的初始化流程:
读取BOOTSTRAP.md → 了解初始化要求
↓
与用户对话 → 确定AI名称/性格/用户信息
↓
更新SOUL.md/IDENTITY.md/USER.md
↓
删除BOOTSTRAP.md → 初始化完成
第六篇:面试实战模拟
第十九章:高频面试题与标准答案
19.1 产品认知类
Q1:请简要介绍WorkBuddy是什么?
标准答案: WorkBuddy是腾讯推出的全场景职场AI智能体桌面工作台。它的核心特点是三个"能":能用自然语言下达任务、能自主规划并执行复杂任务、能实际操作本地文件。它不是简单的对话AI,而是执行型Agent,支持多任务并行、远程控制、自动化定时任务等功能。
Q2:WorkBuddy和CodeBuddy有什么区别?
标准答案: 核心区别在定位:CodeBuddy专注写代码,WorkBuddy专注干杂活。
具体来说:
- 定位:WorkBuddy是AI办公桌面Agent,CodeBuddy是AI编程工具
- 用户群:WorkBuddy面向职场人士,CodeBuddy面向开发者
- 运行环境:WorkBuddy是桌面客户端,CodeBuddy支持IDE插件和CLI
- 核心功能:WorkBuddy擅长文件处理和任务自动化,CodeBuddy擅长代码编写和项目开发
- 模型选择:WorkBuddy支持多模型切换,CodeBuddy主要使用腾讯自研模型
但两者共享同一套账号和Credits体系,积分互通使用。
Q3:CodeBuddy有哪三种产品形态?
标准答案:
- CodeBuddy IDE:独立IDE环境,面向产品经理、设计师、全栈开发者,支持"对话即编程"
- CodeBuddy Plugin:VS Code/JetBrains插件,面向日常编码开发者,即插即用
- CodeBuddy Code (CLI):命令行工具,面向DevOps和高级开发者,支持Shell/File/Network操作
Q4:WorkBuddy的三种工作模式是什么?
标准答案:
- Ask(问一问):仅问答,不修改文件,适合了解内容和确认需求
- Craft(做一做):直接执行并修改文件,适合文档生成和文件处理
- Plan(想一想):先生成计划,确认后再操作,适合多步骤复杂任务
建议首次使用选Ask模式,处理重要文件前先备份。
19.2 技术深度类
Q5:Credits系统是怎么工作的?
标准答案: Credits是基于资源配额的管理机制,用于衡量AI任务的资源消耗。消耗量取决于两个因素:模型Token定价(高级模型单价更高)和任务复杂度(简单问答消耗少,复杂分析消耗多)。
扣减优先级:个人版先消耗体验版额度,再按到期时间消耗;企业版统一按到期时间消耗。WorkBuddy和CodeBuddy同账号积分共享。
Q6:如何配置自定义模型?
标准答案: WorkBuddy支持四种模型接入方式:
- 提供商接入:从列表选择,补全API Key
- Token Plan:腾讯云按用量计费鉴权
- Coding Plan:AI编码专属订阅套餐
- 自定义API/Ollama:手动填写或本地部署
配置文件兼容 ~/.codebuddy/models.json。
Q7:MCP协议是什么?WorkBuddy如何使用?
标准答案: MCP(Model Context Protocol)是标准化协议,将外部服务能力引入AI工作流。WorkBuddy通过连接器实现MCP集成,当前支持5个内置连接器:QQ邮箱、腾讯乐享、腾讯文档、TAPD、微云。也支持自定义连接器配置。
MCP配置存储在 ~/.workbuddy/mcp.json,新增服务器时合并到mcpServers中。
Q8:Skill的安全审查机制是怎样的?
标准答案: 安装新Skill时,系统自动进行安全检测并分级:
- 非高风险:在简洁模式开启时自动继续安装
- 高风险:始终需要手动确认
另外,可以使用Skill Scanner技能进行更深入的安全审查。安装来自社区或第三方的技能时,建议先进行安全扫描。
19.3 售后流程类
Q9:用户要求退款,你怎么处理?
标准答案: 首先确认三个关键信息:购买日期、是否首次退款、Credits消耗情况。
如果购买在5天内且是首次退款,引导用户自助退款或提交工单。退款金额会扣除已消耗的Credits对应金额,代金券和折扣部分不退。
如果超过5天或非首次退款,需提交工单由客服评估。异常/恶意退货申请腾讯云有权拒绝。
Q10:用户反馈Credits消耗过快,怎么处理?
标准答案: 首先解释Credits消耗的两个因素:模型定价和任务复杂度。然后给出具体建议:
- 简单任务选择性价比更高的模型(如DeepSeek-V3.2)
- 复杂任务拆分为小步骤执行
- 避免不必要的多轮对话
- 引导用户在官网查看用量详情
- 如需更多Credits,可购买加量包
Q11:用户遇到错误码14003/11133/1001,怎么处理?
标准答案: 这些错误码属于模型侧状态异常。处理步骤:
- 建议用户切换模型后重试
- 如果切换模型后仍不行,记录错误码和发生时间
- 检查是否有模型服务公告
- 如持续出现,收集详细信息升级处理
Q12:用户反馈登录一直卡住,怎么排查?
标准答案: 登录卡住通常有两个原因:
- 未设置默认浏览器(Windows):引导用户将Chrome设为默认浏览器,或复制链接手动打开
- 账号权限问题:引导用户检查WorkBuddy账号文件夹的读写权限,Mac用chmod授权,Windows用PowerShell授权
如果以上都不行,检查网络环境,确认不是公司网络限制。
19.4 功能指导类
Q13:用户想创建一个自动化任务,怎么指导?
标准答案:
- 打开自动化页面
- 点击右上角"添加"
- 填写配置:
- 名称:描述性名称
- 工作空间:默认或指定
- 提示词:清晰描述任务目标
- 选择模型和技能
- 定时规则:设置执行频率和有效期
- 推送到小程序:按需开启
- 可以使用现成任务模板快速开始
Q14:用户想通过微信远程控制电脑,怎么配置?
标准答案: 推荐使用微信ClawBot方式:
- 打开WorkBuddy → Claw设置
- 选择微信ClawBot接入
- 用微信扫描绑定二维码
- 绑定成功后,在微信中发消息即可远程控制
注意事项:电脑需保持开机运行WorkBuddy,网络需正常。
Q15:Skill、专家、专家团该怎么选?
标准答案:
- 需要特定工具功能 → 选Skill(如文档处理、搜索)
- 有单一领域问题 → 选专家(获得专业视角和经验)
- 任务复杂需要多角色配合 → 选专家团(自动拆解、并行执行)
注意专家团积分消耗是单专家的数倍,使用前确认积分充足。
19.5 产品对比类
Q16:个人专业版和企业版有什么区别?
标准答案:
| 维度 | 个人专业版 | SaaS企业版 |
|---|---|---|
| 价格 | 58元/月 | 198元/月 |
| Credits | 2,000/月 | 2,000/人/月 |
| Credits共享 | 不支持 | 团队内共享 |
| 起购 | 无限制 | 1坐席起 |
| 加量包 | 个人加量包 | 企业加量包 |
企业版核心优势是团队Credits共享,适合多人协作场景。
Q17:WorkBuddy支持的模型各有什么特点?
标准答案:
- Hy3 preview/Hunyuan-2.0-Thinking:推理能力强,适合复杂推理
- GLM-5.0-Turbo:Agent场景优化
- GLM-5v-Turbo:原生多模态
- MiniMax-M2.5:Excel/PPT专长
- Kimi-K2.5/K2.6:视觉类任务
- DeepSeek-V3.2:性价比高
- Auto:自动选择,平衡效果与速度
第二十章:场景模拟与实操演练
20.1 场景1:企业客户批量退款
情景:某企业客户购买了10个SaaS企业版坐席,使用1个月后要求退款。
处理步骤:
- 确认购买日期 — 已超过5天无理由退款期
- 确认是否首次退款 — 如果是首次,可走工单退款
- 计算退款金额 — 需扣除已消耗的Credits对应金额
- 引导提交工单 — 登录腾讯云官网 → 提交工单
- 预估退款金额 — 198×10=1980元,扣除已消耗部分
- 告知处理周期 — 2个工作日内审核
面试要点:超过5天不是不能退,而是需要走工单评估。
20.2 场景2:用户反馈Claw无法连接
情景:用户配置了企业微信Claw,但发消息后没有响应。
排查步骤:
- 确认连接状态 — 连接器是否显示绿色圆点
- 确认电脑状态 — 是否开机运行WorkBuddy
- 确认网络环境 — 公司网络还是家庭网络
- 尝试切换模型 — 优先切换模型测试
- 检查Webhook配置 — 企业微信Webhook是否配置正确
- 检查域名校验 — 是否Webhook域名主体校验未通过
- 收集信息升级 — 如仍无法解决,收集平台、时间、错误码
20.3 场景3:用户不会用Skill
情景:用户想用WorkBuddy生成PPT,但不知道怎么操作。
指导步骤:
- 确认PPT生成Skill是否已安装 — 进入技能页面查看
- 如未安装 — 在技能市场搜索"PPT"相关技能并安装
- 启用PPT生成技能 — 确保技能状态为"已启用"
- 创建任务 — 选择Craft模式,描述PPT需求
- 上传参考文件 — 如有数据文件,上传到任务上下文
- 明确输出要求 — 指定PPT格式、风格、页数等
- 推荐模型 — MiniMax-M2.5适合PPT生成
20.4 场景4:Credits扣费争议
情景:用户反馈一次简单问答消耗了大量Credits。
处理步骤:
- 确认任务详情 — 问答内容、使用模型、对话轮数
- 解释Credits消耗因素 — 模型定价+任务复杂度
- 引导查看用量 — 官网个人主页查看用量详情
- 检查是否误用高级模型 — 如误用Hy3 preview做简单问答
- 给出优化建议 — 简单问答用DeepSeek-V3.2或Auto模式
- 如确为系统异常 — 收集信息升级处理
20.5 场景5:多平台接入配置
情景:企业用户需要在飞书和钉钉同时接入WorkBuddy。
指导步骤:
- 确认两个平台都需要Claw功能
- 分别配置飞书和钉钉的Webhook
- 飞书:创建飞书应用 → 配置事件订阅 → 填写Webhook地址
- 钉钉:创建钉钉机器人 → 配置Outgoing → 填写Webhook地址
- 在WorkBuddy Claw设置中分别完成两个平台的绑定
- 测试两个平台的消息收发
- 注意事项:避免重复输入同一Webhook地址
第二十一章:故障排查与应急响应
21.1 通用排查原则
第一步:确认问题现象(错误码?截图?复现步骤?)
↓
第二步:最小化验证(切换模型?重连?拆分任务?)
↓
第三步:定位问题分类(模型?网络?权限?产品Bug?)
↓
第四步:按分类处理(自助解决?引导文档?升级工单?)
↓
第五步:记录与反馈(更新FAQ?通知产品团队?)
21.2 故障分级标准
| 级别 | 定义 | 响应时间 | 示例 |
|---|---|---|---|
| P0 | 大面积服务不可用 | 立即 | 登录全量故障 |
| P1 | 核心功能异常 | 30分钟 | 某模型全部报错 |
| P2 | 部分功能异常 | 2小时 | 某平台Claw断连 |
| P3 | 体验类问题 | 24小时 | 显示异常 |
21.3 历史故障案例参考
2026年4月2日登录故障
- 现象:WorkBuddy及CodeBuddy出现登录异常
- 处理:腾讯云技术团队紧急修复,耗时2小时+
- 补偿:向受影响用户补偿1000 Credits
- 启示:故障后主动补偿Credits是标准处理方式
21.4 应急响应话术
服务故障时
"您好,目前WorkBuddy/CodeBuddy服务出现[具体问题],
我们的技术团队正在紧急修复中。
修复完成后我们会第一时间通知您。
给您带来不便,深表歉意。"
修复后补偿
"您好,[具体问题]已修复,感谢您的耐心等待。
针对此次故障给您造成的影响,我们已向您账号补偿[数量]Credits,
请您查收。如有其他问题,请随时联系我们。"
21.5 问题升级清单
以下情况需要升级至2线/研发:
- 确认为产品Bug(非用户操作问题)
- 错误码持续出现且切换模型无效
- 数据丢失或文件损坏
- 安全漏洞或权限异常
- 新功能上线后的兼容性问题
升级时必须提供:
- 问题描述和复现步骤
- 错误码和截图
- 系统版本和网络环境
- 已尝试的排查措施
- 用户影响范围
附录
附录A:WorkBuddy文档完整URL清单
入门指南
功能说明
| 文档 | URL路径 |
|---|---|
| 新建任务栏 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Task-Bar |
| Claw详细指南 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Claw-Guide |
| 专家中心 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Expert-Center |
| 技能市场 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market |
| 探索 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Exploration |
| 连接器 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector |
| 资料库 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Knowledge-Base |
| 自动化 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Automation-Guide |
| 右侧边栏 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Right-Sidebar |
| 系统设置 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Setting |
| 记忆 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Memory |
| 模型配置 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model |
| 数据管理 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Data |
| 帮助与反馈 | /docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Feedback |
账号管理
FAQ
| 文档 | URL |
|---|---|
| 常见问题 | https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/FQA |
附录B:定价速查卡
| 项目 | 价格 |
|---|---|
| 个人体验版 | 免费(500 Credits/月) |
| 个人专业版月付 | 58元/人/月 |
| 个人专业版年付 | 696元/人/年 |
| SaaS企业版月付 | 198元/人/月 |
| SaaS企业版年付 | 2,376元/人/年 |
| 专有云企业版月付 | 316元/人/月 |
| 专有云企业版年付 | 3,792元/人/年 |
| 个人加量包 | 38元/1000Credits/月 |
| 企业加量包(小) | 100元/2000Credits/6月 |
| 企业加量包(中) | 245元/5000Credits/6月 |
| 企业加量包(大) | 480元/10000Credits/6月 |
| 企业加量包(超大) | 2,375元/50000Credits/6月 |
| 企业加量包(巨量) | 9,200元/200000Credits/6月 |
附录C:错误码速查表
| 错误码 | 分类 | 处理方式 |
|---|---|---|
| 14003 | 模型侧 | 切换模型重试 |
| 11133 | 模型侧 | 切换模型重试 |
| 1001 | 模型侧 | 切换模型重试 |
| 3002 | 网络侧 | 检查网络/联系IT |
| 3003 | 网络侧 | 检查网络/联系IT |
| 400 | 网络侧 | 检查网络 |
| 401 | 网络侧 | 重新登录 |
| 504 | 网络侧 | 检查网络 |
| 6003 | 频率限制 | 切换模型/稍后重试 |
附录D:连接器配置速查
| 连接器 | 认证方式 | 功能 |
|---|---|---|
| QQ邮箱 | App扫码授权 | 收发/搜索/整理邮件 |
| 腾讯乐享 | 微信/手机/企微登录 | 知识库搜索/创建/管理 |
| 腾讯文档 | 微信/QQ扫码 | 文档管理与协作 |
| TAPD | 账号授权 | 项目管理与追踪 |
| 微云 | 账号授权 | 云端存储与文件管理 |
附录E:Skill vs 专家 vs 专家团速查
| 维度 | Skill | 专家 | 专家团 |
|---|---|---|---|
| 本质 | 工具能力 | AI顾问 | AI协作团队 |
| 解决 | 能做什么 | 谁来做 | 多角色怎么配合 |
| 消耗 | 低 | 中 | 高 |
| 选择 | 需要工具 | 单点问题 | 复杂多维度任务 |
附录F:退款政策速查
| 条件 | 结果 |
|---|---|
| 5天内+首次+未消耗 | 全额退款 |
| 5天内+首次+有消耗 | 扣除消耗后退款 |
| 使用代金券 | 代金券部分不退 |
| 享受折扣 | 折扣部分不退 |
| 超过5天 | 需提交工单评估 |
| 非首次 | 需提交工单评估 |
| 异常/恶意 | 腾讯云有权拒绝 |
附录G:面试前最后检查清单
- [ ] 能说出WorkBuddy和CodeBuddy的5个核心区别
- [ ] 能背出三种工作模式(Ask/Craft/Plan)及其适用场景
- [ ] 能背出四个定价档位(免费/58/198/316)
- [ ] 能说出5天内无理由退款政策的3个限制条件
- [ ] 能说出5个内置连接器
- [ ] 能区分Skill/专家/专家团
- [ ] 能说出3种以上错误码的分类和处理方式
- [ ] 能说出Claw远程控制的工作原理
- [ ] 能说出Credits消耗的两个因素
- [ ] 能说出自定义模型的4种接入方式
- [ ] 能处理退款场景的完整流程
- [ ] 能说出CodeBuddy的三种产品形态
- [ ] 能说出MCP协议的定义和用途
- [ ] 能说出零成本Skill Top 5
- [ ] 能说出自动化任务的配置项
附录G:CodeBuddy Code CLI命令速查
安装命令
| 方式 | 命令 |
|---|---|
| npm | npm install -g @tencent-ai/codebuddy-code |
| Homebrew | brew install codebuddy-code |
| 原生二进制 | curl -fsSL https://copilot.tencent.com/cli/install.sh | bash |
前置条件
- Node.js 18.20+(npm方式)
- 无需Node.js(Homebrew/原生二进制方式)
CLI三种模式
| 模式 | 说明 | 适用场景 |
|---|---|---|
| Plan | AI只分析不修改 | 需要审阅方案 |
| Build | AI直接修改代码 | 明确的小改动 |
| Auto | AI全自主执行 | 高信任度的重复任务 |
项目级配置
- 配置文件:
.codebuddy/rules - 作用:定义项目级编码规范和AI行为约束
附录H:第三方集成API完整配置示例
配置JSON模板
{
"name": "custom-org",
"base_url": "https://example.com",
"enterprise_id": "ent-xxx",
"timeout_seconds": 15,
"auth_header": "Authorization",
"auth_token": "token-value",
"bearer_token": true,
"extra_headers": {
"X-From": "org-service"
},
"account_id_header": "X-Account-Id",
"account_id_query": "account_id",
"success_code": 0,
"config_header": "X-Custom-Config"
}
请求头模板
Authorization: Bearer <auth_token>
X-Custom-Config: <base64(config-json)>
X-Account-Id: <account_id>
X-From: org-service
响应格式模板
{
"code": 0,
"message": "ok",
"data": {
"id": "dept-1",
"name": "研发部",
"display_name": "研发部",
"parent_id": "root",
"full_path": "/公司/研发部",
"has_child": true,
"member_count": 10,
"attributes": { "cost_center": "R&D" }
}
}
附录I:WorkBuddy + CodeBuddy联动实战场景详解
场景一:全栈开发 + 文档自动化
背景:开发团队需要同时完成代码开发和文档输出。
步骤:
- 开发者使用CodeBuddy Plugin在VS Code中编写Spring Boot REST API
- CodeBuddy自动生成Entity、Mapper、Service、Controller代码
- 开发完成后,在WorkBuddy中输入:“根据这些代码文件生成API文档”
- WorkBuddy读取代码文件,自动生成格式化的API文档
- 产物存回腾讯文档,通过企业微信推送给团队
涉及能力:CodeBuddy代码生成 + WorkBuddy文档生成 + 连接器 + Claw
场景二:CloudBase全链路开发
背景:使用腾讯云CloudBase进行全栈开发。
步骤:
- CodeBuddy IDE中创建云函数项目
- CodeBuddy直接管理CloudBase数据库(读写操作)
- 使用WorkBuddy设置自动化任务,每日导出数据报表
- WorkBuddy定时生成数据可视化报告
- 报告通过小程序推送到管理层
涉及能力:CodeBuddy IDE + CloudBase + WorkBuddy自动化 + 小程序推送
场景三:跨设备协作
背景:开发者需要在移动场景下继续工作。
步骤:
- 工位上使用CodeBuddy Code在终端开发
- 下班前提交代码,配置WorkBuddy自动化运行测试
- 通勤路上通过微信ClawBot查看测试结果
- 如有Bug,通过手机远程触发WorkBuddy修复
- 回到工位后查看修复结果
涉及能力:CodeBuddy Code + WorkBuddy Claw + 自动化
场景四:企业知识管理
背景:企业需要将分散的知识文档集中管理。
步骤:
- 通过腾讯乐享连接器搜索知识库
- WorkBuddy AI分析文档内容,提取关键信息
- 自动生成知识摘要和索引
- 产物存回腾讯文档/乐享知识库
- 通过自动化定时检查知识库更新
涉及能力:连接器 + 资料库 + 自动化 + Skill
附录J:1.5线客服工作规范与注意事项
J.1 服务态度规范
| 原则 | 说明 |
|---|---|
| 快速响应 | 首次响应不超过5分钟 |
| 专业准确 | 回答基于官方文档,不编造信息 |
| 态度友好 | 即使面对不合理要求也保持礼貌 |
| 主动跟进 | 问题未解决主动回访 |
| 信息完整 | 收集完整的排查信息 |
J.2 信息收集标准
面对任何问题,必须收集以下信息:
| 信息项 | 重要性 | 说明 |
|---|---|---|
| 用户账号 | 必需 | 用于查询订单和用量 |
| 问题现象 | 必需 | 具体描述出现的问题 |
| 错误码 | 重要 | 如有错误码,优先提供 |
| 系统版本 | 重要 | Windows/Mac + 版本号 |
| 网络环境 | 重要 | 公司/家庭/移动网络 |
| 发生时间 | 重要 | 便于日志排查 |
| 复现步骤 | 重要 | 一步步描述如何触发 |
| 截图 | 建议 | 直观展示问题 |
J.3 工单升级标准
以下情况必须升级:
- 确认为产品Bug(非用户操作问题)
- 涉及数据丢失或文件损坏
- 安全漏洞或权限异常
- 退款金额超出1.5线授权范围
- 用户明确提出投诉意向
- 同一问题3次以上仍未解决
J.4 常见不当操作警告
| 禁止行为 | 原因 |
|---|---|
| 代用户操作退款 | 需用户自行操作确认 |
| 承诺具体退款金额 | 需系统计算实际金额 |
| 承诺修复时间 | 需研发评估 |
| 透露内部信息 | 保护公司信息安全 |
| 越权处理超出范围的问题 | 按流程升级 |
J.5 售后场景话术模板库
退款场景
5天内首次退款: “您好,您的情况符合五天无理由退款条件。请登录腾讯云控制台,在对应产品资源页面提交自助退款申请。如果您不方便操作,也可以提交工单,我们会在2个工作日内处理。退款金额将返还至您的腾讯云账号余额。”
超过5天: “您好,根据退款政策,五天无理由退款仅限首次退还。您的情况需要提交工单进行评估,我们的客服团队会在2个工作日内给您回复。请您在工单中详细说明退款原因。”
有Credits消耗: “您好,退款金额会根据实际Credits消耗进行扣除。您可以在官网个人主页查看用量详情。确认无误后,请提交退款申请,系统会自动计算应退金额。”
功能异常场景
模型报错: “您好,这类错误通常与模型状态有关。建议您先尝试切换到其他模型(如从Auto切换到DeepSeek-V3.2)重新测试。如果切换模型后问题仍然存在,请提供错误码和发生时间,我们进一步排查。”
网络问题: “您好,这类错误通常与网络环境有关。请问您使用的是公司网络还是家庭网络?如果是公司网络,可能需要联系企业IT协助排查网络限制。如果是家庭网络,请检查网络连接是否正常,或尝试切换网络环境。”
频率限制: “您好,错误码6003表示请求频率受限,专业版也可能出现这种情况。建议您稍等片刻后重试,或切换到其他模型作为临时缓解方案。”
使用指导场景
新手引导: "您好,欢迎使用WorkBuddy!建议您从以下步骤开始:
- 选择Ask模式,先了解WorkBuddy的能力
- 从简单任务开始,比如’帮我总结这段文字的要点’
- 逐步尝试更复杂的任务,如文档生成、数据分析
- 探索技能市场,安装适合您工作的技能
- 配置Claw远程控制,随时随地使用WorkBuddy"
模型选择指导: "您好,模型选择建议如下:
- 日常问答和简单任务:Auto模式或DeepSeek-V3.2
- Excel处理和PPT生成:MiniMax-M2.5
- 截图分析和图片转文档:Kimi-K2.5
- 复杂推理和分析:Hy3 preview
- 中文写作和会议纪要:腾讯混元
- Agent场景:GLM-5.0-Turbo"
附录K:产品更新动态追踪(2026年关键节点)
2026年5月15日 — 新计费方案执行
| 变更项 | 说明 |
|---|---|
| 计费方案调整 | 新的Credits定价方案正式执行 |
| 企业版优惠 | 5月15日-8月14日购买旗舰版,首月额外赠送2000 Credits/license |
| 积分共享 | WorkBuddy和CodeBuddy同账号积分共享使用 |
2026年4月2日 — 登录故障与补偿
| 事件 | 说明 |
|---|---|
| 故障现象 | WorkBuddy及CodeBuddy登录异常 |
| 修复时间 | 约2小时紧急修复 |
| 补偿措施 | 向受影响用户补偿1000 Credits |
| 处理流程 | 技术团队介入→应急处理→修复验证→用户补偿 |
关注更新渠道
| 渠道 | 地址 |
|---|---|
| 更新日志 | https://www.codebuddy.cn/docs/workbuddy/Changelog |
| 腾讯云公告 | https://cloud.tencent.com/announce |
| 官方微博 | 腾讯云官方微博 |
附录L:面试高频数字记忆卡
以下数字必须在面试中脱口而出:
| 数字 | 含义 |
|---|---|
| 58 | 个人专业版月付价格(元) |
| 696 | 个人专业版年付价格(元) |
| 198 | SaaS企业版月付价格(元) |
| 2376 | SaaS企业版年付价格(元) |
| 316 | 专有云企业版月付价格(元) |
| 3792 | 专有云企业版年付价格(元) |
| 500 | 个人体验版每月Credits |
| 2000 | 付费版每月Credits |
| 5 | 五天无理由退款天数 |
| 2 | 工单审核工作日 |
| 38 | 个人加量包价格(元/1000Credits) |
| 7 | Claw支持的平台数 |
| 5 | 内置连接器数量 |
| 3 | WorkBuddy工作模式数(Ask/Craft/Plan) |
| 3 | CodeBuddy产品形态数(IDE/Plugin/CLI) |
| 10 | 零成本Skill精选数 |
| 11434 | Ollama默认HTTP端口 |
| 18.20 | CodeBuddy Code CLI所需Node.js最低版本 |
附录M:深度技术问答 — 面试加分项
M.1 WorkBuddy内部架构深度理解
Agent Loop 执行机制
WorkBuddy的AI Agent采用迭代循环机制完成复杂任务:
分析上下文 → 推理决策 → 选择工具 → 执行操作 → 获取结果 → 迭代循环 → 呈现结果
每个循环中,Agent会:
- 分析上下文:理解用户意图和当前状态
- 推理决策:判断是否需要更新计划、推进阶段或执行具体操作
- 选择工具:从可用工具中选择最合适的
- 执行操作:调用选定的工具
- 获取结果:将操作结果追加到上下文
- 迭代循环:重复以上步骤直到任务完成
- 呈现结果:通过消息和产物展示交付
工作空间隔离机制
- 每个任务拥有独立的工作空间
- 任务之间互不影响
- 工作空间包含独立的工作目录和上下文
- 这保证了多任务并行时的数据安全
工具调用机制
WorkBuddy内置多种工具供Agent调用:
| 工具类别 | 典型工具 | 说明 |
|---|---|---|
| 文件操作 | Read/Write/Edit | 读取、写入、编辑文件 |
| 搜索工具 | Glob/Grep | 文件搜索和内容搜索 |
| 终端工具 | Bash/PowerShell | 执行命令行操作 |
| 网络工具 | WebFetch/WebSearch | 网页抓取和搜索 |
| 可视化工具 | show_widget/read_me | 内联SVG/HTML渲染 |
| 任务管理 | TaskCreate/TaskUpdate | 子任务追踪 |
M.2 Skill执行流程深度解析
当用户在对话中触发Skill时,完整流程如下:
1. 用户输入消息
↓
2. 系统匹配可用Skill(基于关键词/触发条件)
↓
3. 加载SKILL.md内容到Agent上下文
↓
4. Agent按SKILL.md中的指令执行任务
↓
5. 调用SKILL.md中声明的allowed-tools
↓
6. 执行完成后返回结果给用户
Skill加载优先级:
- 已启用 > 未启用
- User-level和Project-level同时存在时,两者都可被调用
- 更具体匹配的Skill优先于通用匹配
M.3 MCP协议技术细节
MCP(Model Context Protocol)的核心设计理念:
| 概念 | 说明 |
|---|---|
| Server | 提供工具/资源的外部服务 |
| Client | 发起请求的AI Agent |
| Transport | 通信方式(stdio/HTTP) |
| Tool | Server暴露的可调用函数 |
| Resource | Server提供的可读数据 |
WorkBuddy作为MCP Client,通过配置文件连接MCP Server:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
},
"custom-api": {
"command": "node",
"args": ["path/to/server.js"],
"env": {
"API_KEY": "xxx"
}
}
}
}
M.4 WorkBuddy记忆系统技术架构
三层记忆架构
| 层级 | 存储 | 生命周期 | 用途 |
|---|---|---|---|
| 对话记忆 | 会话上下文 | 单次对话 | 当前任务的上下文信息 |
| 生成记忆 | 系统管理 | 跨会话持久化 | 用户偏好和习惯 |
| 工作记忆 | 文件系统 | 跨会话持久化 | 技术决策和项目信息 |
工作记忆文件规则
| 文件 | 写入时机 | 内容 |
|---|---|---|
MEMORY.md |
长期事实更新 | 用户偏好、项目约定 |
YYYY-MM-DD.md |
每次实质工作后 | 当日工作记录 |
SOUL.md |
首次初始化/用户要求 | AI的身份和价值观 |
IDENTITY.md |
首次初始化 | AI的名称和特征 |
USER.md |
首次初始化/信息变更 | 用户的基本信息 |
记忆维护规则
- 日志文件超过30天需蒸馏到MEMORY.md
- 保持记忆简洁,跳过临时信息
- 日志文件使用append-only方式追加
- MEMORY.md使用原地更新方式维护
- 冲突时以MEMORY.md为准,日志追加修正条目
M.5 企业版管理员操作指南
企业管理后台
访问地址:<企业id>.copilot.qq.com/admin
管理员可执行操作
| 操作 | 路径 | 说明 |
|---|---|---|
| 成员管理 | 成员管理 | 添加/删除成员,分配坐席 |
| 用量查看 | 用量管理/成员用量 | 查看所有成员Credits使用 |
| 订单管理 | 订单管理 | 查看和购买订单 |
| 发票管理 | 发票管理 | 申请和管理发票 |
| 组织架构 | 开放与集成 | 配置第三方组织同步 |
| 加量包购买 | 订单管理 | 购买企业加量包 |
Credits共享机制详解
企业版的核心优势是团队内Credits共享:
企业总Credits = 月固定用量 × 付费坐席数 + 企业加量包
↓
所有成员共享使用
↓
任一成员消耗Credits → 从企业总量中扣减
↓
企业管理员可在用量管理中查看每个成员的消耗
这意味着:
- 活跃用户可能消耗较多Credits
- 不活跃用户的Credits配额可被其他成员使用
- 企业管理员应定期监控用量分布
M.6 面试临场发挥技巧
回答结构化框架
使用"总-分-总"结构:
总:先给出一句话核心结论
分:展开3-5个要点,每个要点配合具体数据或案例
总:总结回归核心,强调关键数字或原则
遇到不确定的问题
不要编造! 采用以下策略:
1. 坦诚说"这个具体细节我需要确认"
2. 给出你知道的相关信息作为参考
3. 说明你会如何找到答案(查哪个文档、问谁)
4. 展现解决问题的思路而非猜测答案
展现1.5线特质
1.5线最看重的不是技术深度,而是:
- 服务意识:用户问题优先解决
- 流程意识:按规范操作,不越权
- 信息收集能力:一次收集完整信息,减少来回
- 升级判断力:知道什么该升级、什么能自己解决
- 文档意识:善于引导用户查阅文档
附录N:WorkBuddy养虾实践案例详解
N.1 实践一:文件内容识别与处理
场景描述:用户需要批量识别和处理不同格式的文件内容。
操作步骤:
- 在WorkBuddy中选择Craft模式
- 设置工作目录为包含待处理文件的文件夹
- 输入任务描述:“读取这个文件夹中所有PDF和Word文件,提取关键信息并汇总到Excel表格中”
- 确保已启用文档处理相关Skill(如办公文档四件套)
- WorkBuddy自动逐个读取文件、提取信息、生成汇总表
- 在右侧产物区查看生成的Excel文件
涉及功能:文件读取、格式转换、Skill调用、批量处理
注意事项:
- 如无法读取某类文件,可能需要切换到支持该文件类型的模型
- 大量文件建议分批处理,避免单次任务过重
- 明确指定输出格式,避免生成无法打开的文件
N.2 实践二:文档生成与编辑
场景描述:用户需要根据模板或参考文档自动生成新文档。
操作步骤:
- 上传参考文档(如历史报告、模板文件)
- 描述需求:“参考这份报告格式,根据以下数据生成本月工作报告”
- 提供本月数据(上传Excel或直接在对话中输入)
- 指定输出格式:Word文档
- WorkBuddy自动分析模板结构、填充新数据、生成文档
- 在右侧变更区查看AI对文件的具体修改
涉及功能:文件上传、@引用、文档生成、变更对比
最佳实践:
- 始终明确指定输出文件类型
- 提供格式参考能显著提高输出质量
- 使用Plan模式先查看生成计划,确认后再执行
N.3 实践三:数据分析并可视化
场景描述:用户需要分析数据文件并生成可视化图表。
操作步骤:
- 上传数据文件(Excel/CSV)
- 描述分析需求:“分析这份销售数据,按月汇总,计算环比增长率,生成折线图和柱状图”
- 推荐使用MiniMax-M2.5模型(Excel处理专长)
- WorkBuddy自动读取数据、执行分析、生成图表
- 产物区可预览生成的图表和报告
涉及功能:数据分析、图表生成、模型选择、产物预览
模型推荐:MiniMax-M2.5 是Excel处理和数据分析的最佳选择
N.4 实践四:每日自动推送资讯简报
场景描述:每天定时自动搜索AI领域新闻并生成简报推送到手机。
操作步骤:
- 打开自动化页面
- 创建新自动化任务:
- 名称:每日AI资讯简报
- 提示词:“搜索过去24小时AI领域的重要新闻,筛选5条最关键的,生成简报”
- 模型:Auto
- 技能:启用Web Search技能
- 定时规则:每天早上8:00执行
- 推送到小程序:开启
- 保存并启用
- 每天早上8点自动执行,结果推送到微信小程序
涉及功能:自动化、定时任务、Web Search技能、小程序推送
N.5 实践五:远程遥控龙虾
场景描述:通过手机远程控制电脑上的WorkBuddy执行任务。
操作步骤:
- 配置微信ClawBot接入(扫码绑定)
- 确保电脑保持开机运行WorkBuddy
- 在微信中向ClawBot发送消息:“帮我整理桌面上的文件,按类型分类”
- WorkBuddy自动执行整理任务
- 执行完成后在微信中收到结果反馈
涉及功能:Claw远程控制、文件操作、微信集成
注意事项:
- 电脑必须保持开机并运行WorkBuddy
- 网络必须正常连接
- 敏感操作建议使用Plan模式先确认方案
N.6 实践六:创建自己的Skill
场景描述:用户有重复性工作需求,想创建自定义Skill。
操作步骤:
- 在技能市场选择"创建技能"
- 描述技能需求:“每次周报生成时,自动从指定文件夹读取工作记录,按固定格式生成周报Word文档”
- WorkBuddy自动生成SKILL.md文件
- 查看和编辑生成的Skill定义
- 启用Skill后,以后只需说"生成本周周报"即可触发
涉及功能:Skill创建、SKILL.md、技能管理
Skill开发要点:
- description中包含触发关键词
- 声明必要的allowed-tools
- 包含完整的步骤说明
- 设置agent_created: true以便后续修改
附录O:CodeBuddy IDE全流程操作详解
O.1 产品阶段 — 从想法到需求
操作流程:
- 打开CodeBuddy IDE
- 在对话区用自然语言描述产品需求
- AI自动分析并生成结构化PRD文档
- 可继续对话优化需求细节
- AI辅助改进产品需求的完整性和合理性
适用角色:产品经理
O.2 设计阶段 — 从需求到原型
操作流程:
- 在对话区描述UI需求
- 选择生成方式:
- 自然语言转交互原型
- 上传手绘草图转高保真设计稿
- 基于组件库(TDesign/MUI/Shadcn)快速组装
- 通过自然语言实时调整设计风格
- 确认设计后准备进入开发阶段
适用角色:设计师
O.3 开发阶段 — 从设计到代码
操作流程:
- 使用内置Figma功能一键设计转代码
- 自动生成前后端代码
- 智能补全和错误修复
- 自动生成单元测试
- 使用
@workspace或#Codebase进行工程结构分析 - 代码审查与优化建议
适用角色:开发者
O.4 部署阶段 — 从代码到上线
操作流程:
- 一键部署到沙箱环境
- 生成公开访问链接
- 团队成员通过链接验证和反馈
- 确认后部署到正式环境
- 支持CloudStudio和EdgeOne Pages部署
适用角色:全栈开发者/DevOps
附录P:面试心理准备与策略
P.1 面试前48小时准备清单
| 时间 | 任务 |
|---|---|
| T-48h | 通读本指南全部内容,标记不熟悉的部分 |
| T-36h | 重点记忆定价数字、退款政策、错误码分类 |
| T-24h | 模拟回答附录中的高频面试题(出声练习) |
| T-12h | 复习WorkBuddy与CodeBuddy对比表 |
| T-6h | 浏览最新Changelog,了解近期更新 |
| T-2h | 放松心态,保证睡眠 |
| T-1h | 快速浏览数字记忆卡和面试检查清单 |
P.2 面试中常见陷阱
| 陷阱 | 正确做法 |
|---|---|
| 编造不确定的信息 | 坦诚说"我需要确认",展示查找思路 |
| 只答技术不谈用户 | 始终以用户问题为导向,技术是手段 |
| 忽略流程直接给方案 | 先确认问题全貌,再按流程处理 |
| 过度承诺(“一定能解决”) | 诚实评估,必要时说明需要升级 |
| 只关注产品功能 | 1.5线重点是服务意识和流程执行 |
P.3 展现核心竞争力的3个角度
- 产品理解深度:不仅知道功能是什么,还知道为什么这样设计
- 用户服务意识:始终从用户角度思考问题解决方案
- 流程规范执行:按标准流程操作,不跳步不越权
P.4 面试可能出现的开放性问题
Q:你觉得WorkBuddy/CodeBuddy最大的不足是什么?
回答思路:
- 选择一个真实存在的痛点(如:复杂任务的Credits消耗较高、某些模型响应不稳定等)
- 提出你的改进建议
- 展现你对产品的深入思考
Q:如果用户反馈一个你从未见过的问题,你怎么处理?
回答思路:
- 先安抚用户情绪
- 收集完整信息(错误码、截图、环境、复现步骤)
- 查阅文档和FAQ
- 尝试最小化验证(切换模型、重连等)
- 无法解决则升级,同时告知用户预期处理时间
- 主动跟进直到问题解决
Q:你怎么看待1.5线的工作价值?
回答思路:
- 1.5线是用户和产品之间的桥梁
- 直接影响用户对产品的第一印象
- 通过高效服务提升用户留存
- 收集的用户反馈驱动产品迭代
- 是理解用户需求和产品逻辑的最佳岗位
📌 本指南基于2026年5月15日的官方文档编写,产品功能和政策可能随时更新,请以最新官方文档为准。
📧 技术问题反馈:codebuddy@tencent.com