Undefined-bot 2.1.0__tar.gz

undefined_bot-2.1.0/.env.example

@@ -0,0 +1,75 @@
+# ================================
+# 机器人小号配置
+# ================================
+BOT_QQ=                             # 机器人QQ号
+SUPERADMIN_QQ=                      # 超级管理员QQ号（唯一，可添加其他管理员）
+ADMIN_QQ=                           # 初始管理员QQ号列表（逗号分隔，可选）
+FORWARD_PROXY_QQ=                   # 音频转发代理QQ号（用于群聊音频转发，可选）
+
+# ================================
+# OneBot WebSocket 配置
+# ================================
+ONEBOT_WS_URL=ws://127.0.0.1:3001   # NapCat WebSocket 地址
+ONEBOT_TOKEN=                       # Access Token（可选）
+
+# ================================
+# 对话模型配置 (用于总结聊天记录)
+# ================================
+CHAT_MODEL_API_URL=
+CHAT_MODEL_API_KEY=
+CHAT_MODEL_NAME=
+CHAT_MODEL_MAX_TOKENS=8192
+CHAT_MODEL_THINKING_ENABLED=false   # 是否启用 thinking（思维链）
+CHAT_MODEL_THINKING_BUDGET_TOKENS=20000  # thinking budget tokens
+
+# ================================
+# 视觉模型配置 (用于图片描述和OCR)
+# ================================
+VISION_MODEL_API_URL=
+VISION_MODEL_API_KEY=
+VISION_MODEL_NAME=
+VISION_MODEL_THINKING_ENABLED=false  # 是否启用 thinking（思维链）
+VISION_MODEL_THINKING_BUDGET_TOKENS=20000  # thinking budget tokens
+
+# ================================
+# 安全模型配置 (用于防注入检测和注入后的回复生成)
+# ================================
+SECURITY_MODEL_API_URL=
+SECURITY_MODEL_API_KEY=
+SECURITY_MODEL_NAME=
+SECURITY_MODEL_MAX_TOKENS=100 # 可选限制
+SECURITY_MODEL_THINKING_ENABLED=false  # 是否启用 thinking（思维链）
+SECURITY_MODEL_THINKING_BUDGET_TOKENS=0  # thinking budget tokens
+
+# ================================
+# Agent 模型配置 (用于执行 agents)
+# ================================
+AGENT_MODEL_API_URL=
+AGENT_MODEL_API_KEY=
+AGENT_MODEL_NAME=
+AGENT_MODEL_MAX_TOKENS=4096 # 可选限制
+AGENT_MODEL_THINKING_ENABLED=false  # 是否启用 thinking（思维链）
+AGENT_MODEL_THINKING_BUDGET_TOKENS=0  # thinking budget tokens
+
+# ================================
+# 日志配置
+# ================================
+LOG_LEVEL=INFO                      # 日志级别（DEBUG/INFO/WARNING/ERROR）
+LOG_FILE_PATH=logs/bot.log          # 日志文件路径
+LOG_MAX_SIZE_MB=10                  # 单个日志文件最大大小（MB）
+LOG_BACKUP_COUNT=5                  # 保留日志文件数量
+
+# ================================
+# 搜索服务配置 (SearXNG)
+# ================================
+SEARXNG_URL=                        # SearXNG 搜索服务地址，如 http://127.0.0.1:8849
+
+# ================================
+# 天气API配置 (心知天气)
+# ================================
+WEATHER_API_KEY=                   # 心知天气API密钥，从 https://www.seniverse.com/ 获取
+
+# ================================
+# XXAPI API 配置
+# ================================
+XXAPI_API_TOKEN=                   # XXAPI Token，前往 https://xxapi.cn 获取

undefined_bot-2.1.0/.github/release.yml

@@ -0,0 +1,32 @@
+changelog:
+  exclude:
+    labels:
+      - ignore-for-release
+    authors:
+      - github-actions
+  categories:
+    - title: "🚀 New Features | 新功能"
+      labels:
+        - enhancement
+        - feature
+        - "new feature"
+    - title: "🐛 Bug Fixes | Bug 修复"
+      labels:
+        - bug
+        - fix
+        - error
+    - title: "📚 Documentation | 文档"
+      labels:
+        - documentation
+        - doc
+        - docs
+    - title: "🛠 Maintenance | 维护与重构"
+      labels:
+        - chore
+        - maintenance
+        - refactor
+        - style
+        - test
+    - title: "📦 Dependencies | 依赖更新"
+      labels:
+        - dependencies

undefined_bot-2.1.0/.github/workflows/release.yml

@@ -0,0 +1,95 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-and-release:
+    name: Build and Release
+    runs-on: ubuntu-latest
+    environment: release
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Fetch tags
+        run: git fetch --tags --force
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build project
+        run: uv build
+
+      - name: Create Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # 1. 检查是否为注解标签 (Annotated Tag)
+          TAG_TYPE=$(git cat-file -t ${{ github.ref_name }})
+          TAG_CONTENT=""
+          
+          if [ "$TAG_TYPE" = "tag" ]; then
+            # 使用 %(contents) 获取完整的 Tag Message
+            TAG_CONTENT=$(git tag -l --format='%(contents)' ${{ github.ref_name }})
+            # 移除 PGP 签名（如果存在）
+            TAG_CONTENT=$(echo "$TAG_CONTENT" | sed '/-----BEGIN PGP SIGNATURE-----/,/-----END PGP SIGNATURE-----/d')
+          fi
+          
+          # 2. 获取上一个 Tag
+          PREV_TAG=$(git describe --tags --abbrev=0 ${{ github.ref_name }}^ 2>/dev/null || git rev-list --max-parents=0 HEAD)
+          
+          # 3. 初始化 tag_message.txt
+          if [ -n "$TAG_CONTENT" ]; then
+            echo "$TAG_CONTENT" > tag_message.txt
+            echo -e "\n---\n" >> tag_message.txt
+          else
+            touch tag_message.txt
+          fi
+          
+          # 4. 追加"Detailed Changes"标题
+          echo -e "## 📝 Detailed Changes\n" >> tag_message.txt
+          
+          # 5. 自动生成基于 Commit 的详细列表 (Angular 规范分类)
+          # 仅在有对应 commits 时才显示标题
+          FEAT_COMMITS=$(git log ${PREV_TAG}..${{ github.ref_name }} --grep="^feat" --pretty=format:"* %s (%h)" 2>/dev/null || true)
+          if [ -n "$FEAT_COMMITS" ]; then
+            echo -e "### 🚀 Features" >> tag_message.txt
+            echo "$FEAT_COMMITS" >> tag_message.txt
+            echo -e "\n" >> tag_message.txt
+          fi
+          
+          FIX_COMMITS=$(git log ${PREV_TAG}..${{ github.ref_name }} --grep="^fix" --pretty=format:"* %s (%h)" 2>/dev/null || true)
+          if [ -n "$FIX_COMMITS" ]; then
+            echo -e "### 🐛 Bug Fixes" >> tag_message.txt
+            echo "$FIX_COMMITS" >> tag_message.txt
+            echo -e "\n" >> tag_message.txt
+          fi
+          
+          OTHER_COMMITS=$(git log ${PREV_TAG}..${{ github.ref_name }} --grep="^feat\|^fix" --invert-grep --pretty=format:"* %s (%h)" 2>/dev/null || true)
+          if [ -n "$OTHER_COMMITS" ]; then
+            echo -e "### 🛠 Maintenance & Others" >> tag_message.txt
+            echo "$OTHER_COMMITS" >> tag_message.txt
+          fi
+          
+          # 6. 创建 Release
+          gh release create ${{ github.ref_name }} dist/* \
+            --title "Undefined ${{ github.ref_name }}" \
+            --notes-file tag_message.txt \
+            --generate-notes
+
+      - name: Publish to PyPI
+        run: uv publish

undefined_bot-2.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Compiled and build artifacts
+*.pyc
+__pycache__/
+
+# Dependencies
+.venv/
+venv/
+node_modules/
+
+# Logs and temp files
+*.log
+*.tmp
+*.swp
+temp/
+
+# Environment
+.env
+
+# Editors
+.vscode/
+.idea/
+
+# Coverage reports
+coverage/
+htmlcov/
+.coverage
+
+# Python specific
+*.pyc
+__pycache__/
+*.pyo
+*.pyd
+.Python
+*.so
+
+# Testing
+.pytest_cache/
+.mypy_cache/
+
+logs/*
+
+AGENTS.md
+.DS_Store
+.claude/
+
+config.local.json

undefined_bot-2.1.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "code/NagaAgent"]
+	path = code/NagaAgent
+	url = https://github.com/Xxiii8322766509/NagaAgent.git

undefined_bot-2.1.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) <2025> <Null>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

undefined_bot-2.1.0/PKG-INFO

@@ -0,0 +1,259 @@
+Metadata-Version: 2.4
+Name: Undefined-bot
+Version: 2.1.0
+Summary: A high-performance, highly scalable QQ group and private chat robot based on a self-developed architecture.
+Project-URL: Homepage, https://www.pylindex.top
+Project-URL: Repository, https://github.com/69gg/Undefined
+Project-URL: Issues, https://github.com/69gg/Undefined/issues
+Author-email: Null <pylindex@qq.com>
+License-File: LICENSE
+Requires-Python: <=3.13,>=3.12
+Requires-Dist: aiofiles>=25.1.0
+Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: apscheduler>=3.10.0
+Requires-Dist: chardet>=5.2.0
+Requires-Dist: crawl4ai>=0.3.0
+Requires-Dist: croniter>=2.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: imgkit
+Requires-Dist: langchain-community>=0.3.0
+Requires-Dist: linkify-it-py>=2.0.3
+Requires-Dist: markdown-it-py[plugins]>=4.0.0
+Requires-Dist: markdown>=3.10
+Requires-Dist: matplotlib
+Requires-Dist: mdit-py-plugins>=0.5.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pillow
+Requires-Dist: playwright>=1.57.0
+Requires-Dist: py7zr>=1.1.0
+Requires-Dist: pymdown-extensions>=10.20
+Requires-Dist: pymupdf>=1.26.7
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: python-markdown-math>=0.9
+Requires-Dist: python-pptx>=1.0.2
+Requires-Dist: rarfile>=4.2
+Requires-Dist: tiktoken>=0.7.0
+Requires-Dist: types-aiofiles>=25.1.0.20251011
+Requires-Dist: types-markdown>=3.10.0.20251106
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<table border="0">
+  <tr>
+    <td width="70%" valign="top">
+      <div align="center">
+        <h1>Undefined</h1>
+        <em>A high-performance, highly scalable QQ group and private chat robot based on a self-developed architecture.</em>
+        <br/><br/>
+        <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.12-blue.svg" alt="Python"></a>
+        <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License"></a>
+        <br/><br/>
+        <p>大鹏一日同风起，扶摇直上九万里。</p>
+      </div>
+      <h3>项目简介</h3>
+      <p>
+        <strong>Undefined</strong> 是一个功能强大的 QQ 机器人平台，采用全新的 <strong>自研 Skills</strong> 架构。基于现代 Python 异步技术栈构建，它不仅提供基础的对话能力，更通过内置的多个智能 Agent 实现了代码分析、网络搜索、娱乐互动等多模态综合能力。
+      </p>
+    </td>
+    <td width="30%">
+      <img src="./data/img/head.jpg" width="100%" alt="Undefined" />
+    </td>
+  </tr>
+</table>
+
+### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
+
+## 立即体验
+
+[点击添加官方实例QQ](https://qm.qq.com/q/cvjJoNysGA)
+
+## 核心特性
+
+- **Skills 架构**：全新设计的技能系统，将基础工具（Tools）与智能代理（Agents）分层管理，支持自动发现与注册。
+- **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
+- **智能 Agent 矩阵**：内置多个专业 Agent，分工协作处理复杂任务。
+- **思维链支持**：支持开启思维链，提升复杂逻辑推理能力。
+- **高并发架构**：基于 `asyncio` 全异步设计，支持多队列消息处理与工具并发执行，轻松应对高并发场景。
+- **安全防护**：内置独立的安全模型，实时检测注入攻击与恶意内容。
+- **OneBot 协议**：完美兼容 OneBot V11 协议，支持多种前端实现（如 NapCat）。
+
+## 安装与部署
+
+### 方式一：使用 pip 安装（推荐）
+
+如果您只是想使用机器人，推荐直接从 Release 下载安装包或通过 pip 安装。
+
+#### 1. 安装
+
+直接通过 PyPI 安装：
+
+```bash
+pip install Undefined-bot
+```
+
+或者下载 Release 中的 `.whl` 文件运行：
+
+```bash
+pip install /path/to/Undefined_bot-x.x.x-py3-none-any.whl
+```
+
+还需要安装浏览器内核（如果尚未安装）：
+
+```bash
+playwright install
+```
+
+#### 2. 配置与运行
+
+1.  创建一个文件夹作为机器人的**工作目录**。
+2.  克隆 [_NagaAgent_ 仓库](https://github.com/Xxiii8322766509/NagaAgent) 至 `./code/NagaAgent`。
+3.  在工作目录下创建一个 `.env` 文件，填入您的配置信息（参考下方配置说明或于 Github 中打开 `.env.example` 查看注释）。
+4.  在工作目录下打开终端，直接输入命令启动：
+
+```bash
+Undefined
+```
+
+> **注意**：程序会自动读取当前运行目录下的 `.env` 文件作为配置。
+
+### 方式二：源码部署（开发）
+
+如果您想进行二次开发或调试，请使用此方式。
+
+#### 1. 克隆项目
+
+由于项目中使用了 `NagaAgent` 作为子模块，请使用以下命令克隆项目：
+
+```bash
+git clone --recursive https://github.com/69gg/Undefined.git
+cd Undefined
+```
+
+如果已经克隆了项目但没有初始化子模块：
+
+```bash
+git submodule update --init --recursive
+```
+
+#### 2. 安装依赖
+
+推荐使用 `uv` 进行依赖管理：
+
+```bash
+uv sync
+```
+
+#### 3. 配置环境
+
+复制所有的示例配置文件（.env.example -> .env）并填写你的配置信息。
+
+```bash
+cp .env.example .env
+```
+
+#### 4. 启动运行
+
+```bash
+uv run -m Undefined
+```
+
+### 配置说明（通用）
+
+无论使用哪种方式，都需要配置 `.env` 文件：
+
+- **基础配置**：`BOT_QQ`, `SUPERADMIN_QQ`, `ONEBOT_WS_URL`
+- **模型配置**：
+  - `CHAT_MODEL_*`：主对话模型
+  - `VISION_MODEL_*`：视觉识别模型
+  - `AGENT_MODEL_*`：Agent 专用模型（建议使用能力更强的模型）
+  - `SECURITY_MODEL_*`：安全审核模型
+- **功能配置**：`LOG_LEVEL` 等
+
+> 启动项目需要 OneBot 实例，推荐使用 [NapCat](https://napneko.github.io/)。
+
+## 使用说明
+
+### 部署后的初始化
+
+机器人启动后会自动连接到 OneBot 实例。如果连接成功，您会在日志中看到机器人 QQ 号及管理员信息。
+
+### Agent 能力展示
+
+机器人通过自然语言自动调用相应的 Agent 完成任务：
+
+#### 1. 网络与信息
+- "搜索一下最近的 AI 新闻"
+- "看看今天的微博热搜"
+- "查询北京明天的天气"
+
+#### 2. 代码与开发
+- "分析一下当前项目的目录结构"
+- "读取 src/main.py 的内容并解释"
+- "在代码库中搜索 'AgentRegistry'"
+
+#### 3. 娱乐与社交
+- "搜一首周杰伦的歌"
+- "找一下 B 站关于 Python 的教程"
+- "画一只赛博朋克风格的猫"
+- "看一下今天的运势"
+
+### 管理员命令
+
+```bash
+/help               # 查看帮助
+/lsadmin            # 查看管理员列表
+/addadmin <QQ>      # 添加管理员（仅超级管理员）
+/rmadmin <QQ>       # 移除管理员（仅超级管理员）
+/bugfix <QQ> <Time> # 生成 Bug 修复报告
+```
+
+### 消息优先级
+
+系统采用多级优先队列设计：
+1. **最高**：超级管理员私聊
+2. **高**：普通私聊
+3. **中**：群聊被 @
+4. **低**：群聊普通消息
+
+## 目录结构
+
+```
+src/Undefined/
+├── skills/
+│   ├── agents/    # 智能体集合 (Web, Code, Social...)
+│   └── tools/     # 基础工具 (SendMsg, Render...)
+├── config.py      # 配置管理
+├── handlers.py    # 消息处理器
+└── ai.py          # AI 核心逻辑
+```
+
+## 扩展与开发
+
+Undefined 采用模块化的 **Skills** 架构，扩展非常简单：
+
+- **添加工具**: 在 `skills/tools/` 下新建目录，添加 `config.json` 和 `handler.py`。
+- **添加 Agent**: 在 `skills/agents/` 下新建目录，定义 `intro.md` 和 `prompt.md`。
+
+## 致谢与友链
+
+### NagaAgent
+
+本项目集成 **NagaAgent** 子模块。Undefined 诞生于 NagaAgent 社区，感谢作者及社区的支持。
+
+> [NagaAgent - A simple yet powerful agent framework.](https://github.com/Xxiii8322766509/NagaAgent)
+
+## 开源协议
+
+本项目遵循 [MIT License](LICENSE) 开源协议。
+
+<div align="center">
+
+**⭐ 如果这个项目对您有帮助，请考虑给我们一个 Star**
+
+</div>