Undefined-bot 2.1.0__py3-none-any.whl

Undefined/skills/agents/naga_code_analysis_agent/tools/glob/handler.py

@@ -0,0 +1,37 @@
+import subprocess
+from pathlib import Path
+from typing import Any, Dict
+
+
+async def execute(args: Dict[str, Any], context: Dict[str, Any]) -> str:
+    pattern = args.get("pattern", "")
+
+    # 将 base_path 限制在 NagaAgent 子模块中
+    base_path = context.get("base_path", Path.cwd() / "code" / "NagaAgent")
+    base_path = Path(base_path).resolve()
+
+    path = str(base_path)
+
+    cmd = ["find", path, "-type", "f", "-name", pattern]
+
+    try:
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+
+        if result.returncode == 0:
+            files = result.stdout.strip().split("\n")
+            relative_files = [str(Path(f).relative_to(base_path)) for f in files if f]
+            if len(relative_files) > 100:
+                relative_files = relative_files[:100] + [
+                    f"... 还有 {len(relative_files) - 100} 个文件"
+                ]
+            return "\n".join(relative_files)
+        else:
+            return f"未找到匹配的文件: {pattern}"
+
+    except subprocess.TimeoutExpired:
+        return "工具执行超时: glob"

Undefined/skills/agents/naga_code_analysis_agent/tools/list_directory/config.json

@@ -0,0 +1,17 @@
+{
+    "type": "function",
+    "function": {
+        "name": "list_directory",
+        "description": "列出目录内容。路径是相对于当前工作目录的。",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "description": "目录路径（相对于当前工作目录，默认为根目录）"
+                }
+            },
+            "required": []
+        }
+    }
+}

Undefined/skills/agents/naga_code_analysis_agent/tools/list_directory/handler.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+from typing import Any, Dict
+
+
+async def execute(args: Dict[str, Any], context: Dict[str, Any]) -> str:
+    path_str = args.get("path")
+    # 将 base_path 限制在 NagaAgent 子模块中
+    base_path = context.get("base_path", Path.cwd() / "code" / "NagaAgent")
+    base_path = Path(base_path).resolve()
+
+    if not path_str:
+        full_path = base_path
+    else:
+        # 解析相对于 base_path 的路径
+        full_path = (base_path / path_str).resolve()
+
+    if not str(full_path).startswith(str(base_path)):
+        return f"权限不足：只能列出当前工作目录下的内容 ({base_path})"
+
+    if not full_path.exists():
+        return f"目录不存在: {path_str}"
+
+    items = []
+    for item in full_path.iterdir():
+        item_type = "📁 " if item.is_dir() else "📄 "
+        items.append(f"{item_type}{item.name}")
+
+    if len(items) > 100:
+        items = items[:100] + [f"... 还有 {len(items) - 100} 项"]
+
+    return "\n".join(items)

Undefined/skills/agents/naga_code_analysis_agent/tools/read_file/config.json

@@ -0,0 +1,17 @@
+{
+    "type": "function",
+    "function": {
+        "name": "read_file",
+        "description": "读取文件内容。路径是相对于当前工作目录的。",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "file_path": {
+                    "type": "string",
+                    "description": "文件路径（相对于当前工作目录）"
+                }
+            },
+            "required": ["file_path"]
+        }
+    }
+}

Undefined/skills/agents/naga_code_analysis_agent/tools/read_file/handler.py

@@ -0,0 +1,66 @@
+import chardet
+from pathlib import Path
+from typing import Any, Dict
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+async def execute(args: Dict[str, Any], context: Dict[str, Any]) -> str:
+    # 支持两个参数名以实现兼容性
+    file_path = args.get("file_path") or args.get("path", "")
+
+    if not file_path:
+        return "错误：文件路径不能为空"
+
+    # 将 base_path 限制在 NagaAgent 子模块中
+    base_path = context.get("base_path", Path.cwd() / "code" / "NagaAgent")
+    base_path = Path(base_path).resolve()
+
+    # 解析相对于 base_path 的路径
+    full_path = (base_path / file_path).resolve()
+
+    # 安全检查
+    if not str(full_path).startswith(str(base_path)):
+        return "权限不足：只能读取当前工作目录下的文件"
+
+    if not full_path.exists():
+        return f"文件不存在: {file_path}"
+
+    if full_path.is_dir():
+        return f"错误：{file_path} 是一个目录，不是文件"
+
+    try:
+        with open(full_path, "rb") as binary_file:
+            raw_data: bytes = binary_file.read()
+
+        detected: Any = chardet.detect(raw_data)
+        encoding: str | None = detected.get("encoding", "utf-8")
+        confidence: float = detected.get("confidence", 0)
+
+        if encoding is None or confidence < 0.5:
+            encoding = "utf-8"
+
+        file_content: str = ""
+        try:
+            file_content = raw_data.decode(encoding)
+        except UnicodeDecodeError:
+            try:
+                file_content = raw_data.decode("utf-8")
+            except UnicodeDecodeError:
+                try:
+                    file_content = raw_data.decode("utf-16")
+                except UnicodeDecodeError:
+                    file_content = raw_data.decode("latin-1")
+                    logger.warning(
+                        f"文件 {file_path} 使用 latin-1 解码，可能包含乱码。"
+                    )
+
+        if len(file_content) > 10000:
+            file_content = file_content[:10000] + "\n... (内容过长，已截断)"
+
+        return file_content
+
+    except Exception as e:
+        logger.exception(f"读取文件 {file_path} 时出错")
+        return f"读取文件失败: {e}"

Undefined/skills/agents/naga_code_analysis_agent/tools/read_naga_intro/config.json

@@ -0,0 +1,12 @@
+{
+    "type": "function",
+    "function": {
+        "name": "read_naga_intro",
+        "description": "读取 NagaAgent 项目的介绍文档，获取项目概述、技术架构、项目结构、构建运行方法等核心信息。当用户询问关于 NagaAgent 项目的任何问题时，应优先使用此工具获取项目上下文，而不是直接阅读代码文件。这样可以节省时间和 token，快速提供准确的项目信息。",
+        "parameters": {
+            "type": "object",
+            "properties": {},
+            "required": []
+        }
+    }
+}

Undefined/skills/agents/naga_code_analysis_agent/tools/read_naga_intro/handler.py

@@ -0,0 +1,327 @@
+from typing import Any, Dict
+
+# NagaAgent 项目介绍内容（直接嵌入以保证稳定性）
+NAGA_INTRO_CONTENT = """
+# NagaAgent 项目上下文
+
+## 项目概述
+
+NagaAgent 是一个功能丰富的智能对话助手系统，采用多服务架构设计，提供智能对话、多Agent协作、知识图谱记忆、语音交互和现代化界面等核心功能。
+
+### 核心特性
+
+- **智能对话系统**：支持流式对话和工具调用循环
+- **多Agent协作**：基于博弈论的智能任务调度
+- **知识图谱记忆**：GRAG系统支持长期记忆和智能检索（基于Neo4j）
+- **完整语音交互**：实时语音输入输出处理
+- **现代化界面**：PyQt5 GUI + Live2D虚拟形象
+- **系统托盘集成**：后台运行和快捷操作
+
+## 技术架构
+
+### 系统架构
+
+项目采用微服务架构，主要包含以下独立服务：
+
+1. **API服务器** (端口8000) - RESTful API接口
+2. **Agent服务器** (端口8001) - 博弈论电脑控制智能体
+3. **MCP服务器** (端口8003) - MCP工具调度服务
+4. **TTS服务器** (端口5048) - 语音合成服务
+
+### 技术栈
+
+- **Python**: 3.11（推荐）
+- **前端框架**: PyQt5 + Live2D + QSS
+- **后端框架**: FastAPI + Uvicorn + AsyncIO
+- **数据库**: Neo4j（知识图谱）
+- **AI模型**: OpenAI兼容API + 通义千问
+- **协议**: MCP (Model Context Protocol) + WebSocket + MQTT
+
+### 依赖管理
+
+- **主要依赖**: `nagaagent-core>=1.0.9`（核心依赖已整合）
+- **包管理器**: `uv`（推荐）或 `pip`
+- **配置文件**: `pyproject.toml` + `requirements.txt`
+
+## 项目结构
+
+```
+NagaAgent/
+├── main.py                    # 主入口文件
+├── config.json.example        # 配置文件模板
+├── setup.py / setup.sh        # 安装脚本
+├── start.sh / start.bat       # 启动脚本
+├── update.py                  # 更新脚本
+│
+├── apiserver/                 # API服务器模块
+│   ├── api_server.py          # FastAPI应用
+│   ├── llm_service.py         # LLM服务
+│   ├── message_manager.py     # 消息管理器
+│   └── streaming_tool_extractor.py # 流式工具提取器
+│
+├── agentserver/               # Agent服务器模块
+│   ├── agent_server.py        # FastAPI应用
+│   ├── agent_manager.py       # Agent管理器
+│   ├── task_scheduler.py      # 任务调度器
+│   ├── toolkit_manager.py     # 工具包管理器
+│   └── agent_computer_control/ # 电脑控制智能体
+│
+├── mcpserver/                 # MCP服务器模块
+│   ├── mcp_server.py          # FastAPI应用
+│   ├── mcp_manager.py         # MCP管理器
+│   ├── mcp_scheduler.py       # MCP调度器
+│   ├── mcp_registry.py        # MCP注册中心
+│   └── agent_*/               # 各种MCP工具代理
+│
+├── summer_memory/             # GRAG知识图谱记忆系统
+│   ├── memory_manager.py      # 记忆管理器
+│   ├── quintuple_extractor.py # 五元组提取器
+│   ├── quintuple_graph.py     # 图数据库操作
+│   ├── quintuple_rag_query.py # RAG查询
+│   └── task_manager.py        # 任务管理器
+│
+├── game/                      # 多智能体博弈系统
+│   ├── naga_game_system.py    # 博弈系统核心
+│   ├── core/
+│   │   ├── models/            # 数据模型
+│   │   ├── interaction_graph/ # 交互图生成器
+│   │   └── self_game/         # 自博弈模块
+│   └── examples/              # 使用示例
+│
+├── ui/                        # PyQt5界面模块（MVC架构）
+│   ├── pyqt_chat_window.py    # 主窗口
+│   ├── components/            # UI组件
+│   ├── controller/            # 控制器
+│   ├── styles/                # 样式表
+│   ├── live2d_local/          # Live2D虚拟形象
+│   └── tray/                  # 系统托盘
+│
+├── voice/                     # 语音处理模块
+│   ├── tts_wrapper.py         # TTS封装
+│   ├── input/                 # 语音输入
+│   └── output/                # 语音输出
+│
+├── system/                    # 系统配置和工具
+│   ├── config.py              # 配置系统（Pydantic）
+│   ├── config_manager.py      # 配置管理器
+│   ├── system_checker.py      # 系统检测
+│   └── background_analyzer.py # 后台分析器
+│
+├── mqtt_tool/                 # 物联网通讯工具
+│   └── device_switch.py       # 设备控制
+│
+├── tests/                     # 测试用例
+├── logs/                      # 日志目录
+└── requirements.txt           # Python依赖
+```
+
+## 构建和运行
+
+### 环境要求
+
+- Python 3.11（推荐）
+- 可选：uv工具（加速依赖安装）
+
+### 安装依赖
+
+**使用setup脚本（推荐）**:
+```bash
+# Linux/macOS
+./setup.sh
+
+# Windows
+setup.bat
+```
+
+**手动安装**:
+```bash
+# 创建虚拟环境
+python -m venv .venv
+source .venv/bin/activate  # Linux/macOS
+# 或
+.\.venv\Scripts\activate  # Windows
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 或使用uv
+uv sync
+```
+
+### 配置
+
+1. 复制配置文件模板：
+```bash
+cp config.json.example config.json
+```
+
+2. 编辑 `config.json`，配置LLM API：
+```json
+{
+  "api": {
+    "api_key": "你的api_key",
+    "base_url": "模型服务商OPENAI API端点",
+    "model": "模型名称"
+  }
+}
+```
+
+3. （可选）启用知识图谱记忆：
+```json
+{
+  "grag": {
+    "enabled": true,
+    "neo4j_uri": "neo4j://127.0.0.1:7687",
+    "neo4j_user": "neo4j",
+    "neo4j_password": "你安装neo4j时设置的密码"
+  }
+}
+```
+
+### 启动应用
+
+**使用启动脚本**:
+```bash
+# Linux/macOS
+./start.sh
+
+# Windows
+start.bat
+```
+
+**直接运行**:
+```bash
+# 激活虚拟环境后
+python main.py
+
+# 或使用uv
+uv run main.py
+```
+
+### 系统检测
+
+```bash
+# 完整环境检测
+python main.py --check-env
+
+# 快速检测
+python main.py --quick-check
+
+# 强制检测（忽略缓存）
+python main.py --check-env --force-check
+```
+
+### 更新
+
+```bash
+# 使用更新脚本
+./update.sh         # Linux/macOS
+update.bat          # Windows
+
+# 或直接运行
+python update.py
+```
+
+## 开发规范
+
+### 代码风格
+
+- **Python版本**: 3.11+
+- **类型注释**: 使用类型提示（typing模块）
+- **代码格式**: 建议使用black（行长度120字符）
+- **代码检查**: 建议使用ruff
+- **日志级别**: INFO（开发时可设为DEBUG）
+
+### 架构设计
+
+1. **模块化设计**: 各服务独立运行，支持热插拔
+2. **配置驱动**: 实时配置热更新，无需重启
+3. **异步优先**: 使用AsyncIO进行异步处理
+4. **类型安全**: 使用Pydantic进行数据验证
+
+### UI开发规范
+
+- **MVC架构**: UI组件符合MVC结构
+- **组件化**: 先创建widget组件和工具，验证后再集成到window
+- **线程安全**: 跨线程调用Qt需使用信号槽机制
+- **样式管理**: 使用QSS统一样式
+
+### 配置管理
+
+- **配置文件**: `config.json`（支持注释，使用json5解析）
+- **配置类**: `system/config.py` 中的Pydantic模型
+- **热更新**: 支持配置变更监听和通知
+
+### 日志规范
+
+- **日志目录**: `logs/`
+- **日志级别**: DEBUG, INFO, WARNING, ERROR, CRITICAL
+- **日志格式**: `%(asctime)s - %(name)s - %(levelname)s - %(message)s`
+
+### 测试
+
+- **测试框架**: pytest
+- **测试目录**: `tests/`
+- **异步测试**: pytest-asyncio
+
+## 关键端口
+
+- **API服务器**: 8000
+- **Agent服务器**: 8001
+- **MCP服务器**: 8003
+- **TTS服务器**: 5048
+- **ASR服务器**: 5060
+
+## 重要注意事项
+
+1. **Python版本**: 必须使用Python 3.11，其他版本可能不兼容
+2. **端口占用**: 启动前确保端口8000、8001、8003、5048未被占用
+3. **Neo4j连接**: 如果启用GRAG，确保Neo4j服务正在运行
+4. **编码问题**: 配置文件使用UTF-8编码，支持中文
+5. **虚拟环境**: 建议使用虚拟环境隔离依赖
+6. **系统检测**: 首次启动会自动进行系统环境检测
+
+## 故障排除
+
+1. **Python版本不兼容**: 确保使用Python 3.11
+2. **端口被占用**: 检查并释放相关端口
+3. **Neo4j连接失败**: 检查Neo4j服务状态和连接配置
+4. **依赖安装失败**: 尝试使用uv代替pip
+5. **UI显示异常**: 检查PyQt5和OpenGL依赖
+
+## 扩展开发
+
+### 添加新的MCP工具
+
+1. 在 `mcpserver/agent_*/` 创建新的MCP代理目录
+2. 实现 `mcp_tools.py` 定义工具接口
+3. 在 `mcpserver/mcp_registry.py` 注册新工具
+
+### 添加新的UI组件
+
+1. 在 `ui/components/` 创建组件文件
+2. 遵循MVC架构，分离视图和逻辑
+3. 在 `ui/pyqt_chat_window.py` 中集成组件
+
+### 扩展博弈系统
+
+1. 在 `game/core/` 添加新模块
+2. 使用 `game/core/models/` 中的数据模型
+3. 在 `game/examples/` 添加使用示例
+
+## 许可证
+
+MIT License - 详见 LICENSE 文件
+
+## 贡献指南
+
+欢迎创建Issue和Pull Request！
+
+- 遵循现有代码风格
+- 添加必要的类型注释
+- 编写清晰的提交信息
+- 更新相关文档
+"""
+
+async def execute(args: Dict[str, Any], context: Dict[str, Any]) -> str:
+    return f"NagaAgent 项目介绍文档:\n\n{NAGA_INTRO_CONTENT}"

Undefined/skills/agents/naga_code_analysis_agent/tools/search_file_content/config.json

@@ -0,0 +1,25 @@
+{
+    "type": "function",
+    "function": {
+        "name": "search_file_content",
+        "description": "在文件中搜索内容。支持正则表达式。路径是相对于当前工作目录的。",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "pattern": {
+                    "type": "string",
+                    "description": "搜索模式（正则表达式）"
+                },
+                "path": {
+                    "type": "string",
+                    "description": "搜索路径（相对于当前工作目录，默认为根目录）"
+                },
+                "include": {
+                    "type": "string",
+                    "description": "文件过滤模式（如 *.py）"
+                }
+            },
+            "required": ["pattern"]
+        }
+    }
+}

Undefined/skills/agents/naga_code_analysis_agent/tools/search_file_content/handler.py

@@ -0,0 +1,46 @@
+import subprocess
+from pathlib import Path
+from typing import Any, Dict
+
+
+async def execute(args: Dict[str, Any], context: Dict[str, Any]) -> str:
+    pattern = args.get("pattern", "")
+    path_str = args.get("path")
+    include = args.get("include")
+
+    # 将 base_path 限制在 NagaAgent 子模块中
+    base_path = context.get("base_path", Path.cwd() / "code" / "NagaAgent")
+    base_path = Path(base_path).resolve()
+
+    if not path_str:
+        full_path = base_path
+    else:
+        full_path = (base_path / path_str).resolve()
+
+    if include is None:
+        include = ""
+
+    if not str(full_path).startswith(str(base_path)):
+        return "权限不足：只能在当前工作目录下搜索"
+
+    cmd = ["grep", "-rn", pattern, str(full_path)]
+    if include:
+        cmd.extend(["--include", include])
+
+    try:
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+
+        if result.returncode == 0:
+            output = result.stdout
+            lines = output.split("\n")[:50]
+            return "\n".join(lines)
+        else:
+            return f"未找到匹配: {pattern}"
+
+    except subprocess.TimeoutExpired:
+        return "工具执行超时: search_file_content"

Undefined/skills/agents/scheduler_agent/__init__.py

@@ -0,0 +1 @@
+# Scheduler Agent

Undefined/skills/agents/scheduler_agent/config.json

@@ -0,0 +1,17 @@
+{
+    "type": "function",
+    "function": {
+        "name": "scheduler_agent",
+        "description": "定时任务管理助手。提供创建、删除、修改、查看定时任务的功能，支持 crontab 语法和执行次数限制。",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "prompt": {
+                    "type": "string",
+                    "description": "用户的定时任务管理需求，例如：'创建一个每天早上8点执行的任务'、'删除所有任务'、'查看当前有哪些定时任务'"
+                }
+            },
+            "required": ["prompt"]
+        }
+    }
+}