# 给 AI 一个目标，它自己交出网页：DeepSeek + WorkBuddy 实验

> 前两集，我们让 AI 回答问题、创建文件；这一集只升级一件事：少下几条命令，只给一个目标，看它能不能自己拆开任务并交付网页。

![本集主线：接入 DeepSeek，在空工作区给出目标，再验收网页](images/01-episode-guide.png)<!-- display-width:500 -->

**这一集只做一件事**

在一个空文件夹里，让 WorkBuddy 使用 DeepSeek 做出一个可以直接打开的单页网页。

- 预计用时：15～25 分钟，下载安装和登录时间另算。
- 需要准备：Windows、WorkBuddy、DeepSeek API Key，以及一个空文件夹。
- 成功标志：任务列表出现执行步骤，文件夹里出现 `index.html`，右侧能看到生成的网页。

WorkBuddy 可以先理解成“一款能在授权文件夹里创建文件的桌面 AI 工具”。不需要前端经验，先把它跑通，再给背后的机制起名字。

**完全新手先看这里：** 本集不需要终端、PowerShell、VS Code、Python、Node.js 或 Git。只要 Windows 10 或更新版本、系统自带浏览器、一个空文件夹、可用的 DeepSeek 实验 Key，以及已经登录的 WorkBuddy。

- 浏览器：用于下载和登录，Windows 自带的 Edge 就够用。
- 文件资源管理器：就是任务栏上的黄色文件夹图标，用来创建和找回实验目录。
- WorkBuddy：本集真正执行任务的桌面 AI 工具；第一次安装可跟着 [WorkBuddy Windows 官方指南](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide)操作。

已经能进入 WorkBuddy 新建任务页，并且手里有一枚可撤销的 DeepSeek 实验 Key，就可以跳过工具准备说明。

## 1. 准备 WorkBuddy 和一个空文件夹

### 1.1 安装并打开 WorkBuddy

从 [WorkBuddy 官方页面](https://www.codebuddy.cn/work/) 下载与你系统匹配的版本，完成安装和登录。不要停在登录二维码页面；能进入新建任务页，才算这一项准备完成。

![从 WorkBuddy 官方入口下载与当前系统匹配的版本](images/02-download-workbuddy.png)<!-- display-width:560 -->

页面和按钮可能随版本更新；如果位置和截图略有不同，以 [WorkBuddy 官方文档](https://www.codebuddy.cn/docs/workbuddy/Overview) 为准。

### 1.2 创建本次实验的“小沙盒”

按 `Win + E` 打开文件资源管理器，进入桌面，在空白处右键选择“新建 → 文件夹”，命名为：

```text
workbuddy-demo
```

只用它完成本次实验，不要放入公司代码、客户数据、个人证件、账号凭证或其他敏感内容。

双击打开一次，确认里面没有文件；再关闭并重新找到它。能找回这个空文件夹，后面选择工作区时就不会迷路。

先给 AI 一个小沙盒。别第一天上班，就把整块硬盘的门禁卡发出去。

**看到这个就算过关：** WorkBuddy 已经打开并登录，电脑上也能找到空的 `workbuddy-demo` 文件夹。

**如果不一样：** 先确认安装包与系统匹配；登录或界面问题优先查官方文档，不要急着连接真实项目。

## 2. 把 DeepSeek 接进 WorkBuddy

这一步只做一件事：让 WorkBuddy 能使用你在第一集已经调用过的 DeepSeek。

进入 **系统设置 → 模型**，点击“添加模型”。在“提供商”列表中选择 **深度求索 / DeepSeek**。这里的“提供商”，就是模型服务来自哪里。

![在模型服务来源列表中选择深度求索 / DeepSeek](images/03-provider-deepseek.png)<!-- display-width:580 -->

接着填写或确认两项：

- API Key：证明调用身份的门票，使用一枚独立、可随时撤销的实验 Key。
- 模型名称：选择当前界面里可用的 DeepSeek 模型，不必照抄截图中的具体版本名。

![只填写实验专用 Key，并选择界面中当前可用的 DeepSeek 模型](images/04-model-api-key.png)<!-- display-width:580 -->

截图中的 Key 输入框为空，没有展示真实凭证。不要把完整 Key 放进文章、聊天记录、Git 仓库或截图。

任务内容会发送给 DeepSeek。实验里不要提交公司资料、个人隐私或其他敏感内容。

保存后回到新建任务页，在模型选择器中选中刚配置的 DeepSeek。

**看到这个就算过关：** 新建任务页的模型选择器里出现并选中了 DeepSeek。

**如果不一样：** 先确认配置已经保存，再重新打开任务页；仍然找不到时，再看文末“找不到 DeepSeek”。

## 3. 把行动范围圈在实验文件夹里

WorkBuddy 稍后会真正创建文件，所以先把模式和工作区设置好。

第一次实验保留默认权限，或选择限制较多的模式。不要为了少点几次确认，就直接授予不必要的完全访问权限。

![第一次实验保留默认权限或限制较多的工作模式](images/05-mode-selection.png)<!-- display-width:580 -->

点击“选择工作空间”，只选择刚创建的 `workbuddy-demo`。

![工作区只选择空的实验文件夹，私人目录已经脱敏](images/06-workspace-safe.png)<!-- display-width:600 -->

后续如果弹出命令或高风险操作确认，先看清动作和目标路径；只有路径确实位于实验文件夹内，才考虑批准。

**看到这个就算过关：** 输入框下方的工作区名称显示为 `demo` 或 `workbuddy-demo`，而不是整个桌面、私人目录或真实项目。

**如果不一样：** 重新选择工作空间，并确认自己选中的是空文件夹本身。

## 4. 选一个帮手，再把目标说清楚

本次要做网页，所以先在输入框旁的功能入口选择 **专家**。这里的“专家”可以先理解成一种预设好的工作方式。

![从输入框旁的功能入口打开“专家”列表](images/07-expert-menu.png)<!-- display-width:580 -->

选择 **UI 设计师**。

![为这次网页任务选择 UI 设计师](images/08-ui-designer.png)<!-- display-width:520 -->

**看到这个就算过关：** 输入框附近出现“UI 设计师”标签，同时模型仍是 DeepSeek，工作区仍是 `workbuddy-demo`。

接下来复制这段更容易复现的“稳定版”任务：

```text
请在当前实验工作区创建一个介绍 WorkBuddy 的单页网页，并保存为 index.html。
使用清晰的卡片布局，说明它与普通聊天工具的区别。
只使用 HTML、CSS 和 JavaScript，不读取或修改工作区外的文件。
完成后在右侧预览，并告诉我创建了哪些文件。
```

它只说清三件事：交付什么、怎样验收、哪里不能碰。提示词不需要华丽，边界清楚更重要。

**看到这个就算过关：** 点击发送后，页面进入执行状态，而不是只返回一段聊天建议。

**如果不一样：** 再检查一次 DeepSeek、UI 设计师和 `workbuddy-demo` 是否同时处于选中状态。

## 5. 看它把目标变成任务

发送后先别离开，观察中间区域。WorkBuddy 会把目标变成可跟踪的任务，并显示执行或文件写入状态。

![目标已经变成任务卡，界面同时显示文件写入状态](images/09-agent-task.png)<!-- display-width:600 -->

重点看任务卡片和“正在写入文件”一类状态，而不是只看最后一句“完成了”。AI 的口头汇报不算交付，文件才算。

**看到这个就算过关：** 页面出现任务卡或执行状态，并开始在工作区写入文件。

**如果不一样：** 如果它一直思考却没有写文件，先把任务缩小成“在当前工作区创建一个只含标题的 `index.html`”，确认最小链路后再重试完整版。

## 6. 验收真正生成的网页

执行完成后，先看右侧内置浏览器。它应该打开实验目录里的本地网页。

![左侧显示执行任务，右侧内置浏览器打开本地网页](images/10-browser-preview.png)<!-- display-width:600 -->

再打开完整页面，检查标题、卡片和基本排版是否出现。

![真实生成的单页 Demo：只用于验证交付流程，内容仍需核对](images/11-final-page.png)<!-- display-width:400 -->

最后回到 `workbuddy-demo` 文件夹，确认 `index.html` 确实存在。Windows 默认可能隐藏扩展名；看到名为 `index`、类型为“HTML 文档”的文件，它通常就是 `index.html`，不要因此重复生成。

本集的验收只看三件事：

1. 任务列表出现过规划或执行步骤。
2. 实验文件夹里产生了网页文件。
3. 右侧预览能够打开这份网页。

> 到这里，本集已经完成。你给出一个目标，WorkBuddy 把它变成任务、写入文件，并交付了一个肉眼可见的网页。

页面里的数字和产品介绍由模型生成，可能不准确或已经过时。页面长得像那么回事，不代表每个数字都靠谱；会排版和会考证是两门课，正式发布前仍要核对官方资料。

## 7. 成功之后，再理解什么是 Agent

现在给刚才这类工具起名字：**Agent**，也就是“不只回答，还能围绕目标拆步骤、调用工具并交付结果的执行者”。

回看刚才的实验，模型和 Agent 的区别就容易理解了：

![模型负责回答，Agent 还会围绕目标拆步骤、使用工具并交付结果](images/12-model-agent-diagram.png)<!-- display-width:500 -->

- 问模型“怎么做一个网页”，通常会得到建议或代码。
- 把目标交给 Agent，它还会规划任务、创建文件，并把结果交给你验收。

[WorkBuddy 官方产品介绍](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Product-Guide)也强调了自然语言目标、自主执行和桌面工具协同。Agent 依然可能理解错需求、选错工具或生成错误内容，所以最后的验收不能省。

根据 [WorkBuddy 官方模型配置说明](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)，自定义模型配置和 API Key 保存在本机；真正请求模型时，任务内容仍会发送给你选择的第三方模型服务。也就是说，WorkBuddy 的界面和文件操作发生在电脑上，但模型回复仍通过网络来自 DeepSeek。桌面 Agent 不等于本地部署模型。

## 8. 选做：跑通以后，再给它更多能力

到这里，核心实验已经完成。下面两项只适合想继续看看入口的读者，不会改变前面的成功标准。

### 8.1 添加参考文件

WorkBuddy 支持上传文件作为任务上下文，例如脱敏后的品牌规范或示例数据。

![选做入口：可以添加参考文件，但本次不上传真实资料](images/13-upload-file.png)<!-- display-width:560 -->

第一次实验不需要上传任何真实材料。先学会控制数据范围，再逐步增加上下文。

### 8.2 查看技能、专家团和连接器

- Skill：为任务增加某种工具能力。
- 专家团：让多个预设角色分工协作。
- 连接器：在授权后访问邮箱、文档或知识库等外部服务。

![选做入口：连接器可在授权后接入邮箱、文档或知识库](images/14-connectors.png)<!-- display-width:580 -->

本集只展示入口，没有实际连接邮箱或知识库。真正授权前，至少确认它能读取或发送什么、任务内容会不会进入第三方模型，以及授权能否随时撤销。

## 9. 常见问题：先判断卡在哪一层

### 保存模型后，任务页找不到 DeepSeek

这说明模型还没有进入当前任务，不代表 Key 一定有问题。先确认配置已经保存，再重新打开任务页或重启 WorkBuddy；界面变化则核对官方模型配置文档。

### 出现 401、403 或模型调用失败

这说明流程已经进入调用阶段，但仅凭这条错误还不能判断请求是否到达 DeepSeek。先看完整报错与请求来源，再依次检查本机网络或代理、实验 Key、可用额度、权限和服务状态；不要打印完整 Key。

### 一直在规划，没有生成文件

这说明还没有完成“写文件”这一层。先确认工作区可写，再把目标缩小成“创建一个只含标题的 `index.html`”。

### 页面能打开，但内容不准确

这说明文件写入和预览链路已经成功，不代表事实内容正确。产品数字、功能列表、价格和安全承诺都要回到官方资料核对。

### 使用自己的 API Key 会产生费用吗

DeepSeek 调用费用由模型服务商计费。一次长任务可能多次请求模型，实验时同时关注 WorkBuddy 的执行状态和 DeepSeek 侧的用量。

## 10. 今天你已经做到了什么

如果右侧已经打开生成的网页，你完成了三件事：

1. 把 DeepSeek 接进 WorkBuddy，并收到可见的配置反馈。
2. 把操作范围限制在空文件夹，再交付一个边界清楚的目标。
3. 看见任务执行、文件生成和网页预览这一整条链路。

![接入模型、限制范围、交付网页：本集核心实验已经跑通](images/15-episode-summary.png)<!-- display-width:500 -->

架构上的变化可以用一句话概括：前两集重点是“让模型回答、让工具执行一个指令”，这一集开始变成“给出目标，让执行者规划并交付结果”。

下一集只增加一个变量：如果模型回复也不再来自云端，能不能让它直接住进自己的电脑？