refactor: 工程化收尾——去 pyee、预计算解析计划与派生密钥、命名与接口一致化

以「语义可读、逻辑清晰、减少心智负担」为目标，不追求极致速度：

- **移除 pyee 依赖**：EventEmitter 改为内置的 `事件名 → handler 列表` 注册表
  （on() 追加、emit() 顺序遍历）。SDK 用不到 pyee 的 once/new_listener/错误
  事件机制，去掉后少一个依赖、分发语义一眼可读。注册语义不变（同函数重复
  注册只生效一次），并补测试锁定「重复注册只生效一次」「按注册顺序执行」。
  破坏性：once/remove_listener 等装饰性 API 不再提供。

- **去掉热路径上的重复计算**（纯缓存，不改语义）：
  · payloads 按类缓存解析计划（字段名 + 是否嵌套 Author），不再每次事件重跑
    dataclasses.fields 与联合类型解包；未收录字段照旧忽略（新增回归测试，
    线上 payload 会带 author.union_openid 这类字段）。实测 7.5µs → 2.5µs。
  · crypto 按 AppSecret 缓存派生私钥（每个 webhook 请求都要验签，派生一次
    约 40µs）；公钥派生只差 3µs，不再多缓存一层。

- **命名与接口一致性**：
  · WebsocketConnecter.reply_helper → send_helper（它从出站缓冲取帧发送，
    原名会让人误以为还有 reply 队列；model.py 的对应注释同步）
  · Connecter 由 typing.Protocol 改为 abc.ABC，与 BaseProtocol 风格统一

- **webhook 去重改摊还清理**：过期判定按当前 id 做（O(1)，且 TTL 外重发的
  同一 id 仍按新事件处理——原先的写法在阈值清理下会误判为重复，已由测试
  抓出并修正），整表清过期项只在表长到阈值时执行，不再每请求 O(n) 扫描。

测试 85 全绿（新增未知字段/解析计划缓存/注册语义/去重摊还与 TTL 过期），
ruff check/format + pyright 干净。文档 ARCHITECTURE/API/CHANGELOG 同步。

tests/test_dedup.py

@@ -1,3 +1,5 @@
+from time import monotonic
+
 from qqbotsdk.config import Config
 from qqbotsdk.connecter import WebhookConnecter
 from qqbotsdk.queue import EventQueue
@@ -48,3 +50,25 @@ def test_expired_entries_are_evicted():
         c._seen[key] -= c._DEDUP_TTL + 1
     assert not c._duplicated("evt-1")
     assert "evt-1" in c._seen  # 以新时间戳重新记录
+
+
+def test_expired_id_is_treated_as_new():
+    """TTL 之外重发的同一 id 是新事件，不能被当成重复丢掉。"""
+    c = make_connecter()
+    assert not c._duplicated("evt-x")
+    c._seen["evt-x"] -= c._DEDUP_TTL + 1  # 只把这一个改成过期
+    assert not c._duplicated("evt-x")
+
+
+def test_table_is_swept_only_at_threshold():
+    """表长未到阈值时不做全表清理（摊还 O(1)），过期项留在表里也不影响判定。"""
+    c = make_connecter()
+    assert not c._duplicated("old")
+    c._seen["old"] -= c._DEDUP_TTL + 1
+    assert not c._duplicated("new")  # 未到阈值：不清理
+    assert "old" in c._seen
+    # 灌到阈值，下一次判定触发清理，过期项被移除
+    for i in range(c._DEDUP_SWEEP_AT):
+        c._seen[f"filler-{i}"] = monotonic()
+    assert not c._duplicated("another")
+    assert "old" not in c._seen

tests/test_emitter.py

@@ -20,6 +20,38 @@ def test_sequence_only_moves_forward():
     assert s.seq == 7
 
 
+@pytest.mark.asyncio
+async def test_same_handler_registered_twice_runs_once():
+    """同名事件重复注册同一函数只生效一次（沿用 pyee 的语义）。"""
+    emitter = EventEmitter()
+    calls: list[str] = []
+
+    async def handler(_):
+        calls.append("hit")
+
+    emitter.on("READY", handler)
+    emitter.on("READY", handler)
+    await emitter.emit({"op": Opcode.DISPATCH, "t": "READY", "d": {}})
+    assert calls == ["hit"]
+
+
+@pytest.mark.asyncio
+async def test_handlers_run_in_registration_order():
+    emitter = EventEmitter()
+    order: list[int] = []
+
+    @emitter.on("READY")
+    async def first(_):
+        order.append(1)
+
+    @emitter.on("READY")
+    async def second(_):
+        order.append(2)
+
+    await emitter.emit({"op": Opcode.DISPATCH, "t": "READY", "d": {}})
+    assert order == [1, 2]
+
+
 @pytest.mark.asyncio
 async def test_handler_exception_is_isolated():
     queue = EventQueue()

tests/test_payloads.py

@@ -1,6 +1,7 @@
 from qqbotsdk.emitter import EventEmitter
 from qqbotsdk.model import Opcode
 from qqbotsdk.payloads import (
+    _PARSE_PLANS,
     C2CMessage,
     GroupAtMessage,
     Interaction,
@@ -10,7 +11,33 @@ from qqbotsdk.payloads import (
 from qqbotsdk.queue import EventQueue
 
 
-def test_parse_group_at_message():
+def test_parse_ignores_unknown_fields():
+    """回归：线上 payload 会带未收录字段（如 author.union_openid），
+    解析必须忽略而非透传给 dataclass 构造（那会直接报错）。"""
+    msg = parse_event(
+        "GROUP_AT_MESSAGE_CREATE",
+        {
+            "id": "msgid-9",
+            "content": "hi",
+            "group_openid": "G1",
+            "unknown_top_level": {"whatever": 1},
+            "author": {"member_openid": "M9", "union_openid": "U-should-be-dropped"},
+        },
+    )
+    assert isinstance(msg, GroupAtMessage)
+    assert msg.content == "hi"
+    assert msg.author is not None and msg.author.member_openid == "M9"
+
+
+def test_parse_plan_is_cached_per_class():
+    """解析计划按类缓存，且二次解析结果与首次一致。"""
+    d = {"content": "x", "group_openid": "G"}
+    first = parse_event("GROUP_AT_MESSAGE_CREATE", d)
+    second = parse_event("GROUP_AT_MESSAGE_CREATE", d)
+    assert isinstance(first, GroupAtMessage) and isinstance(second, GroupAtMessage)
+    assert first.content == second.content == "x"
+    assert GroupAtMessage in _PARSE_PLANS
+
     msg = parse_event(
         "GROUP_AT_MESSAGE_CREATE",
         {