init

vw-agentic-rag/docs/topics/VSCODE_DEBUG_DEMO.md

@@ -0,0 +1,61 @@
+# VS Code调试演示
+
+你现在已经成功配置了VS Code调试环境！下面是具体的使用步骤：
+
+## 🎯 立即开始调试
+
+### 步骤1: 打开VS Code
+如果还没有在VS Code中打开项目：
+```bash
+cd /home/fl/code/ai-solution/agentic-rag-4
+code .
+```
+
+### 步骤2: 选择Python解释器
+1. 按 `Ctrl+Shift+P` 
+2. 输入 "Python: Select Interpreter"
+3. 选择 `.venv/bin/python`
+
+### 步骤3: 设置断点
+在 `service/llm_client.py` 的第42行（`astream` 方法）设置断点：
+- 点击行号左侧设置红色断点
+
+### 步骤4: 开始调试
+1. 按 `Ctrl+Shift+D` 打开调试面板
+2. 选择 "Debug Service with uvicorn"
+3. 按 `F5` 或点击绿色箭头
+
+### 步骤5: 触发断点
+在另一个终端运行测试：
+```bash
+cd /home/fl/code/ai-solution/agentic-rag-4
+uv run python scripts/test_real_streaming.py
+```
+
+断点将在LLM流式调用时触发！
+
+## 📋 可用的调试配置
+
+1. **Debug Agentic RAG Service** - 直接调试服务
+2. **Debug Service with uvicorn** - 推荐，使用uvicorn调试
+3. **Run Tests** - 调试测试用例  
+4. **Run Streaming Test** - 调试流式测试
+
+## 🛠️ 调试功能
+
+- **断点调试**: 在任意行设置断点
+- **变量查看**: 鼠标悬停或查看变量面板
+- **调用栈**: 查看函数调用链
+- **监视表达式**: 添加自定义监视
+- **调试控制台**: 执行Python表达式
+
+## 🔧 常用快捷键
+
+- `F5` - 开始调试/继续
+- `F9` - 切换断点
+- `F10` - 单步跳过
+- `F11` - 单步进入
+- `Shift+F11` - 单步跳出
+- `Shift+F5` - 停止调试
+
+现在你可以在VS Code中愉快地调试你的服务了！🚀