cloneloop 0.1.0__py3-none-any.whl

mcp_ai_supervisor/web/core/auto_responder.py

@@ -0,0 +1,332 @@
+#!/usr/bin/env python3
+"""
+自动回复生成器模块（降级方案 D7）
+================================
+
+当 Agent（qodercli）不可用时的降级回复生成器。
+
+- MCP_AGENT_ENABLED=false → 直接走 AutoResponder
+- Agent 调用失败/超时 → 降级走 AutoResponder
+
+主要功能：
+- 检测问句类型（确认、建议、选择、澄清等）
+- 生成代码自检提示（当检测到代码变更时）
+- 加载项目规范（.cursor/rules/ 或 .qoder/rules/）
+"""
+
+from __future__ import annotations
+
+from enum import Enum
+from pathlib import Path
+
+from .scene_detector import SceneResult
+from ...debug import server_debug_log as debug_log
+
+
+class QuestionType(Enum):
+    """问句类型枚举"""
+
+    NONE = "none"  # 非问句
+    CONFIRMATION = "confirmation"  # 确认类（是否、要不要）
+    SUGGESTION = "suggestion"  # 建议类（我建议、推荐）
+    CHOICE = "choice"  # 选择类（A还是B）
+    CLARIFICATION = "clarification"  # 澄清类（什么意思、为什么）
+
+
+class AutoResponder:
+    """
+    自动回复生成器
+
+    负责在 auto 模式下自动生成回复内容，包括：
+    - 检测问句类型并生成对应回复
+    - 检测代码变更并生成自检提示
+    - 加载项目规范并追加到响应中
+    """
+
+    def generate(
+        self,
+        scene: SceneResult,
+        summary: str,
+        intention: str,
+        project_dir: str = "",
+    ) -> str:
+        """
+        生成自动回复内容
+
+        Args:
+            scene: 场景检测结果
+            summary: 工作摘要
+            intention: AI 意图/回复内容
+            project_dir: 项目目录路径（可选）
+
+        Returns:
+            str: 自动生成的回复内容
+
+        逻辑：
+        - 如果 scene.has_code_changes 为 True：返回代码自检提示
+        - 否则：检测问句类型，返回对应回复
+        """
+        if scene.has_code_changes:
+            return self._build_code_review_prompt(scene, project_dir)
+
+        question_type = self._detect_question(summary, intention)
+        return self._get_response_for_question_type(question_type)
+
+    def _detect_question(self, summary: str, intention: str) -> QuestionType:
+        """
+        检测问句类型
+
+        Args:
+            summary: 工作摘要
+            intention: AI 意图/回复内容
+
+        Returns:
+            QuestionType: 检测到的问句类型
+
+        检测逻辑：
+        1. 获取 intention 或 summary 的最后 300 字符
+        2. 检测关键词匹配
+        3. 检测问号标记
+        4. 返回匹配的类型
+        """
+        # 获取最后 300 字符用于分析
+        text = intention if intention else summary
+        if not text:
+            return QuestionType.NONE
+
+        # 取最后 300 字符
+        analysis_text = text[-300:] if len(text) > 300 else text
+        analysis_text_lower = analysis_text.lower()
+
+        # 确认类关键词
+        confirmation_keywords = [
+            "是否",
+            "要不要",
+            "确认",
+            "可以吗",
+            "行吗",
+            "好吗",
+            "对吗",
+            "shall",
+            "should we",
+            "confirm",
+        ]
+
+        # 建议类关键词
+        suggestion_keywords = [
+            "建议",
+            "推荐",
+            "suggest",
+            "recommend",
+            "方案",
+        ]
+
+        # 选择类关键词
+        choice_keywords = [
+            "还是",
+            "或者",
+            "a方案",
+            "b方案",
+            "方案一",
+            "方案二",
+            "which",
+            "choose",
+            "option",
+        ]
+
+        # 澄清类关键词
+        clarification_keywords = [
+            "什么意思",
+            "为什么",
+            "怎么",
+            "如何",
+            "能解释",
+            "what",
+            "why",
+            "how",
+            "explain",
+        ]
+
+        # 检测关键词
+        for keyword in confirmation_keywords:
+            if keyword in analysis_text_lower:
+                return QuestionType.CONFIRMATION
+
+        for keyword in suggestion_keywords:
+            if keyword in analysis_text_lower:
+                return QuestionType.SUGGESTION
+
+        for keyword in choice_keywords:
+            if keyword in analysis_text_lower:
+                return QuestionType.CHOICE
+
+        for keyword in clarification_keywords:
+            if keyword in analysis_text_lower:
+                return QuestionType.CLARIFICATION
+
+        # 检测问号
+        has_question_mark = "?" in analysis_text or "？" in analysis_text
+
+        # 如果只有问号没有关键词，返回澄清类
+        if has_question_mark:
+            return QuestionType.CLARIFICATION
+
+        # 否则返回非问句
+        return QuestionType.NONE
+
+    def _get_response_for_question_type(self, question_type: QuestionType) -> str:
+        """
+        根据问句类型返回对应回复
+
+        Args:
+            question_type: 问句类型
+
+        Returns:
+            str: 对应的回复内容
+        """
+        responses = {
+            QuestionType.CONFIRMATION: "是的，请继续执行。",
+            QuestionType.SUGGESTION: "好的，按照你建议的方案继续执行。",
+            QuestionType.CHOICE: "请根据你的专业判断选择最佳方案。",
+            QuestionType.CLARIFICATION: "请根据你的专业判断决定。",
+            QuestionType.NONE: "✅ 本次检查通过，请继续执行。",
+        }
+        return responses.get(question_type, "✅ 本次检查通过，请继续执行。")
+
+    def _build_code_review_prompt(
+        self, scene: SceneResult, project_dir: str = ""
+    ) -> str:
+        """
+        构建代码自检提示
+
+        Args:
+            scene: 场景检测结果
+            project_dir: 项目目录路径（可选）
+
+        Returns:
+            str: 代码自检提示文本
+
+        包含内容：
+        1. 变更文件列表（最多10个）
+        2. 4个自检检查点
+        3. 项目规范（如果存在）
+        """
+        # 列出变更文件（最多10个）
+        changed_files = scene.changed_files[:10]
+        file_list_text = "\n".join(f"- {f}" for f in changed_files)
+
+        if len(scene.changed_files) > 10:
+            file_list_text += f"\n...等共 {len(scene.changed_files)} 个文件"
+
+        # 构建自检提示
+        prompt = f"""━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 【代码自检提示】
+
+检测到代码变更，请自检以下内容：
+
+📁 变更文件：
+{file_list_text}
+
+✅ 请检查：
+1. 功能完整性：是否完成了要求的所有功能？
+2. 代码质量：是否有明显的 bug 或安全问题？
+3. 向后兼容：是否破坏了现有功能？
+4. 测试覆盖：关键逻辑是否有测试？
+
+"""
+
+        # 加载项目规范
+        project_rules = self._load_project_rules(project_dir)
+        if project_rules:
+            prompt += f"""📋 项目规范：
+{project_rules}
+
+"""
+
+        prompt += "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+        return prompt
+
+    def _load_project_rules(self, project_dir: str) -> str:
+        """
+        加载项目规范
+
+        Args:
+            project_dir: 项目目录路径
+
+        Returns:
+            str: 项目规范内容（限制2000字符），如果不存在或出错则返回空字符串
+
+        加载逻辑：
+        1. 优先检查 .cursor/rules/ 目录
+        2. 其次检查 .qoder/rules/ 目录
+        3. 读取所有 .md、.mdc、.txt 文件
+        4. 拼接内容，限制总长度 2000 字符
+        """
+        if not project_dir:
+            return ""
+
+        try:
+            project_path = Path(project_dir)
+            if not project_path.exists():
+                debug_log(f"项目目录不存在: {project_dir}")
+                return ""
+
+            # 优先检查 .cursor/rules/
+            rules_dirs = [
+                project_path / ".cursor" / "rules",
+                project_path / ".qoder" / "rules",
+            ]
+
+            rules_dir = None
+            for dir_path in rules_dirs:
+                if dir_path.exists() and dir_path.is_dir():
+                    rules_dir = dir_path
+                    debug_log(f"找到项目规范目录: {rules_dir}")
+                    break
+
+            if not rules_dir:
+                debug_log("未找到项目规范目录")
+                return ""
+
+            # 读取所有 .md、.mdc、.txt 文件
+            rule_files = []
+            for ext in [".md", ".mdc", ".txt"]:
+                rule_files.extend(rules_dir.glob(f"*{ext}"))
+
+            if not rule_files:
+                debug_log("项目规范目录中没有找到规则文件")
+                return ""
+
+            # 拼接内容
+            content_parts = []
+            total_length = 0
+            max_length = 2000
+
+            for rule_file in sorted(rule_files):
+                try:
+                    file_content = rule_file.read_text(encoding="utf-8")
+                    file_length = len(file_content)
+
+                    # 如果加上这个文件会超过限制，只取部分内容
+                    if total_length + file_length > max_length:
+                        remaining = max_length - total_length
+                        if remaining > 100:  # 至少保留100字符才有意义
+                            content_parts.append(file_content[:remaining])
+                            content_parts.append("\n...")
+                        break
+
+                    content_parts.append(f"# {rule_file.name}\n{file_content}\n")
+                    total_length += file_length + len(rule_file.name) + 3
+
+                except Exception as e:
+                    debug_log(f"读取规则文件失败 {rule_file}: {e}")
+                    continue
+
+            result = "\n".join(content_parts)
+            debug_log(f"成功加载项目规范，总长度: {len(result)} 字符")
+            return result
+
+        except Exception as e:
+            debug_log(f"加载项目规范时出错: {e}")
+            return ""

mcp_ai_supervisor/web/core/context_collector.py

@@ -0,0 +1,124 @@
+#!/usr/bin/env python3
+"""
+项目上下文收集器模块
+===================
+
+为 Agent 提供完整的监督上下文，包括：
+- 项目规则和技能目录路径（D64：不读内容，传路径）
+- AI 当前轮行为数据（summary/intention/changed_files）
+- 任务状态迭代信息
+
+设计决策参考：
+- D25: 仅传当前轮 summary/intention
+- D36: diff 统一传路径委托 Agent
+- D52: changed_files_all 上限 200
+- D64: Prompt 只传路径和元数据
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+
+logger = logging.getLogger(__name__)
+
+
+class ContextCollector:
+    """项目上下文收集器，为 Agent 提供完整的监督上下文"""
+
+    MAX_CHANGED_FILES = 200
+
+    def __init__(self, project_dir: str) -> None:
+        self.project_dir = project_dir
+        self.project_rules_dir: str = ""
+        self.project_skills_dirs: list[str] = []
+        self.sub_agent_skill_paths: list[str] = []
+        self.current_summary: str = ""
+        self.current_intention: str = ""
+        self.changed_files_all: list[str] = []
+        self._current_changed: list[str] = []
+        self._dirs_scanned: bool = False
+
+    def update(
+        self,
+        summary: str,
+        intention: str,
+        changed_files: list[str] | None,
+    ) -> None:
+        """每轮调用时更新当前轮数据（D25: 不累计历史 summary/intention）"""
+        logger.debug(
+            "[ContextCollector] update: summary=%d intention=%d files=%d",
+            len(summary or ""),
+            len(intention or ""),
+            len(changed_files or []),
+        )
+        self.current_summary = summary
+        self.current_intention = intention
+        self._current_changed = list(changed_files) if changed_files else []
+        # D52/R23: 有序列表去重，保留最后一次出现的位置
+        for f in self._current_changed:
+            if f in self.changed_files_all:
+                self.changed_files_all.remove(f)
+            self.changed_files_all.append(f)
+        if len(self.changed_files_all) > self.MAX_CHANGED_FILES:
+            self.changed_files_all = self.changed_files_all[-self.MAX_CHANGED_FILES :]
+
+    async def collect(self, task_state) -> dict:
+        """收集完整上下文，输出结构化 dict（D64: 只输出路径元数据）。"""
+        logger.info("[ContextCollector] collect 开始: project=%s", self.project_dir)
+        if not self._dirs_scanned:
+            self._scan_project_dirs()
+            self._dirs_scanned = True
+        logger.debug(
+            "[ContextCollector] collect 完成: rules=%s, all_files=%d",
+            self.project_rules_dir or "N/A",
+            len(self.changed_files_all),
+        )
+        return {
+            "project_dir": self.project_dir,
+            "original_task": task_state.original_task,
+            "retry_count": task_state.retry_count,
+            "task_phase": task_state.task_phase.value,
+            "completion_attempts": task_state.agent_deny_count,
+            "agent_deny_count": task_state.agent_deny_count,
+            "current_summary": self.current_summary,
+            "current_intention": self.current_intention,
+            "changed_files_this_round": list(self._current_changed),
+            "changed_files_all": list(self.changed_files_all),
+            "project_rules_dir": self.project_rules_dir,
+            "project_skills_dirs": self.project_skills_dirs,
+            "sub_agent_skill_paths": list(self.sub_agent_skill_paths),
+        }
+
+    # ─── 项目目录扫描（T1.1）──────────────────────────────
+
+    def _scan_project_dirs(self) -> None:
+        """扫描项目目录，记录规则和技能目录路径（D64: 只传路径，不读内容）"""
+        logger.debug("[ContextCollector] 扫描项目目录: %s", self.project_dir)
+        rules_dir = os.path.join(self.project_dir, ".cursor", "rules")
+        if os.path.isdir(rules_dir):
+            self.project_rules_dir = rules_dir
+
+        for skills_dir in [
+            os.path.join(self.project_dir, ".cursor", "skills"),
+            os.path.join(self.project_dir, ".agents", "skills"),
+        ]:
+            if os.path.isdir(skills_dir):
+                self.project_skills_dirs.append(skills_dir)
+
+        self.sub_agent_skill_paths = []
+        scan_dirs = list(self.project_skills_dirs)
+        global_qoder_skills = os.path.join(os.path.expanduser("~"), ".qoder", "skills")
+        if os.path.isdir(global_qoder_skills) and global_qoder_skills not in scan_dirs:
+            scan_dirs.append(global_qoder_skills)
+
+        seen_skill_names: set[str] = set()
+        for skills_dir in scan_dirs:
+            if not os.path.isdir(skills_dir):
+                continue
+            for entry in sorted(os.listdir(skills_dir)):
+                base_name = entry.removeprefix("tbj_")
+                skill_file = os.path.join(skills_dir, entry, "SKILL.md")
+                if os.path.isfile(skill_file) and base_name not in seen_skill_names:
+                    self.sub_agent_skill_paths.append(skill_file)
+                    seen_skill_names.add(base_name)