本教程带你完成第一个 VibeSpace 任务。开始前请确认：已安装应用并配置好至少一家模型供应商。
1. 新建任务并授权工作区
- 打开左侧导航的「新建任务」；
- 首次使用时点击选择文件夹，授权一个工作区（建议先在一个测试项目上练习）；
- 输入框下方的工具栏可以调整：
- 权限模式：新手建议保持默认的「帮我批准」，或更保守的「请求批准」；
- 模型 / 后端：选择已配置的 API 模型，或本机已安装的 CLI 后端；
- 专家与技能：可选。例如勾选内置的
review-code技能让 Agent 按审查清单工作。
2. 描述你的目标
用自然语言写清楚「想要什么」，必要时补充约束与验收标准。输入框支持：
- Enter 发送任务；
- Shift+Enter 插入换行；
- ↑ / ↓ 浏览此前发送过的草稿；
- 可附加文件或图片（需要模型支持视觉能力）。
一个结构清晰的任务描述示例：
目标：为 utils/dates.ts 增加一个 workdaysBetween(start, end) 函数，
返回两个日期之间的工作日数量（不含周末）。
约束：遵循现有代码风格；不引入新依赖。
验收：新增单元测试并全部通过；运行 pnpm test 后给出结果摘要。3. 观察执行过程
任务开始后，时间线会实时展示 Agent 的每一步：
- 工具卡片：浏览、搜索、读取、编辑、写入、命令执行等，每张卡片显示具体参数与结果；
- 输出流：模型的推理与回复逐段显示；
- 上下文面板：随时查看当前会话的 Token 占用与压缩状态。
4. 处理审批
当 Agent 请求执行受保护操作（如写入文件、执行命令）时，会出现审批卡片：
- 批准：放行这一步操作；
- 拒绝：Agent 会收到拒绝结果并调整方案。
在「帮我批准」模式下，低风险操作会自动放行，高风险操作仍会询问你。你在一次运行中的审批决策会被记住，应用重启恢复后不会重复询问。
5. 查看变更并验收
任务结束后，进入任务的变更视图：
- 查看任务级变更汇总与逐文件 diff；
- 对不满意的部分，可以执行恢复（先预检、再确认），把文件还原到任务开始前的状态；
- 满意的成果直接保留在工作区里。VibeSpace 不会自动执行 git commit / push，提交时机完全由你掌握。
6. 中途干预
- 取消任务：运行中随时可以取消，已产生的变更保留在变更集中；
- 关闭应用再回来：运行状态与检查点会持久化，重启后可以从断点恢复运行（详见中断恢复与上下文）。