WorkBuddy Hy3与Hy4内核对比：从选型到切换回滚的完整指南

最近不管是在 WorkBuddy 的官方社区还是各个用户群里，问得最频繁的问题几乎都是同一个：Hy3 和 Hy4 到底差在哪，我现在应该用哪个？作为一个从 Hy3 时代就开始折腾 WorkBuddy 的老用户，我觉得这个问题没有大家想的那么复杂。简单来说，Hy3 是目前默认搭载的稳定内核，而 Hy4 是新一代推理内核的预览版，两者的差异集中在任务理解、工具调用和多模态处理这几块。今天我就把这两套内核掰开揉碎，用普通用户能听懂的方式把差别讲清楚，最后附上我实际验证过的切换步骤和回滚方案。

这篇内容主要写给三类人看：刚认识 WorkBuddy 的新手，想知道自己到底该用哪个版本；已经在用 Hy3、但天天看社区里讨论 Hy4 心里痒痒的老用户；以及做本地部署时纠结硬件配置和运行稳定性的朋友。如果你是追求效率的普通上班族，看完这篇基本就能做出判断了。

1. Hy3 和 Hy4 到底是什么？先把对比对象搞清楚

1.1 WorkBuddy 里的“内核”是怎么工作的

要聊 Hy3 和 Hy4，得先明白 WorkBuddy 这个产品的基本结构。它本质上是一个“智能体工作台”，你可以在里面定义角色、挂载 Skill、接入各种工具，然后通过对话的方式让它帮你写文档、整理资料、写代码、做定时任务等等。而这些能力并不是 WorkBuddy 自身凭空产生的，它背后要依赖一个大模型来“思考”，这个模型在 WorkBuddy 里被称作内核。

可以这么理解：WorkBuddy 是一辆车的整车框架，Hy3 和 Hy4 就是装在这辆车里的发动机。发动机不一样，整辆车的加速、油耗、稳定性自然也不一样。而且 WorkBuddy 比较灵活，它允许你在多个模型之间自由切换，甚至可以接入其他第三方模型，所以 Hy3 和 Hy4 只是其中两个官方提供的“原厂方案”。

我刚接触 WorkBuddy 的时候，其实完全没有意识到版本问题，因为默认装好的就是 Hy3，日常整理笔记、查资料，用起来平平顺顺的。直到后来社区里开始出现“Hy4 preview”的截图，大家讨论的重点从“要不要装”逐步变成了“装了之后真香还是踩坑”，我才专门花了一个周末去对比测试。这里先给个结论：Hy3 走的是稳定成熟路线，Hy4 则明显带有“新技术尝鲜”的属性，不是一个维度的选型。

1.2 Hy3 和 Hy4 在架构层面的核心差异

这两代内核最本质的差别不在于“多了几个功能”，而在于它们设计时的思考方式完全不一样。

Hy3 采用的是传统的大语言模型任务执行模式。当你给它一个指令，它会按照比较直接的方式去生成对应的文本或调用已定义好的工具，整个过程是线性的，指令越多、步骤越复杂，它就越容易在中间环节丢失上下文。我实测下来，Hy3 应对单轮问答、写文案、总结摘要这类任务非常稳，回答速度也快，基本上没有废话。但如果你想让它“先打开某个文件，提取其中的表格，再根据表格生成一份分析报告”，它就需要你提前把这些步骤拆得很细，否则很容易做一步就停下来等你。

Hy4 在设计上更像是奔着“全能型智能体”去的。它的核心变化是强化了推理链和任务规划能力，官方把它叫做推理与规划一次完成。这意味着你丢给它一个模糊的、多步骤的目标，它不会急着开口回答，而是会先在心里把任务拆解成若干个子目标，然后逐步去执行、验证、回传结果。我在测试中让它处理“把本周所有会议纪要整理成一份周报，并按优先级排序”这样的任务，Hy4 会先扫描文档目录、提取各份纪要去重、再按紧急程度排序，整个流程不需要我干预，这一点是 Hy3 做不到的。

另外，Hy4 的上下文窗口也比 Hy3 大不少。通俗讲，上下文窗口就是模型“短时记忆”的容量，窗口越大，它能一次性处理的长文档、多轮对话就越多。这对需要连续喂入大量资料的场景特别关键，比如你让它基于一本 PDF 做深度问答，Hy3 可能要分几次喂，而 Hy4 可以直接吞进去。但注意，越大的上下文窗口对计算资源的消耗也成倍增加，这正是后面要聊硬件配置的原因。

2. 功能差异拆解：普通用户真正能感知到的变化

2.1 指令理解与多步任务规划：从“单一执行”到“自动拆解”

我刚提到，Hy4 最大的卖点是任务规划。这一个差异在真实使用中带来非常明显的体验变化。拿我自己举例子，以前用 Hy3 的时候，我养成了一个坏习惯：把指令写得很长、很细。比如“请把 notes 目录下的 2024 年 Q4 报告.docx 打开，提取第三页的表格，转成 CSV，然后发送到钉钉群”，这类指令在 Hy3 下是必须的，因为它更像一个听命令办事的工具人，你少一个条件，它就会原地卡住。

切到 Hy4 之后，我开始尝试用自然语言“偷懒”。我直接说“帮我把上周的日报汇总一下，按完成情况排个序，挑出三个最值得在周会上讲的事情”，它会自动判断做哪些步骤：遍历日报文件、提取关键信息、排序、生成摘要，甚至连“最值得讲”这种模糊标准，它也会根据完成度、影响范围做一个基础的推断。虽然它的推断不一定每次都完美，但至少能跑通，这对不想把工作台当“编程工具”来用的普通用户非常友好。

我觉得对普通用户来说，这个变化才是 Hy4 最核心的价值：你不必再把自己变成一个会写“提示词模板”的技术专家，只要把目标说清楚，它自己会规划路径。这也是为什么我把 Hy4 定位成更适合“效率型用户”的原因。

2.2 代码与多媒体能力的升级

第二个感知明显的差异在代码生成和多模态处理上。Hy3 其实也能写代码，但更适合一些短小的脚本，比如“写一个 Python 脚本，把文件夹里的图片尺寸批量改小”。它对逻辑简单、依赖少的小任务处理得很好。可一旦面对稍微复杂的项目级任务，比如“构建一个 Flask 接口，对接数据库并能做用户认证”，Hy3 的生成代码经常会有低级错误，变量命名混乱，甚至出现接口不匹配。

Hy4 在代码生成上的提升相对明显，它更擅长先梳理项目结构，然后把功能模块拆开生成，同时会在你追问的时候附上运行注意事项和测试用例。我在几个实际项目里用 Hy4 写的爬虫脚本、数据清洗脚本，基本是“跑起来就能用”，不需要反复修错。

而“2D 转 3D”这类多模态功能，可以说是 Hy4 preview 阶段的标志性卖点。Hy3 不支持这种能力，你需要额外接第三方模型才能完成。Hy4 则直接内置了基础的 2D 图片转 3D 模型能力，对搞设计、做三维可视化的朋友非常实用。我自己不是专业设计师，但试着把几张户型图丢进去生成简单的 3D 预览，效果足够做方案沟通了。如果你平时工作涉及 CAD、三维展示或者游戏素材预制作，Hy4 的这一块能力会明显改变你的流程。

2.3 Skill 与自定义指令：版本兼容性不能只看表面

WorkBuddy 的一大特色就是支持 Skill 机制。你可以把常用的指令、工具调用流程、提示词模板打包成一个 Skill，用的时候一键调用，省去重复输入的麻烦。这也是社区里“workbuddy skill”“自定义指令推荐”这些词热度一直很高的原因。

兼容性问题是切换版本时最容易踩坑的一个点：很多用户发现，在 Hy3 上正常使用的 Skill，切到 Hy4 之后“变笨了”甚至直接不显示。原因其实不复杂，Hy3 时代的 Skill 是基于旧版工具调用语法写的，而 Hy4 改成了一套更灵活但也更严格的 Skill 描述方式。旧语法在 Hy4 下能被识别，但在复杂任务中可能丢失部分功能参数，所以你才会感觉“好像能用，又好像哪里不对劲”。

我的建议是：如果你在社区里下载了别人分享的 Skill，先看一下发布时间和标注的内核版本。如果是旧版 Skill，切到 Hy4 后最好逐个验证一次。如果是自己写的 Skill，可以参照官方升级指南把指令描述改成“意图、输入、输出、约束”这类结构化格式，这样在两代内核下都能稳定运行。总结一句话：版本升级不只是内核下载，Skill 生态也要跟着更新。

3. 普通用户怎么选：从使用场景出发做决定

3.1 先看你的日常任务类型

选 Hy3 还是 Hy4，最粗暴的判断标准就是：你平时拿 WorkBuddy 干什么。我把常见的使用场景分成了两类，列个表可能会更清楚。

上面这个表基本概括了主力场景。如果你的日常工作停留在“文字处理 + 文档整理”，Hy3 完全够用，而且长期运行更省心。反过来，如果你希望 WorkBuddy 能像一个真正的助理替你跑流程，而不是只有当个“高级问答机器”，那 Hy4 的高规划能力绝对值得你折腾一次。

3.2 再看硬件和部署方式

关于硬件，这里必须多说两句。WorkBuddy 支持云服务和本地部署两种用法，如果你用云端版，那么模型跑在服务器上，你的电脑压力不大，随便切版本都行。但如果你像我一样喜欢把 WorkBuddy 部署在本地跑，那 Hy4 对硬件的要求就要认真对待了。

我实测过，同一台 16GB 内存的笔记本电脑上，Hy3 跑一个多轮对话加上文档处理，内存占用大概能控制在 4GB 以内，CPU 偶尔满载但能恢复。换成 Hy4 之后，内存占用几乎翻倍，尤其是在处理长文档、并发任务时，风扇基本上全程高速运转。如果你用的是 8GB 内存的机器，本地跑 Hy4 会明显感觉到卡顿，甚至在执行复杂任务时直接 OOM——内存不够，进程被杀掉。这种情况下，我劝你老老实实留在 Hy3，或者用云端版承载 Hy4。

顺带一提，Hy4 对显卡也有一点要求。虽然官方说是 CPU 也能跑，但实测下来，同样的任务在带独立显卡的机器上推理速度能快 40% 以上。如果你希望 Hy4 有日常可用的体验，至少得有一块 4GB 显存以上的显卡，否则你会被漫长的等待耗尽耐心。

3.3 稳定性优先还是新功能优先

说到底，这就是一个“稳定派”和“尝鲜派”之间的选择。我的态度一直很明确：主力工作别拿自己当小白鼠。Hy4 现在仍然处于 preview 阶段，功能很有吸引力，但偶尔会有一些小毛病，比如对话历史混乱、Skill 触发不准确、极少数情况下回答内容“偏题”。这些在生产环境里都可能是麻烦事。

如果你决定把 WorkBuddy 纳入日常核心工作流，比如每天用它生成报告、管理日程、同步多维表格，建议选择 Hy3 作为默认内核，然后把 Hy4 当成一个“第二工作区”来试玩。等 Hy4 推出正式版，社区反馈稳定之后再切换，成本并不高。反过来，如果你就是喜欢新功能，愿意接受偶发的小问题，那直接用 Hy4 也完全没问题，毕竟它的效率上限确实高出不少。

4. 从 Hy3 切换到 Hy4：完整步骤与避坑指南

4.1 切换前要做的 4 件准备

版本切换听起来就是点一下按钮的事，但为了避免切完之后手忙脚乱，我还是建议按下面几个步骤做一下准备。这些点都是我踩过坑之后总结出来的。

第一，确认当前版本信息。打开 WorkBuddy 的“设置-关于”，查看当前内核版本号，同时记录一下你正在使用的插件和 Skill 清单。这一步很重要，万一切换后出问题，你至少知道自己原来有哪些组件需要恢复。

第二，备份自定义指令和 Skill。WorkBuddy 里写的自定义指令、Skill 配置文件，本质上都是一些本地文件或数据库记录。在设置里找到“导出配置”或“备份数据”功能，把整个配置目录复制一份存到其他位置。宁可背着用不到的备份，也不要等到丢配置的时候拍大腿。

第三，检查网络连接和磁盘空间。Hy4 内核的安装包体积比 Hy3 大不少，尤其在本地部署模式下，下载和更新耗时可能长达十几分钟，磁盘剩余空间至少要预留 10GB。如果你处于离线环境，提前把 Hy4 的离线安装包准备好。

第四，阅读更新日志。WorkBuddy 在切换版本时通常会展示该版本的变更说明，别急着点“确认”，花两分钟扫一眼有没有破坏性变更。比如某个版本更新后，旧版 Skill 语法不再兼容，这类信息都会在更新日志中标注。

4.2 切换操作详解

准备工作做足之后，正式的切换流程其实不长。以 WorkBuddy 桌面客户端为例，整个流程大致如下：

第一步，打开主面板，点击左下角的设置图标，进入“模型”或者“内核管理”页面。不同版本界面文字会略有不同，但入口基本都在设置一级菜单里。

第二步，在模型列表中找到 Hy4，点击“切换”或“下载”。如果客户端里没有 Hy4 选项，先去官网下载最新的 WorkBuddy 版本，预览版通常只在较新的客户端中开放入口。

第三步，等待 Hy4 内核下载并校验完成。这时候不要强制关闭客户端，否则下载包损坏会导致安装失败。下载完成后客户端会提示重启生效。

第四步，重启 WorkBuddy，重启后在“设置-关于”里确认当前内核已经变成 Hy4。然后随便发一条消息，确认基本对话功能正常。最后再逐个调用你常用的 Skill，确认插件也能正常加载。

如果你是命令行爱好者，用的是 Linux 或本地部署版本，流程也类似：在 WorkBuddy 安装目录下，找到配置文件config.yaml，把model_engine字段的值从hy3改成hy4-preview，保存后重启服务即可。改之前记得备份原配置文件，改完以后用workbuddy doctor这个自检命令检查环境是否正常。

4.3 切换后需要立刻检查的三件事

切换到 Hy4 之后，大部分人都会觉得“好像没有太大变化”，这很正常，因为如果你只是简单问答，两者差别本来就不明显。要验证 Hy4 是否真正生效、是否处于健康状态，我建议重点检查以下三件事。

一是自定义指令是否生效。找一条你已经习惯的指令模板，原样发给它，看输出格式和风格与 Hy3 时代是否一致。如果输出说明性文字变多了，多半是你的指令描述被 Hy4 误解了，可以考虑按新版 Skill 语法稍微改写。

二是工具权限是否正常。WorkBuddy 连接钉钉、多维表格、文件系统这些外部工具时，通常需要授权 token。切换内核后，这些 token 理论上不会丢失，但有概率因为通信协议升级而导致连接失效。建议主动触发一次“发送测试消息”或“读取某个文件”操作，确认工具链路通畅。

三是对话历史的连续性。Hy4 的上下文管理机制和 Hy3 不完全一样，如果发现之前的对话记录在新版下加载不完整，可以在设置里清空旧缓存，让会话以全新状态开始。这种情况不是数据丢了，只是新旧格式不兼容，重新开始一段对话就行。

4.4 从 Hy4 回滚到 Hy3

即使做了充分准备，也难免有人切换后遇到无法忍受的问题。别慌，回滚方案我一直保留着，这里也分享出来。

回滚最直接的方式是回到设置里的“模型”页面，重新选择 Hy3 并点击“切换”。WorkBuddy 会保留旧版本的内核文件，所以不需要重新下载，切换速度很快。如果你在 Hy4 下调整过 Skill 或自定义指令，并且这些改动影响了稳定运行，建议直接使用之前导出的备份配置进行恢复，而不是手动逐条撤销。

还有一种情况：Hy4 运行中导致客户端频繁崩溃，你根本进不了设置页面。这时候可以彻底退出 WorkBuddy，然后在本地找到安装目录下的models文件夹，删除或重命名hy4-preview子目录，再重启客户端，它会自动回落到默认的 Hy3 内核。这个方法在 Windows、macOS 和 Linux 上原理都一样，只是目录路径略有差异。实在找不到目录的，直接卸载重装，然后用备份配置恢复即可。

5. 常见问题与排查技巧实录

5.1 问题速查表

把这段时间在社区和实践中遇到的问题整理成了一张速查表，希望能帮你少走弯路。

5.2 一些值得留意的“非显性”问题

除了表格里的常见问题，有两个隐性坑我必须单独拿出来说，因为它们不太容易定位。

第一个是“多轮对话逐渐变傻”。Hy4 在连续对话几十轮之后，偶尔会忘记任务最初的目标，回答突然偏向“模板化”。这不是模型损坏，而是上下文被大量中间内容占满，注意力分散了。解决办法很简单：遇到这种情况就开启一个新的对话，把关键信息重新陈述一遍，让它在干净的状态下重新规划。别指望一条对话跑到底。

第二个是“本地端口被占用导致内核连不上”。如果你用的是本地部署版本，WorkBuddy 默认会监听某个本地端口提供服务。Hy4 会额外启动一个推理服务进程，如果这个端口被其他程序占用，客户端会提示“连接失败”或者“模型未响应”。遇到这种情况，先去检查端口占用，把冲突进程关闭或者更改 WorkBuddy 的监听端口，然后重启服务。这个问题很容易被当成“版本没切成功”，实际跟切换操作完全无关。

5.3 我对版本选择的一个临时结论

基于这段时间的使用体验，我个人的建议是：日常办公、资料整理、写点东西，留在 Hy3 非常稳妥，它不会给你惹麻烦，响应速度也足够快。如果你想尝试更智能的自动化任务、做代码项目，或者对 2D 转 3D 这类新玩感兴趣，那就切到 Hy4，但要抱着体验的心态，重要工作最好在本地留一个可回滚的 Hy3 环境。

我在实际测试中验证过一个很实际的场景：把同一个“每日工作总结自动生成 + 发送到钉钉群”的流程分别在 Hy3 和 Hy4 下跑了一遍。Hy3 需要我在 Skill 里把每个步骤写死，一旦日期格式变了就报错；Hy4 则能根据文件里的实际日期自动适配，效率高了很多。也因为这一点，我现在把所有带“自动化联动”的任务都移到了 Hy4 上，而平时的问答和文档处理继续留在 Hy3 上。两套内核并行用，不受累也不掉队。

最后再分享一个我自己的习惯：每周五下午会花十分钟做一次“内核自检”。检查系统有没有最新更新、每个 Skill 是否正常加载、最近一周有没有频繁报错。工具是拿来提升效率的，不是拿来折腾自己的。希望这篇文章能帮你在 Hy3 和 Hy4 之间找到最适合自己的答案。