fix: 修复 NameError/状态污染/类型标注/统计; 补全练习与 main; 新增 config/.gitignore/requirements; 文档统一

step_05_07_advanced/README.md

@@ -200,30 +200,28 @@ class MultiAgentSystem:
 
     def __init__(self):
         # 注册各个 Agent
-        self.agents = {
-            "generator": GeneratorAgent(),
-            "validator": ValidatorAgent(),
-            "searcher": SearcherAgent(),
-        }
-        # 协调器
-        self.orchestrator = Orchestrator(self.agents)
+        self.agents: dict[str, Agent] = {}
 
-    def process(self, requirement: str) -> str:
-        """协调多个 Agent 处理请求"""
+    def register(self, agent: Agent) -> None:
+        self.agents[agent.name] = agent
+
+    def process(self, requirement: str):
         # 1. 搜索相关知识
-        context = self.agents["searcher"].search(requirement)
+        searcher = self.agents.get("searcher")
+        context = searcher.process(requirement) if searcher else ""
 
         # 2. 生成（可能需要多轮）
-        for attempt in range(3):
-            draft = self.agents["generator"].generate(requirement, context)
+        generator = self.agents.get("generator")
+        draft = generator.process({"requirement": requirement, "context": context}) if generator else requirement
 
-            # 3. 验证
-            validation = self.agents["validator"].validate(draft)
+        # 3. 验证
+        validator = self.agents.get("validator")
+        if validator:
+            validation = validator.process(draft)
+            if not validation.get("passed", True):
+                return {"error": "验证失败", "validation": validation}
 
-            if validation["passed"]:
-                return validation["result"]
-
-        return "处理失败"
+        return draft
 ```
 
 ---