# 完成第一个任务

> 在工作区创建一个文件，再亲自检查它。

---

LLMS 索引： [llms.txt](/yourbuddy/llms.txt)

---

## 开始前

准备一台受支持的 Mac、可用模型账号或 API 凭据，以及一个练习文件夹。先确认[下载状态](/yourbuddy/download/)。桌面包携带默认插件与托管运行时，普通用户无需从源码构建。Docker 只用于确实需要它的评测流程。

## 接入模型并选择工作区

1. 启动 YourBuddy，等待运行时准备完成。
2. 打开设置，完成一条[模型配置路径](/yourbuddy/docs/models/)。
3. 在工作区选择器中添加并选中练习目录；选中后输入框即可使用。

## 请求一个成果

> 在当前目录创建 hello-yourbuddy.md，写出本周的三件事和各自的验收条件。完成后告诉我保存位置。

界面请求审批时按提示处理。完成后，通过 Better Sidebar 打开文件并检查内容；如果是 Git 仓库，也查看差异。助手的完成说明本身不能证明文件已经存在。

## 卡住时从哪里继续

| 卡点 | 对应说明 |
|---|---|
| 不知道如何登录或选择模型 | [模型配置](/yourbuddy/docs/models/) |
| 输入框不可用或文件位置不对 | [工作区](/yourbuddy/docs/workspace/) |
| 插件已经预装但不能使用 | [默认插件及前提](/yourbuddy/plugins/) |

侧栏“帮助与指南”可以随时打开本页和[故障排查](/yourbuddy/docs/troubleshooting/)。先完成这个文件任务，再按需要学习[扩展 Y8](/yourbuddy/docs/develop/)。

## 继续使用

继续当前会话，探索[文件和终端面板](/yourbuddy/docs/workspace/)，或[调整工作台设置](/yourbuddy/docs/settings/)。某一步失败时先查看[故障排查](/yourbuddy/docs/troubleshooting/)，无需重新安装所有插件。