CLI 命令参考

yeero CLI 所有子命令的语法、参数和示例。

命令总览

命令说明
yeero start启动后台 daemon 服务
yeero stop停止 daemon 或所有 yeero 进程
yeero restart重启 daemon
yeero status查看 daemon 运行状态
yeero login邮箱验证码登录
yeero logout退出登录
yeero whoami查看当前登录账号
yeero chat发起 AI 对话（TUI / 行式 / 一次性）
yeero chats列出对话与文件夹
yeero models列出可用 AI 模型
yeero tools列出可用工具
yeero app管理 Python AI 应用
yeero config管理本地配置
yeero update检查并自动更新 CLI

全局选项

以下选项适用于所有子命令：

选项说明
--lang <LANG>临时覆盖界面语言（zh 或 en），不写入配置
--log-level <LEVEL>日志级别（trace｜debug｜info｜warn｜error）
-h, --help输出帮助信息
-V, --version输出版本号

yeero start

启动后台 daemon HTTP 服务。大多数命令会自动按需启动 daemon，通常无需手动运行。

yeero start [OPTIONS]
选项默认说明
-p, --port <PORT>3000监听端口
--host <HOST>127.0.0.1监听地址
-d, --detach—后台运行，spawn 子进程后立即返回
 
# 前台启动（日志输出到终端）
yeero start

# 后台运行
yeero start --detach

# 指定端口
yeero start --port 8080 --detach

yeero stop

停止 daemon 服务。

yeero stop [OPTIONS]
选项说明
-f, --force强制结束，不等待优雅关闭
--all停止所有 yeero 进程（含 chat / app run / TUI 等，隐含强杀）
 
yeero stop
yeero stop --force
yeero stop --all

yeero status

查看 daemon 是否在运行及监听端口。

yeero status

yeero restart

重启后台 daemon：先停止正在运行的 daemon，再以 detached 模式在后台重新拉起。若 daemon 原本未运行，则直接启动。

yeero restart [OPTIONS]
选项说明
-f, --force强制结束旧进程，不等待优雅关闭
 
# 优雅重启
yeero restart

# 强制重启
yeero restart --force

yeero login

邮箱验证码登录。CLI 不支持 OAuth，如需使用 Google / GitHub 登录请使用网页端或桌面端。

yeero login [OPTIONS]
选项说明
--email <EMAIL>预填邮箱，跳过交互输入
--code <CODE>预填验证码，跳过发码步骤（需同时传 --email）
 
# 交互式登录
yeero login

# 非交互登录（适合 CI/脚本）
yeero login --email [email protected] --code 123456

yeero logout

退出当前账号，清除本地 Token。

yeero logout

yeero whoami

打印当前登录账号信息（JSON 格式）。未登录时输出提示。

yeero whoami

yeero chat

发起 AI 对话。支持 TUI 全屏模式、行式多轮模式和一次性模式。详细使用见对话详解。

yeero chat [MESSAGE] [OPTIONS]

常用参数：

选项说明
MESSAGE初始消息（可选，不传则进入空白会话）
--plain使用行式模式（替代 TUI）
--oneshot发送消息后立即退出，适合脚本/管道
-m, --model <MODEL>指定模型 ID，可重复传入（多模型并行）
--chat-id <ID>接续现有会话
--branch-id <ID>接续现有分支
--folder-id <ID>新建对话时指定所属文件夹
--tool <ID>启用工具（可重复传入）
--user-file <PATH>上传本地文件作为附件（可重复传入）
--use-knowledge启用知识库检索
 
yeero chat "解释什么是向量数据库"
yeero chat -m gpt-4o -m claude-3-5-sonnet "对比两个模型的回答"
yeero chat --oneshot "今天日期是？"

yeero chats

列出当前账号的对话与文件夹。

yeero chats [OPTIONS]
选项默认说明
--folder-id <ID>0（根目录）指定父文件夹 ID
--name <KEYWORD>—按名称模糊搜索
--pinned—仅返回置顶项
--order <ORDER>DEFAULTDEFAULT 或 EARLIEST
--page <N>1页码
--size <N>50每页条数（1~200）
--json—以 JSON 格式输出（脚本友好）
 
yeero chats
yeero chats --name "架构" --json

yeero models

列出当前账号可用的 AI 模型。

yeero models [OPTIONS]
选项说明
--keyword <KW>按名称模糊搜索
--free仅展示免费模型
--input-modalities <LIST>按输入能力过滤，逗号分隔（如 text,image）
--output-modalities <LIST>按输出能力过滤，逗号分隔（如 text,audio）
--page / --size分页参数
--json以 JSON 格式输出
 
yeero models
yeero models --keyword claude --free
yeero models --output-modalities image --json

yeero tools

列出当前账号可用的工具。

yeero tools [OPTIONS]
选项说明
--keyword <KW>按 ID / 名称 / 描述模糊搜索
--json以 JSON 格式输出
 
yeero tools
yeero tools --keyword search --json

yeero app

管理 Python AI 应用。包含多个子命令，详细使用见AI 应用。

子命令说明
yeero app create创建新 Python 应用
yeero app list列出所有应用
yeero app show查看应用详情
yeero app save保存本地文件为新版本
yeero app versions列出版本历史
yeero app version-show查看指定版本详情
yeero app rollback回滚到指定版本
yeero app generateAI 代码生成（单轮）
yeero app discussAI 多轮讨论 REPL
yeero app run运行应用
yeero app stop停止运行中的应用
yeero app uninstall卸载本地已安装应用

yeero config

管理本地配置。详细使用见配置与 Daemon。

子命令说明
yeero config get-lang查看当前界面语言
yeero config set-lang <LANG>设置界面语言（zh 或 en）
yeero config get-default-model查看默认模型
yeero config set-default-model <MODEL>设置默认模型
yeero config unset-default-model清除默认模型设置
yeero config add-to-path将 yeero 目录加入系统 PATH
yeero config get-path查看 PATH 中已有的 yeero 条目
yeero config clear-path从 PATH 移除所有 yeero 条目

yeero update

检查并自动更新 CLI 到最新版本。

yeero update [OPTIONS]
选项说明
--check仅检查是否有新版本，不下载安装
 
# 检查更新并自动安装
yeero update

# 仅检查，不安装
yeero update --check
💡 自动检查更新

每次运行 CLI 命令时，会在后台静默检查（1 小时 TTL 缓存），有新版本时显示一行黄色提示，不阻塞当前命令执行。

上一篇← CLI 快速入门