> 内容来源：Onevium 官方文档
> 文章: 在 Onevium 完成第一个任务
> 原文: https://onevium.com/zh/docs/getting-started
> 语言：简体中文
> 更新于: 2026-09-16
> 适用版本: 1.2.0+

---

# 在 Onevium 完成第一个任务

连接模型、打开项目、发出第一个任务，再按需要认识文件、浏览器、图表、Skills 和队伍协作。

## 从一个小任务开始

Onevium 把 AI 对话、项目文件和操作工具放在同一个工作区。你说清楚要做什么，助手可以读取资料、修改文件、运行命令或检查网页；你在会话里查看过程与结果。

第一次只需完成三件事：**连接模型 → 打开项目 → 发送任务**。下面先让助手读懂一个文件夹，不必提前学会所有工具。

## 连接模型，打开项目

1. 按[安装指南](https://onevium.com/zh/docs/installation)安装并打开 Onevium。
2. 按[服务商连接](https://onevium.com/zh/docs/providers)接入模型：可以登录 Claude Code，也可以使用服务商的 API Key 或支持的 Coding Plan。登录 Onevium 本身不包含模型额度。
3. 点击侧栏 **项目** 旁的文件夹加号（**添加项目**），选择 **打开已有文件夹**。代码仓库或存放文档的文件夹都可以；还没有材料时，也可以创建一个空项目。
4. 在项目行点击铅笔按钮创建会话，在输入框选择已连接的服务商和模型。

把项目理解为“这次工作的文件夹”，把会话理解为“其中一个任务”。同一个任务的补充要求留在原会话，独立任务再新建会话。

## 发出第一个任务

复制下面这段话发送。它只读取文件，适合先熟悉工作方式：

```text
帮我了解当前项目。
先确认工作目录，再阅读 README 或其他现有说明文件。
用三句话介绍这个项目，列出最多三个值得先看的文件，并说明原因。
如果文件夹为空，告诉我可以先准备什么材料。
这次只阅读，不修改文件或运行项目。
```

查看回复下方的工具活动，了解助手读了哪些文件。需要补充范围时，直接继续说，例如“只看 docs 文件夹”。遇到权限确认，先看清要执行的操作再决定。

也可以点击输入框麦克风[用语音输入](https://onevium.com/zh/docs/voice-dictation)：先把话变成文字，检查后再发送。首次使用需完成语音模型和麦克风设置。

## 找到结果，核对一次

点击会话顶部的文件夹图标 **浏览全部文件**，打开回答提到的一份文件，确认说明与实际内容一致。文件夹为空时，正确结果就是说明暂无材料，而不是编造项目内容。

之后可以继续给一个小任务，例如“根据这份说明，列一份待办清单”。开始修改文件后，点击顶部绿色 `+N`、红色 `-N` 查看 Git 项目的改动；操作方法见[文件、终端与 Review](https://onevium.com/zh/docs/files-terminal-review)。

## 按任务选择工具

先记住用途，用到时再打开对应教程。输入框的 **@ 菜单**可以发现多种能力；文件、终端和浏览器也有各自的工作区入口。

| 你想做什么              | 先认识哪个工具                                                                                            | 可以这样说                       |
| ------------------ | -------------------------------------------------------------------------------------------------- | --------------------------- |
| 读文档、改代码、跑检查        | [文件、终端与 Review](https://onevium.com/zh/docs/files-terminal-review)                                 | “修改这段说明，再列出实际改动。”           |
| 看网页、检查页面操作         | [浏览器](https://onevium.com/zh/docs/browser-automation)                                              | “使用内置浏览器打开这个网址，检查导航是否能用。”   |
| 把内容变成图表或小工具        | [Widget](https://onevium.com/zh/docs/widget-workflows)                                             | “把这份数据做成图表，保留原始数字。”         |
| 按一套固定方法重复工作        | [Skills](https://onevium.com/zh/docs/skills)                                                       | “按这个文档审查 Skill 检查 README。”  |
| 将复杂需求拆成多个会话协作      | [队伍 Team](https://onevium.com/zh/docs/teams)                                                       | “把这个需求拆成开发、测试两项，先列分工与验收条件。” |
| 定时处理任务，或从团队聊天中发起工作 | [定时任务](https://onevium.com/zh/docs/scheduled-runs)与[渠道](https://onevium.com/zh/docs/team-channels) | “每天检查这份报告。”或在已配置的机器人中发送请求。  |

Skills 需要先安装或创建；Team、定时任务和渠道也有各自的准备步骤。选中标签后，仍要补充具体要求并发送。第一次用文件和浏览器就能完成很多工作，其他能力按需要添加。

## 遇到问题时从这里查

| 现象             | 下一步                                                                     |
| -------------- | ----------------------------------------------------------------------- |
| 无回复、认证失败或模型不可用 | 回到[服务商连接](https://onevium.com/zh/docs/providers#check)，核对连接和模型，先测试一句话回复 |
| 读到了另一个项目的文件    | 检查当前会话的工作目录，从正确的项目行新建会话                                                 |
| 没有找到想用的能力      | 查看[工具菜单](https://onevium.com/zh/docs/tools-menu)，确认所需工具已启用或扩展已安装        |
| 正在等待权限确认       | 打开待处理动作，检查路径与操作；权限说明见[权限与计划](https://onevium.com/zh/docs/permissions)   |

## 下一步做什么

优先完成[服务商连接](https://onevium.com/zh/docs/providers)，再用[项目与会话](https://onevium.com/zh/docs/projects-and-sessions)整理真实任务。需要哪些能力，就从上表进入对应教程，不必一次配置完所有工具。