夜雨聆风学习资料网

ARTICLE · 1244925

WorkBuddy 完全指南:从安装到上手,一篇讲全

WorkBuddy 完全指南:从安装到上手,一篇讲全

以下 今天有朋友问我有没有WorkBuddy的教程,为方便学习的,这篇我把官方网站教程整理成这篇长文。大家可以收藏转发,从基础到进阶,还有一些案例,可以慢慢学。

现在继续还有注册送2000积分,每天登录领100分的活动,继续免费可以用。

关于模型选择:一般办公问题用deepseek 4.1 flash就可以,使用可以参考我之前的攻略WorkBuddy:DeepSeek-V4.1-Flash 0.03x 优惠,错峰最省,现在还有几个免费的模型可以选择。

还没注册的可以扫我的邀请码:

WorkBuddy 是腾讯出品的 AI 工作台:你用平时说话的方式讲清楚要做什么,它自己拆步骤、动手做,最后交给你能直接用的文档、表格或 PPT。它不是聊天框里多一个更聪明的回答,而是能在你电脑上真的动文件、真的跑流程的那一类工具。

这篇按新手真正上手的顺序写,从装好、登录、跑通第一个任务,到界面、对话、结果、模型、记忆、权限、安全中心、设置、技能、专家、连接器、资料库、助理、定时任务、六种远程接入、11 个实战案例、10 个零成本技能、10 条官方技巧、六类常见问题、错误码对照、套餐与积分。内容取自官方 87 个页面,文中配图全部是官方文档里的界面截图,不是示意图——照着图上的位置就能找到对应入口。

它 是 什 么

一、先把定位说清楚能动手干活,不只是会聊天

它做的核心一件事,是把「说需求」到「交成品」这条路打通:你描述需求,它自主规划、执行,最后给你能直接验收的成果。六个核心能力,按你感知最强的顺序排:

① 自然语言交互,不用预先拆步骤;② 自主规划与执行,自己把目标拆开做完;③ 多模态任务,文档、表格、PPT、数据分析都能做;④ 本地文件操作,授权后能读取、批量整理和修改你电脑里的文件;⑤ 多任务并行,可同时开好几个任务;⑥ 结果交付与验收,做完给你能直接用的成品,而不只是一段文字回复。

先弄清它和「只会聊天的 AI」有什么不同,用起来才不会用错期待:

对比维度
传统 AI 对话
WorkBuddy
能做什么
只能对话、给建议
能实际执行任务
文件操作
需要你手动操作
授权后自动操作本地文件
任务复杂度
单步、简单任务
多步、复杂任务
交付物
一段文字回复
可验收的文档 / 表格 / PPT

二、六个能力里,最容易被低估的是「本地文件」

六条里,自然语言交互和多模态大家已经有预期;真正把「能干活」和「只能给建议」分开的,是本地文件操作。授权一个工作空间之后,它能读你目录里的 Word、Excel、PPT、PDF、图片和代码,做这些事:批量重命名、按规则归档、跨文件统一格式、从一堆素材里抽数据做表、把几十份文档合并成一份汇总。这些活儿以前要一个个点开、复制、粘贴,现在一句话交代完。

但这也是最需要设边界的地方。它不是「看一眼就懂」的那种智能,是真的会去读写你的文件:目录选大了,它可能改到你不想改的文件。稳妥的做法是给任务单开一个文件夹、只放要处理的副本,比出了事再找回省事——具体规则在第十六节。

它还内置了一个独立文件浏览器(第十三节),可以把 WorkBuddy 设成 Word、Excel、PPT、PDF、Markdown、HTML 的默认打开方式。双击文件进去,右边就是 AI 对话栏,一边看一边让它改——这件事以前要开两个窗口来回切。

三、它不做什么三条边界,提前知道省事

反过来也得知道它不干什么,免得把不该交的事交出去:

· 它没有你的业务判断——产出要你验收,尤其涉及数字、法务、财务口径时。

· 它不替你做决定——方向由你定,它负责执行、给选项、补信息,但不替你拍板。

· 不支持云服务器部署——官方 FAQ 明确:服务器端能力仍在完善中,正式支持以后续版本为准,Windows Server 上装完连不上、SSH 连云端失败都属于这一类。

还有一条容易忽略的:它不是云服务产品。有云端沙箱,但那是给定时任务和助理跑任务用的,不是让你拿它当服务器搭站点。要在线上跑业务,走后面的「轻量发布」和「网站应用」两条路。

从 安 装 到 上 手

四、安装与登录三个平台,装法不一样

先对一下环境要求,这一条最容易卡住:Windows 需要 10 及以上、支持 x64,不支持 Windows 7 / 8 / 8.1;不满足的系统无法启动。Mac 需要 macOS 12(Monterey)及以上。另外,Windows 11 ARM64 目前也装不了。

下载到的是安装包本身,文件名里带的 win32-x64 就是架构标识;点「打开文件夹」可以直接定位到它

平台
要求
安装要点
Windows
10 及以上(x64)
官网「立即下载」→ 双击安装包 → 同意协议 → 选安装路径(可直接下一步)→ 确认开始菜单文件夹 → 建议勾桌面快捷方式 → 安装
macOS
12 Monterey 及以上
下载 .dmg → 双击打开 → 把图标拖进 Applications → 等待拷贝 → 推出镜像
银河麒麟
见官方指引
国产桌面系统,按对应安装指南走
统信 UOS
见官方指引
国产桌面系统,按对应安装指南走

Windows 安装向导:可以选择安装路径,也可以直接「下一步」用默认目录

Mac 上最容易选错的是芯片版本。官网若没识别出你的设备,默认给 X64;选版本时按这个规则:M 系列芯片选 ARM64,Intel 芯片选 X64——X64 包可以靠 Rosetta 在 M 系列上跑,兼容性更广;ARM64 包不能在 Intel 机器上跑。所以拿不准时选兼容性更好的那个。查本机芯片:「苹果图标 → 关于本机」。

登录:启动客户端点「登录」,浏览器会自动打开官网 workbuddy.cn,勾选《用户服务协议》与《隐私政策》,用微信扫码完成登录;也支持手机号、邮箱、SSO 等方式,全程在当前页面完成,不用来回跳。登录成功后返回客户端就能用。

点登录没反应、或者一直失败,先查两件事:默认浏览器没设——Windows 去「设置 → 默认应用」把 Chrome 设为默认浏览器,或者点「复制链接」自己粘到浏览器里完成验证;安全软件拦截了——火绒、360、电脑管家这类安全软件经常误拦 WorkBuddy,临时退出再试。这两条能解决官方 FAQ 里最常见的登录故障。

更新:头像 →「检查更新」,有新版本自动下载升级。换界面语言:头像 → 设置 → 通用 → 语言。装完之后建议先做一件事:把默认权限和安全中心过一遍(第十六、十七节会讲为什么要先做)。

五、创建第一个任务一句话就够,不用学语法

主界面点「新建任务」,输入你要做的事,选好工作目录和模型,点发送。没有「正在准备执行」这种过渡页,直接进对话界面,它怎么接手、怎么拆步骤,你在对话里实时看得到。

任务创建后直接进这个界面:左侧是任务列表,中间是对话,右侧边栏看产物

它到底能听懂什么程度的话,看官方给的例子就够了:「帮我把这份销售数据生成一个分析报告,包含图表」「整理 Downloads 文件夹里的图片,按日期分类」「根据这份会议纪要生成一个 PPT」「分析这份简历,提取关键信息生成表格」

把需求说清楚的四个要素

同一句话,补齐这四项,结果差别很大:目标(要生成什么)、输入(用哪些数据或文档)、输出格式(Word / Excel / PPT / PDF / Markdown)、约束(风格、字数、截止时间)。信息越全,它越不需要猜;它真猜了也会在方案里标出来。

不想自己组织语言,就用输入框上方的提示词模板:按「日常办公 / 代码开发 / 设计创意」分了组,鼠标悬停或键盘聚焦时,输入框里会显示灰色预览文案。预览只是预览——不改变你已输入的内容,不进草稿、不进撤销记录、也不会被发送,点一下才正式填入。

输入框上方的模板按场景分组,悬停即显示灰色预览文案,点一下才真正填入

工作空间:点击输入框左下角「选择工作空间」,选一个目录;不选也行,它会自动建一个独立目录。建议按任务类型分开建——「发票整理」「周报」「待处理照片」各一个,既好找,也让默认权限更容易判断哪些操作属于本次任务。

补充上下文有四种方式:用 @ 引用文件或规则、Ctrl/Cmd + V 直接粘截图、拖文件进输入框、在描述里写清约束。

六、三种工作模式Agent 干活、Plan 先看方案、Ask 只聊不动手

输入框左侧的 + 菜单里能开「计划」或「仅问答」,两者互斥,关掉就回到默认。处在非默认模式时,输入框下方会显示模式标识,点标识上的 × 直接退出。

模式
做什么
适合
默认(Agent)
高效执行并完成任务指令,可修改文件
文档生成、表格处理、文件整理
计划(Plan)
先规划,等你确认后再执行
多步骤任务、需要审阅改动范围
仅问答(Ask)
适合问问题、找思路,不执行
了解内容、确认需求

什么时候该开 Plan

Plan 的价值是「先出方案再动手」——几十秒内就能纠正方向,而不是等结果跑完才发现思路错了。判据是「怎么做」和「做出来」哪个更值得先讨论:

建议开 Plan
用默认模式更快
任务要拆成多个步骤才能完成
单点问答:查数字、问概念、翻译
需求模糊、有多种解法
明确的小改动
关键前提条件尚未确定
已经完全知道要什么,一句话可执行
产出成本高,不想白跑
会话里的连续轻量追问

用起来的流程是四步:开 Plan → 回答它围绕关键变量提的问题(时间、预算、偏好,建议逐项答,全跳过它会自行假设并标注)→ 在右侧面板审阅完整方案 → 点「开始执行」或直接说改哪。

调整计划时不用重开:删减、收窄、新增、调序、重来,直接说;确认前它不会动手,可以反复迭代。

仅问答(Ask):只想问信息、确认概念、讨论思路,不希望它改文件时用。三个模式的默认选择其实很简单——日常任务用 Agent,要把控方案开 Plan,只咨询开 Ask。

七、任务管理列表、搜索、筛选、归档、批量

左侧边栏把任务分两块:任务 放最近访问或更新的任务,空间 按工作空间归类。没有任务的项目不会出现在列表里;项目下新增任务,分组自动出现,任务删光,分组自动隐藏。分组默认只显示一部分,点「查看更多」展开,点末尾「收起」折叠。

六种任务状态与四种侧边栏标记

状态
含义
进行中
正在执行
已完成
执行完成
失败
过程中出问题,未能完成
待处理
等待进一步处理或输入
规划中
正在分析需求、整理执行思路
已归档
已归档,用于后续查阅

侧边栏还会在任务行右侧标出需要注意的四种状态:进行中、已完成未读、失败、待确认。「置顶」「任务」「空间」以及空间内文件夹收起时,里面的状态会逐层聚合显示在标题行右侧,只显示该层优先级最高的一个,优先级是待确认 > 已完成未读 > 失败 > 进行中——待确认 > 已完成未读 > 失败 > 进行中。点聚合图标会展开分组并直接跳到第一个带状态的任务。已归档任务不参与聚合。

找任务:搜索和筛选

全局搜索:一次查任务、空间、产物、资料库四类内容,命中关键词高亮

左上角搜索按钮(或 ⌘K / Ctrl+K)打开全局搜索,一次查任务、空间、产物、资料库四类内容,命中关键词高亮;未输入关键词时,「全部」页显示最近浏览记录。搜到后点击,会定位到对应位置并短暂高亮。「产物」支持按文件类型再筛,「资料库」是按标题和正文内容搜。

筛选面板按任务状态或日期缩小范围,用完点「重置筛选」恢复。手里任务多的时候,这一条比翻列表快得多。

十项常用操作

鼠标悬停在任务行点「⋯」,或直接右键,能做的事有这些:

操作
用途
置顶
频繁访问的任务固定在上方
重命名
让标题更准确反映内容
分享任务
生成公开链接发到任意渠道
在独立窗口中打开
同时看多个任务,方便对照
保存到工作空间
归入工作空间,可多 Agent 协作,也能用 IDE 打开
打开文件夹
直接定位到任务所在目录
在 CodeBuddy 打开
装过 CodeBuddy 且任务是代码开发模式时出现
批量操作
一次处理多个任务,支持快捷键
归档
移出列表但保留,之后在「设置 → 数据管理」里找
删除任务
彻底删除,删前会提示无法恢复

删除有一个细节值得记住:普通任务提示「删除后,这些任务将从你的所有设备中移除,且无法恢复」,运行中的任务提示变成「该任务正在执行中,删除将立即终止运行」,主按钮也变成「停止并删除」。批量删除时弹窗标题和结果提示都带数量(如「确认删除 2 项任务?」「已删除 2 项任务」),而正在运行的任务没法勾选——要先停掉或等它跑完。

工作空间本身也能管:打开文件夹、在 CodeBuddy 打开、重命名、从列表中移除。注意最后一项,「从列表中移除」只移出列表,不删本地文件夹。命名有实时校验:不能为空、不含 \ / : * ? " < > | 这些字符、不超过 255 字符、同级不能重名,不合规时按钮置灰并提示原因。

快捷键:先记三个

Mac
Windows
作用
⌘ + K
Ctrl + K
打开全局搜索
⌘ + Shift + E
Ctrl + Shift + E
定位到当前任务
⌘ + [ / ⌘ + ]
Ctrl + [ / Ctrl + ]
切到上一个 / 下一个任务

全局搜索里还有一组:↑ ↓ 切换选中结果、Enter 打开、⌃ + Tab(Control,不是 ⌘) 切换分类、Esc 关闭。批量选择状态下的键位在第三十四节讲。

八、输入框里五个省事的设计

这几个功能官方写了,但很多人没发现,用上能省不少时间:

· 拖拽加文件:拖到页面任意位置都行(首页或对话页),不用精准拖到输入框上;显示出「松开即可添加文件」提示层就松手。最多 50 个文件,单个文件大小不限,不合规的文件会在页面顶部给出具体错误。拖出去或按 Esc 取消,输入框内容不受影响。

· 超长粘贴自动收起:粘贴超过 3000 字符 的文本,会自动收成一条可展开的条目,只显示开头片段加省略号;悬停能预览原文,点一下完整展开继续编辑。连续粘几段长文本会各生成独立条目。

· 召回历史输入:输入框为空时按 ↑ 逐条回溯最近发过的内容,最多保留 20 条;按 ↓ 反向返回,在最新一条上按 ↓ 清空输入框。调出来能直接发,也能改完再发。

· 微信聊天记录直接转进来:在微信或企业微信里把聊天记录转发到 WorkBuddy,客户端会被唤起,输入框里生成一条聊天记录附件,随任务一起交给它处理。不管客户端当时没启动、已启动还是在后台,都能正常唤起接收;解析失败时删掉重转即可。

· 斜杠命令补全:项目会话里输入 / 就能看到当前项目的斜杠命令补全,来自项目目录 .codebuddy/commands/,支持嵌套(如 team:review)。命令文件增删改后,补全列表会自动刷新,也不会串到别的项目里去。

另外还有个提醒机制:循环执行确认。当它发现任务可能在原地打转时,会在调用工具前暂停并弹确认,让你选「继续执行」还是「终止请求」。两者的积分处理规则不一样,在第三十七节说。

界 面 与 结 果

九、左侧导航栏四块,能自己排顺序

官方标注的主界面分区:左导航、中对话、右侧边栏,三块各有分工

最左侧这一列把新建任务、历史任务和各功能入口收在一起,自上而下分四块:

区域
内容
顶部
版本号、「发现应用」
一级入口
新建任务、助理、项目、专家·技能·连接器、定时任务、资料库、更多
任务与空间
历史任务列表与工作空间列表
底部
消息中心、多端协同、账号头像

「更多」里默认收纳的是低频入口:我的邮箱、腾讯文档、ima、乐享知识库、灵感、Genie BaaS。入口变多之后,把常用的留在一级菜单、不常用的收进「更多」,每次找功能能省几秒。

顺序可以自己定:在导航栏任意位置右键 →「自定义菜单」,会打开自定义面板。面板分「一级菜单」与「更多」两组,按住条目右侧的手柄上下拖动改顺序,拖到另一组就在两者之间切换。「新建任务」是固定项,不能拖、也不能收进「更多」。

调整即时生效,不用点保存,关掉客户端重开还是上次的顺序。当「更多」里没有任何条目时,导航栏上不会显示这个入口,避免出现一个空菜单。一个限制要知道:自定义结果存在当前设备,不跨设备同步。

十、任务对话补充、追加、引用、看过程

任务对话界面:左边推进任务,右边实时出结果,中间不用切窗口

任务建好之后,对话区就是你推进任务的地方。顶部除了任务标题,从左到右还有四个常用操作:

· 在 CodeBuddy 打开:用 CodeBuddy 打开当前任务的工作空间继续开发(装了 CodeBuddy 且任务是代码开发模式时才显示)。

· 对话内搜索:在当前对话里查关键词。

· 分享任务:自动生成公开链接,直接分享出去。

· 显示详情面板:打开右侧边栏看产物、全部文件、文件变更和内置浏览器。

继续推进:三种最常见的补充方式

场景
说明
示例
补充要求
方向不变,增加内容、细化要求或加限制
再加一个饼图;把字体调大一点
调整已有结果
已生成的不符合预期
表格按销售额排序;报告增加执行摘要
继续处理或深入分析
基于当前结果往下做
帮我导出成 PDF;再分析一下环比变化

执行中也能追加:模型正在跑的时候你可以继续发消息,不用等上一轮结束。新消息会进入输入框上方的队列,等当前一轮输出结束后依次处理。队列里的消息支持编辑、删除、拖动排序;点发送按钮能立即发送、引导当前会话,但不会打断正在输出。已经进入对话流的消息会显示发送时间、可复制,但不支持撤回或编辑。

引用:把结论、表格、组件拽进对话

想针对回复里的某段结论、某张表格或某个组件追问,不用复制粘贴:选中文本,选区上方会浮出操作栏。点击「添加到对话」后选区旁会出现批注框(选填),可以顺手写下要它怎么改。表格和组件是悬停时右上角出现添加图标,点了原位置会提示「已添加到对话」。

几条实用的细节:可以连续加多个引用,文本、表格、组件混在同一条消息里;每条引用都带删除入口,删掉后正文里对应的引用标识也会取消;只发引用、不补文字也能直接发送——引用的原文和批注会一起交给模型。

看过程:知道它卡在哪一步

执行过程中会显示阶段说明与本次消耗,不用猜它现在在干什么

执行时对话区会显示回复内容、阶段说明(如「正在分析数据」)、已生成的结果摘要,以及可展开查看的中间步骤。需要连 MCP 服务时,会显示「正在连接 MCP 服务」加已连接数 / 服务总数,可展开按「已连接 / 未连接」分组看明细,全部连完显示「所有 MCP 服务已就绪」。这段进度只在加载时临时出现,加载完就从对话流消失,不当历史消息保留。

如果接入的 MCP 应用提供交互界面,WorkBuddy 会在对话或右侧产物区把那个界面显示出来,你可以在里面选选项、填内容、提交操作,而不只是拿一段文字结果。打不开时先检查服务是否已连接,再重新发起任务。

中断与继续:执行中输入框区域会显示停止入口,随时能中断。中断后可以补充说明、调整需求重发、或基于已有内容继续推进——重点是接着聊,不是每次从头开始。

关于隐私,官方写得很具体:所有文件处理默认在本地完成,原始数据不上传云端;服务端只处理数据片段,用后即弃,不保存也不用于模型训练;WorkBuddy 只能访问你主动勾选授权的文件夹,系统敏感目录自动拦截,高危操作需二次确认

上传支持的格式覆盖面很宽:PDF、Word、TXT、Markdown、RTF、Excel、CSV、TSV、PPT、JPG、PNG、GIF、BMP、ZIP、RAR 以及常见代码文件。大文件传不上去,先压缩或拆开。

十一、右侧边栏一个面板装下五件事

右侧边栏是主要的工作面板,把文件预览编辑、产物管理、变更追踪、网页预览和终端放在一起,都以标签页形式存在,可以同时打开、随时切换。它分两块:

区域
位置
作用
任务概览
对话区右上角
浮层形式,看本次对话的全部产物和任务进程
标签页
右侧边栏
看产物详情、工作空间文件、变更,用浏览器和终端

任务概览里有「产物」(带数量,没有时显示「暂无产物文件」)和「任务进程」(展开可看本轮执行步骤,没有就不显示这一项)。点任一产物会在右侧边栏以新标签页打开,对话流里的「查看所有产物」也是打开这个浮层。

五种标签页,数量有限制

标签页
可开数量
怎么打开
产物
多个
点对话流里的产物卡片,或任务概览里的文件
工作空间文件
1 个
新标签页 → 查看工作空间
变更
1 个
新标签页 → 查看变更(本次任务有改动后才显示)
浏览器
多个
新标签页 → 打开浏览器,或点对话里的链接
终端
多个
新标签页 → 打开终端(不支持终端的任务里不显示)

工作空间文件和变更各只能开一个,已开时再点会直接切过去。关标签可以点标签上的 ×,或用鼠标中键点;右键还能「关闭其他标签页」「关闭右侧标签页」。快捷键:Cmd/Ctrl + T 新建标签页、Cmd/Ctrl + W 关闭当前标签页。点标签栏右侧的全屏按钮可以铺满窗口,Esc 退出。

有个省内存的机制要知道:切到其他会话后,较早会话的标签页会被自动关闭,回到该会话后按需重新打开。所以切回来发现标签没了是正常的,不是崩溃。

产物标题栏:左边看状态,右边做操作

不管从哪里打开产物,标题栏布局都一致:左侧信息区显示文件名和保存状态(编辑后「未保存」、保存后「已保存」),右侧操作区最多直接显示 3 个常用操作,其余收进「更多(⋯)」。进入或退出编辑有即时反馈——在 HTML 产物上点「编辑」,按钮变高亮、文字变「退出编辑」,并弹出「已进入编辑态」。

一个几乎没人注意的功能:以渲染后的样子看 .md 文件时,「更多(⋯)→ 复制 Markdown」,会把当前文档完整的 Markdown 源码复制到剪贴板。它和「全选 + 复制」不同——后者会按粘贴位置决定给你渲染后的文字还是源码。这个入口只在 Markdown 文件出现,Word、PDF 没有;切到源代码视图时本身已是源码,也不再提供。

产物保存到本地后,文件名旁会出现已下载标识,「下载」变成「打开所在文件夹」,直接跳到 Finder 或资源管理器定位文件。

工作空间文件、变更、终端

工作空间文件用树状结构展示当前工作目录,点文件在新标签页打开。这里有个顺手的小改进:打开本地 Excel 后选中单元格区域右键,菜单第一行就是「AI 编辑」,不用再翻到选区右下角找入口。

变更视图记录它对文件的所有修改,展开能看具体变更文件,通过差异对比快速确认改动。如果任务涉及代码、脚本或配置调整,就优先在这里过一遍。终端可以在标签页里直接执行命令,能同时开多个,标签标题显示当前命令行或正在运行的程序名。

内置浏览器:比想象的完整

这是被严重低估的一块。它不只是渲染网页:

· 网址与搜索二合一:网址栏既能输网址也能输关键词。输网址(example.com、localhost:3000)直接访问;输其他内容用搜狗搜索打开结果页,下方还会列出匹配的浏览历史和搜索历史,↑ ↓ 选、Enter 打开。

· 登录态持久复用:访问需要登录的页面(企业内网、SaaS 后台、社交电商)登录一次,切换会话、新建标签都不丢。而且按账号隔离——同一台电脑换账号不会串用登录态。

· 能清数据:更多(⋯)→ 清除浏览数据 → 清除 Cookie / 清除缓存,清完对应网站需要重新登录或重新加载。

· 页面工具四个:查找页面内容(Cmd/Ctrl + F)、缩放(− / + 或 Cmd/Ctrl 加 + − 0,触控板双指捏合也行)、显示设备工具栏、截取屏幕截图(截完直接进剪贴板)。

· 设备调试工具栏:一键切手机 / 平板 / 桌面视口,或自定义宽高,验证响应式效果;悬停在设备上能看到视图宽高,例如 2560×1440。做页面的时候这一条最实用。

一个容易混的地方:对话区顶部的 Cmd/Ctrl + F 搜的是对话内容,焦点在浏览器页面里时,同样的快捷键搜的是当前网页。

消息中心

左侧边栏底部的铃铛打开消息中心,现在改成整页平铺(不再是弹框),能显示更多内容。消息只有两类:「任务操作待您确认」和「任务已成功完成」。点任一条直接跳到对应任务。没有消息时显示「暂无消息」。

十二、结果查看四类结果,六项操作

结果区:左边任务进度与产物列表,右边直接预览生成的文件

结果区按页签组织,主要提供四类:产物(生成的文件和交付物)、网页(生成的页面或本地 Web 应用)、工作空间文件、变更。不用离开当前任务就能对照检查。

产物覆盖的类型包括:文档(Word、Markdown、PDF)、表格(Excel、CSV)、演示文稿(PPT)、分析报告、自动生成的交付文件。对着产物卡片点右边的「⋯」,菜单有六项:

菜单项
作用
打开文件夹
跳到文件所在的本地目录
在默认应用打开
用系统默认程序打开
添加到对话框
作为引用加进输入框
复制路径
复制本地路径,方便粘贴分享
另存为
存到本地指定位置
上传到云端
传到网盘、腾讯文档或知识库

链接怎么打开也能改:头像 → 设置 → 通用 → 链接打开方式,有三档——智能打开(默认)、内置打开(全在内置浏览器)、外部打开(全在系统浏览器)。默认是「智能打开」:本地预览留在 WorkBuddy 内,其他链接交给系统浏览器。

分享和上云都在预览页右上角:点分享图标可以把结果发出去;上传支持的目的地是我的云端网盘、腾讯文档、ima 知识库、乐享知识库,在其他端的应用里也能看。

十三、独立文件浏览器把 WorkBuddy 当成默认打开方式

这是一个独立的文件窗口,和主程序互不影响:一个窗口就能打开本机文件,支持多标签、右侧内置 AI 对话栏,支持「人机双写」——一边看,一边让它总结、改写、润色。

它和普通文件查看器的差别在覆盖率:一个窗口打开 Word / Excel / PPT / PDF / Markdown / HTML / 图片 / 音频 / TXT,不用来回切应用;其中 Word、Excel、PPT、Markdown、HTML 都支持人机双写

三种打开方式

· 从系统打开:把 WorkBuddy 设成该类型文件的默认打开方式,之后在访达 / 资源管理器里双击即可;或右键 →「打开方式」→ WorkBuddy。

· 窗口顶部 +:新建文件(文档 / 表格 / 幻灯片 / Markdown)、打开文件、查看最近使用。

· 窗口会复用:从本地双击打开的文件会作为新标签加入当前激活的窗口——不支持的类型不会出现入口,右键菜单里没有 WorkBuddy,双击也不会用它打开。

关闭文件窗口不会退出主程序,反之亦然。多标签里点标签切换,按住可拖动排序;标签上右键能复制路径、打开文件位置、关闭、关闭右侧、关闭其他、在新窗口打开;Ctrl/Cmd + W 关当前标签。

右侧 AI 对话栏怎么用

对话栏默认是收起的——打开文件时先保证你安静看文档。点右上角「和 WorkBuddy 对话」展开,或者在收起状态下直接用「AI 编辑」,它也会自动展开。对话面板与正文之间的分隔条可拖拽调宽。

几条规则:对话跟着文件走——切文件标签时右侧对话也跟着切,每个对话只服务当前这个文件;历史对话会保留,关掉再打开还能往上回溯;也可以点「新建任务」开一段全新对话;独立窗口里新建的对话会关联并同步到主窗口。

AI 生成的新文件默认与原文件放同一目录,在对话里点这个产物会在窗口内开新标签查看。

不登录能不能用

能看:打开文件正常展示正文;Markdown 不登录也能看能编辑;但 Office 文档(Word / Excel / PPT)的编辑需要登录。所以临时看个文件不登录也行,要改 Office 文档就得登录。

保存方式按类型不同:Word / Excel / PPT 手动保存(保存按钮或 Ctrl/Cmd + S),关闭时也会提示;Markdown 自动保存,没有单独保存按钮,编辑即生效;HTML 点编辑进入编辑态,改完点退出编辑,文件自动保存。有未保存改动时关标签或关窗口,会先弹提示(可选保存或不保存),避免误关丢内容。

三种报错怎么处理

提示
原因
怎么办
文件格式不支持预览
后缀在支持范围内但内容解析不了,通常是文件损坏,或后缀与真实格式不符
用原应用打开检查,或另存为标准格式后重试
文件已被占用,当前仅可查看
文件正被其他应用、其他窗口、其他用户或系统进程占用
关掉占用它的程序再重新打开
文件在别处发生了修改
打开后别处改过;直接保存会覆盖别人的改动
选「刷新」载入外部最新版(当前未保存的编辑会被替换),或「另存为」保留你的版本

分享也是在这里做:点分享可以把文件链接或以文件形式发到各渠道,文件会自动上传到资料库(我的文档),并提供「查看在线版本」入口、可设访问权限(如「互联网获得链接的人 · 可查看」)。另外它只读取你主动打开的文件,不会遍历或扫描磁盘——这点比很多同类工具克制。

模 型 · 记 忆 · 安 全

十四、模型配置三档够用,细节值得调一次

三档的积分倍率直接标在选项上:快速 0.21x、均衡 0.65x、极致 1.20x,下面还能单独选型号,带「限时免费」「夜间折扣」标签的会显示 0.00x

模型设置里最实用的是三档模式,很多人一直用默认档却没意识到可以切:

模式
适合
特点
快速模式
简单明确的任务:日常问答、格式转换、小段代码修改、文案润色
响应最快,消耗最低
均衡模式
绝大多数任务:写文档、分析数据、多文件代码改动
效果和速度兼顾,不确定选哪档就用它
极致模式
复杂任务:跨模块重构、多步骤推理、需要反复验证的分析
响应稍慢,消耗更高,但复杂任务下结果更稳定

除了三档模式,还有几个参数值得知道:思考强度(同档位下付出更多思考,适合推理型任务)、上下文窗口(长文档、长对话才需要拉满)、Max 模式(针对最难的题目,会压缩中间过程)。这三项都属于「知道了会调,不知道也不影响入门」的层级。

内置模型怎么选

官方页面把内置模型逐个列了出来,按家族看更清楚:

模型
特点
能力
Hy4 preview
混元新一代模型
图片输入 · 思考模式
Hy3
混元思考模型,推理能力增强
图片输入 · 思考模式
GLM-5.3
GLM 新一代,支持 1M 上下文
图片输入 · 思考模式
GLM-5.3-Flash
GLM 新一代的快速版本
思考模式
GLM-5.2
1M 上下文,擅长长程任务
图片输入 · 思考模式
GLM-5.1
能力均衡,适合日常
推理模型
GLM-5v-Turbo
原生多模态
图片输入 · 推理模型
MiniMax-M3
原生多模态,擅长代码与智能体任务
图片输入 · 推理模型
MiniMax-m2.7
能力均衡,性价比高
图片输入 · 推理模型

按任务类型对号入座更直观,官方在新建任务页给的对应关系是:MiniMax 适合 Excel 处理、数据分析、PPT 生成,执行快;智谱 GLM 适合多步骤、长流程的复杂任务;Kimi 适合截图分析、图片转文档这类视觉任务;DeepSeek 适合日常问答和文案,响应快成本低;腾讯混元适合中文写作、会议纪要、中文文档处理

中途换模型有个提示要知道:如果对话正在进行,切换会在下一轮生效,同时提醒中途更换可能降低性能、增加积分消耗。提示不影响这次切换,可以手动关掉。

添加自定义模型:选提供商、填 API Key 和模型名称,仅支持 OpenAI 兼容协议

支持自定义模型:在「自定义模型管理」里填接口地址等方式接入。里面有个「自定义协议」开关——关闭时(默认)走标准 /chat/completions 路径,并自动校验补全接口地址;开启后直接用你填的地址发请求,跳过路径校验和补全。

十五、记忆越用越懂你,也能随时删

记忆并不是聊天记录。它从会话历史里提取有参考价值的信息(事实信息、偏好习惯、人物关系、近期跟进事项)形成记忆数据,后续对话时把相关的部分作为背景一起参考。提取在每晚整理当天会话,且仅你本人可见。

管理入口是「设置 → 记忆」(旧版叫「记忆与进化」):能查看摘要、能编辑、能一键删除、能整体关闭。编辑是对话式的——点右上角编辑图标,在弹出的对话框里告诉它要记住或忘记什么,不用自己改字段。

一个挺贴心的功能:支持从其他 AI 导入使用习惯。它会给你一段示例提示词,你复制到别的 AI 里问一遍,把结果粘回来就完成了导入。换工具不用从零重新养。

两点提醒,官方写得很明确:一是记忆不涉及积分消耗——记忆提取由 WorkBuddy 自费完成,不额外消耗 token 或积分;二是记忆只用于给你本人做个性化服务,不会共享给第三方。反过来,如果希望某些信息不被记住,就删掉对应条目或直接关闭功能,关闭后停止提取新的记忆。关闭或删除后,相应数据不再用于后续对话,但已经生成的输出不会因此追溯撤回。

还有一个诚实的提示值得记住:记忆由模型自动抽取,可能存在概括偏差或时效问题,依赖它做重要判断前先核验。

十六、权限模式这是整套安全设计的核心

这是全篇最值得逐字读的一节。WorkBuddy 能读写文件、整理目录、调用脚本和外部程序,所以它有两档权限:默认权限和完全访问权限。日常应该用默认权限——不挡路,但越过边界或执行危险动作前会停下来问你一次。

入口在哪

输入框底部有一个常驻的权限状态按钮,默认显示「默认权限」。点它能看到当前状态和说明,并通过「允许完全访问」开关切换。状态在输入框上始终可见——发起任务前随时可以确认自己在哪一档。

默认权限到底保护什么

开了删除保护之后,普通文件写入通常可以直接继续。但一旦涉及下面四类,它仍会停下来让你确认:

操作类型
为什么要拦
写入受保护或敏感路径
避免覆盖密钥、凭据或安全配置
删除受保护文件、重要目录或批量删除
避免误删难以恢复的资料(普通单文件删除由删除保护兜底)
执行脚本、命令或外部程序
可能修改文件、访问网络或影响系统环境
网络访问或敏感能力
命中安全中心规则或高风险能力时要求确认

如果你点了取消,这一步就不会执行。这时候正确的做法不是硬点允许,而是继续对话让它换个更安全的姿势——先列出将要删除的文件清单、先把结果存到工作空间内、先给预览或备份。

沙箱在这之上还叠了三层:命令优先在沙箱约束下执行,被拦了再按风险决定要不要问;删除保护尽量走安全删除或回收站;修改已有文件前自动备份(新建文件不重复备份)。

生效范围:以工作空间为边界

默认权限以工作空间为边界,工作空间内的常规文件操作通常可直接执行;超出工作空间、或属于需要确认的高风险操作,就会暂停并请求确认。工作空间就是本任务主要读写的那个文件夹——新建任务时选的目录,或它自动建的任务目录。

所以最有效的防护措施其实是选对目录:处理重要资料前,为任务新建一个独立文件夹,只把要处理的副本放进去。官方给了四个典型例子:周报整理、发票归档、客户资料清洗、图片批量处理——都是天然适合单独建夹的事。

为什么默认权限比「看着像不像危险」更靠谱

这是官方解释里最有说服力的一段。脚本分析本质上是先看命令或脚本内容,判断它「看起来」危不危险,但实际风险来自很多看不见的地方:脚本内部又调了别的脚本或工具;文件路径是运行时动态生成的,开头不容易看出来;一个普通命令可能因为参数不同就删掉、覆盖或移动大量文件;外部程序的真实行为也没法只靠文本判断。

默认权限的保护点不在「看起来像什么」,而在真正准备执行高风险动作时,把决定权交还给你一次。这就是它比静态规则更可靠的地方。

完全访问权限:会关掉什么

开启后它关闭上述二次确认——写文件、删文件、执行脚本、调用外部程序都不再逐步确认。生效范围是当前客户端内所有任务:已存在的任务和之后新建的任务统一生效;在对话过程中关掉,所有任务恢复默认确认流程。这个设置不跨设备,每台客户端各自管理。

切换时会弹出「确认允许完全访问?」,明确列出要放开的能力:文件操作、终端命令、访问互联网,并提示所有任务将减少确认步骤、直接操作你的电脑。官方在这里放了一句很重的话:允许完全访问不等于更安全,也不会自动帮你判断所有风险——它只是把确认环节交给 AI 自动通过。

这五种情况不建议开:

· 正在处理生产资料、客户资料、财务资料或唯一副本;

· 工作目录靠近桌面、下载目录、个人文档根目录或项目仓库根目录;

· 任务会批量删除、批量重命名或覆盖文件;

· 任务需要运行你不了解的脚本或第三方工具;

· 当前电脑里有重要文件,且没有备份。

建议的用法是短时间开、开完就关——隔离目录里反复跑已验证的脚本,或者 Docker、虚拟机、临时测试目录里的实验。

两档对比

对比项
默认权限
完全访问权限
文件访问范围
沙箱约束内,越界需请求允许
计算机上任意位置
删除 / 修改文件
需逐次确认
多数直接执行
终端命令
系统级命令需确认
可直接运行命令、装软件、改系统设置
访问互联网
受控,敏感动作需确认
可访问网站、发送数据、用已启用连接器
打断频率
较高
很低
生效范围
当前任务
全局,所有任务统一生效
风险等级
低
高
适合
日常文档、表格、资料整理、第一次做某类任务、目标不明确时
隔离目录里跑可信脚本、虚拟机或临时环境实验

十七、读懂确认弹窗它拦你的时候在说什么

被拦下来时,弹窗标题就是拦截原因,而且不重复展示路径:

操作
标题
读取文件
读取文件命中询问规则,需要确认。
写入文件
写入文件命中询问规则,需要确认。
删除文件
删除文件命中询问规则,需要确认。
访问网络
访问网络命中询问规则,需要确认。
执行命令
执行命令命中询问规则,需要确认。

具体对象显示在标题下方,按类型标为「文件」或「网址」,最多一行,过长会省略;点这条详情会打开浮窗看完整路径或网址。

弹窗右上角有「查看拦截规则」(内置规则显示为「查看拦截原因」):有对应设置项的规则,点了直接进「设置 → 安全中心」并自动滚动高亮那条规则;没有设置项的内置保护,会弹出说明框解释原因——内置保护不提供可调整的设置。

看到弹窗时按这三条快速判断:操作内容是什么(写、删、还是跑脚本)、影响范围在哪(目标路径是否在本任务工作空间内,会不会碰到桌面、下载目录、项目源码)、这一步是否真的是完成任务所必需。

拿不准就取消,然后让它先做这四件事之一:展示将要修改或删除的文件清单、生成预览或备份、把输出存到工作空间内、解释脚本内容和执行理由后再运行。

十八、安全中心比权限模式细一层的十二项

权限模式决定整体访问范围,安全中心负责细化文件、命令、网络、数据、运行时各方面。分成这几组:

分组
配置项
说明
沙箱安全
沙箱安全总开关
AI 运行于隔离沙箱,配置文件/命令/网络策略
文件安全
按路径配三态规则:读取 / 写入 / 删除可分别设为允许、询问、拒绝
命令安全
按命令前缀配允许、询问或禁止
网络安全
按域名 / URL 配规则,拦 HTTP 请求与恶意网站
自动备份
每轮对话修改文件之前自动备份
工具管控
Tool 管控
按工具、MCP 服务及工具粒度启停,对当前客户端所有 Agent 生效
AI 安全防护
三个开关
模型行为智能审查、工具内容注入防护、AI 智能审批,默认全关
数据安全
安全网关
工作空间出入流量统一过网关(默认开启)
传输加密
本地与云端端到端加密通道(默认开启)
敏感保护
检测拦截票据、密码等意外泄露,支持自定义规则
删除保护
开启后优先移到废纸篓 / 回收站
批量删除审批
一次删除达到设定数量(默认 50)时需审批,需先开删除保护
内置运行时
内置运行时
允许使用随包提供的运行时工具
审计中心
审计中心
记录拦截 / 放行日志,可导出、可清空
系统授权
仅 macOS
完全磁盘访问权限、辅助功能、自动化

网络安全这块值得单独记一下:远程 HTTP 请求默认询问、本地 HTTP 请求默认放行、域名白名单内的访问不受规则限制。macOS 还有「网络严格模式」(默认关闭),开启后用系统机制阻止绕过代理的出站连接,但 SSH、直连数据库工具这类可能受影响,用的时候可以临时关掉。

「AI 安全防护」这三个开关默认全关,开了会有确认弹窗说明作用:

开关
作用
模型行为智能审查
工具执行前用 AI 识别高风险操作,识别到先请求你确认
工具内容注入防护
识别工具返回内容里诱导危险操作的指令;发现疑似风险,先经你确认才允许进模型上下文
AI 智能审批
可选「仅风险提示」或「自动审批」(有有效审查结论时自动放行)

三条边界要清楚:AI 安全防护不替代沙箱规则、工具权限、敏感保护这些确定性防护,是在其上多加一层 AI 判断;设置修改对正在进行的那一轮不生效,从下一条消息起生效;「允许完全访问」模式下不启用 AI 安全防护。

工具管控:Agent 可调用的工具和 MCP 能逐个启停,减少不必要的联网、文件访问、命令执行和外部调用。「工具页」逐个启停产品工具,文件读写、命令执行这类必要工具进「必要工具管理」页管理(关之前会提示可能影响通用任务);「MCP 页」按服务整体启停,支持逐工具控制的可展开配置;还有个「自定义 MCP」统一开关,关掉后所有自己添加的 MCP 都不可调用。

自动备份:开启后它改已有文件前自动生成快照,新建文件不重复备份——好处是文件修改可以直接进行,不再逐个弹窗询问。规则是同一次对话轮次内同一文件只在首次修改前存快照;所有会话共享备份空间,默认上限 3000 MB,满了按时间顺序清理最早的。这条建议保持开启,但它不替代你自己的重要文件备份,只用于改错时快速回退。

敏感保护(默认开启)用敏感信息识别库自动识别密钥、凭证这类内容。内置规则库覆盖常见凭证(1Password Secret Key、各类 API Key、Client Secret 等),每条都标注检测方式——关键词检测、正则匹配、熵值检测,支持加密的会打「支持加密」标签。命中提示时如果选「允许加密访问」,明文会保存下来并生成密文,后续对话以密文参与上下文,输出环节再自动还原成明文,功能不受影响。

检测范围分输入和输出两侧:输入侧检测沙箱内打开较小文件、读取文件内容和输入框输入;输出侧检测执行命令、联网搜索、抓取网页等对外动作。部分内置能力(比如通过 MCP Token 调用的工具)已在白名单里,不会弹确认。

十九、设置面板独立窗口,14 项分组

设置面板:左侧一列分组,左上角有「搜索设置项」,找不到的直接搜

桌面端的设置是以独立窗口打开、不占用主窗口——主窗口可以继续用,设置窗口里也能自由切换各项。再点一次设置会聚焦到已开的窗口,不会重复开;关掉设置窗口不影响主窗口和正在跑的任务。

入口有三个:顶部「帮助 → 设置」(登录前后都能用)、已登录时头像 → 设置、未登录时登录界面底部的「网络代理」。未登录时设置只提供通用、快捷键和获取帮助,依赖登录的项要登录后才能用——这个设计是为了让你在登录失败时能先排查网络和代理。

头像菜单的十个快捷入口

入口
说明
套餐
看当前套餐与用量,到额度上限或要更多权益时点「升级套餐」
积分余额
看余额与明细,不足时点「购买积分」
Buddy 加油站
参与当前活动获取积分
去邀约
邀请好友获取积分
成长计划
完成成长任务拿能量、解锁专属 Buddy
外观
切浅色 / 深色
记忆与进化
查看与管理记忆
意见反馈
看帮助文档或提交反馈
检查更新
检查并按提示更新
退出登录
退出当前账号换号登录

设置项按三组排

分组
设置项
设置
通用(语言、字体大小、锁屏运行、运行时防止休眠、开机自启、网络代理、通知)、个人主页、套餐与积分、外观、快捷键
功能
个性化(对话风格)、记忆与进化、智能体、模型、助理、设备连接
数据与安全
数据管理、应用管理、安全中心

改完即时生效,不用重启。记不住某项在哪,用左侧导航顶部的搜索设置项:支持中文、英文和常用别名(输「代理」或 proxy 都能找到网络代理),命中会高亮,通过别名匹配的还会标出匹配词;↑ ↓ 选、Enter 跳转、Esc 清空。注意它只搜设置项名称,不搜你已经填进去的代理地址、文件路径。

两个容易被忽略但很有用的开关

运行时防止系统休眠:在「设置 → 通用 → 权限」里,默认开启。开启后本地任务执行期间电脑保持唤醒,避免空闲自动休眠把任务中断,屏幕仍可正常熄灭;任务结束后就不再阻止休眠。它和「允许锁屏运行」相互独立——如果你在后者选了保持唤醒或屏幕常亮,关掉这个不会取消那项的效果。另外它防的是系统空闲休眠,不阻止你主动睡眠或关机。

通知:任务完成、需要确认或中断时会用系统通知提醒,不用一直盯着窗口。里面有三项——桌面通知(点了去系统设置允许)、通知提示音(可选灵动、晴朗、沉稳,默认无音效)、定时任务产物通知(默认开启,点通知直接打开产物)。通知标题会显示任务状态:完成是「任务已完成」、需要确认是「任务等待确认,请处理」、中断是「任务中断,请重试」;定时任务的通知标题会带「定时任务」,任务名前面也会加「定时任务:」。如果 WorkBuddy App 已关联这台电脑,通知还会同步推到手机。

做代码开发的话还有个兼容点:它会自动识别并加载你个人环境里的用户级 .codebuddy 配置,包括规则、技能、Commands、MCP;用户级与项目级按明确优先级合并生效,互不冲突,加载失败会给清晰提示且不影响主流程。

二十、数据管理两个清单,清列表不丢东西

「设置 → 数据管理」里有两块,都跟「删了还能不能找回」有关:

· 我分享的文件:你分享出去的文件会留在这里,方便回看分享过什么、撤或者改权限。

· 已归档任务:任务列表里点「归档」的东西都在这。这就是为什么删不掉的任务可以先归档——列表干净了,东西还在。

能 力 扩 展

二十一、技能给 AI 加工具能力

技能市场:按推荐 / SkillHub / 套件分类,看中点一下就装

技能(Skill)解决的是「让 AI 具备某种工具能力」。内置20 多个技能包,覆盖文档处理、数据报表、海报设计、文件整理等场景;同时兼容 OpenClaw 社区技能导入,也支持用自然语言直接创建自己的技能。

技能页分两个区:「技能市场」和「已安装」——前者按分类浏览,后者是本地已装、能直接在对话里调用的。市场里按「推荐 / SkillHub / 套件」分类展示,看中点一下就装。

获取技能有四条路:安装(从市场挑)、上传(把本地技能包传上来)、创建(用自然语言描述让 AI 帮你写)、查找并安装(按名字搜)。

管理也简单:启停、搜索、卸载。装多了就该关一批——技能装得多会拖慢技能匹配,而且每个技能的描述都会进上下文,用不上的没必要常开。

二十二、专家与专家团角色切换 vs 协作执行

专家中心:按领域分类的角色卡片,选中就切换成那个身份

这两个东西的名字容易混,官方的区分其实很清楚:专家是「角色切换」机制——AI 变成一个懂某领域的具体角色;专家团是「协作执行」机制——自动拆解、并行执行、完整交付。

维度
技能(Skill)
专家(Agent 型)
专家团(Team 型)
本质
工具能力:让 AI 能做某件事
AI 顾问:懂某个领域的角色
AI 协作团队:拆解、并行、完整交付
什么时候用
需要 AI 具备某种工具能力
有一个明确的单点问题
任务复杂,需要多角色配合

召唤之后,如果专家依赖的外部服务还没连接(比如它要查数据库、要读某个知识库),WorkBuddy 会提示你去连接,而不是硬答。这点比「假装知道」安全。

自己建一个专家的四个字段

官方给了很具体的填写要点,照着写出来的专家质量差别很大:

配置项
怎么填
别这么填
头像与显示名称
用短角色名,便于识别和召唤,如「文档评审官」
「专家1」「助手」这类没指向的名字
人设身份
写「是谁 + 有什么背景」,如「10 年经验的后端工程师,熟悉 Go 与 Java」
写成任务本身,如「帮我写代码」
擅长领域
写清边界,同时说明「做什么」和「不做什么」
「什么都行」
提示词
写工作流程、输出格式与约束,能举例最好
只写「您是一个专家」

最容易忽略的是第三项。把「不做什么」写清楚,比写一堆「擅长什么」更能提升输出稳定性——它不会在边界外硬编。

二十三、连接器把外部服务接进来

连接器管理页:已授权的卡片能看到授权状态,失效时卡片会提示重新连接

连接器解决「任务要用外部服务的数据或能力」这件事。四类典型用法:

场景
说明
示例
数据查询
从外部数据源取信息
查数据库、检索文档
服务调用
调第三方 API 完成操作
发邮件、创建日程
文件管理
访问云端存储与文件系统
读网盘文件、上传附件
消息通知
与即时通讯工具集成
发企业微信 / 飞书消息

流程是:加连接器 → 完成授权 → 在对话里用自然语言调用。几个状态要分清:授权失效了要重新连接;「停止使用」是不用了但保留配置;「解绑」才是彻底断开。

也可以通过对话管理连接器——直接跟它说「帮我把 QQ 邮箱接进来」,它会引导你走授权流程。官方给了两个完整示例:连接 QQ 邮箱、连接腾讯乐享,跟着做一遍就明白机制了。

要是市面上没有你需要的服务,可以建自定义连接器:填接口地址和认证方式,自己接。权限边界值得知道:第三方业务数据仅在你的指令触发时按需读取;代发邮件、创建文档、建会议这类「写」操作,需要你明确指令确认。

二十四、资料库让产出沉淀下来,而不是散在文件夹里

资料库:左侧是你和 Agent 共用的目录树,底部有容量条

资料库有三个能力,解决了三个不同问题:

能力
解决的问题
包含
内容管理
人和 Agent 的产物一起管,共享上下文
个人文档与团队资料分开;零散资料进同一棵目录树;任务中直接读写资料库
多人多 Agent 协作
多人多 Agent 一起在资料库里干活
团队空间与权限;MD 审阅与 AI 修订;多人协同编辑 HTML;MD / CSV / HTML 分工
轻量发布
把做出来的东西发布上线
本地 HTML 发布为在线链接;HTML + CSV 搭轻应用

MD、CSV、HTML 的分工

这是资料库最核心的一条设计,理解了就不会乱:MD 决定内容,负责叙事;CSV 存数据,是唯一数据源;HTML 负责表达,读取 CSV 渲染成图表和列表

说白了:改文字改 MD,改数字改 CSV,改版式改 HTML。三者不混,才能做到「改数据不动页面」,也才不会出现同一个数字在三个文件里各写一遍、改漏一个的情况。

两条入库路径与格式覆盖

内容进资料库有两条路:在会话里让 Agent 保存,或者分享即存入。能装的格式分四类:AI 三件套(MD / CSV / HTML)、办公与本地文件(PDF / Word / PPT / Excel)、多媒体(PNG / JPG / MP3 / MOV)、压缩包(ZIP)。压缩包作为普通文件保存,可下载可删除;包含网页内容的压缩包可以自行选择转为在线网页。

团队空间与四档权限

团队协作按四档权限分:查看(只能浏览)、编辑(可新建修改整理)、管理(管成员和权限)、无权限(不可访问)。关键设计是「Agent 按同一权限读取」——Agent 在空间里干活时,读的权限和你本人一致,不会越权拿到你看不到的东西。

审阅模式:AI 改的每一处都看得见

用 MD 文档协作时,可以让 AI 出修订建议:每处改动都标出来,你点了「接受」才写进正文。配合随时划词评论一起讨论、按评论修订、以及逐层撤销与重做,整个流程跟人在 Word 里改稿没什么差别。

HTML 的协作逻辑不一样,这个差异要记住:MD 是划词提要求 → 生成修订建议 → 你接受后才写入;HTML 是划词调用 AI → 直接改选中内容 → 改动即时可见,无需审阅。

里面的本地 Markdown 编辑器也比想象中完整:划词菜单、悬浮快捷菜单(列表能继续编号和重新编号,表格能增删行列、长按列头拖拽调整列序,代码块能 AI 编辑、切语言、复制、删除,Mermaid 图表能切视图、下载,图片和视频文件能预览下载)、文档目录导航、查找替换、内容缩放。还有个智能复制很实用:粘到 md 编辑器里最高保真还原,粘到 Word / 飞书 / Gmail 样式保留且不出现 ## 和 ** 这类符号,粘到记事本 / 搜索框得到干净纯文本但列表结构保留。

任务和资料库是双向的:可以从空间或文档添加到任务作为上下文,可以基于资料提问让它执行,也可以把成果保存回资料库。这样就形成闭环,而不是每次生成完就散落在下载目录。

二十五、外部知识库腾讯文档、ima、乐享三条线

除了自建资料库,还能对接三个外部知识库,机制都一样:连接 → 任务里引用指定文件 → 产物存回 → 需要时解除绑定。

区别在细节:

· 腾讯文档:支持导入本地文件、导入本地文件夹(整目录导入并保留结构)、从腾讯文档个人版导入(需先在选择器里登录);能看文档归属、搜文件、引用指定文件、存回产物。

· ima 知识库:企业账号会拿到「企业版 + 个人版」双连接器,其他企业旗舰版拿个人版连接器。能建个人知识库、共享知识库、订阅知识库,把产物回传。

· 乐享知识库:连接后任务可引用指定文件,产物能存回,也看得到版本信息。

ima 这条线官方写得很深,给了五篇完整攻略:WorkBuddy × ima 功能指引、如何把 ima 知识库越用越厚、OPC 的一天、创作者攻略、学业助手攻略、求职展示攻略。如果想把知识库真正用起来(而不是建完就荒),这几篇值得看——核心方法是「按任务目标建主题库 + 每次产物回传」,让库越用越厚,而不是一次性堆资料。

二十六、轻量发布与做应用四种产物,先选对路

做完东西想给别人看,路子有四种,别一上来就选最重的那个:

你的需求
选什么
把页面快速发布为在线链接
轻量发布、网站应用
用 HTML 和 CSV 做持续维护的看板、台账、工作台
轻量发布
让用户注册登录、提交信息、上传文件
网站应用
区分普通用户、管理员等不同角色
网站应用

轻量发布解决的是一个很具体的坑:直接把本地 HTML 文件发给别人,对方看到的是本地地址,打不开。点「发布为网站」就变成一个在线链接,发出去别人能直接打开。再往上一步是HTML + CSV 搭轻应用——HTML 是展示与操作层(看板、待办、表单),CSV 是数据层(商品、订单、库存),改数据不动页面。

选哪种做法还有个简单判据:「把资料变好看」——数据不常变,一个 HTML 页面就够,适合汇报、复盘、旅游攻略、作品集;「把资料变能用」——需要持续记录更新,用 HTML + CSV,适合个人工作台、客户跟进、任务看板、记账。

要做小程序或带后端,走应用开发这条路

生成小程序/网站应用之后,能预览、修改、发布。小程序分三档,差别很大:

版本
用途
要已有账号
要微信审核
限制
试用版
快速验证效果
否
否
14 天有效,到期自动注销
体验版
上线前调试和验收
是
否
只有体验权限的用户能访问
正式版
对外发布和长期运营
是
是
需完成备案并通过审核

正式版卡人的三件事:小程序备案(境内小程序应完成备案,否则微信可能限制新用户访问或暂停服务)、用户隐私保护指引(按实际填信息类型、收集目的、变动通知方式、联系手机和邮箱)、UGC 内容场景要额外在微信公众平台填服务内容声明。

要存数据、要登录、要传文件,就得开云服务。它是按「资源点」计费的,不同会员档次给的应用数和资源点不一样:

会员
可开云服务的应用数
单应用资源点(月)
体验版
10 个
5,000
标准版
30 个
25,000
高级版
50 个
50,000
旗舰版
99 个
150,000

资源点花在哪:数据库的 CPU 用量和容量、服务调用次数、访问频率超额(按小时统计、P95 剔除瞬时尖峰、每 100 次/秒向上取整)、文件读写请求与存储容量、下载流量、缓存回源流量、短信验证码(按条)。还有一点要记住——资源点用完之后数据不会立刻没了,但有保留期:体验版 15 天、标准版 30 天、高级版 30 天、旗舰版 60 天。要长期留数据,别赌这个窗口。

远 程 与 自 动 化

二十七、助理手机上发消息,电脑替你干活

助理解决的是「人不在电脑前,但活儿得在电脑上干」这件事。你在手机上发一句指令,任务跑在你那台开着的电脑上,因为手机只负责发指令、批准操作和收后续消息;真正的执行环境全部由你的电脑提供。

支持六个平台:微信助理(官方推荐)、微信客服号、企业微信助理、QQ 机器人、飞书、钉钉机器人。

助理和普通任务有几个必须知道的不同:

对比项
普通任务
助理(远程任务)
工作目录
自由指定
固定用助理专属文件夹,不能改
新建对话
可开多个任务并行
只有一个会话,所有远程指令集中处理
上下文管理
可清空历史重新开始
保留完整对话历史,不可清空

这三条是设计取舍,不是缺陷。助理的定位是「一个随身的远程入口」,所以只有一个会话、一个目录;如果你需要多任务并行或干净的新上下文,回电脑上新建任务。别把助理工作空间当成日常项目的目录——这一点官方在 FAQ 里专门提醒过。

前端准备条件是硬要求:WorkBuddy 已安装并登录、电脑保持开机运行、电脑和手机都能正常联网。微信侧还要注意版本——手机微信需 ≥ 8.0.70,WorkBuddy 需 ≥ 4.6.4,且WorkBuddy 与微信需用同一账号登录(或已关联)。

解绑在助理设置里做。解绑后远程指令不再送达,但已经产生的任务和文件都还在,不会跟着消失。

远程使用有个安全边界值得说清楚:删除文件这类高风险操作,它会先把确认推到你手机上,你同意才执行。所以手机上派活不是「绕过权限」,只是「换了输入设备」。

二十八、定时任务到点自己跑,人不用在

新建定时任务:九项配置都在这一屏,权限那一项决定它会不会停在等待确认

定时任务有三种来源,决定了它跑在哪:

来源
说明
本地
在电脑端创建,在本机客户端执行(电脑得开着)
项目
在项目里创建,需要去对应项目查看和管理
云端
在云端沙箱执行,无需电脑在线,卡片上带云端标识

创建有三种方式,按你手上的信息量选:手动新建(要精确指定时间、权限、推送渠道)、从任务新建(一句话描述让它帮你建)、从模板新建(不确定能做什么,从常见场景快速上手)。

手动新建要填九项

配置项
说明
名称
区分不同任务
提示词
任务目标和输出要求
模型 / 专家 / 技能 / 连接器
在提示词输入框底部选,点 + 可添加专家、技能、连接器
工作空间
执行目录与文件保存位置
权限
默认权限或完全访问权限
重复
间隔、单次、每天、每周、每双周、每月、每年
时间
每次执行的具体时间
有效期
生效日期范围(单次任务不用设)
推送到企业微信
完成后把结果推到企业微信

这里有个官方特意说明的规则:多个日期要写在同一条重复规则里。也就是说「每周一、三、五」要写在一条规则里,而不是建三条。

权限这一项决定它会不会卡住

这是新手最容易踩的坑:官方对定时任务推荐「完全访问权限」,而不是默认权限。定时任务是无人值守的,你选了默认权限,它跑到需要确认的那一步就会停下来等,而那时候你很可能不在电脑前——于是任务等于没跑。

反过来说,开完全访问就意味着它会在你不看着的时候直接动文件。所以定时任务的工作空间一定要单独设、只放能承受改动的文件,这条比在手动任务里更重要。

日常操作七项

立即运行(跑一次但不影响原计划)、编辑、暂停 / 开启、查看运行记录、打开任务、删除、批量管理(右上角勾选后统一删除)。另外「暂停」只影响后续执行,正在跑的这一轮不会中断——这个细节设计得挺合理,不会因为手滑点一下就把跑了一半的任务掐掉。

结果有三处能看:任务运行页面、运行记录、结果通知。开了「推送到企业微信」,结果会直接推到企业微信里,不用回电脑上看。

二十九、六种远程接入的差别选哪个,怎么排障

六个平台都能接,但接入难度和适用场景差得挺远:

平台
接入要点
适合
微信助理
扫码绑定,最快;官方标记为推荐
个人日常用,手机上派活
微信客服号
扫码绑定;需 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70
个人用,另一种微信侧入口
企业微信
需管理员建智能机器人、设可见范围;支持长连接或 URL 回调
团队用,可控谁能用
QQ 机器人
需在 QQ 开放平台注册、建机器人、拿凭证
QQ 重度用户、群内共享
飞书
开发者后台建应用 → 加机器人能力 → 配权限 → 拿凭证 → 配事件回调 → 发布版本
飞书团队
钉钉
开发者后台建应用 → 加机器人能力 → 配权限 → 拿凭证 → 发版本
钉钉团队

按难度排:微信助理和微信客服号是扫码就完事,两分钟;企业微信要管理员动手;QQ 要过开放平台;飞书和钉钉步骤最多,因为要配权限、凭证、事件回调、再发一个版本。如果只是自己用,没必要绕远路去接飞书或钉钉。

按用途选:自己一个人用 → 微信助理;团队里要有权限控制、要让指定的人用 → 企业微信;整个团队都在飞书或钉钉里工作,不想再学一个新入口 → 对应的那个

六类常见故障,先自查这几条

官方 FAQ 把接入问题归成了六个典型症状,按顺序查效率最高:

症状
先查什么
发消息没响应
电脑是否开着且 WorkBuddy 在运行、账号是否一致、网络是否通
页面一直停在「绑定中」
等初始化完成;不动的重开助理设置再扫一次
扫码后没显示「已绑定」
退出重进;确认扫的是当前这台电脑生成的码
鸿蒙微信扫码失败
换设备扫码,或改用其他接入方式
企业微信提示 Webhook 域名主体校验未通过
改用长连接方式接入,或按回调要求配置域名
飞书配置 Webhook 提示无法检查链接
确认 WorkBuddy 侧已生成并保存 URL、本机可被访问
QQ 机器人频繁断开或不回复
检查开放平台侧机器人状态与凭证是否过期

还有一个跨平台的限制要知道:远程指令要操作本地文件时,尽量在本机侧先把路径说清楚。在飞书、企业微信、QQ、钉钉或微信上要求它上传你电脑桌面的某个文件,常常会失败——受设备权限、路径访问方式、平台能力限制。改成明确指定完整路径再执行,成功率会高很多。

三十、还有六个能力设计、灵感、邮箱、项目、应用、并行开发

设计创意(WorkBuddy × Ardot)

做设计稿这件事,它给了两条自由度。图片素材处理方式二选一:色块占位适合已有素材、稍后手动替换,或只想快速确认版式;AI 生图适合没有素材、希望一次出稿就是成品。再选设计风格模板,就能用对话生成初稿。

改稿有三种方式,对应三种不同情况:智能框选 + 对话(选中画布位置描述修改,局部精准调整)、纯语言指挥(不选中,全局调整或不确定位置时)、粘贴参考(贴网页链接或传参考图,参考别的设计风格)。

要精修就跳到 Ardot 编辑器。官方对两类人的说明挺实在:非专业设计师(产品经理、开发、运营)——AI 出的稿大方向对,但间距不匀、字号层级不清、配色想微调,靠对话说不清;Ardot 是所见即所得,点选改颜色、拖动调间距,零基础也能出专业效果。专业设计师——AI 初稿结构不错但细节不到交付标准(图层命名乱、对齐有偏差、缺状态变体、没法导出规范切图);Ardot 提供像素级对齐、图层管理、组件化编辑、多格式导出(PNG / SVG / PDF)

最后还能从设计稿生成应用代码,从设计稿生成应用代码——这一步把「设计」和「开发」接上了。

灵感

灵感和技能、专家不是一类东西。官方用三个问题区分:技能回答「WorkBuddy 能做什么」,专家回答「谁帮我做」,灵感回答「实际做出了什么」。值得逛的原因很实际——你能看到别人用这套能力实际做出了什么,觉得合适直接复用,不用从空白开始想。

我的邮箱

可以直接申请一个专属邮箱地址(形如 xxx.agent@agent.qq.com)作为独立收发身份,开通时需要手机号短信验证。它有通知中心,状态分三种:运行中(正常收发)、已停用(你主动停的,可一键开回)、已封禁或冻结(显示错误码和原因,去邮箱管理页处理)。

五类典型用法,基本覆盖了办公邮件的大部分场景:

场景
怎么用
会议纪要发送
让它整理纪要并发到指定邮箱
发票 / 合同处理
把邮件加进对话,提取关键字段并生成摘要
长邮件总结
整条线程丢给它,输出要点和待办
回复草稿
让它起草,你确认后再发
资讯简报
把订阅的新邮件汇总成行业简报

项目

项目是「按事组织任务」,适合一件事要持续做、还要跟人协作的场景。创建时要填五项:项目名称(必填)、指令(对 AI 的全局行为规则)、连接器、技能、专家。

项目里最有用的是它自带的那套目录约定——把配置写进仓库,团队就共享同一套规则:

目录 / 文件
作用
.codebuddy/rules/
项目规则:团队代码规范、工作流约定,自动加载并在项目会话生效
.codebuddy/agents/
项目专属 Agent 定义,会自动发现并使用
.codebuddy/skills/
项目级技能,每个技能一个目录,含 SKILL.md
.codebuddy/commands/
自定义斜杠命令,用 /命令名 触发,支持目录嵌套
.codebuddy/CODEBUDDY.md
项目级记忆文件:架构、约定、常用命令等团队知识

项目动态分三类:「与我有关」(别人把任务定向分享或转交给你)、「成员动态」(别人上传更新文件、邀请成员、公开任务、增删 Skill / 专家 / 连接器、改指令)、「定时任务」(只自己可见)。项目资产能装九类内容,上传来源有本地文件和在项目任务产物里点「上传到云端」两种。发起任务时,专家、Skill、连接器的可选范围会比个人任务更宽,排序规则是项目专家 / 项目 Skill / 公共授权连接器排在最前——项目级的永远置顶。

项目里的连接器授权分两种,这个区分很关键:公共授权是管理员配一次、全员共用同一套票据,适合团队共享的服务账号;个人授权是每人各自授权自己的账号、票据不共享,适合个人私有服务。

Git 集成与并行开发

做代码的话有几个实用点。创建任务时就能选分支——不是 Git 仓库时分支选择器是灰的。切分支时对未提交改动有三种处理:Committing 到当前分支(默认,弹轻量提交面板勾文件填信息后切)、Stash 暂存(含未跟踪文件)、丢弃变更(需二次确认)。

Worktree 并行任务是给「同一个仓库要同时改两条线」准备的:每条并行任务跑在独立的 worktree 里,互不干扰,任务卡上有标识和分支展示,结束有自动清理机制。一个人同时推进两个需求时,这比来回切分支安全得多。

Buddy 应用

Buddy 应用是别人发布的能力包,你授权后就能用,里面可以带专家、技能、连接器。流程是授权 → 进入应用 → 新建任务 → 用专家 / 技能 / 连接器 → 管理里切换、暂停或取消授权。如果你自己发布东西,会收到六类审核通知:发布审核通过、发布审核驳回(附原因)、信息审核通过、信息审核驳回、强制下架通知、资料违规通知。

场 景 · 实 战 · 技 巧

三十一、适用场景官方列了三大类,照着对号

官方的场景清单写得很细,直接列出来最有参考价值。

日常办公:15 个具体场景

场景
说明
文档处理
创建、编辑、整理和优化各类文档,支持批量处理
金融信息辅助分析
辅助处理金融信息、数据和相关业务内容
数据分析及可视化
分析处理数据并生成可视化结果
个人工作台
协助处理个人事务、信息整理和日常工作
幻灯片
按需求生成和优化演示文稿
深度研究
针对复杂主题检索、分析、整理并输出研究结果
视频生成
按文字或创意生成视频内容
产品管理
辅助产品规划、需求分析和内容整理
最新新闻
快速获取和整理最新资讯
帮我写作
按主题和要求生成、修改、优化文字
日常翻译
翻译、润色和语言转换
生活小知识
查询整理日常实用知识与信息
工作技巧
提供方法、效率提升和问题处理建议
旅游攻略
按目的地和出行需求整理行程、景点与建议

代码开发:7 个场景

场景
说明
日常开发
代码编写、审查、Bug 修复、调试、重构优化、问题排查
网站开发
按需求完成网站设计、开发和优化
小程序
设计开发微信小程序,支持预览和托管发布,不用装微信开发者工具
Agent 应用
设计和开发基于 Agent 的智能应用
Skill 开发
创建、编写和优化可复用的 Skill
CI/CD
辅助构建和优化持续集成与持续交付流程
文档
编写、整理和维护 README、开发文档及技术说明

小程序这一条值得单独提:不用搭建开发环境,也不用装微信开发者工具。它把「装开发环境、装微信开发者工具」这一步省掉了,对非开发者意义很大。

设计创意 这一类偏向视觉与表达,配合前面讲过的 Ardot 精修,能把「有内容的页面」推到「能交付的页面」。

三十二、11 个官方实战案例照着能复现

案例
做什么
一、文件内容识别与处理
读一批不同格式的文件,识别内容并按规则提取、汇总、改名或归档
二、文档生成与编辑
按需求从零生成文档,或在已有文档上改写、扩写、统一格式
三、数据分析并可视化
读表格数据做分析,输出图表和结论
四、自媒体运营
围绕选题、素材、成稿、多平台改写的一整套内容流程
五、每日自动推送资讯简报
定时抓取并整理资讯,按天推送简报
六、远程遥控 WorkBuddy
用手机从外部派任务、看进度、批准高风险操作
七、零代码制作本地应用
不写代码,做出能在本机跑起来的小工具
八、自我进化:创建自己的 Skills
把你反复用的流程固化成技能,之后一句话调用
九、AI 自驱动
让它按目标自己拆解、执行、验收,人只在关键节点介入
十、一句话管理所有会议
把会议纪要、待办、日程串起来,一句话查到要的东西
十一、一句话管理腾讯文档
接上腾讯文档后,用一句话查找、引用、生成并存回

这 11 个案例的价值不在「照着做一遍」,而在它们覆盖的能力梯度:案例一到三对应「单点任务」;四到五对应「有节奏的重复任务」;六到七对应「离开电脑也能干活」;八到九对应「把能力沉淀下来」;十到十一对应「接上外部系统」。看完能判断手上这件事属于哪一类,就知道该用哪个功能,而不是每次都从新建任务开始试。

三十三、10 个零成本技能装上就多十种能力

官方挑出的这 10 个都来自 SkillHub,不需要额外付费,装完直接在对话里调用。括号里是安装名,搜这个名字能找到:

技能
解决什么
Agent Browser(agent-browser)
让它直接进网页做浏览器级操作:打开、滚动、点击、展开、截图、读页面信息。必须交互才能看到内容的页面,靠它才能拿到
Find Skills(find-skills)
技能多了以后真正的门槛是「选」,它按需求筛候选并解释差异
Frontend Design(frontend-design)
生成前端页面时同时考虑设计感、风格一致性和演示效果,避免「结构对但很丑」
Local Whisper(local-whisper)
本地语音转文字,模型下载后可离线跑,适合会议录音、访谈、课程音频
Obsidian(obsidian)
读写、搜索、整理本地 Obsidian 笔记库,不用每次重复交代背景
办公文档四件套(PDF / DOCX / PPTX / XLSX)
直接处理常见办公文件,覆盖读取、生成、转换等操作
Skill Scanner(skill-scanner)
安装前先做安全审查,发现可疑依赖、硬编码配置和潜在风险。装第三方技能前建议先跑一遍
Web Search(web-search)
遇到「最近、最新、现在」这类时效问题,先搜再整理再回答,避免用过期记忆
self-improvement(self-improvement)
记录经验、偏好和修正结果,后续相似任务优先参考,越用越贴近你的习惯
tl_video_downloader(tl_video_downloader)
下载视频、提取音频和字幕,再交给 WorkBuddy 摘要整理

如果只装三个,建议是Web Search、Local Whisper、Frontend Design——搜得到(Web Search)、听得懂(Local Whisper)、做得好看(Frontend Design)。装之前如果技能来源不明,先用 Skill Scanner 过一遍。

三十四、10 条官方上手技巧每一条都对应一个真实的坑

官方这份技巧文档写得比大多数教程实在,我按原文意思重述并补上判断标准。

1. 说清楚:做什么 + 有什么 + 怎么样

新手最常犯的错是随手甩一句模糊需求,然后对结果失望。它不会读心术,你给的信息越少,它能发挥的空间越混沌。对比一下:

反面:「帮我把上次的会议纪要整理一下。」

正面:「把 D:/会议纪要/0320产品评审.docx 里的会议纪要整理成清单,包含:① 每个议题的结论;② 对应的责任人和截止日期;③ 标记有争议、未决的事项。用表格输出,不需要开场白。」

不确定从哪开始,就先问它:「我想做 XX,你需要我提供哪些信息?」让它帮你梳理输入项再开工。

2. 小步快跑,一次搞定一件事

把庞大需求一口气丢过去(「把整个项目重构一遍」「把这份 50 页报告全翻译并总结」),结果往往是输出了很多、没有一处真满意。拆开就稳得多:

第 1 轮:读取 D:/报告/2026年AI行业报告.pdf,提炼 5 个核心结论,每个一句话,附原文页码。

第 2 轮:基于这 5 条写一份 15 页汇报大纲,聚焦与我们业务相关的机会,补充建议和下一步。

第 3 轮:大纲没问题,把第二页「机会分析」扩展成完整页面内容,每条配 50 字说明,发给领导。

好处是每一步都能先确认方向,发现偏了及时拉回来,而不是最后整份推翻。

3. 不满意就调整,别一轮定生死

第一轮先给方向,后面几轮收窄校准。四种常用调整方式:直接指出问题、换角度重述需求、补充限制条件(受众/场景/格式/篇幅)、切换角色视角。把它想象成一个很勤奋、但需要反馈的实习生——你越愿意说清「哪里不对、想要什么」,结果越贴近。

第 1 轮:帮我写一封给客户的道歉邮件,原因是上期交付的报表数据有误。

第 2 轮:太正式了,客户是合作三年的老朋友,语气轻松点、像微信消息,200 字以内,重点说原因和已修复,不用反复道歉。

第 3 轮:不错,结尾补一句「下次交付前我会先发你确认版本」。

4. 先本地后远程,稳扎稳打

远程很方便,但那是它在你看不见的地方自主行动。一旦执行超出预期,你未必来得及叫停。建议顺序是:先看清单 → 再让它动文件且执行前列清单确认 → 确认判断无误后才交给定时或远程。

5. 给个身份,它就更专业

选一个对口的专家(法律顾问、产品经理、数据分析师、营销文案等),它会沿这个角色的思路组织回答。本质是预先设了一层角色提示,让表达框架、关注重点和专业术语更快对齐——对专业性强的任务,效果比堆形容词稳定得多。

6. 给例子,比说一堆要求管用

语言很难精确表达「感觉」。最省力的方式就是把手边一个满意的样本发给它,说「照这个来」。语气、结构、格式、风格,只要参照物清晰,它就能锚得住。

7. 善用多任务,别在烂上下文里死磕

每个会话是一张独立工作台:写方案一个、整理数据一个、回邮件一个,互不干扰。反过来说,一个会话过长、开始「前说后忘」「越聊越偏」时,不要硬撑——直接开新任务、把关键背景简洁说一遍,比在旧上下文里反复修补有效。

8. 备份和版本管理要勤

它有时会改过头:删掉你想留的内容、打乱格式、方向越改越偏。等你发现时,原始版本可能已经被覆盖。改文档、方案、表格之前先复制一份,哪怕只在文件名后加个日期。真正成熟的使用方式不是期待它永不出错,而是提前留好回退的路。

9. 用好自动化,让它自己持续干

重复性高、规则明确、不需要实时人工判断的任务,最适合交给定时任务。官方给的两个例子够典型:每天早上 8:30 把新闻早报发到邮箱;每周五 17:00 汇总本周代码提交记录,按模块分类统计提交次数和主要改动,生成周报。

10. 「偷懒」+ 合理激发输出

这里说的偷懒是把机械劳动外包,比如把 2000 行 Excel 里的电话统一成 xxx-xxxx-xxxx 格式、0 开头的保留区号、其余补默认区号 0755。而所谓「激发」,本质是给更强的角色设定和质量标准——它没有情绪,但这种表达会实际影响措辞选择、分析深度和输出结构。

比较一下两种说法:「帮我分析这家公司的财报」对比「你是一位在投行做了 10 年的财务分析师,以你见过最优秀的研究报告为标准,重点看:收入结构是否健康、现金流是否有隐患、相比同行的竞争优势。给出明确结论;数据不足可以大胆假设,但要标注假设条件。我要的是有洞察力的分析,不是数据搬运。」

三十五、六类常见问题按症状查,别一上来重装

安装与登录

问题
怎么处理
升级或隔天重启后,原工作空间文件夹消失
去 C:\Users\<用户名>\workbuddy(Mac 为 /Users/用户名/WorkBuddy)里找按日期或自定义名命名的文件夹,从 WorkBuddy 里打开即可找回。重要文件建议另存到独立目录
点 WorkBuddy 没反应、登录失败
① 未设默认浏览器:把 Chrome 设为默认,或用「复制链接」自己粘到浏览器完成验证;② 目录权限异常:查 CodeBuddyExtension 目录 owner 是否为当前用户,不是就授权;③ 安全软件拦截:临时退出火绒 / 360 / 电脑管家 / Windows 安全中心
Windows 11 ARM64 装不了
当前版本暂不支持,换受支持的设备环境或等后续版本

自检与日志

顶部「帮助 → 诊断工具 → 开始检测」能一键检测网络(API 连通性、DNS、TCP 端口、代理、丢包率)、系统资源(磁盘剩余低于 1GB 报失败、低于 3GB 告警、内存使用)、安全软件(EDR / 杀毒识别、文件读写监控)、环境信息、崩溃日志。检测完自动生成 .txt 报告,存在 logs/self-check/ 下保留最近 10 份。报告已脱敏(IP 只留前两段、用户名替换为 ***),可以放心交给支持团队。注意个人账号与海外版只展示「网络」分组,企业账号和内网版 / 专享版展示全部检查项。

日志位置:Mac 是「帮助 → 打开日志文件夹」,Windows 是「帮助 → 打开日志目录」,里面那个压缩包就是。反馈走「帮助 → helpFeedback」,或头像 → 设置 → 帮助与反馈 → 意见反馈,描述问题、传截图、勾选上传日志后提交。

文件读取与工作空间

问题
怎么处理
读不了图片、PDF、Excel、Word
① 换支持图片/文档输入的模型;② 分步描述需求,让它逐步完成环境准备;③ 装文档处理类技能
整理桌面后文件像丢了
执行前先备份;执行后先查目标整理目录和回收站;保留生成的脚本与截图再排查
生成的文件打不开
下任务时明确说要什么格式(Word / Excel / PDF / Markdown)
更新时提示「安装目录下存在用户项目目录」
安装目录更新时会清空重写。打开安装目录,只保留 bin、locales、resources、tools 四个系统文件夹,其余(含你的文件)先移走,再检查更新
助理工作空间的历史会话找不到
助理里只显示最近产生对话的任务,其他只在工作空间列表里。所以不建议把助理当成日常项目的工作空间

功能与性能

问题
怎么处理
支持自定义模型吗
支持,在模型配置里接
为什么助理不能改默认文件夹
助理专为远程任务设计,固定使用专属文件夹,不支持修改
支持云端部署或服务器安装吗
服务器端能力仍在完善,正式支持以后续版本为准
回复乱码、胡乱输出、长时间无响应
先换模型;把复杂任务拆小;记录是否伴随错误码或网络波动
运行缓慢、一个任务跑很久
先确认网络稳定;减少一次性过长过大的复合任务;必要时换模型或拆成多个任务并行
任务卡住没反应
点发送处的停止按钮 → 换模型 → 重跑历史任务
移动端要求上传桌面文件失败
受设备权限、路径访问方式、平台能力限制,改为在本机侧明确指定完整路径

账户与数据安全

账户类的六种情况——申请退款(腾讯云工单)、查最新价格(价格方案页)、补偿积分领取(官网个人中心 → 套餐与用量)、积分未到账或消耗异常(同上查明细,把截图发 workbuddy@tencent.com)、企业售前咨询(价格方案页的售前渠道)、升级后仍显示体验版(已知前端显示异常,在修复中,先保留订单信息)。

数据安全放在最后一类,官方给了三层纵深防御架构、通信安全保障、VPC 专享版安全架构,以及和开源方案的对比。对普通使用者来说,最该记住的是前面那几条具体机制:本地处理不上传原始数据、服务端只处理片段用后即弃、只访问你授权的文件夹、敏感目录自动拦截、高危操作二次确认、传输端到端加密、安全网关默认开启。

三十六、错误码十个码,两种病

看着吓人,其实归成两类:模型侧和网络侧。

错误码
判断
怎么办
1001
多与模型侧状态有关
切换模型重试
3002
多与网络环境有关
先分清公司网还是家庭网:公司网找 IT,家庭网按网络排查流程走;也可先关掉代理
3003
同上
同上
3007
同上
同上
6003
请求频率受限(专业版也可能出现)
切换模型重试
6004
同上
同上
11115
输入内容过长
精简输入,或换支持更大上下文的模型
11133
多与模型侧状态有关
新开会话或切换模型重试
11134
同上
同上
14003
多与模型侧状态有关
切换模型重试

顺带一个有用的信息:5.3.0 版本之后,内置了网络代理切换功能。官方给了「跟随系统」这个选项——不了解三者的区别时就选它。

三十七、套餐、积分、发票、注销和钱有关的部分

套餐与积分页:本月额度、已用、剩余,以及每条消耗明细

四档套餐与积分额度

体验版
标准版
高级版
旗舰版
月付
免费
99 元/月
199 元/月
999 元/月
连续包月(7 折)
—
70 元/月
140 元/月
700 元/月
连续包年(5.6 折)
—
672 元/年
1,344 元/年
6,720 元/年
基础积分 / 月
500
2,000
4,000
20,000
加赠积分 / 月(限时)
—
2,000
5,000
30,000
每月实得(限时)
500
4,000
9,000
50,000
自动任务
3 个(限免 99 个)
15 个(限免 99 个)
30 个(限免 99 个)
99 个
代码实时补全
5,000 次/月(限免无限次)
无限次
无限次
无限次
功能抢先体验
—
逐步开放
逐步开放
优先

积分不够可以买加量包:1 个月 1,000 积分 50 元。7 月 1 日前已经是付费会员的老用户有过渡安排——开了月付自动续费的享半年保价,2026 年 12 月 31 日前按 58 元/月,2027 年 1 月 1 日起按 70 元/月,自动续费届时微信支付与短信会再提醒,可随时取消;没开自动续费和年付会员,当前周期权益完整保留至到期,到期后按新方案订阅。

积分怎么扣、什么时候过期

积分衡量的是 AI 任务的资源消耗,所有对话相关请求都要消耗。数量由两个因素决定:模型单价(高级模型输入输出单价更高,同样 Token 量扣更多)和任务复杂度(长代码分析、多轮对话、知识库检索这类要吃更多推理和 Token)。

扣减顺序是优先用最先到期的积分包(标准/高级/旗舰/加量包都算在内);到期时间相同则先扣基础积分,再扣赠送积分。

有效期这几条最容易踩坑:月会员是新购当天到次月当天(11 月 5 日买,到 12 月 5 日),年会员是新购当日起一个自然年;加量包也是当天到次月当天;积分按月发放、当月有效、不累积结转;赠送部分从到账日起 1 个月内有效;付费会员到期但加量包还有积分,可以继续用加量包直到到期或耗尽;会员到期后额度降为体验版。

循环执行确认那一下,两选的积分后果不一样:「继续执行」照常执行、按正常规则计费,不计为循环、不进退费评估;「终止请求」不执行本次调用,本次已产生但未生成最终回答的消耗进入退费评估。另外,普通情况下手动取消请求不进入退费评估,只有选了「终止请求」才会额外上报。

升级、续费、退款

升级是先用后退:先按新套餐收全额,再把当前套餐的剩余价值退回原支付账户,你只补差价。剩余价值只拿基础积分算,加赠积分不参与核算:月付 = 月价 ×(1 − 已用积分 / 月总积分);年付 = 未来未生效月数 × 月均价 + 月均价 ×(1 − 当月已用积分 / 月总积分)。

几条硬规则:支持升级不支持降级;月升月、年升年、月升年、年转月都行(年转月要买比剩余更多的月付);最小购买周期 = 剩余有效期按月/年向上取一整周期;升级后旧版基础积分回收、按新套餐全量下发;新版积分先生效、旧版再失效,过程零断档;加量包不受影响、不回收。在 iOS App 或 iOS 小程序里升级是另一套逻辑——Apple 按剩余天数比例退款,和「积分按用量消耗」不一定同步,所以会出现三种情况:退款少于剩余积分价值就补发积分(最低 100 积分、有效期 1 个月)、等于就不处理、多于就冻结等额积分(本周期不可用,下周期也不补回)。

取消自动续费有个时间点务必记:要在当前计费周期到期前至少 5 个自然日完成操作,否则下个周期可能被扣。官网可以在个人中心 → 套餐与用量 → 取消自动订阅里关;第三方支付渠道则去微信「我 → 服务 → 钱包 → 支付设置 → 免密支付/自动扣款」关。

退款走腾讯云官网提工单:产品分类找到对应产品 → 填详情和联系方式 → 提交,客服一般两个工作日内处理,通过后系统执行退货,可在订单管理看到「已退款」状态。

发票

官网右上角头像 → 个人中心 → 账单与发票 → 开票管理 → 选订单 → 去开票。填抬头类型、发票类型、抬头、纳税人识别号、开户账户、邮箱,提交后24 小时内发到邮箱,邮件里带 PDF、XML、OFD 三种格式的下载链接。开票状态在「已开票」页签看,要退票也在那里点「更多 → 退票」。邮箱填错了不用重开,在已开票页签选对应订单,点「更多 → 发送到邮箱」重填即可。

三十八、排障顺序四步,别跳着走

遇到问题别急着重装,按这个顺序来最省时间:

1. 先跑自检(帮助 → 诊断工具 → 开始检测):网络、系统资源、安全软件、环境信息、崩溃日志一次性过一遍,失败项会直接给出方向性修复建议,检测到安全软件拦截时还会告诉你该把哪个路径加白名单。

2. 再看日志(帮助 → 打开日志目录 / 文件夹),里面的压缩包就是。反馈时勾选上传日志,比只说「用不了」有用得多。

3. 对现象查文档:错误码对第三十六节,症状对第三十五节,安装 / 权限 / 网络三类基本能覆盖八成问题。

4. 最后才提反馈:描述操作、截图、附日志。涉及积分异常、注销受阻、发票问题,直接发 workbuddy@tencent.com。

还有一条经验:先怀疑环境和输入,再怀疑软件本身。多数时候不是软件坏了,是权限没给对、网络被拦了、或者模型不支持某种输入。


看完这一篇,最该动手的其实只有三步:装好并登录;用一句话跑通一个真实任务(别用示例数据,用你手上真的要做的那份文件);然后把默认权限和自己的使用习惯调一遍。剩下的功能,等真的遇到需要时再回来翻——它是工具箱,不是考试范围。

—— 瑶瑶老师 · AI 的一百个实验

相关学习资料