在 Onevium 完成第一个任务
安装后连接 Claude Code 或其他 AI 服务,选好项目,在输入框发出第一个开发任务,看着它推进、按需批准,再到审阅(Review)核对改动。
开始使用先认识工作区#
Onevium 把 AI 对话、项目文件和操作工具放在同一个窗口。第一次使用只需走完一条线:连接 AI 服务 → 选项目 → 发出任务 → 看进度、按需批准 → 核对结果。
窗口分成几块:
| 位置 | 用途 |
|---|---|
| 最左侧导航栏 | 主页回到会话;默认还有自动化、插件、渠道、图像,其余入口在更多里;最下方头像打开账户与设置 |
| 侧栏 | 新建会话、搜索、添加项目、筛选,以及按项目分组的会话列表 |
| 中间 | 当前会话和输入框 |
| 右侧面板 | 点标题栏最右侧的打开面板展开。浏览器、审阅(Review)、文件预览以标签页打开;终端停靠在会话下方。预览需要更大空间时,会话可以收起为角落里的悬浮球继续对话 |
本文用一个虚构的研发任务演示:在 checkout-web 项目里给结账页加优惠码校验。
安装、登录并连接 AI 服务#
- 按安装指南安装并打开 Onevium,用邮箱验证码登录 Onevium 账户。Onevium 账户本身不包含模型额度。
- 第一次进入且还没有项目时,会显示引导。点击开始使用。
- 这台电脑上还没有可用的 AI 服务时,会进入连接一个 AI 服务(图 1):
- 已经在终端里登录过 Claude Code:选我已经在用 Claude Code,Onevium 会检测这台电脑上的 Claude Code 登录。提示没有检测到时,先在终端完成 Claude Code 登录,再回来点一次。
- 使用 API Key 或 Coding Plan:在列表中选择服务商,例如 Anthropic、DeepSeek、GLM、Kimi、MiniMax 或千问,填写后点连接并继续。各家需要的凭据见服务商连接。
- 暂时不连:点稍后再说。第一次发送消息时还会提示连接,消息不会丢。
图 1:首次引导的连接步骤。1.3.2 真实组件的隔离演示,模拟“这台电脑上没有可用 AI 服务”的状态;没有连接任何服务,也未调用模型。
以后要添加或管理服务商,打开设置 → AI 与连接 → AI 服务。
选好项目#
项目就是这次工作的文件夹,AI 在里面读写文件、运行命令。引导的选择项目一步有三种做法:
| 选项 | 适合 |
|---|---|
| 直接开始 | 还没有材料,让 Onevium 在默认位置新建一个文件夹 |
| 打开文件夹 | 已有代码仓库或文档文件夹,例如 checkout-web |
| 新建文件夹 | 自己起名,从空文件夹开始 |
这台电脑上有 Claude Code CLI 的历史对话时,还会出现从 Claude Code 导入,可以接着原来的对话继续。
引导结束后,再添加项目就点侧栏顶部的文件夹加号(添加项目),选择打开已有文件夹,或输入名称新建。项目、会话与分屏的完整用法见项目与会话。
发出第一个任务#
点侧栏的新建会话,或悬停在项目行上点铅笔按钮。主页显示“今天想构建什么?”,输入框上下的控件决定这次任务在哪里、怎样运行(图 2):
- ① 项目:确认是
checkout-web。点它可以搜索、切换或添加新项目。同一行还显示本地和当前 Git 分支;Git 仓库右侧的工作树开关用于在独立目录里做任务,第一次可以先不勾,详见工作树。 - ② 权限:点开有三档。第一次建议选默认权限,运行命令等需要确认的操作会先停下来问你;Auto 模式自动批准安全操作、拦截风险操作;完全访问自动批准所有操作,开启前会再确认一次。新安装默认是完全访问,全局默认在设置 → 应用设置 → 通用 → 默认权限模式修改,区别见权限与计划。
- ③ 模型:选择已连接服务商下的模型,例如 Claude Code 分组里的 Opus 5.5;同一菜单可以调推理力度。
图 2:发送前确认 ① 项目、② 权限、③ 模型。1.3.2 真实组件的隔离演示,项目、会话和任务均为虚构;尚未发送。
在输入框写清目标、范围和验证方式,例如:
给结账页加优惠码校验:输入框失焦时调用 /api/promo/validate,
无效码在输入框下方显示原因。先补单元测试,再改组件。
改完列出改动的文件,不要动支付相关代码。
需要指向具体内容时:
- 输入
@:引用文件(当前目录或所有文件)、之前的会话,以及浏览器、图表等能力。 - 输入
/:调用命令(如/init、/review、/compact)和已安装的技能。 - 点 +:添加图片和文件,或在模式里切到计划,让 AI 先给方案再动手。
各菜单的完整说明见工具菜单。按 Enter 或点右下角的发送按钮发出任务。
看进度,按需批准#
发送后,会话出现在侧栏对应项目下,AI 开始读文件、改代码。回复上方的折叠行概括这一轮做了什么(图 3 中的 ①),例如“已完成 · 2 次编辑 · 查看 1 处”,点开可以看到每一步工具操作。
在默认权限下,需要确认的操作会替换输入框,显示一张审批卡(图 3 中的 ②):
- 先看清工具和内容,例如 Bash 要运行的命令。
- 允许一次:只放行这一次。有可用的规则建议时,还会出现本次会话允许。
- 拒绝,或拒绝并反馈:写清原因,AI 会据此调整做法。
等待确认时,侧栏的会话行会显示提醒标记,在其他会话里工作也不会错过。
图 3:① 本轮进度摘要,② 等待你确认的命令。1.3.2 真实组件的隔离演示,对话与命令均为虚构;未运行任何命令,也未调用模型。
不确定时选拒绝并写明顾虑,比放行一个看不懂的命令更稳妥。
核对结果#
有文件改动的回复下方会出现文件改动卡片,例如“已编辑 2 个文件”,并显示新增和删除的行数:
- 点卡片上的审核,在右侧审阅(Review)中逐个文件查看这一轮的差异。也可以按 ⇧⌘G(Windows 和 Linux 为 Ctrl+Shift+G)开关审阅面板。
- 不想保留这一轮的改动时,点卡片上的撤销,先预览将恢复的文件,确认后再恢复。
- 要看全部文件,按 ⇧⌘E 或在右侧面板的新标签页选浏览全部文件;需要自己跑检查时,按 ⌘J(Windows 和 Linux 为 Ctrl+J)打开终端。
本例的正确结果是:新增一个优惠码测试文件,PromoCodeField 组件在失焦时调用校验接口,测试通过,支付代码没有改动。差异里出现计划外的文件时,直接在会话里指出,让 AI 解释或改回。审阅、分支比较与提交见文件、终端与 Review。
按任务选择下一个工具#
| 你想做什么 | 先看哪篇 | 可以这样说 |
|---|---|---|
| 读文档、改代码、跑检查 | 文件、终端与 Review | “修改这段说明,再列出实际改动。” |
| 在独立目录里尝试修改 | 工作树 | “先确认工作目录和分支,再开始修改。” |
| 看网页、检查页面操作 | 浏览器 | “用内置浏览器打开本地预览,检查优惠码输入框。” |
| 引用文件、会话或能力 | 工具菜单 | 在输入框输入 @ 选择 |
| 按固定方法重复工作 | Skills | “按这个审查 Skill 检查 README。” |
| 把复杂需求拆给多个会话 | 队伍 Team | “拆成开发、测试两项,先列分工与验收条件。” |
| 定时运行,或从团队聊天发起 | 定时任务与渠道 | “每天检查这份报告。” |
遇到问题时从这里查#
| 现象 | 下一步 |
|---|---|
| 发送后出现“先连接一个 AI 服务再发送” | 选我已经在用 Claude Code或一个服务商,填写后点连接并发送;消息留在输入框,连好后自动发出 |
| 选了“我已经在用 Claude Code”,却提示没有检测到登录 | 先在终端完成 Claude Code 登录,再回到 Onevium 重试;或改用 API Key,见服务商连接 |
| 发送时项目选择器抖动并展开 | 还没选项目。选一个项目,或点添加新项目 |
| 无回复、认证失败或模型不可用 | 到设置 → AI 与连接 → AI 服务核对连接,先发一句话测试;排查步骤见服务商连接 |
| 没看到审批卡,AI 直接改了文件或运行了命令 | 检查输入框下方的权限档:完全访问会自动批准所有操作;默认权限下编辑项目内文件通常不逐次确认 |
| 读到了另一个项目的文件 | 看会话在侧栏哪个项目下;从正确的项目新建会话 |
| 找不到审阅 | 审阅只用于 Git 仓库;普通文件夹用浏览全部文件查看 |
下一步#
先连好常用的服务商(服务商连接),再用项目与会话管理真实任务,用会话整理给会话起好标题、打上标签。想随时查看等待确认的会话和当天用量,打开菜单栏快捷中心。