nonebot-plugin-fakemsg-next 0.2.0__tar.gz

nonebot_plugin_fakemsg_next-0.2.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.3
+Name: nonebot-plugin-fakemsg-next
+Version: 0.2.0
+Summary: 使用显式命令触发的合并转发伪造消息插件
+Author: Misty02600
+Author-email: Misty02600 <Misty02600@gmail.com>
+Requires-Dist: nonebot-adapter-onebot>=2.4.6,<3.0.0
+Requires-Dist: nonebot2>=2.4.2,<3.0.0
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/Misty02600/nonebot-plugin-fakemsg-next
+Project-URL: Issues, https://github.com/Misty02600/nonebot-plugin-fakemsg-next/issues
+Project-URL: Repository, https://github.com/Misty02600/nonebot-plugin-fakemsg-next.git
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <img src="https://github.com/Misty02600/nonebot-plugin-template/releases/download/assets/NoneBotPlugin.png" width="310" alt="logo">
+
+## ✨ nonebot-plugin-fakemsg-next ✨
+
+ NoneBot 合并转发伪造消息插件。
+</div>
+
+## 介绍
+
+[Cvandia/nonebot-plugin-fakemsg](https://github.com/Cvandia/nonebot-plugin-fakemsg) 支持图片和 QQ 表情的实现版本
+
+
+## 安装
+
+### 使用 uv
+
+```bash
+uv add nonebot-plugin-fakemsg-next
+```
+
+### 使用 nb-cli
+
+```bash
+nb plugin install nonebot-plugin-fakemsg-next --upgrade
+```
+
+在 `pyproject.toml` 中启用插件：
+
+```toml
+[tool.nonebot.plugins]
+nonebot-plugin-fakemsg-next = ["nonebot_plugin_fakemsg_next"]
+```
+
+## 使用
+
+每个分隔符分隔一条完整的伪造节点，每段均需显式写目标：
+
+```text
+/伪造消息 @user1说ping
+/伪造消息 @user1说ping|@user1说pong
+/消息伪造 @user1说ping|@user2说pong
+/fakemsg @user1说ping|@user2说pong
+```
+
+- 每条消息结构必须为 `@用户说<内容>`
+- 仅支持群聊中通过 `@用户` 指定伪造目标
+- 如果正文需要字面量 `|`，可写成 `\|`
+
+## 配置
+
+
+```env
+FAKEMSG_NEXT_QUICK_SEPARATOR=|
+```
+
+- `fakemsg_next_quick_separator`
+  - 单字符分隔符，默认 `|`

nonebot_plugin_fakemsg_next-0.2.0/README.md

@@ -0,0 +1,58 @@
+<div align="center">
+  <img src="https://github.com/Misty02600/nonebot-plugin-template/releases/download/assets/NoneBotPlugin.png" width="310" alt="logo">
+
+## ✨ nonebot-plugin-fakemsg-next ✨
+
+ NoneBot 合并转发伪造消息插件。
+</div>
+
+## 介绍
+
+[Cvandia/nonebot-plugin-fakemsg](https://github.com/Cvandia/nonebot-plugin-fakemsg) 支持图片和 QQ 表情的实现版本
+
+
+## 安装
+
+### 使用 uv
+
+```bash
+uv add nonebot-plugin-fakemsg-next
+```
+
+### 使用 nb-cli
+
+```bash
+nb plugin install nonebot-plugin-fakemsg-next --upgrade
+```
+
+在 `pyproject.toml` 中启用插件：
+
+```toml
+[tool.nonebot.plugins]
+nonebot-plugin-fakemsg-next = ["nonebot_plugin_fakemsg_next"]
+```
+
+## 使用
+
+每个分隔符分隔一条完整的伪造节点，每段均需显式写目标：
+
+```text
+/伪造消息 @user1说ping
+/伪造消息 @user1说ping|@user1说pong
+/消息伪造 @user1说ping|@user2说pong
+/fakemsg @user1说ping|@user2说pong
+```
+
+- 每条消息结构必须为 `@用户说<内容>`
+- 仅支持群聊中通过 `@用户` 指定伪造目标
+- 如果正文需要字面量 `|`，可写成 `\|`
+
+## 配置
+
+
+```env
+FAKEMSG_NEXT_QUICK_SEPARATOR=|
+```
+
+- `fakemsg_next_quick_separator`
+  - 单字符分隔符，默认 `|`

nonebot_plugin_fakemsg_next-0.2.0/pyproject.toml

@@ -0,0 +1,125 @@
+[project]
+name = "nonebot-plugin-fakemsg-next"
+version = "0.2.0"
+description = "使用显式命令触发的合并转发伪造消息插件"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Misty02600", email = "Misty02600@gmail.com" }]
+dependencies = [
+  "nonebot-adapter-onebot>=2.4.6,<3.0.0",
+  "nonebot2>=2.4.2,<3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Misty02600/nonebot-plugin-fakemsg-next"
+Issues = "https://github.com/Misty02600/nonebot-plugin-fakemsg-next/issues"
+Repository = "https://github.com/Misty02600/nonebot-plugin-fakemsg-next.git"
+
+[dependency-groups]
+dev = [
+  "commitizen>=4.1.0",
+  "git-cliff>=2.11.0,<3.0.0",
+  "prek>=0.2.0",
+  { include-group = "test" },
+]
+test = [
+  "basedpyright>=1.16.0",
+  "ruff>=0.14.13,<1.0.0",
+  "nonebot2[fastapi]>=2.4.4,<3.0.0",
+  "nonebug>=0.4.3,<1.0.0",
+  "pytest-asyncio>=1.3.0,<1.4.0",
+  "pytest-cov>=7.0.0",
+]
+
+[tool.nonebot.plugins]
+nonebot-plugin-fakemsg-next = ["nonebot_plugin_fakemsg_next"]
+
+[tool.nonebot.adapters]
+nonebot-adapter-onebot = [
+  { name = "OneBot V11", module_name = "nonebot.adapters.onebot.v11" },
+]
+
+[build-system]
+requires = ["uv_build>=0.10.0,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "0.1.0"
+version_provider = "uv"
+tag_format = "v$version"
+annotated_tag = true
+major_version_zero = true                   # 允许 0.x.x 版本号
+
+[tool.coverage.report]
+exclude_lines = [
+  "raise NotImplementedError",
+  "if TYPE_CHECKING:",
+  "@overload",
+  "except ImportError:",
+]
+
+[tool.pyright]
+include = ["src"]      # 默认仅检查源码目录；测试通过 pytest / ruff 保证质量
+pythonVersion = "3.11" # 目标 Python 版本（影响可用的类型特性）
+pythonPlatform = "All" # 目标平台：All | Linux | Windows | Darwin
+# typeCheckingMode 类型检查严格程度，可选值：
+#   - "off"：      关闭类型检查
+#   - "basic"：    基础检查（仅报告明确的类型错误）
+#   - "standard"： 标准检查（推荐，平衡严格性与实用性）
+#   - "strict"：   严格检查（要求完整的类型注解，适合新项目）
+#   - "all"：      最严格（启用所有检查，可能产生大量警告）
+typeCheckingMode = "standard"
+
+[tool.pytest.ini_options]
+addopts = [
+  "--import-mode=importlib", # 使用 importlib 导入模式（推荐，避免 sys.path 污染）
+  "--strict-markers",        # 严格标记模式（未注册的 marker 会报错）
+  "--tb=short",              # 简短的错误回溯（减少输出噪音）
+  "-ra",                     # 显示所有非通过测试的摘要（a=all except passed）
+]
+pythonpath = ["src", "tests"] # 添加到 Python 路径，确保模块可导入
+asyncio_mode = "auto" # 自动检测异步测试函数，无需手动标记 @pytest.mark.asyncio
+
+[tool.ruff]
+line-length = 88                 # 每行最大字符数（与 Black 保持一致）
+src = ["src", "tests"]           # 源代码目录（用于判断导入是本地模块还是第三方模块）
+extend-exclude = ["scripts"]     # 脚本目录不做 lint 检查
+
+[tool.ruff.format]
+line-ending = "lf" # 行尾符：lf（Unix）| crlf（Windows）| auto | native
+
+[tool.ruff.lint]
+# 启用的规则集，每个字母代码对应一组规则
+select = [
+  "F",     # Pyflakes：基础语法和逻辑错误检查
+  "W",     # pycodestyle warnings：PEP 8 风格警告
+  "E",     # pycodestyle errors：PEP 8 风格错误
+  "I",     # isort：导入语句排序
+  "B",     # flake8-bugbear：发现潜在 bug 和设计问题
+  "UP",    # pyupgrade：升级到新版 Python 语法
+  "ASYNC", # flake8-async：异步代码最佳实践
+  "C4",    # flake8-comprehensions：推导式优化建议
+  "T10",   # flake8-debugger：检测遗留的调试器语句（如 pdb）
+  "T20",   # flake8-print：检测 print 语句（生产代码应使用 logging）
+  "PYI",   # flake8-pyi：类型存根文件（.pyi）规范检查
+  "PT",    # flake8-pytest-style：pytest 代码风格检查
+  "Q",     # flake8-quotes：引号使用规范
+  "TID",   # flake8-tidy-imports：导入语句整理
+  "RUF",   # Ruff-specific：Ruff 特有的规则
+]
+# 忽略的规则（根据项目需求放宽）
+ignore = [
+  "E501",   # 行长度由 formatter 控制，lint 不重复检查
+  "E402",   # 允许模块导入不在文件顶部（某些情况下需要先执行代码）
+  "UP037",  # 允许使用引号包裹的类型注解（前向引用）
+  "RUF001", # 允许字符串中的中文等 Unicode 字符
+  "RUF002", # 允许文档字符串中的中文等 Unicode 字符
+  "RUF003", # 允许注释中的中文等 Unicode 字符
+  "W191",   # 允许使用制表符缩进
+  "TID252", # 允许使用相对导入
+  "B008",   # 允许在函数参数默认值中使用函数调用
+]
+
+[tool.ruff.lint.isort]
+extra-standard-library = ["typing_extensions"] # 将 typing_extensions 视为标准库

nonebot_plugin_fakemsg_next-0.2.0/src/nonebot_plugin_fakemsg_next/__init__.py

@@ -0,0 +1,16 @@
+from nonebot.plugin import PluginMetadata
+
+from .config import Config
+
+__plugin_meta__ = PluginMetadata(
+    name="伪造消息 Next",
+    description="使用显式命令触发的合并转发伪造消息插件。",
+    usage="伪造消息 @用户说ping|@用户说pong",
+    type="application",
+    homepage="https://github.com/Misty02600/nonebot-plugin-fakemsg-next",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+    extra={"author": "Misty02600"},
+)
+
+from . import handlers as handlers

nonebot_plugin_fakemsg_next-0.2.0/src/nonebot_plugin_fakemsg_next/config.py

@@ -0,0 +1,14 @@
+from nonebot.plugin import get_plugin_config
+from pydantic import BaseModel, Field
+
+
+class Config(BaseModel):
+    fakemsg_next_quick_separator: str = Field(
+        default="|",
+        min_length=1,
+        max_length=1,
+        description="多条伪造消息的分隔符，必须是单个字符。",
+    )
+
+
+plugin_config = get_plugin_config(Config)

nonebot_plugin_fakemsg_next-0.2.0/src/nonebot_plugin_fakemsg_next/handlers.py

@@ -0,0 +1,77 @@
+from contextlib import suppress
+
+from nonebot import on_command
+from nonebot.adapters.onebot.v11 import (
+    Bot,
+    GroupMessageEvent,
+    Message,
+    MessageSegment,
+)
+from nonebot.params import CommandArg
+
+from .config import plugin_config
+from .parser import parse_quick_message
+
+
+async def resolve_display_name(
+    bot: Bot,
+    event: GroupMessageEvent,
+    user_id: int,
+) -> str:
+    """解析伪造节点的显示名。
+
+    优先尝试群昵称，失败时直接使用 QQ 号字符串。
+
+    Args:
+        bot: 当前 OneBot v11 bot 实例。
+        event: 触发命令的群消息事件。
+        user_id: 目标用户 QQ 号。
+
+    Returns:
+        适合写入合并转发节点的显示名。
+    """
+
+    with suppress(Exception):
+        info = await bot.get_group_member_info(
+            group_id=event.group_id,
+            user_id=user_id,
+        )
+        display_name = info.get("nickname")
+        if display_name:
+            return display_name
+
+    return str(user_id)
+
+
+fakemsg_command = on_command(
+    "伪造消息",
+    aliases={"fakemsg", "消息伪造"},
+    priority=10,
+    block=True,
+)
+
+
+@fakemsg_command.handle()
+async def handle_fakemsg(
+    bot: Bot,
+    event: GroupMessageEvent,
+    arg: Message = CommandArg(),
+) -> None:
+    try:
+        parsed = parse_quick_message(
+            arg,
+            separator=plugin_config.fakemsg_next_quick_separator,
+        )
+    except ValueError as exc:
+        await fakemsg_command.finish(str(exc))
+
+    messages = [
+        MessageSegment.node_custom(
+            user_id=node.target_id,
+            nickname=await resolve_display_name(bot, event, node.target_id),
+            content=node.content,
+        )
+        for node in parsed
+    ]
+    await bot.send_group_forward_msg(group_id=event.group_id, messages=messages)
+    await fakemsg_command.finish()

nonebot_plugin_fakemsg_next-0.2.0/src/nonebot_plugin_fakemsg_next/parser.py

@@ -0,0 +1,168 @@
+from typing import NamedTuple
+
+from nonebot.adapters.onebot.v11 import Message, MessageSegment
+
+
+class ParsedNode(NamedTuple):
+    target_id: int
+    content: Message
+
+
+def _trim_message_edges(message: Message) -> Message:
+    segments = list(message)
+    while segments and segments[0].type == "text":
+        stripped = segments[0].data.get("text", "").lstrip()
+        if not stripped:
+            segments.pop(0)
+            continue
+        if stripped != segments[0].data.get("text", ""):
+            segments[0] = MessageSegment.text(stripped)
+        break
+
+    while segments and segments[-1].type == "text":
+        stripped = segments[-1].data.get("text", "").rstrip()
+        if not stripped:
+            segments.pop()
+            continue
+        if stripped != segments[-1].data.get("text", ""):
+            segments[-1] = MessageSegment.text(stripped)
+        break
+
+    return Message(segments)
+
+
+def _format_error(index: int, reason: str) -> ValueError:
+    return ValueError(f"格式不正确：第{index}条消息{reason}")
+
+
+def split_message_chunks(message: Message, *, separator: str) -> list[Message]:
+    """把一条命令参数拆成多条伪造消息。
+
+    只有文本段里的分隔符会触发拆分，图片、表情、at 等非文本段会留在
+    当前消息里。正文里需要保留分隔符本身时，可以在它前面加反斜杠转义。
+    连续分隔符、开头分隔符和结尾分隔符会产生空消息片段，交给后续格式
+    校验返回精确错误。
+
+    Args:
+        message: 待拆分的原始消息。
+        separator: 已从配置读取并校验过的单字符分隔符。
+
+    Returns:
+        按顺序拆出的消息片段列表。
+    """
+
+    chunks: list[Message] = []
+    current = Message()
+
+    def append_text(text: str) -> None:
+        nonlocal current
+        if text:
+            current += MessageSegment.text(text)
+
+    def flush_chunk() -> None:
+        nonlocal current
+        chunk = _trim_message_edges(current)
+        current = Message()
+        chunks.append(chunk)
+
+    for segment in _trim_message_edges(message):
+        if segment.type != "text":
+            current += segment
+            continue
+
+        text = segment.data.get("text", "")
+        buffer: list[str] = []
+        index = 0
+        while index < len(text):
+            char = text[index]
+            if char == "\\" and index + 1 < len(text) and text[index + 1] == separator:
+                buffer.append(separator)
+                index += 2
+                continue
+
+            if char == separator:
+                append_text("".join(buffer))
+                buffer.clear()
+                flush_chunk()
+                index += 1
+                continue
+
+            buffer.append(char)
+            index += 1
+
+        append_text("".join(buffer))
+
+    flush_chunk()
+    return chunks
+
+
+def parse_targeted_message(message: Message, *, index: int = 1) -> ParsedNode:
+    """解析单条“@用户说<内容>”结构。
+
+    Args:
+        message: 单条伪造消息片段。
+        index: 当前片段序号，用于错误提示。
+
+    Returns:
+        解析后的目标用户和消息内容。
+
+    Raises:
+        ValueError: 当缺少用户、缺少“说”或缺少内容时抛出。
+    """
+
+    remaining = _trim_message_edges(message)
+    if not remaining:
+        raise _format_error(index, "缺少内容")
+
+    first = remaining[0]
+    if first.type != "at":
+        raise _format_error(index, "缺少用户")
+
+    qq = first.data.get("qq")
+    if not qq or qq == "all":
+        raise _format_error(index, "缺少用户")
+    target_id = int(qq)
+    payload = _trim_message_edges(remaining[1:])
+    if not payload or payload[0].type != "text":
+        raise _format_error(index, "缺少“说”")
+
+    first_text = payload[0].data.get("text", "")
+    if not first_text.startswith("说"):
+        raise _format_error(index, "缺少“说”")
+
+    rest = first_text[1:]
+    if rest:
+        payload = MessageSegment.text(rest) + payload[1:]
+    else:
+        payload = payload[1:]
+
+    content = _trim_message_edges(payload)
+    if not content:
+        raise _format_error(index, "缺少内容")
+
+    return ParsedNode(target_id=target_id, content=content)
+
+
+def parse_quick_message(
+    message: Message,
+    *,
+    separator: str,
+) -> list[ParsedNode]:
+    """解析整条快捷命令参数。
+
+    Args:
+        message: 命令参数部分的原始消息。
+        separator: 多条伪造消息的顶层分隔符。
+
+    Returns:
+        每个分段对应的一组目标用户和消息内容。
+
+    Raises:
+        ValueError: 当任意分段不符合“@用户说<内容>”结构时抛出。
+    """
+
+    chunks = split_message_chunks(message, separator=separator)
+    return [
+        parse_targeted_message(chunk, index=index)
+        for index, chunk in enumerate(chunks, start=1)
+    ]