autogen/RUN_STREAMLIT.md

# Streamlit 运行说明

## 📂 生成的代码在哪里？

当您运行 `streamlit run frontend/streamlit_app_v3.py` 并启动 SDLC 工作流后，所有生成的文件都保存在：

```
c:\Workspace\AI_AutoGen\workspace\
```

## 📁 目录结构

```
c:\Workspace\AI_AutoGen/
├── workspace/              ← 生成的代码在这里！
│   ├── SRS.md             # 软件需求规格说明书
│   ├── test_battery_health.py  # 测试用例
│   ├── src_battery_health.py   # 源代码
│   ├── bdd_scenarios.md   # BDD 测试场景
│   ├── coverage_report.md # 测试覆盖率报告
│   └── FINAL_REPORT.md    # 最终项目报告
├── logs/                  ← 对话日志
│   └── session_*.jsonl    # 会话日志
└── frontend/
    └── streamlit_app_v3.py
```

## 🔍 如何查看生成的文件

### 方法 1: 在 Streamlit 界面查看（推荐）

运行 Streamlit 后，在界面右侧边栏会显示：
- **"生成的文件"** 区域
- 点击文件名可以预览内容
- 支持查看 `.md`, `.py`, `.txt` 等格式

### 方法 2: 直接在文件管理器查看

**Windows:**
```powershell
# 打开 workspace 目录
explorer c:\Workspace\AI_AutoGen\workspace
```

**命令行查看:**
```bash
# 查看所有生成的文件
dir c:\Workspace\AI_AutoGen\workspace

# 查看 SRS 文档
type c:\Workspace\AI_AutoGen\workspace\SRS.md

# 查看源代码
type c:\Workspace\AI_AutoGen\workspace\src_battery_health.py
```

### 方法 3: 使用 Python 脚本查看

创建一个快速查看脚本：

```python
# view_generated_files.py
from pathlib import Path

workspace = Path("workspace")
if workspace.exists():
    print("生成的文件列表:")
    for file in workspace.glob("*"):
        if file.is_file():
            print(f"  📄 {file.name} ({file.stat().st_size:,} bytes)")
else:
    print("workspace 目录不存在，请先运行 SDLC 工作流")
```

## 🎯 典型生成的文件

运行一次完整的 SDLC 工作流后，通常会生成以下文件：

| 文件名 | 类型 | 说明 | 生成 Agent |
|--------|------|------|-----------|
| `SRS.md` | Markdown | 软件需求规格说明书 | PM Agent |
| `test_*.py` | Python | 测试用例脚本 | QA Agent |
| `src_*.py` | Python | 源代码实现 | Dev Agent |
| `bdd_scenarios.md` | Markdown | BDD 测试场景 | QA Agent |
| `coverage_report.md` | Markdown | 测试覆盖率报告 | QA Agent |
| `FINAL_REPORT.md` | Markdown | 最终项目总结 | Orchestrator |

## 💡 示例：查看生成的代码

假设您运行了"电池健康预测 API"的示例，生成的代码会在：

**源代码位置:**
```
c:\Workspace\AI_AutoGen\workspace\src_battery_health.py
```

**测试代码位置:**
```
c:\Workspace\AI_AutoGen\workspace\test_battery_health.py
```

**需求文档位置:**
```
c:\Workspace\AI_AutoGen\workspace\SRS.md
```

## 🔧 在 Streamlit 中添加文件查看器

如果想要在 Streamlit 界面中直接查看生成的文件，可以在 `streamlit_app_v3.py` 中添加以下代码：

```python
# 在 sidebar 中添加
st.sidebar.subheader("📁 生成的文件")

workspace_dir = Path("workspace")
if workspace_dir.exists():
    files = list(workspace_dir.glob("*"))
    for file in files:
        if file.is_file():
            with st.sidebar.expander(f"📄 {file.name}"):
                try:
                    content = file.read_text(encoding='utf-8')
                    st.code(content[:1000] + ("..." if len(content) > 1000 else ""))
                    
                    # 下载按钮
                    st.download_button(
                        label="⬇️ 下载",
                        data=content,
                        file_name=file.name,
                        mime="text/plain"
                    )
                except Exception as e:
                    st.error(f"读取失败：{e}")
else:
    st.sidebar.info("工作目录为空，请先运行工作流")
```

## ⚠️ 注意事项

1. **首次运行会创建目录** - workspace 目录会在第一次运行时自动创建
2. **文件会覆盖** - 每次运行新的需求会覆盖之前的文件
3. **及时备份** - 重要的生成物请及时复制到其他目录
4. **日志目录** - 对话历史保存在 `logs/` 目录，格式为 JSONL

## 📊 查看对话日志

对话日志保存在 `logs/` 目录：

```bash
# 查看最新的会话日志
dir c:\Workspace\AI_AutoGen\logs\session_*.jsonl

# 使用 Python 查看
python -c "import json; [print(json.loads(line)) for line in open('logs/session_*.jsonl')]"
```

---

**🎉 现在您知道生成的代码在哪里了！**

运行 `streamlit run frontend/streamlit_app_v3.py` 后，所有生成的文件都会出现在 `workspace/` 目录中。