157 lines
3.3 KiB
Markdown
157 lines
3.3 KiB
Markdown
# AutoGen SDLC 系统 - 问题修复说明
|
||
|
||
## 🔧 已修复的问题
|
||
|
||
### 问题：Streamlit 运行时报错 `'TERMINAL'`
|
||
|
||
**错误现象**:
|
||
```
|
||
错误：'TERMINAL'
|
||
```
|
||
|
||
**根本原因**:
|
||
`UserProxyAgent` 的 `human_input_mode="TERMINAL"` 设置会在 Web 环境下尝试使用终端输入，导致 Streamlit 报错。
|
||
|
||
**解决方案**:
|
||
将所有文件中的 `human_input_mode="TERMINAL"` 改为 `human_input_mode="NEVER"`。
|
||
|
||
### 修改的文件
|
||
|
||
1. ✅ `frontend/streamlit_app_v2.py` (第 224 行)
|
||
2. ✅ `frontend/streamlit_app.py` (第 104 行)
|
||
3. ✅ `autogen_sdls_system.py` (第 115 行)
|
||
|
||
---
|
||
|
||
## 🚀 现在可以正常运行了
|
||
|
||
### 方式 1: Streamlit 增强版界面（推荐）
|
||
|
||
```bash
|
||
streamlit run frontend/streamlit_app_v2.py
|
||
```
|
||
|
||
**功能特色**:
|
||
- 🎭 Agent 实时状态面板
|
||
- 🔄 Mermaid 工作流程图
|
||
- ⏱️ 执行时间线
|
||
- 💬 对话实录展示
|
||
- 📁 生成文件预览
|
||
- 📊 统计仪表盘
|
||
|
||
### 方式 2: Streamlit 经典界面
|
||
|
||
```bash
|
||
streamlit run frontend/streamlit_app.py
|
||
```
|
||
|
||
### 方式 3: 命令行完整工作流
|
||
|
||
```bash
|
||
python autogen_sdls_system.py
|
||
```
|
||
|
||
### 方式 4: HTML 独立演示（无需依赖）
|
||
|
||
```bash
|
||
# 直接在浏览器打开
|
||
demo_visualization.html
|
||
```
|
||
|
||
---
|
||
|
||
## ⚙️ 配置说明
|
||
|
||
### 环境变量设置
|
||
|
||
**Windows PowerShell**:
|
||
```powershell
|
||
$env:DASHSCOPE_API_KEY="your_api_key_here"
|
||
```
|
||
|
||
**Linux/Mac**:
|
||
```bash
|
||
export DASHSCOPE_API_KEY="your_api_key_here"
|
||
```
|
||
|
||
### 依赖安装
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
或单独安装：
|
||
```bash
|
||
pip install streamlit autogen dashscope pytest
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 Agent 说明
|
||
|
||
| Agent | 职责 | 图标 |
|
||
|-------|------|------|
|
||
| PM Agent | 产品经理 - 需求分析与 SRS 生成 | 📋 |
|
||
| QA Agent | 测试工程师 - 测试用例设计 | ✅ |
|
||
| Dev Agent | 开发工程师 - 代码实现 | 💻 |
|
||
| Orchestrator | 协调器 - 流程调度与验证 | 🎯 |
|
||
| User Proxy | 用户代理 - 人机交互 | 👤 |
|
||
|
||
---
|
||
|
||
## 📊 工作流程
|
||
|
||
```
|
||
用户需求
|
||
↓
|
||
📋 PM Agent → SRS 文档
|
||
↓
|
||
✅ QA Agent → 测试用例
|
||
↓
|
||
💻 Dev Agent → 源代码
|
||
↓
|
||
🔧 自动测试
|
||
↓ (失败)
|
||
💻 Dev Agent (修复)
|
||
↓ (通过)
|
||
🎯 Orchestrator → 最终报告
|
||
```
|
||
|
||
---
|
||
|
||
## 💡 使用提示
|
||
|
||
1. **API Key 获取**: 访问 [阿里云 DashScope 控制台](https://dashscope.console.aliyun.com/)
|
||
2. **模型选择**: 推荐使用 `qwen3.5-flash`（速度快、成本低）
|
||
3. **工作目录**: 所有生成的文件保存在 `workspace/` 目录
|
||
4. **日志位置**: 对话历史保存在 `logs/` 目录
|
||
5. **人机协同**: 如需人工确认，可在代码中添加 Streamlit 弹窗
|
||
|
||
---
|
||
|
||
## 🐛 常见问题
|
||
|
||
### Q1: 仍然报错怎么办？
|
||
|
||
**检查清单**:
|
||
- [ ] API Key 是否正确设置
|
||
- [ ] 依赖包是否安装完整
|
||
- [ ] Python 版本是否 >= 3.9
|
||
- [ ] 工作目录是否有写权限
|
||
|
||
### Q2: 如何查看详细的错误信息？
|
||
|
||
在 Streamlit 界面查看底部的红色错误提示，或在命令行运行查看完整堆栈。
|
||
|
||
### Q3: 生成的代码在哪里？
|
||
|
||
所有生成的文件都在 `workspace/` 目录下，可以在 Streamlit 界面的"生成的文件"区域查看。
|
||
|
||
---
|
||
|
||
## 📞 技术支持
|
||
|
||
如有其他问题，请查看：
|
||
- [AutoGen 官方文档](https://microsoft.github.io/autogen/)
|
||
- [阿里云 DashScope 文档](https://help.aliyun.com/zh/dashscope/)
|