nonebot-plugin-hermes 0.3.2__tar.gz → 0.3.3__tar.gz

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-hermes
-Version: 0.3.2
+Version: 0.3.3
 Summary: NoneBot plugin for Hermes Agent — multi-platform AI chatbot via Hermes API Server
 License: MIT
 Project-URL: Homepage, https://github.com/gsskk/nonebot-plugin-hermes
@@ -18,6 +18,7 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: ruff>=0.15; extra == "dev"
+Requires-Dist: nonebot-adapter-onebot>=2.4.6; extra == "dev"
 
 # nonebot-plugin-hermes
 
@@ -61,6 +62,7 @@ Requires-Dist: ruff>=0.15; extra == "dev"
 - 🧪 **群活跃态 (M1, 实验性)**：@bot 后 5 分钟内主动监听群对话，由 Hermes 通过结构化决策判断是否插话
 - 🧪 **反向通道 (M1, 实验性)**：内嵌本地 MCP server，让 Hermes 主动 push 消息进群（延迟回复 / 异步通知）
 - 🧪 **历史图片召回 (0.3+, 实验性)**：SQLite 持久化消息日志 + 文件系统图字节缓存 + MCP 工具 `get_message_images`，让 Hermes 在用户说"上图"/"刚才那张"时按消息 id 精确取回历史图字节
+- 🧪 **OneBot v11 Notice 触发 (0.3.3+, 实验性)**：戳一戳作为第二种 @ 等价触发；有人入群时让 Hermes 自决要不要欢迎（noop 合法，不做模板欢迎语）
 
 ## 快速开始
 
@@ -325,6 +327,8 @@ T+5s  用户 B:  @bot 评价下上图
 | `HERMES_ACTIVE_SESSION_ENABLED` | `false` | 启用群活跃态（M1）。`false` 时退化为 v0.1.6 等价行为 |
 | `HERMES_ACTIVE_SESSION_TTL_SEC` | `300` | 活跃窗口 TTL（秒），每次插话滑动续期 |
 | `HERMES_ACTIVE_SWEEP_INTERVAL_SEC` | `30` | 活跃态过期清扫 cron 频率（秒） |
+| `HERMES_POKE_TRIGGER_ENABLED` | `false` | OneBot v11:被戳一戳时触发对话（私聊 / 群都生效,等价于被 @）。其他适配器静默忽略 |
+| `HERMES_GREET_ON_JOIN` | `false` | OneBot v11:有人加入群且 `HERMES_ACTIVE_SESSION_ENABLED=true` 时,触发一次 reactive turn 让 Hermes 自决是否欢迎(`noop` 是合法返回)。active 关时不触发 |
 | `HERMES_BUFFER_PER_GROUP_CAP` | `200` | ⚠️ **0.3 起空转**——MessageBuffer 改为 SQLite 后端,无内存 per-group 上限;消息淘汰由 `HERMES_STORAGE_MESSAGE_*` 控制。下一个 major 版本会移除 |
 | `HERMES_BUFFER_TOTAL_GROUPS_CAP` | `50` | ⚠️ **0.3 起空转**——同上,SQLite 后端无 LRU,改为 retention + 行数上限 |
 | `HERMES_MCP_ENABLED` | `false` | 启动内嵌 FastMCP server（M1 反向通道） |

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/README.md

@@ -40,6 +40,7 @@
 - 🧪 **群活跃态 (M1, 实验性)**：@bot 后 5 分钟内主动监听群对话，由 Hermes 通过结构化决策判断是否插话
 - 🧪 **反向通道 (M1, 实验性)**：内嵌本地 MCP server，让 Hermes 主动 push 消息进群（延迟回复 / 异步通知）
 - 🧪 **历史图片召回 (0.3+, 实验性)**：SQLite 持久化消息日志 + 文件系统图字节缓存 + MCP 工具 `get_message_images`，让 Hermes 在用户说"上图"/"刚才那张"时按消息 id 精确取回历史图字节
+- 🧪 **OneBot v11 Notice 触发 (0.3.3+, 实验性)**：戳一戳作为第二种 @ 等价触发；有人入群时让 Hermes 自决要不要欢迎（noop 合法，不做模板欢迎语）
 
 ## 快速开始
 
@@ -304,6 +305,8 @@ T+5s  用户 B:  @bot 评价下上图
 | `HERMES_ACTIVE_SESSION_ENABLED` | `false` | 启用群活跃态（M1）。`false` 时退化为 v0.1.6 等价行为 |
 | `HERMES_ACTIVE_SESSION_TTL_SEC` | `300` | 活跃窗口 TTL（秒），每次插话滑动续期 |
 | `HERMES_ACTIVE_SWEEP_INTERVAL_SEC` | `30` | 活跃态过期清扫 cron 频率（秒） |
+| `HERMES_POKE_TRIGGER_ENABLED` | `false` | OneBot v11:被戳一戳时触发对话（私聊 / 群都生效,等价于被 @）。其他适配器静默忽略 |
+| `HERMES_GREET_ON_JOIN` | `false` | OneBot v11:有人加入群且 `HERMES_ACTIVE_SESSION_ENABLED=true` 时,触发一次 reactive turn 让 Hermes 自决是否欢迎(`noop` 是合法返回)。active 关时不触发 |
 | `HERMES_BUFFER_PER_GROUP_CAP` | `200` | ⚠️ **0.3 起空转**——MessageBuffer 改为 SQLite 后端,无内存 per-group 上限;消息淘汰由 `HERMES_STORAGE_MESSAGE_*` 控制。下一个 major 版本会移除 |
 | `HERMES_BUFFER_TOTAL_GROUPS_CAP` | `50` | ⚠️ **0.3 起空转**——同上,SQLite 后端无 LRU,改为 retention + 行数上限 |
 | `HERMES_MCP_ENABLED` | `false` | 启动内嵌 FastMCP server（M1 反向通道） |

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes/__init__.py

@@ -14,7 +14,7 @@ require("nonebot_plugin_localstore")
 
 from .config import Config, plugin_config
 
-__version__ = "0.3.2"
+__version__ = "0.3.3"
 
 __plugin_meta__ = PluginMetadata(
     name="Hermes Agent",

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes/config.py

@@ -92,11 +92,28 @@ class Config(BaseModel):
     hermes_active_sweep_interval_sec: int = 30
     """expire_active_sessions cron 频率(秒)"""
 
+    # --- Notice 事件触发 (Phase A) ---
+    hermes_poke_trigger_enabled: bool = False
+    """OneBot v11: 被戳一戳时触发对话(私聊/群无差别),等价 @。
+    其他适配器无效,缺省全关 = 老用户行为零变化。"""
+
+    hermes_greet_on_join: bool = False
+    """OneBot v11: 群里有人加入时,在 active_session 开启的群触发一次 reactive turn
+    让 Hermes 自决是否欢迎(decision_protocol 的 noop 是合法选择)。
+    active_session 关时不触发——passive 是 1:1 Q&A 语义,不适用欢迎场景。"""
+
     hermes_reactive_post_reply_cooldown_sec: int = 8
     """reactive 模式下,bot 刚回复完群里 N 秒内,非显式 @ 触发的新消息直接静默。
     用来阻断「我刚说完别人接话→我又凑一句」类型的过触发。
     0 = 关闭(回退到旧行为)。显式 @bot 不受影响,任何时候都会立刻进入决策。"""
 
+    hermes_transport_error_fallback_text: str = "嗯…我这边遇到点状况,稍后再问一次"
+    """Hermes 上游返 5xx / 传输错误时, 替代 LLM raw_text 的兜底文本。
+    没有这条兜底, 服务端英文错误信息(如 "Model generated invalid tool call: ...")
+    会被原文当 raw_text 发到群里,体验差也泄露内部信息。
+    空串 → 不发任何文本(等价于 silent)。仅在 reactive 显式触发 / passive 路径生效——
+    非显式触发本来就静默,不受影响。"""
+
     # --- M1: 反向 MCP 通道 ---
     hermes_mcp_enabled: bool = False
     """是否启动内嵌 FastMCP server(False 时 Hermes 反向调用全失败,出向不影响)"""

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes/handlers/__init__.py

@@ -3,3 +3,4 @@
 
 from . import commands  # noqa: F401
 from . import message  # noqa: F401
+from . import notices  # noqa: F401

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes/handlers/message.py

@@ -513,6 +513,27 @@ async def _run_passive_turn(
         user_content_override=user_content,
     )
 
+    # 上游 transport_error 同款保护(见 _run_reactive_turn 同名分支注释)。
+    # passive 路径下私聊总是显式对话,群聊已通过触发判断进得来,两边都该有可见反馈;
+    # 配空 fallback_text 时静默,保留逃生口。
+    if result.is_transport_error:
+        fallback_text = plugin_config.hermes_transport_error_fallback_text
+        logger.warning(
+            f"[HERMES passive] transport error fallback "
+            f"(group={group_id}, is_private={is_private}, "
+            f"fallback={'silent' if not fallback_text else 'friendly_text'}); "
+            f"upstream raw_text suppressed (len={len(result.raw_text or '')})"
+        )
+        if fallback_text:
+            await send_text_with_media(
+                bot=bot,
+                target=target,
+                text=fallback_text,
+                media_urls=[],
+                at_user_id=None if is_private else user_id,
+            )
+        return result
+
     # 防御:同一 Hermes session 之前跑过 reactive 时学到 submit_decision 契约,
     # 切回 passive 后仍可能吐 JSON。检测并抠 reply_text;不命中则用原 raw_text。
     reply_text = result.raw_text
@@ -562,11 +583,9 @@ async def _run_reactive_turn(
     if session is None:
         return None  # 防御:窗口刚刚过期 / 被外部 end()
 
-    # B.3: 快照本 turn 入口时的 last_bot_reply_at,供 chat() 返回后判定 agent loop
-    # 期间是否有外部(MCP push_message)推过 bot 自己的回复。若发生,即使 LLM 返
-    # should_reply=True 也必须抑制本路 send,否则同 turn 内双答。
-    # 2026-05-18 17:48 事件原型:Hermes 在 reactive agent loop 内既调 push_message
-    # 又在 submit_decision 里把同样答案再吐了一遍,plugin 接下来都发了一遍 → 双答。
+    # B.3: 快照本 turn 入口时的 last_bot_reply_at, 供 chat() 返回后判定 agent loop
+    # 期间是否有外部(MCP push_message)推过 bot 自己的回复。 若发生, 即使 LLM 返
+    # should_reply=True 也必须抑制本路 send, 否则同 turn 内双答。
     last_bot_reply_at_at_entry = session.last_bot_reply_at
 
     recent = _mcp.message_buffer.get_recent(
@@ -614,6 +633,28 @@ async def _run_reactive_turn(
     )
 
     if result.parse_failed or result.structured is None:
+        # 上游 transport_error(5xx / 网络断 / 流被掐):raw_text 是服务端错误信息原文
+        # (如 "Model generated invalid tool call: ..."),原文转发会把内部错误丢到群里
+        # 既泄密又难看。换成 config 里的友好兜底文本;空串则静默。
+        # parse_failed 但非 transport(LLM 真的回了点啥但结构错):原样转发 raw_text,
+        # 仍可能是用户想要的回答。
+        if result.is_transport_error and is_explicit_trigger:
+            fallback_text = plugin_config.hermes_transport_error_fallback_text
+            logger.warning(
+                f"[HERMES reactive] transport error fallback "
+                f"(group={group_id}, fallback={'silent' if not fallback_text else 'friendly_text'}); "
+                f"upstream raw_text suppressed (len={len(result.raw_text or '')})"
+            )
+            if fallback_text:
+                await send_text_with_media(
+                    bot=bot,
+                    target=target,
+                    text=fallback_text,
+                    media_urls=[],
+                    at_user_id=user_id,
+                )
+            return result
+
         logger.warning(
             f"[HERMES reactive] structured parse failed (group={group_id}, "
             f"transport_error={result.is_transport_error}); fallback="
@@ -686,12 +727,18 @@ async def _run_reactive_turn(
         f"ok={sent} text_len={len(reply_text)} at_user={at_user}"
     )
 
-    # 把 bot 自己的回复回写 MessageBuffer。复用入参 now_ms,避免 send 耗时
-    # 后两次 _now_ms() 调用之间出现毫秒级偏差。
+    # 用 send 完成时的 wall clock,不复用入参 now_ms。
+    # 入参 now_ms 是 _handle_reactive_path 进函数那一刻抓的, chat() + send 可能耗时
+    # 任意长(上游重试 / 上下文压缩 / 工具调用累加),复用入参会让 last_bot_reply_at
+    # 远早于真实 send 时间, 让下游 cooldown 闸门(_in_post_reply_cooldown)算出来的
+    # elapsed 失真,把窗内的 refire 误判成窗外放过去。
+    # 调一次 _now_ms() 拿到 reply_now_ms,三个写操作复用这一个快照,既校正 stale
+    # 入参,又避免多次读时钟在三个字段间引入毫秒级偏差。
     if sent and _mcp.message_buffer is not None:
+        reply_now_ms = _now_ms()
         _mcp.message_buffer.append(
             BufferedMessage(
-                ts=now_ms,
+                ts=reply_now_ms,
                 adapter=adapter_name,
                 group_id=group_id,
                 user_id=str(bot.self_id),
@@ -703,9 +750,10 @@ async def _run_reactive_turn(
         )
         # 注:若 should_exit_active=True,session 已在上方 end(),touch / mark_bot_replied
         # 都是安全 no-op(两者文档统一:session 缺失则 no-op)。
-        _mcp.active_sessions.touch(adapter_name, group_id, now_ms=now_ms)
-        # B.2: 记下「bot 刚回过」时间戳,供 _handle_reactive_path 入口的 cooldown 闸门判定
-        _mcp.active_sessions.mark_bot_replied(adapter_name, group_id, now_ms=now_ms)
+        _mcp.active_sessions.touch(adapter_name, group_id, now_ms=reply_now_ms)
+        # B.2: 记下「bot 刚回过」时间戳,供 _handle_reactive_path 入口 + _refire 入口的
+        # cooldown 闸门判定。
+        _mcp.active_sessions.mark_bot_replied(adapter_name, group_id, now_ms=reply_now_ms)
 
     return result
 
@@ -1020,3 +1068,81 @@ async def _refire(
             )
         else:
             _mcp.inflight.exit(key)
+
+
+async def route_synthesized_input(
+    *,
+    bot: Bot,
+    target,
+    adapter_name: str,
+    user_id: str,
+    group_id: Optional[str],
+    nickname: Optional[str],
+    text: str,
+    allow_passive: bool,
+    now_ms: int,
+):
+    """合成消息的统一入口,供 notice handler 复用既有 message routing。
+
+    派发规则:
+      - private (target.private=True) → 仅 allow_passive=True 才走 passive,否则跳过
+      - group + active_session 开 → 触发 active session 并走 reactive
+        (synth 始终算 is_explicit_trigger=True)
+      - group + active_session 关 → 仅 allow_passive=True 才走 passive
+
+    `allow_passive` 控制无 active session 时的兜底:
+      - 戳一戳: True (任何 mode 都开口)
+      - 入群: False (仅 active 开时通过 reactive 让 Hermes 自决,否则不打扰)
+    """
+    if target.private:
+        if not allow_passive:
+            return
+        await _handle_passive_path(
+            bot=bot,
+            target=target,
+            adapter_name=adapter_name,
+            user_id=user_id,
+            nickname=nickname,
+            group_id=None,
+            text=text,
+            image_urls=[],
+            is_private=True,
+            now_ms=now_ms,
+        )
+        return
+
+    # 群聊
+    if not plugin_config.hermes_active_session_enabled:
+        if not allow_passive:
+            return
+        await _handle_passive_path(
+            bot=bot,
+            target=target,
+            adapter_name=adapter_name,
+            user_id=user_id,
+            nickname=nickname,
+            group_id=group_id,
+            text=text,
+            image_urls=[],
+            is_private=False,
+            now_ms=now_ms,
+        )
+        return
+
+    # 群 + active_session 开 → 显式触发 + reactive
+    # (与 handle_message 显式触发同语义: 先 trigger,再 _handle_reactive_path)
+    assert _mcp.active_sessions is not None
+    _mcp.active_sessions.trigger(adapter_name, group_id or "", user_id, now_ms=now_ms)
+    logger.info(f"[HERMES notice] synthesized reactive trigger: {adapter_name}/{group_id} by {user_id}")
+    await _handle_reactive_path(
+        bot=bot,
+        target=target,
+        adapter_name=adapter_name,
+        user_id=user_id,
+        nickname=nickname,
+        group_id=group_id,
+        text=text,
+        image_urls=[],
+        is_explicit_trigger=True,
+        now_ms=now_ms,
+    )

nonebot_plugin_hermes-0.3.3/nonebot_plugin_hermes/handlers/notices.py

@@ -0,0 +1,140 @@
+"""通知事件处理器
+
+priority=1 dispatch: 适配器特定 notice 事件 → 合成伪消息 → 复用 message.py 路由。
+
+**CLAUDE.md 规则例外**: 本文件是仅有的允许 import 适配器特定类型的位置。
+- 仅在 dispatch 函数内部 try-import (惰性)
+- 失败 (ImportError) 即 no-op,不影响其他平台
+"""
+
+from __future__ import annotations
+
+import time
+
+import nonebot_plugin_alconna as alconna
+from nonebot import logger, on_notice
+from nonebot.adapters import Bot, Event
+
+from ..config import plugin_config
+from ..utils import check_isolation, get_adapter_name
+from .message import route_synthesized_input
+
+notice_handler = on_notice(priority=1, block=False)
+
+
+def _now_ms() -> int:
+    return int(time.time() * 1000)
+
+
+@notice_handler.handle()
+async def dispatch(bot: Bot, event: Event):
+    """OneBot v11 notice 事件分发入口。
+
+    早期 return:
+      - 两个开关都关
+      - adapter != OneBot V11
+      - ImportError (onebot adapter 未装)
+    """
+    if not (plugin_config.hermes_poke_trigger_enabled or plugin_config.hermes_greet_on_join):
+        return
+
+    adapter_name = get_adapter_name(bot)
+    if adapter_name != "onebotv11":
+        return
+
+    try:
+        from nonebot.adapters.onebot.v11 import (
+            GroupIncreaseNoticeEvent,
+            PokeNotifyEvent,
+        )
+    except ImportError:
+        logger.debug("[HERMES notice] OneBot v11 adapter not installed; skip")
+        return
+
+    if isinstance(event, PokeNotifyEvent) and plugin_config.hermes_poke_trigger_enabled:
+        await _handle_poke(bot, event)
+    elif isinstance(event, GroupIncreaseNoticeEvent) and plugin_config.hermes_greet_on_join:
+        await _handle_member_join(bot, event)
+
+
+async def _handle_poke(bot: Bot, event) -> None:
+    """戳一戳: 仅戳 bot 自己时触发,合成 `[poke] 戳了你一下`。"""
+    # OneBot v11 的 target_id/self_id/user_id 都是 int,统一字符串后比较
+    if str(event.target_id) != str(bot.self_id):
+        return
+    if str(event.user_id) == str(bot.self_id):
+        return  # bot 戳自己(罕见),跳过
+
+    user_id = str(event.user_id)
+    group_id = str(event.group_id) if event.group_id else None
+
+    target = _build_target(adapter_name="onebotv11", user_id=user_id, group_id=group_id)
+    if not check_isolation(event, target):
+        return
+
+    nickname = await _resolve_nickname(bot, user_id=user_id, group_id=group_id)
+
+    await route_synthesized_input(
+        bot=bot,
+        target=target,
+        adapter_name="onebotv11",
+        user_id=user_id,
+        group_id=group_id,
+        nickname=nickname,
+        text="[poke] 戳了你一下",
+        allow_passive=True,
+        now_ms=_now_ms(),
+    )
+
+
+async def _handle_member_join(bot: Bot, event) -> None:
+    """入群: 合成 `[event=member_join] {nickname} 加入了群`。
+    active_session 关时由 route_synthesized_input 自检并跳过。"""
+    if str(event.user_id) == str(bot.self_id):
+        return  # bot 自己被拉进新群,buffer 空,跳过
+
+    user_id = str(event.user_id)
+    group_id = str(event.group_id)
+
+    target = _build_target(adapter_name="onebotv11", user_id=user_id, group_id=group_id)
+    if not check_isolation(event, target):
+        return
+
+    nickname = await _resolve_nickname(bot, user_id=user_id, group_id=group_id)
+
+    await route_synthesized_input(
+        bot=bot,
+        target=target,
+        adapter_name="onebotv11",
+        user_id=user_id,
+        group_id=group_id,
+        nickname=nickname,
+        text=f"[event=member_join] {nickname} 加入了群",
+        allow_passive=False,
+        now_ms=_now_ms(),
+    )
+
+
+async def _resolve_nickname(bot: Bot, *, user_id: str, group_id):
+    """OneBot v11 API 拿昵称,失败 fallback 用 user_id 字符串。"""
+    try:
+        if group_id:
+            info = await bot.call_api(
+                "get_group_member_info",
+                group_id=int(group_id),
+                user_id=int(user_id),
+                no_cache=True,
+            )
+            return info.get("card") or info.get("nickname") or user_id
+        info = await bot.call_api("get_stranger_info", user_id=int(user_id))
+        return info.get("nickname") or user_id
+    except Exception as e:
+        logger.debug(f"[HERMES notice] nickname resolve failed for {user_id}: {e}")
+        return user_id
+
+
+def _build_target(*, adapter_name: str, user_id: str, group_id):
+    """构造 alconna.Target——notice handler 不在 alconna 消息上下文里,要自己造。"""
+    if group_id:
+        return alconna.Target(id=group_id, private=False, adapter=adapter_name)
+    return alconna.Target(id=user_id, private=True, adapter=adapter_name)

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes/mcp/tools/push_message.py

@@ -5,13 +5,13 @@
   - BotRegistry 必须有该 (adapter, group_id) 的 Target
 不满足任一条件返回 422 等价错误(由 FastMCP 序列化为 isError=true)。
 
-成功路径的副作用,与 reactive submit_decision 回复路径(_run_reactive_turn 末段)等价:
-  1. mark_bot_replied — 写 ActiveSession.last_bot_reply_at,供 post-reply cooldown 闸门
+成功路径的副作用, 与 reactive submit_decision 回复路径(_run_reactive_turn 末段)等价:
+  1. mark_bot_replied — 写 ActiveSession.last_bot_reply_at, 供 post-reply cooldown 闸门
      在后续 reactive turn / refire 入口判定
   2. message_buffer.append(is_bot=True) — 让后续 _run_reactive_turn 拉到的
-     <recent_messages> 里能看见 bot 这条 push 出去的话,LLM 不会"以为自己没说"
-两件都做才能避免「Hermes 用 push_message 当主回复 + 后续 refire 又答一遍同主题」
-的重复回复事件(2026-05-18)。
+     <recent_messages> 里能看见 bot 这条 push 出去的话, LLM 不会"以为自己没说"
+两件都做才能避免 Hermes 用 push_message 当主回复后, 后续 refire / 同 turn submit_decision
+又答一遍同主题。
 """
 
 from __future__ import annotations

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes/utils.py

@@ -4,9 +4,17 @@ from nonebot.adapters import Event
 from .config import plugin_config
 
 
-def get_adapter_name(target: alconna.Target) -> str:
-    """从 Target 中提取适配器名称"""
-    adapter = getattr(target, "adapter", "") or ""
+def get_adapter_name(source) -> str:
+    """提取并归一化 adapter 名。
+
+    支持两种输入:
+      - `alconna.Target` (`.adapter` 是 str) — 消息处理路径主用
+      - `nonebot.adapters.Bot` (`.adapter` 是 Adapter 实例,有 classmethod `get_name()`)
+        — notice handler 路径用,因为还没有 alconna 消息上下文构造 Target
+    """
+    adapter = getattr(source, "adapter", "") or ""
+    if hasattr(adapter, "get_name"):
+        adapter = adapter.get_name()
     return adapter.lower().replace(" ", "").replace(".", "") or "unknown"
 
 

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-hermes
-Version: 0.3.2
+Version: 0.3.3
 Summary: NoneBot plugin for Hermes Agent — multi-platform AI chatbot via Hermes API Server
 License: MIT
 Project-URL: Homepage, https://github.com/gsskk/nonebot-plugin-hermes
@@ -18,6 +18,7 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: ruff>=0.15; extra == "dev"
+Requires-Dist: nonebot-adapter-onebot>=2.4.6; extra == "dev"
 
 # nonebot-plugin-hermes
 
@@ -61,6 +62,7 @@ Requires-Dist: ruff>=0.15; extra == "dev"
 - 🧪 **群活跃态 (M1, 实验性)**：@bot 后 5 分钟内主动监听群对话，由 Hermes 通过结构化决策判断是否插话
 - 🧪 **反向通道 (M1, 实验性)**：内嵌本地 MCP server，让 Hermes 主动 push 消息进群（延迟回复 / 异步通知）
 - 🧪 **历史图片召回 (0.3+, 实验性)**：SQLite 持久化消息日志 + 文件系统图字节缓存 + MCP 工具 `get_message_images`，让 Hermes 在用户说"上图"/"刚才那张"时按消息 id 精确取回历史图字节
+- 🧪 **OneBot v11 Notice 触发 (0.3.3+, 实验性)**：戳一戳作为第二种 @ 等价触发；有人入群时让 Hermes 自决要不要欢迎（noop 合法，不做模板欢迎语）
 
 ## 快速开始
 
@@ -325,6 +327,8 @@ T+5s  用户 B:  @bot 评价下上图
 | `HERMES_ACTIVE_SESSION_ENABLED` | `false` | 启用群活跃态（M1）。`false` 时退化为 v0.1.6 等价行为 |
 | `HERMES_ACTIVE_SESSION_TTL_SEC` | `300` | 活跃窗口 TTL（秒），每次插话滑动续期 |
 | `HERMES_ACTIVE_SWEEP_INTERVAL_SEC` | `30` | 活跃态过期清扫 cron 频率（秒） |
+| `HERMES_POKE_TRIGGER_ENABLED` | `false` | OneBot v11:被戳一戳时触发对话（私聊 / 群都生效,等价于被 @）。其他适配器静默忽略 |
+| `HERMES_GREET_ON_JOIN` | `false` | OneBot v11:有人加入群且 `HERMES_ACTIVE_SESSION_ENABLED=true` 时,触发一次 reactive turn 让 Hermes 自决是否欢迎(`noop` 是合法返回)。active 关时不触发 |
 | `HERMES_BUFFER_PER_GROUP_CAP` | `200` | ⚠️ **0.3 起空转**——MessageBuffer 改为 SQLite 后端,无内存 per-group 上限;消息淘汰由 `HERMES_STORAGE_MESSAGE_*` 控制。下一个 major 版本会移除 |
 | `HERMES_BUFFER_TOTAL_GROUPS_CAP` | `50` | ⚠️ **0.3 起空转**——同上,SQLite 后端无 LRU,改为 retention + 行数上限 |
 | `HERMES_MCP_ENABLED` | `false` | 启动内嵌 FastMCP server（M1 反向通道） |

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes.egg-info/SOURCES.txt

@@ -26,6 +26,7 @@ nonebot_plugin_hermes/core/storage/message_store.py
 nonebot_plugin_hermes/handlers/__init__.py
 nonebot_plugin_hermes/handlers/commands.py
 nonebot_plugin_hermes/handlers/message.py
+nonebot_plugin_hermes/handlers/notices.py
 nonebot_plugin_hermes/mcp/__init__.py
 nonebot_plugin_hermes/mcp/auth.py
 nonebot_plugin_hermes/mcp/server.py
@@ -57,6 +58,10 @@ tests/test_mcp_read_tools.py
 tests/test_message_buffer.py
 tests/test_message_handler_coalesce.py
 tests/test_message_store.py
+tests/test_notices.py
+tests/test_notices_config.py
 tests/test_prompt_builder.py
+tests/test_route_synthesized_input.py
 tests/test_session_manager.py
-tests/test_tasks_storage_vacuum.py
+tests/test_tasks_storage_vacuum.py
+tests/test_utils_adapter_name.py

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/nonebot_plugin_hermes.egg-info/requires.txt

@@ -11,3 +11,4 @@ pydantic>=2.0
 pytest>=8.0
 pytest-asyncio>=0.23
 ruff>=0.15
+nonebot-adapter-onebot>=2.4.6

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-hermes"
-version = "0.3.2"
+version = "0.3.3"
 description = "NoneBot plugin for Hermes Agent — multi-platform AI chatbot via Hermes API Server"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -22,6 +22,7 @@ dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
     "ruff>=0.15",
+    "nonebot-adapter-onebot>=2.4.6",
 ]
 
 [project.urls]

{nonebot_plugin_hermes-0.3.2 → nonebot_plugin_hermes-0.3.3}/tests/test_mcp_push_message.py

@@ -236,15 +236,14 @@ async def test_push_accepts_image_only_message():
 # Side-effects on success: mark_bot_replied + buffer append
 # ---------------------------------------------------------------------------
 #
-# 这两个 case 是 2026-05-18 "重复回答" 事件的回归测试。Hermes 在 reactive turn 内
-# 调 push_message 时,plugin 必须把它当成"bot 在群里发了一句"来记账,否则:
-#   1. cooldown 闸门读不到 last_bot_reply_at,后续非显式触发的旁观消息会被白白
-#      送进 LLM 决策,产生与 push 内容同主题的二次回复(见 _refire 路径)
-#   2. 后续 _run_reactive_turn 的 <recent_messages> 里看不见 bot 已答,LLM 也无从
-#      自决 should_reply=false
+# push_message 成功后必须把它当成"bot 在群里发了一句"来记账, 与
+# _run_reactive_turn 末段写 last_bot_reply_at / append BufferedMessage(is_bot=True)
+# 等价。 否则:
+#   1. cooldown 闸门读不到 last_bot_reply_at,后续非显式触发会被放过去送进 LLM 决策
+#   2. 后续 turn 拉到的 <recent_messages> 看不见 bot 已答,LLM 无从自决 should_reply=false
 #
-# 这里只钉死 push_message_impl 自己的副作用契约;_refire 入口的 cooldown 闸门
-# 在 test_message_handler_coalesce.py 里有独立回归测试。
+# 这里只钉死 push_message_impl 自己的副作用契约;_refire 入口、_run_reactive_turn
+# 末段的 cooldown 闸门在 test_message_handler_coalesce.py 里有独立测试。
 
 
 @pytest.mark.asyncio