ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

WorkBuddy 上手教程:AI Agent 工作台、Skill 与本地模型接入

WorkBuddy 上手教程:AI Agent 工作台、Skill 与本地模型接入 这次我们来看 WorkBuddy。一个讨论热度上升很快的 AI 助手工具。和传统聊天机器人不一样WorkBuddy 更接近“AI Agent 工作台”的定位把 AI 模型、Skill 技能、本地文件、远程连接和定时任务串起来让 AI 不只是回答问题而是直接帮你把活干了。你在里面可以搭客服工作台、做 PDF 批量整理、接本地模型做私有推理或者挂一个 SSH 连接器做远程服务器辅助。从公开讨论的热度看WorkBuddy 最值得关注的能力有五个Skill 技能生态、本地模型接入、自定义指令、批量自动化任务、与 CodeBuddy 的联动场景。这篇保姆级教程会按“装什么 — 怎么装 — 怎么用 — 怎么验证 — 出问题怎么查”的顺序把 WorkBuddy 从下载安装、初始化工作台、配置 Skill、接入本地模型到跑通自动签到和 PDF 批量解析的完整流程过一遍。目标是让一个完全没接触过的新手在 30 分钟内走通第一套能用的工作流顺带理解它跟普通 AI 聊天工具有什么本质区别。先说一个现实情况WorkBuddy 属于客户端型 AI 工具版本更新节奏比较快不同版本的界面入口、Skill 名称、设置路径可能存在差异。文中给出的操作路径和配置示例主要整理自当前公开讨论中较常见的版本。如果你打开后的界面和我描述的不完全一样优先以你自己安装版本的设置面板为准。这不算模糊而是这类工具迭代快的正常状态。1. WorkBuddy 核心能力速览先把关键信息放在前面方便你快速判断要不要继续看。能力项说明工具类型AI 助手 / AI Agent 智能体工作台主要功能自然语言对话、Skill 技能调用、自定义指令、PDF 文档处理、SSH 远程连接、本地模型接入、批量自动化任务模型方式支持在线模型也支持搭配本地模型做私有推理具体模型名单以客户端当前版本为准硬件门槛客户端本体常规办公电脑即可运行接入本地模型时硬件要求取决于所选模型规模支持平台以桌面客户端为主Windows / macOS 都有人在使用Windows 7 等老系统需单独验证兼容性启动方式图形客户端启动不需要写命令行对新手友好接口能力可接入兼容 OpenAI 格式的本地推理服务WorkBuddy 自身开放接口需确认当前版本说明批量任务支持定时自动签到、批量文档解析等场景具体能力以已安装的 Skill 为准常见关联与 CodeBuddy 经常被放在一起讨论一个偏编码辅助一个偏通用工作助手适合人群客服团队、科研人员、办公自动化用户、AI 工具尝鲜者、开发者从这张表能看出来WorkBuddy 的定位不是“更强的 ChatGPT”而是“能把工具串起来干活的 AI 代理”。所以判断它适不适合你标准不是你平时聊不聊 AI而是你有没有重复性工作想交给它。2. WorkBuddy 适用场景与使用边界先讲场景再讲边界。WorkBuddy 最适合下面几类人客服负责人和客服团队成员。从公开讨论看客服场景是 WorkBuddy 的高频用法。你可以把常见问答、话术规范、客户等级规则写进自定义指令再配一个文档检索类 Skill让 AI 帮忙做客服回复草稿、舆情归类、客户标签整理。这样客服新人上手快老客服能把时间腾出来处理复杂投诉。科研人员和文档处理用户。文献 PDF 解析、内容摘要、笔记整理、资料归档这些是 WorkBuddy 站内讨论中经常出现的使用方式。你不需要手动打开 PDF 一段段复制直接丢给 WorkBuddy 让它按格式输出摘要和重点即可。办公自动化用户。自动签到、定时任务、批量文档转换、日常提醒这类重复性操作如果能被 Skill 覆盖确实能省下不少时间。开发者和技术爱好者。已经装了 CodeBuddy 的用户往往也会装一个 WorkBuddy 对照使用。一个处理代码任务一个处理日常办公任务两个工具互补的场景比较常见。再说边界。WorkBuddy 再方便也只是一个工具使用时有几条红线必须说清楚涉及客户个人信息、企业内部数据、医疗或金融隐私数据时必须先确认使用环境和你是否有合法授权。不要把未脱敏的客户真实信息、身份证号、手机号直接丢给外部模型处理。本地模型接入可以降低部分隐私风险但也不能因此放松授权要求。自动签到、网页自动化这类 Skill必须确认符合对应平台的使用规则和当地相关规定。合规性判断不能交给 AI 自己决定是你决定。AI 生成的回复。不管 WorkBuddy 生成的客服话术多通顺上线前和商用前都要做人工复核。回复内容涉及退款、投诉、承诺、法务条款时必须人工确认后再发出。WorkBuddy 本身不解决版权归属问题。你用开源模型、网上找的 Skill、别人的提示词都要看对应的许可证和被授权范围。3. WorkBuddy 环境准备与安装在安装之前先快速检查一下自己的环境是否满足要求。操作系统方面Windows 10 / 11 和 macOS 是目前讨论中最常见的使用环境。Windows 7 有人问过能不能装但老系统要单独验证兼容性建议优先在受支持的 Windows 版本上安装减少白屏、崩溃这类问题的干扰。硬件方面如果你的使用场景只是 WorkBuddy 本体的对话、Skill 调用和 PDF 解析一台主流办公电脑就够了显卡不是必需品。如果你要接入本地大模型那就另说了后面第 7 节会展开。磁盘空间方面安装客户端本体预留几 GB 空间就够。但你要注意WorkBuddy 会把会话记录、模型缓存、临时文件写到默认目录如果系统盘空间比较紧张累计占用量会明显增长建议提前规划一个数据目录。网络方面初次安装、登录账号、下载 Skill 都需要正常联网。如果处于内网环境需要提前确认网络策略是否允许客户端访问所需服务。安装步骤WorkBuddy 目前主要是桌面客户端方式通常是从官方渠道下载安装包。不同系统的安装过程差异不大这里给一套通用流程。Windows 系统从 WorkBuddy 官方渠道下载 Windows 安装包。双击运行安装程序选择安装目录。企业办公电脑如果没权限需要联系管理员放开权限。完成安装后启动客户端使用账号登录。首次登录可能有一个初始化向导按提示走即可。登录后进入主界面找到“设置 / 关于”等入口检查当前版本状态。macOS 系统下载对应 dmg 文件。打开后把 WorkBuddy 拖入 Applications 目录。首次打开如果系统提示安全警告前往“系统设置 - 隐私与安全性”允许打开。登录账号并完成初始化检查。安装包来源这里要特别强调优先去官方渠道下载不要用来路不明的第三方整合包。AI 助手客户端要登录账号、处理本地文件渠道不正规的话数据安全风险是非常高的。4. WorkBuddy 初始化、工作台搭建与缓存目录设置安装完成后第一次启动会进入初始化流程。整个过程不需要碰命令行跟着界面操作就可以。下面把三个关键环节单独拆开讲。4.1 登录账号与基础设置登录账号后先不要急着装 Skill先把基础环境确认一遍。打开设置面板检查这几个项目账号状态是否正常、是否开启了云同步如果有、默认语言模型是否已经配置、应用缓存所在位置。这一步的目的是确认 WorkBuddy 处于一个干净的初始化状态后续出了问题也容易定位。4.2 搭建第一个工作台WorkBuddy 的工作台可以理解为“针对某类任务组织好模型、Skill、指令和数据的一整套环境”。比如你要做客服接待就建一个“客服工作台”你要做 PDF 文献整理就建一个“科研资料工作台”。两个工作台之间互不干扰切换即可。搭建工作台的核心动作有三个绑定模型、添加 Skill、写自定义指令。模型决定了 AI 的能力底座Skill 决定了 AI 能调用什么工具自定义指令决定了 AI 按什么规则干活。这三件事配置好工作台基本就成了。4.3 更改系统缓存目录这里单独讲一下因为讨论里问的人很多WorkBuddy 怎么更改系统缓存目录。默认情况下WorkBuddy 会把数据写到系统盘的用户目录下。系统盘空间紧张或者你想把数据统一放到非系统盘就需要改缓存目录。通用做法是打开客户端的设置面板搜索“缓存”“存储”“存储位置”相关选项重新指定一个目录例如 D:\WorkBuddyCache。旧缓存是否迁移看界面是否提供迁移选项有些版本会提示你复制旧目录有些需要手动移动。如果你使用的版本提供配置文件修改方式例如 JSON 或 YAML 格式可以参考下面这个示例。但必须注意不同版本的字段名不一定相同不能直接照抄要以你版本的实际配置为准。{ cache_dir: D:/WorkBuddyCache, temp_dir: D:/WorkBuddyTemp, auto_cleanup: false }修改缓存目录后建议重启一次客户端并确认新目录中开始生成文件。如果系统盘空间已经告急改完目录后还要把旧缓存清理掉避免磁盘继续占满。5. WorkBuddy Skill 功能测试以 PDF 解析为例Skill 是 WorkBuddy 的关键能力也是它区别于普通聊天机器人的地方。简单说Skill 就是“给 AI 装上某种技能包”装上之后 AI 才能处理对应类型的工作。社区讨论中经常被提到的 Skill 方向包括PDF 解析、自动签到、SSH 连接器、文字润色去 AI 味、小程序教学、科研文献整理等。这一节用 PDF 解析来做完整的功能测试。选择 PDF 解析作为首个测试项目是因为它最容易验证输入明确、输出可检查、失败原因好定位。测试步骤如下在 WorkBuddy 的 Skill 列表或 Skill 市场中搜索 PDF 相关技能安装一个评分较高的解析 Skill。准备一份测试 PDF。建议包含中英文文字和至少一个表格这样能同时验证文字提取和表格结构识别。把 PDF 放到固定目录例如 D:\test\sample.pdf。在对话输入框中给出清晰指令要求解析并输出摘要。示例输入请解析 D:/test/sample.pdf 的内容提取主要观点并用 Markdown 表格输出其中包含的关键数据。预期结果WorkBuddy 返回 PDF 的基本信息、内容摘要、关键数据表格。如果 Skill 支持还可能生成 Markdown 格式的完整转换文件。判断成功的标准中英文没有乱码表格结构可读摘要与原文观点一致输出格式符合你指定的要求。常见失败情况和排查思路PDF 提示读取失败优先检查文件路径是否拼写错误、文件是否被占用、目录是否给了 WorkBuddy 访问权限。中文乱码或者文字丢失可能是 PDF 本身包含非标准字体编码也可能是扫描件不包含可提取文字这时需要换成 OCR 类型的 Skill。大 PDF 解析慢先确认是否超时可以先把文件拆成多个小文件或者只提取指定页。从体验上看PDF 解析这类 Skill 的完成度比较高但有一个通用原则不要一上来就把几百页的 PDF 丢给 WorkBuddy 做全文解析。第一次测试先用小文件验证输出格式确认没问题后再放大文件这是所有 AI 工具测试都能用的策略。6. WorkBuddy 自定义指令、减少 AI 味与自动签到自定义指令是 WorkBuddy 工作台承上启下的配置项。Skill 让 AI 有能力干活自定义指令让 AI 知道按什么标准干活。很多用户觉得 AI 回复“一股 AI 味”问题通常出在自定义指令没写好而不是模型不够聪明。6.1 自定义指令示例客服负责人场景假如你是一个客服负责人希望用 WorkBuddy 提高客服团队的回复效率可以这样写自定义指令你是一名客服负责人助理。回答客户问题时的要求如下 1. 每个回答先给结论再给理由不要绕弯。 2. 用词克制不要堆叠“亲”“呢”“哦”“感谢您的耐心等待”等空洞话术。 3. 涉及退款、赔偿、法律条款的问题只提供处理流程说明不要代替客服承诺结果。 4. 无法确定的信息直接说明“需要人工确认”不要猜测。 5. 不要使用“首先、然后、最后、综上所述”这类固定句式。 6. 回答长度控制在 80 字以内除非客户主动要求详细说明。这段指令包含了一个减少 AI 味的关键技巧直接禁止某些高频句式同时限定回答结构和长度。如果不做这些限制AI 默认生成的回复会倾向于礼貌、冗长、什么都想沾一点这在客服场景里反而影响效率。6.2 减少 AI 味的通用写法如果你不是客服场景只是想让自己日常生成的文字不那么像 AI 写的核心原则是一样的告诉 AI 你的读者是谁。写邮件和写博客的用词完全不同不指定读者AI 会取一个平均风格。告诉 AI 不能出现什么。AI 味通常来自固定过渡词、排比句式、万能总结把这类句式列成禁止清单比说“要有文采”更有效。告诉 AI 每次输出的硬限制比如“不要超过三句话”“不要分段”“不要使用形容词堆叠”。限制越具体AI 越不容易发挥出模板味。6.3 自动签到任务的配置与合规确认自动签到是 WorkBuddy 讨论里的常见需求。这类 Skill 的运行逻辑通常是你配置好目标平台的账号信息、签到时间和要执行的步骤Skill 按计划自动运行。配置时要注意几个点确认 Skill 支持的签到平台列表不是所有平台都有人做过适配配置日期和时间粒度时要明确时区避免跑错时间首次配置后不要直接开定时先手动执行一次确认流程能走通再开启自动任务保持任务日志开启这样签到失败时能查到原因。合规层面要单独提醒自动签到是否被目标平台允许要按对应平台的规定判断。有的平台会禁止自动化脚本轻则功能受限重则账号异常。用 WorkBuddy 自动签到前必须自行确认合规性这不是工具能替你判断的事。7. WorkBuddy 本地模型接入与资源占用观察7.1 为什么要接本地模型接入本地模型是 WorkBuddy 的一个重要使用方向也是“AI 代理助手加本地模型”这个讨论组合的来源。接本地模型的好处有几点数据不出本地敏感内容的风险更可控不依赖在线服务配额离线环境也能用处理流程可以定制不会受在线模型版本更新的影响。代价也很明确本地模型对硬件有要求显存和内存不够体验会大打折扣。7.2 本地模型接入的通用做法本地模型一般通过兼容 OpenAI 接口的推理服务暴露出来例如 Ollama、LM Studio、vLLM 等。WorkBuddy 接入时的通用思路是先启动本地推理服务确认服务地址和端口能访问然后在 WorkBuddy 的模型设置中选择“本地模型 / 自定义模型”填写服务地址和模型名称最后在对话里发一条测试消息验证连通性。下面给一个通用命令示例用 curl 验证本地推理服务是否正常curl http://127.0.0.1:1234/v1/models如果返回包含模型列表的 JSON说明本地服务正常。这里的端口 1234 和路径 /v1/models 是本地推理服务的常见默认值具体要看你使用的推理服务是什么地址和端口要以你启动服务的输出为准。验证完服务后可以用 Python 发一条最短的对话请求import requests url http://127.0.0.1:1234/v1/chat/completions payload { model: your-local-model-name, messages: [{role: user, content: 你好请回复一句话说明连接正常}] } response requests.post(url, jsonpayload, timeout120) print(response.status_code) print(response.json())这段代码同样是通用模板需要按你的推理服务实际接口来调整。测试通过后再把 WorkBuddy 的模型地址指向这个服务。7.3 资源占用观察方法本地模型的资源占用需要在模型加载和推理时观察而不是只看模型文件大小。观察工具可以用任务管理器也可以在命令行里用 nvidia-sminvidia-smi也可以实时监控显存变化watch -n 1 nvidia-smi要提醒的是不同参数规模的模型显存占用差异非常大。7B、8B 级别的量化模型和 70B 甚至更大规模的模型占用不是一个数量级。第一次跑业务前建议先跑一次最小测试观察最高显存峰值和推理速度再决定模型和量化等级。别人报的显存数字只能做参考你的系统占用还要以本机实际测试为准。CPU 推理不是不能用但速度会明显慢于 GPU适合小模型或对响应时间要求不高的批量任务。接入本地模型后如果 WorkBuddy 出现响应慢、页面卡顿可以优先排查是不是推理服务的模型很大但硬件支撑不住。8. WorkBuddy 批量任务批量 PDF 解析与任务配置WorkBuddy 的实际价值在批处理场景中体现得最充分。单份 PDF 解析、单次文字润色手动操作也能做但当你面对几十份文档、几十条签到任务时重复操作的时间成本就上来了。批量任务的设计建议分成四个部分输入目录、输出目录、任务配置、日志。输入目录存放待处理文件建议每个任务单独一个文件夹不要和输出混在一起。输出目录按任务和时间组织命名带上日期方便回溯。任务配置用统一的模板文件保存这样同样的批量任务下次可以直接复用。日志必须开启记录每个文件是否成功、失败原因、耗时。批量处理配置可以学习这种结构具体字段以你的 WorkBuddy 版本支持的能力为准task_name: 2026_batch_pdf_parse input_dir: D:/input_pdfs output_dir: D:/output_markdown output_format: markdown batch_size: 5 retry_count: 3 log_file: D:/logs/workbuddy_batch.log批量任务第一次运行时建议先复制 2 到 3 个文件放进输入目录做小批量冒烟测试。确认输出格式正确、日志记录完整后再放入全量文件。这个“小批量验证 - 全量执行”的顺序看起来慢实际节省的时间最多。多账号记忆迁移也是这里要提的一个点。如果你需要在换账号后保留原来的会话记忆和 Skill 配置不要只依赖云同步先把本地数据目录完整备份。数据目录位置可以通过设置面板查看导出和导入操作看客户端是否提供对应功能。没有明确导出入口时手动备份目录是最稳妥的办法。9. WorkBuddy 常见问题与排查方法这里整理一份面向 WorkBuddy 的排查清单。表中覆盖的是公开讨论中常见的几类问题出现对应现象时按“原因 - 排查 - 解决”的路径处理。问题现象可能原因排查方式解决方案安装后白屏显卡驱动或软件渲染兼容问题、缓存损坏、网络加载异常查看客户端日志清理缓存目录关闭硬件加速选项更新显卡驱动清缓存后重启切换兼容模式登录失败网络不稳定、账号状态异常检查网络连通性确认账号可正常登录网页端重启客户端或联系账号服务支持本地模型连不上推理服务未启动、端口错误、模型名错误用 curl 验证推理服务地址和模型列表修正服务地址、端口、模型名称PDF 解析乱码PDF 字体编码异常、扫描件无文字层检查 PDF 是否扫描件查看是否可复制文字扫描件改用 OCR Skill字体问题则换解析方式自动签到未执行时间配置错误、权限不足、Skill 未激活查看任务日志手动执行一次确认流程修正定时配置授予必要权限重新激活 Skill系统盘空间不足缓存和临时文件默认写入系统盘查看设置中的缓存目录位置修改缓存目录到非系统盘并清理旧缓存CSV/Excel 输出格式不规整提示词未指定格式模型自由发挥检查输出列名和数据结构是否符合要求在指令中明确列名、分隔符和空值处理规则排查通用思路有两个先看日志再做最小化复现。遇到任何异常优先打开日志确认错误信息比自己瞎猜有效。最小化复现指用最简单的输入、最干净的环境重复一次问题能复现就能定位能定位就能修。10. WorkBuddy 最佳实践与合规建议到这里WorkBuddy 的完整流程已经走了一遍安装、初始化、工作台搭建、Skill 测试、自定义指令、本地模型接入、批量任务、问题排查。最后给出一套可以直接用的最佳实践。第一次接触 WorkBuddy先做一个最小场景验证比如单文件 PDF 解析。不要一上来就规划几十个 Skill、十几个自动化任务那样出问题了很难定位。保留一套“最小可用配置”。把模型选择、一条测试指令、一个测试 Skill 固定下来这套配置专门用来判断“是 WorkBuddy 出问题了还是我的某个 Skill 配置出问题了”。以后的每次改动都在最小配置上叠加出问题回滚也方便。目录管理要统一。模型文件、输入素材、输出结果、日志、缓存分目录存放。这里给出一个参考结构D:/WorkBuddy/ ├── cache/ # 缓存目录 ├── inputs/ # 批量任务输入 ├── outputs/ # 批量任务输出 ├── logs/ # 任务日志 ├── skills/ # 本地 Skill 或配置备份 └── backups/ # 账号数据备份批量任务必须加日志和失败重试。日志能让你知道任务跑到哪一步失败重试能让偶发网络错误不中断整个队列。没有日志的任务跑完无法验收。不用 WorkBuddy 处理未经授权的个人信息。客服场景里如果涉及真实客户数据先确认脱敏要求和使用边界再确认本地模型环境是否安全。这不是可选步骤是必须步骤。涉及人脸、声音、他人创作内容的处理必须获得明确授权。WorkBuddy 作为 AI 助手工具本身不改变版权和隐私的归属任何输出和自动化行为使用责任都在使用方。每次批量结果要人工复核。AI 工具的输出质量是概率性的不是每次都能保证正确。特别是客服回复、文章发布、报表整理这类要人看的输出发布前留出一道复核关卡。保持客户端和 Skill 更新。WorkBuddy 处于活跃迭代期新版本会修复问题、增加 Skill、调整界面。长期不更新的客户端可能出现模型接入失败、Skill 不兼容等问题。数据库和重要配置要定期备份。本地目录备份成本很低但一旦误删或换机迁移没有备份的损失会很大。11. 总结与下一步WorkBuddy 最值得尝试的点不是它又多了一个对话入口而是它把模型、Skill、自动化任务和本地工具整合在一个工作台里。你可以在里面做客服话术管理、PDF 批量解析、本地模型隐私推理、SSH 远程连接辅助、自动签到流程每个能力都有对应的实操场景。第一次接触时建议先验证三件事装好后能不能正常完成一个 PDF 解析任务能不能写好一条限制回复风格的客服自定义指令能不能接入一个本地模型并跑通一次对话。这三个能力分别对应文档处理、规则控制、私有部署是 WorkBuddy 使用中最核心的三角。最容易踩的坑有三个一是系统盘缓存不清理越用越占空间二是本地模型接入时端口和模型名配置错AI 半天无响应三是批量任务不放日志跑完不知道哪些文件成功了、哪些失败了。绕开这三个坑WorkBuddy 的体验会有明显提升。后续值得探索的方向包括把 WorkBuddy 和 CodeBuddy 配合使用一个处理日常工作一个辅助编码在稳定的批量任务基础上做定时全自动流程用自定义指令逐步积累属于自己团队的管理话术库以及把本地模型和在线模型按敏感程度分场景使用。这几个方向都建立在同一个基础上先把 WorkBuddy 的安装、Skill、指令、日志这一套基本功练熟。工具本身不复杂复杂的是把 AI 放进真实工作流里还能保持可控。从最小场景开始配好自定义指令做好数据备份和合规确认WorkBuddy 就是一个能真正帮你省时间的 AI 助手而不是又一个吃灰的聊天窗口。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进