快速开始

本章将引导你完成从 CLI 安装到首次成功对话的全流程。完成后，即可开始日常的交互式使用。

概述

完整的首次启动流程包含以下步骤：

1. 安装 CLI 并验证 unitarylab 命令是否可用。
2. 运行 unitarylab，跟随引导完成 LLM 配置、账号登录并启动会话。
3. 开始第一次对话。

若你已完成部分步骤，可直接跳至对应小节。

安装

我们为各平台提供一键安装脚本：

• macOS / Linux：终端脚本，或使用 Homebrew 安装
• Windows：PowerShell 脚本

macOS / Linux （终端）

curl -fsSL https://assets.unitarylab.com/install.sh | bash

macOS / Linux （Homebrew）

brew install unitarylab/unitarylab-agent/unitarylab

Windows (PowerShell)

irm https://assets.unitarylab.com/install.ps1 | iex

安装完成后，在任意终端中执行：

unitarylab --help

若输出中显示了包含 configure、login、logout、whoami 等子命令的列表，则表明 unitarylab 已正确加入 PATH，可继续下一步。

启动与初始化

执行：

unitarylab

执行该命令后，CLI 会自动检测当前环境。如果检测到当前登录态缺失或未配置 LLM ，系统会引导你依次完成以下设置：

步骤 A：账号登录

配置完 LLM 后，向导会提示你登录账号：

1. 向导会依次询问账号（手机号或邮箱）与密码。若使用手机号登录，请在号码前添加国际区号，例如 +86。
2. 如你已获知账号，可在命令中直接指定账号信息，避免交互输入（具体用法请参阅 账号指南）。
3. 更多账号相关命令见 账号指南。

步骤 B：配置 LLM

向导会首先提示你配置所需调用的 LLM 服务：

1. Provider：可选 DashScope、OpenAI 或 Custom（兼容 OpenAI 接口的自定义服务，例如 SiliconFlow、自建网关等）。
   • 若选择 DashScope 或 OpenAI，API Base 已预设，无需填写；
   • 若选择 Custom，则需手动输入 API Base（OpenAI 兼容的根路径）。
2. API Key与模型校验：输入对应 Provider 的 API Key，输入时不会明文显示。
   • 输入后，系统不会立即校验 Key 的正确性，而是先尝试拉取模型列表。若拉取失败（API Key 不正确，或当前 Provider 不支持自动拉取），系统会提示用户手动输入模型列表。
   • 用户确定模型列表并从中选择具体模型后，系统才会真正校验 API Key 是否有效、所选模型是否可用。
3. 模型列表：API Key 填写完成后，CLI 会展示当前可用的所有模型。
   • 使用 ↑ ↓ 键移动光标；
   • 按 Space 键切换模型的选中状态，按 Enter 确认选择；
   • 支持多选，对已选中模型再次按 Space 可取消选择；
   • 若模型列表较长，可直接键入模型名称进行搜索过滤；
   • 已使用过的模型会被预选，最近使用的模型自动置顶；
   • 按 Space 键选中补充模型 id后按 Enter 进入补充模型id的页面，可补充列表未涵盖的自定义模型，按系统引导格式输入正确的 model id 即可。
4. 模型切换准备：配置完成后，在后续的会话中，如需更换模型，只需在交互界面输入 /model 命令，系统会展示你此时配置完成的模型列表以供快捷切换。

步骤 C：启动会话

完成配置和登录后，向导将依次询问：

1. 模型：从已配置的模型列表中选择。若仅有一个模型，则自动跳过；若有多个，则进入模糊搜索选择器，可直接键入关键字进行过滤。
2. 对话模式：可选 agent（完整工具链，默认）、ask（检索问答）、plan（规划式）。
3. 会话：可选择新建会话，或从最近 8 个历史会话中选择继续；也可输入 session_id 指定某一历史会话。继续已有会话时，CLI 会自动恢复该会话上一次使用的工作目录。
4. 工作目录：Agent 进行文件读写的根目录。若上一步已恢复工作目录，则本步自动跳过。若目录不存在，向导会提示自动创建。
5. 工具审批：设置每次调用非安全工具前是否需要弹出确认。

完成后即进入对话，提示符示例如下：

[agent│deepseek-v4-pro] ›

会话与工作目录指南见会话与工作目录指南，提示符的具体含义见 交互对话指南。

第一次对话

在提示符后直接输入问题或指令，按Enter发送：

[agent│deepseek-v4-pro] › 帮我自动求解一个PDE系统

若当前模式为 agent，Agent 在调用工具（例如下载文件至工作目录）时，会遵循你在向导中设定的审批策略进行相应确认。生成的可视化文件（SVG、PNG、JPG、PDF 等）将自动调用系统默认程序打开；其他文件则仅在终端中显示保存路径。

在会话中，可随时输入 /help 查看所有可用命令及其说明，详见 交互对话指南。 例如：

• /mode – 切换对话模式（agent、ask、plan）；
• /model – 切换模型；
• /cd <path> – 切换工作目录；
• /config – 重新配置 API 等。

修改配置

在后续的日常使用中，你随时可以使用/config命令来重新修改配置、切换账号。 在终端运行此命令可随时重新配置 Provider、API Base 或 API Key，并更新你的模型列表。（详见 模型配置指南）

重新登录

若需切换用户或登录态过期，可运行/login重新获取访问凭据。如你已获知账号，可在命令中直接指定账号信息避免交互输入（详见 账号指南）。

退出

可通过以下任一方式退出对话：

• 输入 exit、quit 、/logout或 :q 后回车；
• 按 Ctrl-D；
• 按 Ctrl-C。

其中，输入/logout会清空本地登录态，下次登入需重新输入账号密码。其他退出方式在账号有效期内则无需重新登入。退出后，会话信息与工作目录将被保存至本地，下次启动时可直接继续。