账号指南
概述
本章介绍 CLI 中所有与账号相关的命令和操作流程,适用场景包括:
- 首次使用 CLI,需登录后才能调用远端服务。
- 在多设备间切换,或因长时间未使用导致登录态过期。
- 希望在会话中临时切换账号,但不想退出当前对话。
- 需要确认当前登录态还能持续多久。
本章涵盖:登录、查看登录态、登出,以及 对话内的对应命令。
命令对照与触发方式
unitarylab login:以交互方式询问账号与密码。unitarylab whoami:显示账号标识与剩余有效时间。unitarylab logout:清空本地登录信息。- 会话中的
/login、/whoami、/logout:在不退出当前会话的前提下完成对应操作。
会话中命令与 CLI 子命令功能对应,使用场景不同:CLI 子命令在 shell 中调用,会影响整台设备的登录状态;会话中命令在对话过程中调用,并作用于当前会话。
登录
登录是调用 CLI 远端能力的前提。执行:
unitarylab login系统将依次提示输入:
- 账号:手机号(建议带
+86等国家区号)或邮箱。 - 密码:输入时不回显。
查看登录态
要确认当前 Token 是否有效,可执行:
unitarylab whoamiCLI 会显示账号标识与剩余有效时间。剩余有效时间不足 60 秒即视为过期,过期后需重新登录。
如果要在不退出会话的情况下检查登录态,可在会话中执行 /whoami :
[agent│deepseek-v4-pro] › /whoami输出结果与 unitarylab whoami 相同。
登出
执行:
unitarylab logoutCLI 将清空本地保存的登录态,但不会影响:
- 账号在远端的状态。
- 其他设备上的登录态。
登出后,任何需要远端凭据的命令都会要求重新登录。
会话中的对应命令
会话中提供了等效命令,方便用户在不退出会话的情况下处理登录状态变化:
| 会话中命令 | 行为 |
|---|---|
/login | 会话中重新登录,刷新当前会话的 Token,不退出当前会话。 |
/whoami | 解析当前 Token,显示账号标识与剩余有效时间。 |
/logout | 清空本地 Token;下一次工具调用会收到 401 响应,并提示执行 /login。 |
典型场景:
[agent│deepseek-v4-pro] › 帮我求解一个1D热方程
(Agent 调用工具,远端返回 401)
请重新登录:在会话中执行 /login,或退出后会话后运行 unitarylab login
[agent│deepseek-v4-pro] › /login
账号:+8617700000000
密码:********
✓ 登录成功
[agent│deepseek-v4-pro] › 帮我求解一个1D热方程
(重试成功)登录态过期
当登录态过期需要重新登录时,模型会提示你在会话中执行 /login 或返回 shell 执行 unitarylab login。
建议
- 在共享或不可信设备上:使用完毕后执行
/logout或unitarylab logout。 - 在个人开发机上:登录一次即可,过期后 CLI 会自动提醒。
- 收到“请重新登录”提示时:优先使用会话内的
/login,以保留当前会话上下文,避免对话中断。 - 切换多账号:先
/logout再/login或在另一个终端窗口中分别保持各自的登录状态。
最后更新于