CLI 对话详解
深入了解 yeero chat——行式多轮模式、一次性模式、多媒体生成与采样参数。
两种交互模式
行式多轮模式（默认）
yeero chat 默认进入行式多轮模式：在终端提示符后输入消息，按 Enter 发送，AI 回复流式输出；可持续多轮对话，输入 /exit 或按 Ctrl+C 退出。
# 启动行式多轮（新对话）
yeero chat
# 携带首轮消息启动
yeero chat "分析一下这段代码"
# 接续已有对话
yeero chat --chat-id 12345一次性模式
加上 --oneshot 发送一条消息后立即退出，适合脚本、管道和 CI 场景：
# 直接输出 AI 回复
yeero chat --oneshot "用一句话总结量子计算"
# 管道输入
cat error.log | yeero chat --plain --oneshot "帮我解释这个错误"
# 关闭颜色输出（适合管道或日志采集）
yeero chat --no-color --oneshot "生成一段 JSON"多模型并行
通过多次传入 -m 同时向多个模型发送相同消息，并排比较回答：
yeero chat -m gpt-4o -m claude-3-5-sonnet "哪个编程语言更适合 AI 开发？"
yeero chat -m deepseek-r1 -m gemini-2.5-pro "解这道数学题：..."不传 -m 时使用默认模型（可通过 yeero config set-default-model 设置）。
会话与分支管理
| 选项 | 说明 |
|---|---|
--chat-id <ID> | 接续指定会话（从已有历史继续） |
--branch-id <ID> | 接续指定分支 |
--folder-id <ID> | 新建对话时指定所属文件夹 |
# 查找对话 ID
yeero chats --name "上次的项目"
# 接续该对话
yeero chat --chat-id 98765 "继续之前的讨论"文件与工具
附件上传
使用 --user-file 上传本地文件作为对话附件（可重复传入多个文件）：
yeero chat --user-file ./report.pdf "总结这份报告的要点"
yeero chat --user-file image1.png --user-file image2.png "比较这两张图片"启用工具
使用 --tool 指定工具 ID（可通过 yeero tools 查看可用工具）：
yeero tools # 列出可用工具
yeero chat --tool web_search "今天有什么科技新闻？"知识库检索
yeero chat --use-knowledge "根据我的历史对话，总结我关注的主要技术领域"采样参数
精细控制模型生成行为：
| 选项 | 范围 | 说明 |
|---|---|---|
--temperature | 0~2 | 采样温度，越高越随机（默认由模型决定） |
--nucleus-sampling | 0~2 | Top-P 文本多样性 |
--maximum-token-count | 正整数 | 最大生成词元数量 |
--presence-penalty | 0~2 | 话题发散度，减少重复话题 |
--frequency-penalty | 0~2 | 词汇丰富度，减少重复词汇 |
--reasoning-effort | XHIGH｜HIGH｜MEDIUM｜LOW｜MINIMAL｜NONE | 推理程度（支持推理的模型） |
--message-window-size | 0–100 | 上下文历史消息窗口大小 |
yeero chat --temperature 0.2 --reasoning-effort HIGH "写一篇严谨的技术分析"
yeero chat --temperature 1.5 "给我一个创意十足的故事开头"图片生成
选择支持图片输出的模型（如 dall-e-3、gpt-image-1），并传入图片参数：
| 选项 | 可选值 | 说明 |
|---|---|---|
--image-aspect-ratio | RATIO_1_1｜RATIO_2_3｜RATIO_3_2｜RATIO_4_3｜RATIO_3_4｜RATIO_16_9｜RATIO_9_16 | 图片宽高比 |
--image-size | SIZE_1K｜SIZE_2K｜SIZE_4K | 图片分辨率 |
yeero chat -m dall-e-3 --image-aspect-ratio RATIO_16_9 --image-size SIZE_2K "一幅赛博朋克城市夜景"音频生成
选择支持音频输出的模型（如 gpt-4o-audio），传入音频参数：
| 选项 | 可选值 | 说明 |
|---|---|---|
--audio-voice | ALLOY｜ECHO｜FABLE｜ONYX｜NOVA｜SHIMMER | 合成语音音色 |
--audio-format | WAV｜MP3｜FLAC｜OPUS｜PCM16 | 音频输出格式 |
yeero chat -m gpt-4o-audio --audio-voice NOVA --audio-format MP3 "朗读这段文字：..."视频生成
选择支持视频输出的模型，传入视频参数（视频生成为异步任务，CLI 会自动轮询结果）：
| 选项 | 可选值 | 说明 |
|---|---|---|
--video-aspect-ratio | RATIO_16_9｜RATIO_9_16｜RATIO_1_1｜RATIO_4_3｜RATIO_3_4 | 视频宽高比 |
--video-resolution | P480｜P720｜P1080｜K1｜K2｜K4 | 视频分辨率 |
--video-duration | 1–300（秒） | 视频时长 |
--video-generate-audio | true｜false | 是否同时生成音频轨道 |
yeero chat -m wan-2.1 --video-aspect-ratio RATIO_16_9 --video-resolution P720 --video-duration 10 "一只猫在草地上奔跑"