nonebot-plugin-aigfm-peer 0.1.0__tar.gz

nonebot_plugin_aigfm_peer-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Funny1Potato
+
+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.

nonebot_plugin_aigfm_peer-0.1.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-aigfm-peer
+Version: 0.1.0
+Summary: 跨bot通信代理插件：捕获本bot插件输出推送给主bot，并支持远程插件调用
+License-Expression: MIT
+Requires-Python: <4.0,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nonebot2>=2.3.0
+Requires-Dist: nonebot-adapter-onebot>=2.2.0
+Requires-Dist: httpx>=0.24.0
+Dynamic: license-file
+
+# nonebot-plugin-aigfm-peer
+
+跨 bot 通信代理插件，安装到其它 bot 上，配合主插件 [nonebot-plugin-aigf-master](https://github.com/Funny1Potato/nonebot-plugin-aigf-master) 使用。
+
+## 📖 介绍
+
+- **捕获输出并推送**：拦截本 bot 所有插件的输出（文本/图片），通过 HTTP 推送给主 bot（aigf-master），进入其 LLM 上下文（标注 `[bot名]`）
+- **远程插件调用**：提供 `/peer/invoke` 端点，接收主 bot 的远程命令调用，用 synthetic event 执行本 bot 的本地插件
+- **命令推送**：启动时扫描本 bot 已注册的 `on_command` 命令，随推送告知主 bot，让 LLM 了解可调用命令
+
+## 💿 安装
+
+```bash
+pip install nonebot-plugin-aigfm-peer
+```
+
+在 `pyproject.toml` 中添加：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot-plugin-aigfm-peer"]
+```
+
+## 配置
+
+在 `.env` 中添加：
+
+```env
+# 主插件（Bot A）的 HTTP 端口
+AIGFM_PEER_PUSH_PORT=14514
+# 共享 token（与主插件 AIGFM_PEER_BOTS 中对应项一致）
+AIGFM_PEER_TOKEN="shared_secret"
+# 本 bot 名称（与主插件 AIGFM_PEER_BOTS 的 name 对应）
+AIGFM_PEER_BOT_NAME="botB"
+# 要捕获输出的插件名列表，为空则捕获所有
+AIGFM_PEER_CAPTURE_PLUGINS=[]
+```
+
+## 与主插件配合
+
+1. 在主插件 `.env` 配置 `AIGFM_PEER_BOTS`（含本 bot 的 name/port/token）
+2. 两端 token 必须一致
+3. 主插件与 peer 插件的前缀（`COMMAND_START`）各自独立配置，远程调用时按各 bot 的前缀自动适配
+
+## License
+
+MIT

nonebot_plugin_aigfm_peer-0.1.0/README.md

@@ -0,0 +1,47 @@
+# nonebot-plugin-aigfm-peer
+
+跨 bot 通信代理插件，安装到其它 bot 上，配合主插件 [nonebot-plugin-aigf-master](https://github.com/Funny1Potato/nonebot-plugin-aigf-master) 使用。
+
+## 📖 介绍
+
+- **捕获输出并推送**：拦截本 bot 所有插件的输出（文本/图片），通过 HTTP 推送给主 bot（aigf-master），进入其 LLM 上下文（标注 `[bot名]`）
+- **远程插件调用**：提供 `/peer/invoke` 端点，接收主 bot 的远程命令调用，用 synthetic event 执行本 bot 的本地插件
+- **命令推送**：启动时扫描本 bot 已注册的 `on_command` 命令，随推送告知主 bot，让 LLM 了解可调用命令
+
+## 💿 安装
+
+```bash
+pip install nonebot-plugin-aigfm-peer
+```
+
+在 `pyproject.toml` 中添加：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot-plugin-aigfm-peer"]
+```
+
+## 配置
+
+在 `.env` 中添加：
+
+```env
+# 主插件（Bot A）的 HTTP 端口
+AIGFM_PEER_PUSH_PORT=14514
+# 共享 token（与主插件 AIGFM_PEER_BOTS 中对应项一致）
+AIGFM_PEER_TOKEN="shared_secret"
+# 本 bot 名称（与主插件 AIGFM_PEER_BOTS 的 name 对应）
+AIGFM_PEER_BOT_NAME="botB"
+# 要捕获输出的插件名列表，为空则捕获所有
+AIGFM_PEER_CAPTURE_PLUGINS=[]
+```
+
+## 与主插件配合
+
+1. 在主插件 `.env` 配置 `AIGFM_PEER_BOTS`（含本 bot 的 name/port/token）
+2. 两端 token 必须一致
+3. 主插件与 peer 插件的前缀（`COMMAND_START`）各自独立配置，远程调用时按各 bot 的前缀自动适配
+
+## License
+
+MIT

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer/__init__.py

@@ -0,0 +1,283 @@
+"""nonebot-plugin-aigfm-peer — 跨 bot 通信代理（安装在其它 bot 上）
+
+职责：
+1. 捕获本 bot 所有插件输出（文本/图片），通过 HTTP 推送给 Bot A（aigf_manager）
+2. 提供 POST /peer/invoke 端点，接收 Bot A 的远程命令调用，用 synthetic event 执行本地插件
+"""
+
+from datetime import datetime
+
+import asyncio
+import httpx
+from nonebot import Bot, get_bot, get_driver, logger
+from nonebot.adapters.onebot.v11 import GroupMessageEvent, Message, MessageSegment
+from nonebot.internal.matcher import current_matcher
+from nonebot.matcher import matchers
+from nonebot.message import handle_event
+from nonebot.plugin import PluginMetadata
+from nonebot.rule import CommandRule
+
+from .config import PluginConfig, plugin_config
+
+__plugin_name__ = "nonebot-plugin-aigfm-peer"
+
+__plugin_meta__ = PluginMetadata(
+    name="aigfm-peer", description="跨 bot 通信代理插件：捕获本 bot 插件输出推送给主 bot，并支持远程插件调用",
+    usage="安装到其它 bot 后自动工作；配置 AIGFM_PEER_PUSH_PORT / AIGFM_PEER_TOKEN / AIGFM_PEER_BOT_NAME",
+    type="application",
+    config=PluginConfig, supported_adapters={"~onebot.v11"},
+    homepage="https://github.com/Funny1Potato/nonebot-plugin-aigf",
+    extra={"author": "Funny1Potato"},
+)
+
+_invoke_tasks: set = set()
+_commands_cache: list[dict] = []
+
+
+def _scan_commands() -> list[dict]:
+    """扫描本 bot 已注册的 on_command 命令，供 Bot A 了解可用命令"""
+    commands: list[dict] = []
+    seen = set()
+    for priority, matcher_list in matchers.items():
+        for matcher_cls in matcher_list:
+            try:
+                rule = matcher_cls.rule
+                if not rule or not rule.checkers:
+                    continue
+                for checker in rule.checkers:
+                    if isinstance(checker.call, CommandRule):
+                        cmd_rule = checker.call
+                        if not cmd_rule.cmds:
+                            continue
+                        main_cmd = cmd_rule.cmds[0]
+                        name = main_cmd[0] if main_cmd else ""
+                        if not name or name in seen:
+                            continue
+                        seen.add(name)
+                        description = ""
+                        if matcher_cls.plugin and hasattr(matcher_cls.plugin, "metadata"):
+                            meta = matcher_cls.plugin.metadata
+                            if meta:
+                                description = meta.description or ""
+                        commands.append({"name": name, "description": description})
+                        break
+            except Exception:
+                continue
+    return commands
+
+
+# ========== 消息解析（从 aigf_manager api_hooks 抽取，不包含 VLM 描述） ==========
+
+def _parse_segments(message) -> list[dict]:
+    """将 OneBot v11 消息统一解析为段落列表（文本 + 图片 url/base64）"""
+    if isinstance(message, str):
+        try:
+            msg = Message(message)
+            return _parse_segments(msg)
+        except Exception:
+            return [{"type": "text", "text": message}]
+
+    if isinstance(message, Message):
+        result = []
+        try:
+            for seg in message:
+                seg_type = getattr(seg, "type", None)
+                seg_data = getattr(seg, "data", {})
+                if seg_type == "text":
+                    text = seg_data.get("text", "") if isinstance(seg_data, dict) else ""
+                    if text:
+                        result.append({"type": "text", "text": text})
+                elif seg_type == "image":
+                    data = seg_data if isinstance(seg_data, dict) else {}
+                    result.append(_extract_image_data(data))
+        except Exception as e:
+            logger.error(f"[PeerAgent] Message 迭代失败: {e}")
+        return result
+
+    if isinstance(message, list):
+        result = []
+        for seg in message:
+            if isinstance(seg, dict):
+                if seg.get("type") == "text":
+                    result.append({"type": "text", "text": seg.get("data", {}).get("text", "")})
+                elif seg.get("type") == "image":
+                    result.append(_extract_image_data(seg.get("data", {})))
+        return result
+
+    return []
+
+
+def _extract_image_data(data: dict) -> dict:
+    """从图片段落的 data 中提取图片数据，处理 base64:// 前缀"""
+    file_value = data.get("file", "")
+    url = data.get("url", "")
+    b64 = data.get("base64", "")
+
+    if file_value.startswith("base64://"):
+        b64 = file_value[9:]
+        file_value = ""
+
+    return {"type": "image", "url": url, "file": file_value, "base64": b64}
+
+
+# ========== 推送 ==========
+
+async def _push(plugin: str, group_id: int, text: str = "", image_url: str = "", image_base64: str = ""):
+    """将捕获到的插件输出推送给 Bot A 的 /peer/capture"""
+    if not plugin_config.aigfm_peer_push_port or not plugin_config.aigfm_peer_token:
+        return
+    payload = {
+        "bot_name": plugin_config.aigfm_peer_bot_name,
+        "plugin": plugin,
+        "group_id": group_id,
+        "text": text,
+        "image_url": image_url,
+        "image_base64": image_base64,
+        "commands": _commands_cache,
+    }
+    headers = {"Authorization": f"Bearer {plugin_config.aigfm_peer_token}"}
+    url = f"http://127.0.0.1:{plugin_config.aigfm_peer_push_port}/peer/capture"
+    try:
+        async with httpx.AsyncClient(timeout=30.0) as client:
+            resp = await client.post(url, json=payload, headers=headers)
+            resp.raise_for_status()
+        logger.success(f"[PeerAgent] 推送成功: [{plugin}] → {plugin_config.aigfm_peer_bot_name}")
+        logger.info(f"[PeerAgent] 推送内容: plugin={plugin}, group={group_id}, "
+                    f"text={text[:100] if text else ''}, "
+                    f"image_url={image_url[:100] if image_url else ''}, "
+                    f"image_base64={'有' if image_base64 else '无'}")
+    except Exception as e:
+        logger.exception(f"[PeerAgent] 推送失败: {e}")
+
+
+# ========== 钩子：捕获本 bot 插件输出 ==========
+
+@Bot.on_calling_api
+async def capture_outgoing(bot: Bot, api: str, data: dict):
+    """拦截本 bot 插件发出的 API 调用，推送给 Bot A"""
+    if api not in ("send_msg", "send_group_msg", "send_private_msg"):
+        return
+    if not plugin_config.aigfm_peer_push_port:
+        return
+
+    group_id = data.get("group_id")
+    if not group_id:
+        return
+
+    try:
+        matcher = current_matcher.get()
+        source = matcher.plugin_name or "unknown"
+    except LookupError:
+        return
+
+    # 防死循环：跳过自身
+    if source in ("nonebot_plugin_aigfm_peer", "nonebot-plugin-aigfm-peer"):
+        return
+
+    # 白名单过滤
+    if plugin_config.aigfm_peer_capture_plugins and source not in plugin_config.aigfm_peer_capture_plugins:
+        return
+
+    message = data.get("message", "")
+    segments = _parse_segments(message)
+    for seg in segments:
+        if seg["type"] == "text" and seg["text"]:
+            await _push(source, group_id, text=seg["text"])
+        elif seg["type"] == "image":
+            await _push(source, group_id, image_url=seg.get("url", ""), image_base64=seg.get("base64", ""))
+
+
+# ========== synthetic event 执行（从 aigf_manager plugin_invoker 抽取） ==========
+
+def _apply_command_prefix(command: str) -> str:
+    """按本 bot 配置的命令前缀（COMMAND_START）补充到命令前"""
+    try:
+        command_start = get_driver().config.command_start
+        if command_start:
+            prefix = next(iter(command_start), "")
+            if prefix and not command.startswith(prefix):
+                command = prefix + command
+    except Exception:
+        pass
+    return command
+
+
+def _create_synthetic_event(bot, group_id: int, command: str, user_id: int = 0) -> GroupMessageEvent:
+    """创建模拟的群消息事件"""
+    # LLM 传无前缀命令，这里按本 bot 配置的命令前缀补充
+    command = _apply_command_prefix(command)
+
+    message = Message(MessageSegment.text(command))
+    now = datetime.now()
+    return GroupMessageEvent(
+        time=int(now.timestamp()),
+        self_id=int(bot.self_id) if bot else 0,
+        post_type="message",
+        sub_type="normal",
+        message_type="group",
+        user_id=user_id,
+        group_id=group_id,
+        message_id=0,
+        message=message,
+        raw_message=command,
+        font=0,
+        sender={"user_id": user_id, "nickname": "aigf_user", "role": "member"},
+    )
+
+
+async def _execute_command(bot, group_id: int, command: str, user_id: int = 0):
+    """执行插件命令，插件响应由 capture_outgoing 钩子自动推送"""
+    logger.debug(f"[PeerAgent] 执行远程命令: command={command}, group={group_id}, user={user_id}")
+    event = _create_synthetic_event(bot, group_id, command, user_id)
+    await handle_event(bot, event)
+
+
+# ========== HTTP 端点：接收 Bot A 的远程调用 ==========
+
+@get_driver().on_startup
+async def _on_startup():
+    # 启动时扫描本 bot 已注册命令，随推送告知 Bot A
+    _commands_cache.clear()
+    _commands_cache.extend(_scan_commands())
+    logger.info(f"[PeerAgent] 扫描命令: {len(_commands_cache)} 个")
+    if not plugin_config.aigfm_peer_token:
+        logger.warning("[PeerAgent] 未配置 aigfm_peer_token，invoke 端点将拒绝所有请求")
+    try:
+        import nonebot
+        from fastapi import Request
+        from fastapi.responses import JSONResponse
+        app = nonebot.get_app()
+
+        @app.post("/peer/invoke")
+        async def _peer_invoke(request: Request):
+            auth = request.headers.get("Authorization", "")
+            token = auth[len("Bearer "):].strip() if auth.startswith("Bearer ") else ""
+            if not plugin_config.aigfm_peer_token or token != plugin_config.aigfm_peer_token:
+                return JSONResponse({"error": "unauthorized"}, status_code=401)
+            try:
+                data = await request.json()
+            except Exception:
+                return JSONResponse({"error": "bad json"}, status_code=400)
+            command = data.get("command", "")
+            group_id = data.get("group_id")
+            user_id = data.get("user_id", 0)
+            if not command or not group_id:
+                return JSONResponse({"error": "missing command or group_id"}, status_code=400)
+            logger.info(f"[PeerAgent] 收到调用: command={command}, group={group_id}, user_id={user_id}")
+            try:
+                bot = get_bot()
+            except ValueError:
+                return JSONResponse({"error": "no bot"}, status_code=500)
+            # 后台执行插件命令，立即返回（响应由 capture_outgoing 钩子异步推回 Bot A）
+            try:
+                task = asyncio.create_task(_execute_command(bot, int(group_id), command, int(user_id or 0)))
+                _invoke_tasks.add(task)
+                task.add_done_callback(_invoke_tasks.discard)
+            except Exception as e:
+                logger.error(f"[PeerAgent] 命令执行失败: {e}")
+                return JSONResponse({"error": "execute failed"}, status_code=500)
+            return JSONResponse({"ok": True})
+
+        logger.success(f"[PeerAgent] 启动完成 | 推送: {bool(plugin_config.aigfm_peer_push_port)} | bot 名: {plugin_config.aigfm_peer_bot_name}")
+    except Exception as e:
+        logger.error(f"[PeerAgent] 注册 invoke 端点失败: {e}")

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer/config.py

@@ -0,0 +1,18 @@
+"""插件配置定义"""
+
+from nonebot import get_plugin_config
+from pydantic import BaseModel, Field
+
+
+class PluginConfig(BaseModel):
+    # 推送目标端口（Bot A 的 HTTP 端口）
+    aigfm_peer_push_port: int = Field(0, description="Bot A 的 HTTP 端口，如 14514")
+    # 共享 token（Bot A 的 aigfm_peer_bots 里对应项必须一致）
+    aigfm_peer_token: str = Field("", description="共享密钥，用于推送和 invoke 认证")
+    # 本 bot 名称（推送给 Bot A 时作为来源标识）
+    aigfm_peer_bot_name: str = Field("", description="本 bot 的名称，与 Bot A 的 aigfm_peer_bots 配置里的 name 对应")
+    # 捕获白名单
+    aigfm_peer_capture_plugins: list[str] = Field(default_factory=list, description="要捕获输出的插件名列表，为空则捕获所有")
+
+
+plugin_config: PluginConfig = get_plugin_config(PluginConfig)

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-aigfm-peer
+Version: 0.1.0
+Summary: 跨bot通信代理插件：捕获本bot插件输出推送给主bot，并支持远程插件调用
+License-Expression: MIT
+Requires-Python: <4.0,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nonebot2>=2.3.0
+Requires-Dist: nonebot-adapter-onebot>=2.2.0
+Requires-Dist: httpx>=0.24.0
+Dynamic: license-file
+
+# nonebot-plugin-aigfm-peer
+
+跨 bot 通信代理插件，安装到其它 bot 上，配合主插件 [nonebot-plugin-aigf-master](https://github.com/Funny1Potato/nonebot-plugin-aigf-master) 使用。
+
+## 📖 介绍
+
+- **捕获输出并推送**：拦截本 bot 所有插件的输出（文本/图片），通过 HTTP 推送给主 bot（aigf-master），进入其 LLM 上下文（标注 `[bot名]`）
+- **远程插件调用**：提供 `/peer/invoke` 端点，接收主 bot 的远程命令调用，用 synthetic event 执行本 bot 的本地插件
+- **命令推送**：启动时扫描本 bot 已注册的 `on_command` 命令，随推送告知主 bot，让 LLM 了解可调用命令
+
+## 💿 安装
+
+```bash
+pip install nonebot-plugin-aigfm-peer
+```
+
+在 `pyproject.toml` 中添加：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot-plugin-aigfm-peer"]
+```
+
+## 配置
+
+在 `.env` 中添加：
+
+```env
+# 主插件（Bot A）的 HTTP 端口
+AIGFM_PEER_PUSH_PORT=14514
+# 共享 token（与主插件 AIGFM_PEER_BOTS 中对应项一致）
+AIGFM_PEER_TOKEN="shared_secret"
+# 本 bot 名称（与主插件 AIGFM_PEER_BOTS 的 name 对应）
+AIGFM_PEER_BOT_NAME="botB"
+# 要捕获输出的插件名列表，为空则捕获所有
+AIGFM_PEER_CAPTURE_PLUGINS=[]
+```
+
+## 与主插件配合
+
+1. 在主插件 `.env` 配置 `AIGFM_PEER_BOTS`（含本 bot 的 name/port/token）
+2. 两端 token 必须一致
+3. 主插件与 peer 插件的前缀（`COMMAND_START`）各自独立配置，远程调用时按各 bot 的前缀自动适配
+
+## License
+
+MIT

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+nonebot_plugin_aigfm_peer/__init__.py
+nonebot_plugin_aigfm_peer/config.py
+nonebot_plugin_aigfm_peer.egg-info/PKG-INFO
+nonebot_plugin_aigfm_peer.egg-info/SOURCES.txt
+nonebot_plugin_aigfm_peer.egg-info/dependency_links.txt
+nonebot_plugin_aigfm_peer.egg-info/requires.txt
+nonebot_plugin_aigfm_peer.egg-info/top_level.txt

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer.egg-info/requires.txt

@@ -0,0 +1,3 @@
+nonebot2>=2.3.0
+nonebot-adapter-onebot>=2.2.0
+httpx>=0.24.0

nonebot_plugin_aigfm_peer-0.1.0/nonebot_plugin_aigfm_peer.egg-info/top_level.txt

@@ -0,0 +1 @@
+nonebot_plugin_aigfm_peer

nonebot_plugin_aigfm_peer-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nonebot-plugin-aigfm-peer"
+version = "0.1.0"
+description = "跨bot通信代理插件：捕获本bot插件输出推送给主bot，并支持远程插件调用"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10, <4.0"
+dependencies = [
+    "nonebot2>=2.3.0",
+    "nonebot-adapter-onebot>=2.2.0",
+    "httpx>=0.24.0",
+]
+
+[tool.nonebot]
+plugins = ["nonebot_plugin_aigfm_peer"]

nonebot_plugin_aigfm_peer-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+