下载、安装和登录只证明客户端能打开，不证明它已经具备安全完成任务的条件。本教程把入门拆成五个可验收关卡：设备支持、安装包正确、官方域名登录、版本可追踪、固定首次任务通过。
版本与验证范围： 本页于 2026-09-09 核读 WorkBuddy 5.5.3 更新日志以及当前 Windows、Mac、首次任务和常见问题文档。本站没有在你的设备上安装或登录 WorkBuddy；按钮、版本和执行结果必须记录为你的实际观察。
下载两个练习文件
新建一个 workbuddy-entry-lab 文件夹，把输入文件放在根目录，再新建空的 output 子目录。练习目录不放真实客户、合同、邮箱导出或生产代码。
workbuddy-entry-lab/
├── workbuddy-first-task-source.md
└── output/先计算输入文件 SHA-256 并写入验收表：
# macOS
shasum -a 256 workbuddy-first-task-source.md
# Windows PowerShell
Get-FileHash .\workbuddy-first-task-source.md -Algorithm SHA256第一关：确认设备是否受支持
根据 2026-09-09 官方安装文档：
| 设备 | 官方最低要求 | 安装包选择 | 当前边界 |
|---|---|---|---|
| Windows x64 | Windows 10 及以上 | Windows 安装包 | Windows 7 / 8 / 8.1 不支持 |
| Windows 11 ARM64 | — | — | 官方 FAQ 标为当前不支持 |
| Apple Silicon Mac | macOS 12 Monterey 及以上 | Mac ARM64 | 也可用 X64 + Rosetta，但优先原生包 |
| Intel Mac | macOS 12 Monterey 及以上 | Mac X64 | ARM64 包不能运行 |
在 Mac 点击左上角苹果图标 → “关于本机”，记录系统和芯片；Windows 在“设置 → 系统 → 系统信息”记录版本与系统类型。条件不满足就停止，不用通过关闭系统安全机制强行安装。
第二关：从官方入口下载
- 手动进入
https://www.workbuddy.cn/，从官网的 WorkBuddy 下载入口选择当前设备。 - 在验收表记录最终下载页 URL、文件名和架构。
- 如果搜索结果、广告或第三方文章直接提供安装包，不从那里下载。
- Mac 官网无法识别设备时可能默认给出 X64；回到上一关自行核对芯片。
本教程不提供安装包镜像，也不记录一个容易过时的固定文件名。判断依据是下载来源、设备架构和安装后显示的版本三者相符。
第三关：按系统安装
Windows 10 / 11 x64
- 双击官方安装包，阅读并同意安装协议。
- 选择安装路径和开始菜单文件夹；需要时创建桌面快捷方式。
- 官方首次任务文档建议选择“仅为我安装”。共享电脑上尤其要先确认安装用户。
- 确认配置后安装，完成后退出向导并启动 WorkBuddy。
- 若系统或安全软件拦截，先记录提示原文并核对来源，不直接选择绕过。
macOS 12 及以上
- 打开官方
.dmg。 - 把 WorkBuddy 拖入
Applications。 - 等待复制完成，推出磁盘映像；确认不再需要后再删除下载的
.dmg。 - 从启动台或
Command + 空格搜索 WorkBuddy 并打开。 - 若 macOS 阻止启动，在“隐私与安全性”核对来源和提示；不关闭 Gatekeeper 等整体安全能力。
安装通过证据： WorkBuddy 位于预期应用目录，能启动到自己的登录入口；这一步还不授予整个磁盘、邮箱或第三方文档权限。
第四关：只在官方域名完成登录
官方 Windows 与 Mac 文档描述的当前流程一致：在客户端点击登录，默认浏览器打开 workbuddy.cn 登录页；同意服务协议和隐私政策后，可使用微信扫码，也支持手机号、邮箱和 SSO，成功后自动返回客户端。
逐项检查：
- 浏览器地址栏的主机名是
workbuddy.cn或其子域，不只看页面 Logo。 - 选择个人或所属企业提供的登录方式，不把验证码发给教程作者或所谓客服。
- 浏览器完成后能够回到客户端。
- 首次实验不连接邮箱、腾讯文档、IM 或其他外部服务。
如果点击登录没有打开页面，先确认系统已设置默认浏览器。官方 FAQ 建议 Windows 使用默认 Chrome，Mac 使用 Chrome 或 Safari后重启应用再试。记录真实错误，不连续重装不同来源的安装包。
第五关：记录版本并检查更新
在左侧底部头像或个人中心菜单找到“检查更新”。Windows 与 Mac 官方文档都说明该入口会检测版本，并在存在新版本时下载和升级。
本教程核读时最新日志版本为 5.5.3。你应记录安装当天显示的真实版本；如果官方已经发布更新版本，以更新日志为准，不为了匹配教程去降级。
更新前先做两件事：
- 把重要产物复制到 WorkBuddy 应用安装目录之外；
- 结束正在执行的任务，保留版本、错误和文件位置记录。
官方 FAQ 特别提示，安装目录更新或重装时可能被清空。用户项目和重要文件不应存放在应用程序本体目录中。
第六关：完成固定首次任务
在 WorkBuddy 新建普通 PC 任务，工作区只选择 workbuddy-entry-lab。先要求它复述边界：只读一个输入，只写 output/kestrel-summary.md，不联网，不修改源文件；边界无误后再执行。
可复制下面的提示词：
只读取工作区根目录的 workbuddy-first-task-source.md，不联网，不修改输入文件。
先列出你将读取和写入的路径；边界不一致就停下等待确认。
然后按文件中的“首次任务目标”生成 output/kestrel-summary.md。
不要补充材料没有提供的预算、客户或最终发布日期。
完成后报告实际读取文件、实际生成文件和未完成项。官方首次任务文档说明，目标文件可在右侧“产物”中找到，任务生成的其他文件可在“概览 → 工作空间文件”查看。两处都要实际打开核对，不以聊天框里的“已完成”作为通过证据。
执行后再次计算输入文件哈希。只有前后 SHA-256 相同，才能证明这次实验没有修改输入。再按验收表检查：
- 项目代号必须是 Kestrel；
2026-09-18必须写成候选日期；- 负责人是林舟；
- 桌面端冒烟测试是发布前待办；
- 阻塞项是 Windows 11 ARM64 兼容性复核；
- 预算、客户和最终日期必须写“材料未提供”。
任何一项事实错误、输入哈希变化、输出写到工作区之外或凭空增加信息，都记为失败。先保留现场，再缩小提示或工作区重新测试。
安装、登录或执行失败时收集证据
不要只写“打不开”。至少保存系统版本、芯片、WorkBuddy 版本、发生时间、操作步骤和错误原文。
官方 FAQ 提供“帮助 → 诊断工具”，可检查网络、系统资源、安全软件、环境和崩溃日志，并导出诊断报告；个人账号与海外版可能只显示网络分组。客户端也提供打开日志目录的入口。日志可能含对话和设备信息，分享前自行检查并按官方隐私说明处理。
| 现象 | 先验证 | 升级为故障证据 |
|---|---|---|
| 点击登录无反应 | 默认浏览器、系统时间、网络 | 登录时间、浏览器、错误原文、诊断报告 |
| 登录后未回客户端 | 地址栏域名、是否取消登录 | 客户端版本、浏览器结果、日志 |
| 更新失败 | 磁盘空间、是否把项目放在安装目录 | 旧/新版本、安装路径、更新错误 |
| 文件打不开 | 提示是否明确指定 Markdown | 文件名、大小、产物位置、错误原文 |
| 输出事实错误 | 是否只读固定材料 | 输入哈希、提示词、实际输出 |
官方 FAQ 公开了 workbuddy@tencent.com 作为未解决问题的咨询渠道，也提供客户端意见反馈入口。提交前优先附诊断报告和可复现步骤，同时删除与问题无关的敏感材料。
最终通过标准
- 设备满足官方系统与架构要求，安装包来自 WorkBuddy 官方入口。
- 登录发生在
workbuddy.cn，成功返回客户端。 - 验收表记录了真实版本和检查更新结果。
- 工作区只包含固定练习，未连接第三方服务。
output/kestrel-summary.md六项事实全部通过。- 输入文件执行前后 SHA-256 相同。
- 目标文件和其他文件的位置都经过实际检查。
- 未执行的项目写“未验证”，失败保留错误、诊断和日志证据。
完成这些关卡，才算建立了可复现的 WorkBuddy 入门基线。下一课再认识任务、工作区、右侧栏和产物位置；不要在同一轮实验里追加真实文件、连接器或自动化。