UnitaryLab CLI 用户手册

UnitaryLab CLI 是 UnitaryLab 的本地终端命令行工具。在终端执行 unitarylab 命令即可进入交互式对话环境（REPL），Agent 会协助您进行模型对话、文件读写，并调用量子算法、PDE 求解等内置技能。

本手册面向直接使用 CLI 的用户，覆盖从启动、日常对话、技能调用、会话管理到故障排查的完整流程。如果您使用 Web 端产品，请参阅《Unitary Studio Web 用户手册》。

适用人群

• 习惯在终端中工作，希望通过命令行完成日常对话和文件协作的开发者。
• 需要在本地保留对话历史与工作目录结构的研究人员。
• 需要将 UnitaryLab Agent 嵌入本地脚本与工作流的工程师。
• 以及对量子计算和 CLI 工具有浓厚兴趣的其他用户。

核心能力

• 本地交互对话：在终端中以会话方式与 Agent 进行多轮对话，对话历史持久化保存在本地。
• 多对话模式：提供 agent（完整工具链）、ask（检索问答）、plan（规划式）三种对话模式，满足不同场景。
• 多模型支持：兼容 DashScope、OpenAI 及任意 OpenAI 兼容服务（如 SiliconFlow、本地 vLLM等）。可在配置阶段一次性添加多个模型，运行中随时切换。
• 会话与工作目录绑定：每个会话自动记录最近使用的工作目录，恢复会话时可直接继续之前的工作。
• 技能调用：通过 /<技能名> 命令直接驱动 Agent 加载量子算法、PDE 求解、代码空间等内置技能。
• 本地账号登录：通过账号密码登录，登录状态本地持久化，凭证过期后自动提示重新登录。

章节导航

• 快速开始：从零启动到第一次对话。
• 账号指南：登录、登出、查看登录状态。
• 模型配置指南：配置 LLM Provider、API Base、API Key 与模型列表。
• 交互对话指南：会话中提示符、对话模式、运行时切换、文件打开操作。
• 会话与工作目录指南：会话切换、工作目录、本地历史记录。
• 技能调用指南：调用内置skills的方法。
• 排障指南：常见问题与排查思路。

建议

• 首次使用：请跟随 快速开始 中的引导完成配置和登录，再阅读其他章节。
• 已能正常对话：按需查阅相关章节即可。会话内的 /help 命令始终是查看可用指令的最快方式。
• 遇到问题：请优先查阅 排障指南。您也可以直接在对话中向 Agent 描述遇到的现象，Agent 会尝试进行自主诊断。