交互对话指南

概述

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

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

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

启动与提示符

启动方式

下面两条命令完全等价：

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

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

启动横幅与自检

启动后会依次出现：

1. 品牌横幅：显示 UnitaryLab 字样。

2. 启动自检徽章：单行元信息。

3. 向导步骤：参见 快速开始 的「启动会话」章节。

会话提示符

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

[agent│deepseek-v4-pro] ›

含义：

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

对话模式

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

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

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

运行时切换

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

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

输入体验

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

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

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

/files 文件管理

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

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

帮助：/help

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

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

退出

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

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

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

建议

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