docs: 📚 完善系统文档

- 添加控制台应用程序使用说明
- 优化文档结构和格式
- 补充界面预览和操作指南
- 更新功能说明和注意事项

Readme.md

@@ -150,6 +150,66 @@ Epoch 10/10
 - 训练完成后模型自动保存到 models/yingyan_model.h5
 - 详细日志记录在 log 目录下
 
+## 🖥 控制台应用程序
+
+### 启动控制台
+
+```bash
+python run.py
+```
+
+控制台应用程序提供以下功能：
+
+1. 启动 API 服务
+
+   - 启动 FastAPI 服务器
+   - 默认端口：8000
+   - 支持热重载
+
+2. 启动实时监控
+
+   - 打开摄像头进行实时内容识别
+   - 支持视频录制和截图
+   - 实时显示识别结果
+
+3. 训练模型
+
+   - 一键启动模型训练
+   - 自动保存训练结果
+   - 显示训练进度
+
+4. 系统状态
+
+   - 查看 AI 模型加载状态
+   - 检查 API 服务就绪情况
+   - 监控实时监控系统状态
+
+### 操作说明
+
+- 使用数字键 1-4 选择对应功能
+- 按 q 退出程序
+- 按 Enter 确认选择
+- 系统状态界面按任意键返回主菜单
+
+### 界面预览
+```bash
+╭───────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ │
+│ 鹰眼 AI 系统控制台 │
+│ ================= │
+│ │
+╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭──────┬──────────────╮
+│ 选项 │ 描述          │
+├──────┼──────────────┤
+│ 1 │ 启动 API 服务    │
+│ 2 │ 启动实时监控      │
+│ 3 │ 训练模型         │
+│ 4 │ 系统状态         │
+│ q │ 退出系统         │
+╰──────┴──────────────╯
+请选择操作 [1/2/3/4/q]: 
+```
 
 ### 启动服务
 

run.py

@@ -1,7 +1,95 @@
 import uvicorn
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Prompt
+from rich.table import Table
+from rich.live import Live
+from rich import box
+import sys
+import os
 
-# To build executable
-# pyinstaller --onefile --windowed --name YYAI {SCRIPT}t.py
+console = Console()
 
-if __name__ == "__main__":
+
+def display_banner():
+    banner = """
+    鹰眼AI系统控制台
+    =================
+    """
+    console.print(Panel(banner, style="bold green"))
+
+
+def display_menu():
+    table = Table(box=box.ROUNDED)
+    table.add_column("选项", style="cyan")
+    table.add_column("描述", style="yellow")
+
+    table.add_row("1", "启动API服务")
+    table.add_row("2", "启动实时监控")
+    table.add_row("3", "训练模型")
+    table.add_row("4", "系统状态")
+    table.add_row("q", "退出系统")
+
+    console.print(table)
+
+
+def start_api():
+    console.print("[bold green]正在启动API服务...[/]")
     uvicorn.run("src.app:app", host="0.0.0.0", port=8000, reload=True)
+
+
+def start_monitor():
+    console.print("[bold green]正在启动实时监控...[/]")
+    os.system("python3 tools/live.py")
+
+
+def train_model():
+    console.print("[bold green]正在启动模型训练...[/]")
+    os.system("python3 src/YingYanAI.py")
+
+
+def show_status():
+    status = Table(title="系统状态")
+    status.add_column("组件", style="cyan")
+    status.add_column("状态", style="green")
+
+    model_exists = os.path.exists("models/yingyan_model.h5")
+    status.add_row("AI模型", "已加载" if model_exists else "未加载")
+    status.add_row("API服务", "就绪")
+    status.add_row("实时监控", "就绪")
+
+    console.print(status)
+
+
+def main():
+    try:
+        while True:
+            console.clear()
+            display_banner()
+            display_menu()
+
+            choice = Prompt.ask("请选择操作", choices=["1", "2", "3", "4", "q"])
+
+            if choice == "1":
+                start_api()
+            elif choice == "2":
+                start_monitor()
+            elif choice == "3":
+                train_model()
+            elif choice == "4":
+                show_status()
+                input("\n按回车键继续...")
+            elif choice.lower() == "q":
+                console.print("[bold red]正在退出系统...[/]")
+                break
+
+    except KeyboardInterrupt:
+        console.print("\n[bold red]用户中断，正在退出...[/]")
+    except Exception as e:
+        console.print(f"[bold red]错误: {str(e)}[/]")
+    finally:
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()