AutoHedge · 第 5 章 CLI与交互体验

AutoHedge · 第 5 章 CLI与交互体验

章节摘要:本章属「外围篇」,讲用户与 AutoHedge 交互的两层。先是 autohedge/cli.py(约 190 行)——一个用 rich 库美化的交互式 REPL:欢迎屏、最近任务历史(存于 ~/.autohedge/recent_tasks.txt)、命令解析、循环接收用户输入并交给 Agent。再是 autohedge/main.py(约 52 行)的 AutoHedge 主类——它维护一个 swarms.Conversation 消息历史,调用 director_agent,并支持 list/dict/str 三种输出格式。本章共 3 节,前置依赖为「第 1~3 章」。

学习目标

阅读完本章,你应当能够:

1. 精读 cli.py,理解 Rich 美化的 REPL 循环与欢迎屏。
2. 理解命令解析与任务历史的持久化。
3. 精读 main.py 的 AutoHedge 主类,说清三种输出格式(list/dict/str)。

核心概念速览

CLI 是框架的「门面」——它决定用户怎么用、怎么记、怎么看结果。

子章节导航

01 Rich 美化的 REPL

rich 的 Panel/Columns/Text、欢迎屏、REPL 主循环、退出处理。

02 命令解析与任务历史

argparse、命令路由、~/.autohedge/recent_tasks.txt 的读写、历史回看。

03 主类 AutoHedge 与三种输出格式

main.py 逐行、Conversation 消息历史、return_messages_as_list/dict/str 的差异。

子章节之间的逻辑关系

本章第 01 节(REPL) ──► 第 02 节(命令/历史) ──► 第 03 节(主类/输出)
   │
   ▼
下一章(第 6 章 LLM 工具调用体系)
​

前置知识与后续延伸

前置知识:

• 第 1~3 章(理解 Agent 与编排)

后续延伸:

• 第 6 章讲 REPL 背后 Agent 调用的工具