交互对话指南

概述

本章介绍 CLI 进入会话后的所有交互细节，适用于以下场景：

已完成配置与登录，希望深入了解会话的提示符、对话模式以及运行时切换。
想了解 Agent 调用工具生成的文件是如何自动打开的。
希望熟悉对话的输入体验，包括命令历史、Tab 补全和 / 命令等。

覆盖内容：启动与提示符、对话模式、运行时切换、输入体验、结果文件自动打开、/files 文件管理、退出。

启动与提示符

启动方式

下面两条命令完全等价：


unitarylab            # 不带子命令，自动进入 start
unitarylab start      # 显式写法

两条命令都会先经过启动向导，再进入会话。如果当前已配置好 LLM，向导前会额外增加一步确认，让你选择“继续使用当前配置”或“重新配置”，以避免遗忘上次的配置内容就直接开始对话。

启动横幅与自检

启动后会依次出现：

品牌横幅：显示 UnitaryLab 字样。
启动自检：单行元信息。
向导步骤：参见快速开始的「启动会话」章节。

会话提示符

进入会话后，终端环境下的提示符形如：


[agent│model] ›

含义：

mode：当前对话模式，可选值为 agent / ask / plan。
model：当前模型的缩略名。

对话模式

CLI 内置三种对话模式，作用于当前会话：

agent（默认）：完整工具链。Agent 可调用文件读写、远端 workspace、技能等所有可用工具。
ask：检索问答模式。偏向基于检索的问答，工具调用更收敛。
plan：规划式模式。Agent 倾向于先输出执行计划，再逐步执行。

模式切换不会丢失会话历史，在下一轮对话中即时生效。

运行时切换

可使用下列命令在任意轮次之间动态切换参数，无需重启：

命令	行为
`/mode <ask\|agent\|plan>`	切换对话模式。
`/model`	切换当前模型；不带 `model_id` 时进入 fuzzy 选择器。
`/session`	切换会话；详见会话与工作目录指南。
`/cd <path>`	切换工作目录；详见会话与工作目录指南。
`/config` 或 `/setup`	重新走 LLM 配置流程；详见模型配置指南。
`/login` , `/logout` , `/whoami`	账号相关操作；详见账号指南。
`/history [n]`	查看当前会话最近 n 轮对话摘要。
`/search <关键词>`	在当前会话中全文搜索历史对话。
`/show <N>`	展开当前会话第 N 轮对话的完整内容。
`/bookmark [备注]`	为当前轮次打上书签；`/bookmarks` 查看所有书签。
`/clear` 或 `cls`	清空终端显示内容，保留当前会话上下文。
`/help`	打开帮助面板，按类别着色显示（切换 / 技能 / 历史 / 会话 / 文件）。

输入 /mode、/model、/models、/session 后按 Space 会列出可选值。

工具调用审批

在 Agent 模式下，当 Agent 准备调用非安全工具（如文件写入、任务创建等）时，会先弹出审批确认框，由你决定是否允许执行。

审批界面包含以下信息：

中文动作描述，例如”加载技能说明""创建项目文件夹”等，直观展示 Agent 的操作意图。
关键参数结构化展示，例如技能文件路径、任务 ID 等。

按键操作：

按键	结果
`y`	批准当前工具调用。
`n`	拒绝当前工具调用。
`Esc`	拒绝当前工具调用。
`Ctrl+C`	拒绝当前工具调用。
`Enter`	拒绝当前工具调用。

审批行为说明：

拒绝某个工具后，下次调用同类工具仍会再次询问，不会因为之前拒绝过就自动跳过。
已批准过的工具和参数组合，同一次会话中不会重复询问，减少重复操作。
弹出审批框时，输入框中未发送的内容会被自动清除，防止误触回车导致意外取消。

工具审批中的 Ctrl+C 仅拒绝当前工具调用，不会退出 CLI。破坏性工具不缓存批准结果，每次调用均需重新确认。

流式状态与取消

在交互式终端下，CLI 会实时展示当前任务的运行阶段，让你清楚了解 Agent 正在进行哪一步操作：

准备请求
分析中
生成中
执行中间步骤
等待用户确认
继续处理
整理最终答案
已取消

取消操作：

按 Esc 可随时取消当前推理。
长时间运行的任务会显示取消提示。

输入体验

会话在终端下提供以下输入增强：

命令历史：按 ↑ / ↓ 翻阅历史记录。
斜杠命令补全：输入 / 触发命令与技能补全；按 Tab 确认候选；Backspace 会实时刷新候选。
二级补全：参见上一节的运行时切换命令。

/ 仅在输入框中用于触发斜杠命令补全。进入 /model、/models 等弹出的模型 fuzzy 选择器后，直接键入关键字即可过滤，无需再输入 /。

`/files` 文件管理

/files 用于查看与重新打开当前工作目录下的文件，常用形式如下：

命令	行为
`/files`	列出当前工作目录下的文件。
`/files open <文件名>`	使用系统默认程序重新打开指定文件。

/files 操作的是当前工作目录（参见会话与工作目录指南），而非进程的当前目录。

帮助：`/help`

在会话内执行 /help 会打开按类别着色的帮助面板：

切换类（蓝）：/mode / /model 等。
技能类（橙）：/skills、所有 /<技能名>。
历史类（紫）：会话相关命令。
文件类（绿）：文件与工作目录相关命令。
会话类（灰）：退出会话和与agent交互相关等。

退出

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

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

退出后，会话与工作目录信息会保留在本地，以便下次启动时继续使用。

建议

保持同一会话上下文：日常工作中建议在同一个会话内完成连续性任务，让 Agent 获得更完整的上下文；开始新任务时再创建新会话。
谨慎切换模式：从 agent 切换至 ask 或 plan 后，工具调用能力会受限，请留意当前任务是否仍能正常运行。
善用帮助命令：遇到不熟悉的命令时，先执行 /help 查看帮助面板，再根据需要查阅本手册对应章节。