配置与 Daemon
使用 yeero config 管理语言、默认模型及 PATH 环境,使用 yeero start / stop / status 控制后台 Daemon 服务。
config 命令概览
yeero config 包含以下子命令,均为纯本地文件操作,无需 Daemon 运行:
| 子命令 | 说明 |
|---|---|
config get-lang | 查看当前界面语言 |
config set-lang | 设置界面语言 |
config get-default-model | 查看当前默认模型 |
config set-default-model | 设置默认模型 |
config unset-default-model | 清除默认模型(恢复内置默认) |
config add-to-path | 将 yeero 加入系统 PATH |
config get-path | 查看 PATH 中已有的 yeero 条目 |
config clear-path | 从 PATH 移除所有 yeero 条目 |
语言设置
yeero CLI 支持中文(zh)和英文(en)两种界面语言。
# 查看当前语言
yeero config get-lang
# 设置为中文
yeero config set-lang zh
# 设置为英文
yeero config set-lang en
# 不传参数将进入交互式输入
yeero config set-lang
语言配置持久化保存在 config.toml 中,路径按构建档位隔离(开发 / 预发 / 生产分别独立)。
每条命令也可通过 --lang zh / --lang en 临时覆盖语言,优先级高于配置文件。
默认模型
默认模型决定了 yeero chat、yeero app generate 等命令在未指定 --model 时所使用的模型。
# 查看当前默认模型
yeero config get-default-model
# 设置默认模型
yeero config set-default-model gpt-4o
# 不传参数将进入交互式输入
yeero config set-default-model
# 清除默认模型(回退到内置默认值)
yeero config unset-default-model
模型 ID 可通过 yeero models 命令获取完整列表。
将 yeero 加入 PATH
安装后如果终端无法识别 yeero 命令,可运行以下命令自动配置 PATH:
# 添加到用户级 PATH(推荐)
yeero config add-to-path
# 添加到系统级 PATH(需要管理员权限)
yeero config add-to-path --system
# 预览操作但不实际执行
yeero config add-to-path --dry-run
# 从 PATH 移除
yeero config add-to-path --remove
| 选项 | 说明 |
|---|---|
--system | 写入系统级 PATH(默认写入用户级) |
--remove | 从 PATH 移除 yeero 所在目录 |
--dry-run | 仅预览,不实际修改 |
此命令会在 ~/.bashrc、~/.zshrc 等 Shell 配置文件中追加 PATH 导出语句,修改后需重开终端或执行 source ~/.zshrc 生效。
查看 PATH 配置
使用 config get-path 可以查看当前 yeero 可执行文件所在目录,以及用户级和系统级 PATH 中已加入的 yeero 条目:
yeero config get-path
输出示例:
当前 yeero 目录: /usr/local/bin
用户级 PATH 中的 yeero 条目: /usr/local/bin
系统级 PATH: 未包含 yeero 条目
从 PATH 移除 yeero
config clear-path 用于从 PATH 中移除所有 yeero 相关条目(不追加新路径),适合卸载或迁移场景:
# 从用户级 PATH 移除(默认)
yeero config clear-path
# 从系统级 PATH 移除(需要管理员权限)
yeero config clear-path --system
# 预览操作但不实际执行
yeero config clear-path --dry-run
| 选项 | 说明 |
|---|---|
--system | 从系统级 PATH 移除(默认从用户级) |
--dry-run | 仅预览,不实际修改 |
clear-path 与 add-to-path --remove 效果完全一致,是更语义化的别名,便于直觉理解。
Daemon 概览
yeero CLI 的大部分功能(对话、AI 应用等)依赖一个后台 Daemon 进程。Daemon 以本地 HTTP 服务形式运行,负责与云端 API 通信、管理对话上下文和 AI 应用生命周期。
通常情况下,运行任意需要网络的命令时 Daemon 会自动启动。你也可以手动管理它:
启动 Daemon
# 启动 Daemon(后台运行)
yeero start
# 指定监听端口(默认自动分配)
yeero start --port 7700
# 前台运行(调试用途)
yeero start --foreground
停止 Daemon
yeero stop
此命令会向正在运行的 Daemon 发送终止信号,优雅退出。
查看状态
yeero status
输出示例:
Daemon running on port 7700
Version: 0.1.0
若 Daemon 未运行,将显示 Daemon not running。
配置文件路径
yeero 的配置文件 config.toml 按构建档位隔离存放:
| 系统 | 路径 |
|---|---|
| macOS / Linux | ~/.config/yeero/config.toml |
| Windows | %APPDATA%\yeero\config.toml |
配置文件为 TOML 格式,目前支持以下字段:
# 界面语言:zh 或 en
lang = "zh"
# 默认模型 ID(可选)
default_model = "gpt-4o"
请勿手动编辑 config.toml 中的其他字段,建议始终通过 yeero config 命令修改配置。