WorkBuddy 接入 DeepSeek :Windows/macOS 安装、模型配置与文件自动化

WorkBuddy 接入 DeepSeek :Windows/macOS 安装、模型配置与文件自动化 关注 霍格沃兹软件测试开发 公众号回复「资料」, 领取人工智能测试开发技术合集过去一年大模型已经进入开发、测试、运维、数据分析等技术工作但很多人的使用方式仍然停留在复制文件内容 → 粘贴到大模型 → 等待回答 → 复制生成结果 → 再回到本地修改和保存看似使用了 AI真正自动化的往往只有“生成内容”这一步。WorkBuddy 的定位并不是另一个聊天窗口而是一套桌面 AI Agent 工作台它可以理解任务、规划步骤、读取指定工作空间、调用技能和工具并最终交付文档、表格、图表、代码或 HTML 报告。本文以接入 DeepSeek 为例完整介绍Windows 与 macOS 的安装差异WorkBuddy 的界面和工作模式DeepSeek API 配置方法Windows/macOS 下的接口验证文件自动整理与数据分析实操IT 从业者需要注意的权限、密钥和成本问题一、Windows版和macOS版安装有区别吗有区别但区别主要集中在安装阶段。Windows 与 macOS 在以下方面不同对比项WindowsmacOS系统要求Windows 10及以上macOS 12及以上安装包Windows x64安装程序.dmg磁盘映像芯片选择官网提供Windows x64版本并标注兼容ARM64Apple芯片选Mac ARM64Intel芯片选Mac X64安装方式运行安装向导可选择安装路径和快捷方式将应用拖入Applications文件夹文件路径C:\Users\用户名\.../Users/用户名/...终端环境PowerShell或CMDTerminal、zsh或bash登录成功后两端的主要功能、模型配置、Craft/Ask/Plan 工作模式、工作空间管理和任务执行流程基本一致。因此安装部分需要分别介绍后续操作没有必要重复写两遍。二、下载WorkBuddy进入 WorkBuddy 官网点击下载按钮可以看到不同平台的安装包。image下载时按设备选择Windows电脑 Windows x64 苹果M系列芯片 Mac ARM64 Intel芯片Mac Mac X64Mac 用户可以点击左上角苹果图标进入“关于本机”查看自己的芯片类型。官方安装指南明确区分了 Apple 芯片与 Intel 芯片版本。([CodeBuddy][3])三、Windows版安装步骤WorkBuddy 的 Windows 版本要求 Windows 10 及以上不支持 Windows 7、Windows 8 和 Windows 8.1。第一步运行安装程序下载完成后进入“下载”目录双击 WorkBuddy 安装程序。image安装向导会依次要求用户阅读并同意软件协议选择安装目录设置开始菜单文件夹选择是否创建桌面快捷方式确认并开始安装第二步选择安装目录Windows 版允许自定义安装路径。第三步完成安装并登录安装完成后启动 WorkBuddy勾选服务条款与隐私协议使用微信扫码登录。登录完成后客户端会自动进入主界面。四、macOS版安装步骤macOS 版本要求 macOS 12 Monterey 及以上。第一步打开DMG安装包下载完成后双击.dmg文件。第二步拖入Applications在弹出的窗口中将 WorkBuddy 图标拖入 Applications 文件夹。等待复制完成后即可推出已挂载的磁盘映像并删除下载目录中的.dmg文件。第三步启动和登录可以通过以下两种方式启动启动台 → WorkBuddy 或者 Command 空格 → 输入 WorkBuddy → 回车点击登录后系统会打开浏览器登录页面。完成微信扫码后会自动返回客户端。([CodeBuddy][3])五、登录后的界面是否一样Windows 和 macOS 登录后的核心界面与使用逻辑基本一致。下面以 macOS 界面为例。主要区域可以分为三部分。1. 左侧功能区常见入口包括新建任务Claw专家技能连接器或插件自动化2. 中间任务区主要用于输入任务上传或引用文件选择工作模式选择大模型启用技能设置权限指定工作空间3. 执行与结果区Agent 开始工作后会在任务区域展示执行计划工具调用过程文件变更中间结果最终交付物WorkBuddy 支持为不同任务建立独立工作空间和上下文也支持多个任务并行执行。六、第一次使用先建立隔离工作空间WorkBuddy 能读取和修改本地文件。这也是它比普通 AI 对话工具更实用、同时风险更高的地方。不建议第一次使用就把以下目录直接交给 Agent整个用户目录 公司完整代码仓库 生产环境配置目录 SSH密钥目录 云平台配置目录 浏览器用户数据目录 财务和客户资料目录更稳妥的方式是先建立一个专门的测试工作空间。Windows PowerShellNew-Item -ItemType Directory -Force $HOME\WorkBuddyWorkspace\input, $HOME\WorkBuddyWorkspace\output, $HOME\WorkBuddyWorkspace\backup最终目录类似C:\Users\你的用户名\WorkBuddyWorkspace ├── input ├── output └── backupmacOS终端mkdir -p ~/WorkBuddyWorkspace/input mkdir -p ~/WorkBuddyWorkspace/output mkdir -p ~/WorkBuddyWorkspace/backup最终目录类似/Users/你的用户名/WorkBuddyWorkspace ├── input ├── output └── backup其中input保存原始材料output保存 AI 生成结果backup保存操作前备份WorkBuddy 官方也建议按照任务类型分别建立工作空间以减少误操作风险。Windows 和 Mac 只是路径格式不同通过文件选择器选中目标目录即可无需手动输入完整路径。七、Ask、Plan、Craft三种模式怎么选WorkBuddy 提供三种核心工作模式问一问 Ask想一想 Plan做一做 Craft三种模式的关键差异不是模型能力而是执行权限和工作方式。Ask读取与分析Ask 模式主要用于查询和信息查看不修改文件。适合阅读需求文档分析代码结构查询日志总结测试报告了解一个陌生目录检查数据质量第一次打开一个陌生项目时建议先使用 Ask。官方文档同样建议首次使用优先选择该模式。示例请只读取当前工作空间不要创建、删除、移动或修改任何文件。 请完成以下分析 1. 输出目录结构 2. 说明每类文件的用途 3. 识别疑似重复文件 4. 识别命名不规范的文件 5. 给出整理建议 6. 输出拟执行的操作清单但不要真正执行。Plan先制定计划Plan 模式会先输出执行计划等待确认后再操作。适合项目重构数据迁移回归测试规划批量文件处理多步骤数据分析复杂报告生成示例请分析当前项目并制定一份完整的回归测试计划。 计划至少包含 1. 项目模块识别 2. 核心业务链路 3. 已有测试资产 4. 回归范围 5. 自动化脚本执行顺序 6. 高风险模块 7. 测试数据准备 8. 最终交付物。 当前阶段只输出计划不要运行命令不要修改文件。Craft执行具体任务Craft 模式可以直接执行操作包括创建或修改文件执行命令整理目录生成代码清洗数据输出 HTML、Markdown、Excel 等文件对于重要任务更推荐下面的流程Ask先了解现状 ↓ Plan生成执行方案 ↓ 人工确认 ↓ Craft执行具体操作 ↓ Verify人工验收结果而不是一上来就将整个项目交给 Craft。八、接入DeepSeek前先澄清两个概念1. 接入DeepSeek不等于本地部署模型在 WorkBuddy 中填写 DeepSeek API Key本质上的调用链路是WorkBuddy客户端 ↓ DeepSeek API ↓ DeepSeek云端模型模型并没有运行在本机也不会因为配置了 API Key 就变成“本地大模型”。更准确的表述是在 WorkBuddy 中接入自己的 DeepSeek API。只有通过 Ollama、LM Studio、llama.cpp、vLLM 等工具把模型权重真正运行在本机或内网服务器上才属于严格意义上的本地部署。2. 接入API也不等于无限免费DeepSeek API 会按照输入和输出 Token 数量计费。当前官方模型包括deepseek-v4-flash deepseek-v4-pro其中 Flash 更强调速度和成本Pro 更适合复杂任务。旧模型名deepseek-chat和deepseek-reasoner已于 2026 年 7 月24日停止作为主要模型名使用。因此视频中的“充值1元就能无限使用”并不准确。更严谨的说法是配置自己的 DeepSeek API 后可以使用自己的模型账户和余额但实际成本仍由任务长度、文件数量、上下文大小、执行轮次和模型类型决定。DeepSeek 官方会根据模型输入和输出 Token 数量扣费价格也可能后续调整。九、通过界面配置DeepSeek当前 WorkBuddy 已经支持可视化模型配置不需要用户手工编辑 JSON 文件。配置参数会保存在本地模型配置中。选择标准模型提供商时接口地址、模型列表和部分能力标记可以自动填充。第一步进入设置点击左下角头像在弹出的菜单中选择“设置”。第二步进入模型管理在设置菜单中选择“模型”然后点击“添加模型”。第三步选择DeepSeek在提供商列表中选择深度求索 / DeepSeekimage如果客户端版本中没有预置 DeepSeek也可以选择自定义 / Custom然后按照 OpenAI 兼容协议填写接口。第四步填写API Key和模型通过 DeepSeek 官方开放平台创建 API Key。配置时主要需要关注API Base URL https://api.deepseek.com Chat Completions接口 https://api.deepseek.com/v1/chat/completions 模型 deepseek-v4-flash 或者 deepseek-v4-proDeepSeek 官方确认 WorkBuddy 可以通过 OpenAI 兼容的 Chat Completions API 接入 V4 Flash 和 V4 Pro。([DeepSeek API Docs][7])对于一般办公和技术资料处理可以优先选择deepseek-v4-flash适合文档总结文件分类信息抽取日常问答普通数据分析简单脚本生成对于复杂代码分析、多步骤规划和长链路 Agent 任务可以选择deepseek-v4-pro第五步保存并选择模型保存配置后返回新建任务页面在模型选择器中找到刚刚添加的 DeepSeek 模型。Windows 和 macOS 的这部分操作基本相同不需要分别配置。十、在WorkBuddy外验证DeepSeek接口配置完成后不建议直接在 WorkBuddy 中反复尝试。先通过终端验证以下内容API Key 是否正确DeepSeek 账户是否可用网络是否正常模型名称是否正确接口是否能够返回结果这样可以快速判断问题出在 DeepSeek 侧还是 WorkBuddy 配置侧。Windows PowerShell验证$env:DEEPSEEK_API_KEY 替换成你的API Key $headers { Authorization Bearer $env:DEEPSEEK_API_KEY } $body { model deepseek-v4-flash messages ( { role user content 只回复连接成功 } ) stream $false } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://api.deepseek.com/v1/chat/completions -Method Post -Headers $headers -ContentType application/json -Body $bodymacOS终端验证export DEEPSEEK_API_KEY替换成你的API Key curl https://api.deepseek.com/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer ${DEEPSEEK_API_KEY} \ -d { model: deepseek-v4-flash, messages: [ { role: user, content: 只回复连接成功 } ], stream: false }如果返回内容中包含{ choices: [ { message: { content: 连接成功 } } ] }说明 API 基本可用。DeepSeek 官方文档也提供了针对 WorkBuddy 的 Windows PowerShell 验证示例。([DeepSeek API Docs][7])常见错误错误现象常见原因401API Key错误、失效或复制时包含空格402账户余额不足404模型名称或接口地址错误429请求频率或并发超过限制WorkBuddy中不显示模型配置未保存或客户端没有完全重启可以对话但无法执行任务模型工具调用能力未正确配置十一、第一个实操自动整理杂乱文件文件整理适合作为 WorkBuddy 的第一个 Agent 实操。首先在input目录中放入一些无敏感信息的测试文件例如需求文档.docx 测试报告.pdf 接口数据.csv 产品截图.png 应用日志.log 安装包.zip 需求文档-副本.docx然后在 WorkBuddy 中选择这个目录作为工作空间。第一步Ask扫描目录请只读取当前工作空间不要修改任何文件。 完成以下分析 1. 统计文件总数 2. 按扩展名和文件类型分类 3. 识别疑似重复文件 4. 识别命名不规范的文件 5. 识别无法判断用途的文件 6. 给出建议的目录结构 7. 输出拟移动文件清单。第二步Plan生成执行方案请基于刚才的扫描结果制定文件整理方案。 约束条件 1. 不删除任何文件 2. 不覆盖同名文件 3. 疑似重复文件放入duplicate-review目录 4. 无法识别的文件放入unknown目录 5. 保留原始文件名 6. 执行前生成完整备份 7. 输出回滚方案 8. 当前只输出计划不执行。第三步Craft执行整理确认执行刚才的整理计划。 执行要求 1. 先将原始目录复制到backup 2. 不删除任何文件 3. 不覆盖同名文件 4. 所有移动记录写入operations.csv 5. 生成README_目录说明.md 6. 遇到无法判断的文件时暂停并向我确认 7. 完成后输出整理前后的目录结构对比。这段指令比简单说一句“帮我整理文件”更可靠因为其中包含权限边界备份机制文件冲突处理操作审计回滚要求人工确认节点这也是执行型 Agent 与普通聊天模型的重要区别。十二、第二个实操生成数据分析报告假设工作空间中有一份product_metrics.csv字段如下date new_users active_users orders revenue refund_amount channel不要一开始就让 Agent 直接给业务结论。更稳妥的流程是先检查数据再生成报告。第一步Ask进行数据质量分析请读取product_metrics.csv但不要修改原始文件。 完成以下数据质量检查 1. 输出字段名称和推测的数据类型 2. 统计每个字段的缺失值 3. 识别重复记录 4. 检查日期是否连续 5. 识别异常值 6. 检查订单、收入和退款金额之间是否存在明显矛盾 7. 所有结论必须注明计算依据 8. 不允许补造不存在的数据。第二步Craft生成HTML报告请基于product_metrics.csv生成一份HTML数据分析报告。 报告至少包含 1. 核心指标总览 2. 新增用户趋势 3. 活跃用户趋势 4. 订单量和收入趋势 5. 客单价变化 6. 退款率变化 7. 不同渠道的用户和收入对比 8. 异常波动日期 9. 数据质量说明 10. 结论与风险提示。 交付文件 - report.html - cleaned_data.csv - analysis_notes.md 约束要求 - 不修改原始CSV - 不编造缺失数据 - 推断性结论必须明确标注 - 图表支持鼠标悬停 - 输出核心指标的计算公式。最终交付的不再只是一段聊天内容而是一组可以继续使用的成果文件report.html cleaned_data.csv analysis_notes.md十三、IT从业者更适合尝试哪些场景1. 日志分析与故障定位读取logs目录中的应用日志按时间还原故障发生过程。 要求 1. 提取ERROR、WARN和异常堆栈 2. 聚合同类异常 3. 找出最早出现异常的服务 4. 分析可能的上下游传播关系 5. 输出故障时间线 6. 将事实、推断和待验证项分开 7. 不修改任何原始日志。2. 测试报告汇总读取JUnit XML、Allure结果和覆盖率报告。 输出 1. 用例总数、成功数、失败数和跳过数 2. 失败用例分类 3. 重复失败问题聚合 4. 核心模块覆盖情况 5. 与上一版本的差异 6. 高风险未覆盖模块 7. 建议补充的测试场景 8. Markdown和HTML两个版本。3. 接口测试设计读取openapi.yaml和需求文档。 为核心接口设计测试场景覆盖 - 正常流程 - 必填参数 - 参数类型 - 边界值 - 鉴权失败 - 权限越权 - 幂等性 - 重放请求 - 并发请求 - 限流 - 异常依赖 - 数据一致性 先输出测试分析和用例目录不要直接生成自动化脚本。4. 代码库理解请只读取当前代码库不要修改代码。 输出 1. 项目技术栈 2. 模块结构 3. 核心调用链 4. 外部依赖 5. 数据库和缓存使用情况 6. 核心接口 7. 测试代码分布 8. 潜在高风险模块 9. 新人建议阅读顺序。5. 版本发布材料生成读取本次版本的提交记录、需求文档、缺陷列表和测试报告。 生成 1. 版本发布说明 2. 功能变更清单 3. 缺陷修复清单 4. 数据库变更说明 5. 配置变更说明 6. 发布步骤 7. 回滚步骤 8. 已知风险 9. 上线验证清单 10. 面向业务方的简版通知。十四、使用WorkBuddy必须守住的安全边界1. 工作空间最小化只授权当前任务必须使用的目录。不要直接将以下目录设置为工作空间~/.ssh ~/.aws ~/.kube 公司完整代码仓库 生产配置目录 浏览器用户数据目录2. 修改前先备份批量移动、修改或重命名文件时应明确要求先生成备份 不删除原文件 不覆盖同名文件 记录所有变更 提供回滚方案。3. 高风险操作保留人工确认以下任务不建议完全自动执行删除文件提交或合并代码修改数据库发送外部消息执行生产命令发布生产版本上传公司内部数据修改账号和系统权限WorkBuddy 官方提供默认权限与完全访问权限。默认权限下涉及敏感操作、文件修改或工作空间外执行时需要用户确认完全访问权限会减少确认步骤只适合明确可信的任务。4. API Key不要出现在截图中API Key 不应直接出现在公众号配图视频录屏Git仓库Markdown文档团队聊天记录测试报告项目配置示例制作教程截图时应将密钥区域完全打码而不是只遮挡其中几位。结语Windows 与 macOS 版本的 WorkBuddy 确实存在安装差异Windows 安装向导 → 可选择安装路径 → 可创建快捷方式 macOS 选择对应芯片版本 → 打开DMG → 拖入Applications但安装完成后两端的核心使用方式基本一致设置工作空间 → 选择Ask、Plan或Craft → 配置DeepSeek → 启用技能和权限 → 执行任务 → 检查交付结果WorkBuddy 真正值得技术人员关注的不是它多接入了一个大模型而是它把大模型与以下能力组合在了一起任务规划 文件系统 工具调用 Skill扩展 连接器 权限控制 结果交付对开发、测试、运维和数据从业者来说使用 Agent 的重点也不应该是“让它完全替代人工”而是建立一套可审查、可回滚、可验证的执行流程Ask先读取和分析 Plan先输出方案 Craft再执行操作 Verify最后人工验收AI Agent 能否真正进入技术工作流最终取决于的不是它会不会回答问题而是它能否在明确权限和工程约束下把任务稳定地完成。本文部分内容参考了霍格沃兹测试开发学社整理的相关技术资料主要涉及软件测试、自动化测试、测试开发及 AI 测试等内容侧重测试实践、工具应用与工程经验整理。