配置与 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 选项

每条命令也可通过 --lang zh / --lang en 临时覆盖语言,优先级高于配置文件。

默认模型

默认模型决定了 yeero chatyeero 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仅预览,不实际修改
💡 macOS / Linux

此命令会在 ~/.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仅预览,不实际修改
💡 与 add-to-path --remove 的区别

clear-pathadd-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 命令修改配置。