ErisPulse-BilibiliAdapter 0.1.0__tar.gz

erispulse_bilibiliadapter-0.1.0/BilibiliAdapter/Core.py

@@ -0,0 +1,700 @@
+import asyncio
+import json
+import time as _time
+import uuid
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+
+from ErisPulse import sdk
+from ErisPulse.Core.Bases import BaseConfig, BotAccountConfig, BaseAdapter
+try:
+    from ErisPulse.runtime.tasks import spawn_background
+except ImportError:  # pragma: no cover
+    spawn_background = None
+
+__version__ = "0.1.0"
+
+MIN_FRAMEWORK_VERSION = (2, 7, 1)
+
+
+def _parse_version(version_str: str):
+    try:
+        parts = []
+        for part in version_str.split("."):
+            digits = ""
+            for ch in part:
+                if ch.isdigit():
+                    digits += ch
+                else:
+                    break
+            parts.append(int(digits or 0))
+        while len(parts) < 3:
+            parts.append(0)
+        return tuple(parts[:3])
+    except Exception:
+        return (0, 0, 0)
+
+
+def _check_framework_version() -> bool:
+    try:
+        raw = sdk.__version__ if hasattr(sdk, "__version__") else sdk.version
+        if callable(raw):
+            raw = raw()
+        current = _parse_version(str(raw))
+        if current < MIN_FRAMEWORK_VERSION:
+            print(
+                f"警告: ErisPulse 版本过低 (当前 {current}，需要 >= "
+                f"{MIN_FRAMEWORK_VERSION})，BilibiliAdapter 可能无法正常工作"
+            )
+            return False
+        return True
+    except Exception:
+        return True
+
+
+from bilibili_api import login_v2, session as bili_session
+from bilibili_api.utils.network import Credential
+
+
+@dataclass
+class BilibiliAccountConfig(BotAccountConfig):
+    """Bilibili 账户配置"""
+
+    login_mode: str = field(
+        default="cookie",
+        metadata={
+            "description": "登录方式：cookie=手动填写凭据，qrcode=面板扫码登录",
+            "required": False,
+            "ui": {
+                "widget": "select",
+                "group": "connection",
+                "order": 1,
+                "options": [
+                    {"label": "Cookie 凭据", "value": "cookie"},
+                    {"label": "扫码登录", "value": "qrcode"},
+                ],
+            },
+        },
+    )
+    sessdata: str = field(
+        default="",
+        metadata={
+            "description": "SESSDATA（浏览器 Cookie，登录后可见）",
+            "required": False,
+            "secret": True,
+            "ui": {
+                "widget": "password",
+                "group": "connection",
+                "order": 2,
+                "show_if": {"field": "login_mode", "op": "eq", "value": "cookie"},
+            },
+        },
+    )
+    bili_jct: str = field(
+        default="",
+        metadata={
+            "description": "bili_jct（浏览器 Cookie，csrf 令牌）",
+            "required": False,
+            "secret": True,
+            "ui": {
+                "widget": "password",
+                "group": "connection",
+                "order": 3,
+                "show_if": {"field": "login_mode", "op": "eq", "value": "cookie"},
+            },
+        },
+    )
+    buvid3: str = field(
+        default="",
+        metadata={
+            "description": "buvid3（浏览器 Cookie，降低风控概率）",
+            "required": False,
+            "secret": True,
+            "ui": {
+                "widget": "password",
+                "group": "connection",
+                "order": 4,
+                "show_if": {"field": "login_mode", "op": "eq", "value": "cookie"},
+            },
+        },
+    )
+    dedeuserid: str = field(
+        default="",
+        metadata={
+            "description": "DedeUserID（浏览器 Cookie，即账号 UID）",
+            "required": False,
+            "secret": True,
+            "ui": {
+                "widget": "password",
+                "group": "connection",
+                "order": 5,
+                "show_if": {"field": "login_mode", "op": "eq", "value": "cookie"},
+            },
+        },
+    )
+    bot_id: str = field(
+        default="",
+        metadata={
+            "description": "账号 UID（留空则登录后自动获取）",
+            "required": False,
+            "ui": {"widget": "text", "group": "basic", "order": 6},
+        },
+    )
+
+
+BilibiliAccountConfig._schema_meta = {
+    "group_labels": {
+        "basic": {"i18n": "bilibili.group.basic", "default": "基本设置"},
+        "connection": {"i18n": "bilibili.group.connection", "default": "登录凭据"},
+    }
+}
+
+
+class BilibiliAdapter(BaseAdapter):
+    """
+    Bilibili 私信适配器
+
+    基于 bilibili-api-python，Cookie / 扫码双登录，事件驱动的私信收发。
+
+    {!--< tips >!--}
+    1. 多账户：accounts 下每个账户对应一个 B 站账号
+    2. 事件：私信消息（detail_type=private），PlatformEvent 提供 bilibili_raw 原始数据
+    3. 发送：支持 text 段与 image 段（image 的 file 为 URL 或本地路径）
+    4. 风控提醒：非官方接口，请控制发送频率，避免账号风控
+    {!--< /tips >!--}
+    """
+
+    _platform = "bilibili"
+    ConfigClass = None
+    AccountConfigClass = BilibiliAccountConfig
+
+    def __init__(self, sdk_ref=None):
+        super().__init__(sdk_ref)
+        _check_framework_version()
+        self._runtimes: Dict[str, _AccountRuntime] = {}
+        self._sessions: Dict[str, Any] = {}
+        self._credentials: Dict[str, Credential] = {}
+        self._account_tasks: Dict[str, asyncio.Task] = {}
+
+    def _get_config_key(self) -> str:
+        return "BilibiliAdapter"
+
+    def _build_credential(self, account) -> Optional[Credential]:
+        if account.login_mode == "cookie":
+            if not (account.sessdata and account.bili_jct):
+                return None
+            return Credential(
+                sessdata=account.sessdata,
+                bili_jct=account.bili_jct,
+                buvid3=account.buvid3 or None,
+                dedeuserid=account.dedeuserid or None,
+            )
+        # qrcode 模式：凭据由扫码流程写入配置（sessdata 等字段），同样按 cookie 构建
+        if account.sessdata and account.bili_jct:
+            return Credential(
+                sessdata=account.sessdata,
+                bili_jct=account.bili_jct,
+                buvid3=account.buvid3 or None,
+                dedeuserid=account.dedeuserid or None,
+            )
+        return None
+
+    async def _detect_bot_id(self, credential: Credential) -> str:
+        info = await bili_session.get_self_info(credential)
+        return str((info or {}).get("mid", ""))
+
+    # ==================== 生命周期 ====================
+
+    async def start(self):
+        for name, account in self.enabled_accounts.items():
+            credential = self._build_credential(account)
+            if credential is None:
+                self.logger.warning(
+                    f"账户 {name} 缺少登录凭据（cookie 模式需 sessdata+bili_jct；"
+                    "qrcode 模式请在面板扫码登录）"
+                )
+                continue
+
+            bot_id = account.bot_id or await self._detect_bot_id(credential)
+            self._credentials[name] = credential
+
+            rt = self._runtimes.get(name)
+            if rt is None:
+                rt = _AccountRuntime(name, account, bot_id, credential)
+                self._runtimes[name] = rt
+            rt.config = account
+            rt.bot_id = bot_id
+            rt.credential = credential
+
+            task = asyncio.create_task(self._run_account(rt))
+            self._account_tasks[name] = task
+
+            await self.emit_meta("connect", bot_id, user_name=rt.user_name)
+
+        self.logger.info(
+            f"Bilibili 适配器已启动，共 {len(self._account_tasks)} 个账户"
+        )
+        self._setup_dashboard_section()
+
+    async def _run_account(self, rt: "_AccountRuntime"):
+        """事件驱动接收：Session(credential) + on(TEXT/PICTURE/WITHDRAW) + run()"""
+        session = bili_session.Session(rt.credential)
+        self._sessions[rt.name] = session
+
+        @session.on(bili_session.EventType.TEXT)
+        async def _on_text(event):
+            await self._emit_private_message(rt, event)
+
+        @session.on(bili_session.EventType.PICTURE)
+        async def _on_picture(event):
+            await self._emit_private_message(rt, event)
+
+        @session.on(bili_session.EventType.WITHDRAW)
+        async def _on_withdraw(event):
+            data = getattr(event, "data", {}) or {}
+            self.logger.debug(f"账户 {rt.name} 对方撤回了消息: {data}")
+
+        try:
+            await session.run(exclude_self=True)
+        except asyncio.CancelledError:
+            raise
+        except Exception as e:
+            self.logger.error(f"账户 {rt.name} 私信会话异常退出: {e}")
+
+    async def _emit_private_message(self, rt: "_AccountRuntime", event):
+        try:
+            data = getattr(event, "data", {}) or {}
+            sender_uid = str(data.get("sender_uid") or data.get("sender_id") or "")
+            if not sender_uid:
+                return
+            content = data.get("content") or {}
+            if isinstance(content, str):
+                try:
+                    content = json.loads(content)
+                except Exception:
+                    content = {"text": content}
+
+            raw_type = "text"
+            message_segments = []
+            alt_parts = []
+            if isinstance(content, dict):
+                txt = str(content.get("message") or content.get("content") or "")
+                if txt:
+                    message_segments.append({"type": "text", "data": {"text": txt}})
+                    alt_parts.append(txt)
+                for pic in content.get("pictures", []) or []:
+                    url = pic.get("url") or pic.get("image_url") or ""
+                    if url:
+                        message_segments.append({"type": "image", "data": {"file": url}})
+                        alt_parts.append("[图片]")
+                        raw_type = "picture"
+            if not message_segments:
+                return
+
+            self_info = {
+                "platform": "bilibili",
+                "user_id": rt.bot_id,
+                "user_name": rt.user_name,
+                "account_id": rt.name,
+            }
+            ev = {
+                "id": str(uuid.uuid4()),
+                "time": int(_time.time()),
+                "type": "message",
+                "detail_type": "private",
+                "platform": "bilibili",
+                "self": self_info,
+                "user_id": sender_uid,
+                "user_nickname": str(content.get("sender_name") or "") or None,
+                "message": message_segments,
+                "alt_message": " ".join(alt_parts),
+                "bilibili_raw": data,
+                "bilibili_raw_type": raw_type,
+            }
+            if ev["user_nickname"] is None:
+                ev.pop("user_nickname")
+            await self.emit_event(ev)
+        except Exception as e:
+            self.logger.error(f"处理 B 站私信事件失败: {e}")
+
+    async def call_api(self, endpoint: str, _account_id: Optional[str] = None, **params):
+        """API 动作统一入口（send_message / get_self_info 等）"""
+        rt = self._runtimes.get(_account_id) if _account_id else next(iter(self._runtimes.values()), None)
+        if rt is None:
+            return self.make_error(retcode=10003, message="账户不存在或未启动")
+        if endpoint == "send_message":
+            target_id = str(params.get("target_id") or "")
+            if not target_id:
+                return self.make_error(retcode=10003, message="缺少 target_id")
+            message = params.get("message") or []
+            texts = [str(seg.get("data", {}).get("text", "")) for seg in message if seg.get("type") == "text"]
+            pictures = [seg.get("data", {}).get("file") for seg in message if seg.get("type") == "image"]
+            result = None
+            if texts:
+                result = await self._send_text(rt, target_id, "".join(texts))
+            for pic in pictures:
+                if pic:
+                    result = await self._send_picture(rt, target_id, pic)
+            return result or self.make_error(retcode=10002, message="空消息")
+        if endpoint == "get_self_info":
+            info = await bili_session.get_self_info(rt.credential)
+            return self.make_response(data=info, raw=info)
+        return self.make_error(retcode=10002, message=f"不支持的动作: {endpoint}")
+
+    async def shutdown(self):
+        for session in self._sessions.values():
+            try:
+                await session.close()
+            except Exception:
+                pass
+        self._sessions.clear()
+        for task in self._account_tasks.values():
+            task.cancel()
+        if self._account_tasks:
+            await asyncio.gather(*self._account_tasks.values(), return_exceptions=True)
+        self._account_tasks.clear()
+        for rt in self._runtimes.values():
+            if rt.bot_id:
+                try:
+                    await self.emit_meta("disconnect", rt.bot_id)
+                except Exception:
+                    pass
+        try:
+            sdk.Dashboard.unregister_section("bilibili-qr")
+        except Exception:
+            pass
+        self.logger.info("Bilibili 适配器已关闭")
+
+    # ==================== 发送 ====================
+
+    async def _send_text(self, rt: "_AccountRuntime", receiver_id: str, text: str) -> dict:
+        result = await bili_session.send_msg(
+            rt.credential, int(receiver_id), bili_session.EventType.TEXT, text
+        )
+        code = (result or {}).get("code", -1)
+        if code != 0:
+            return self.make_error(
+                retcode=33100,
+                message=f"B 站接口返回 code={code}: {(result or {}).get('message', '')}",
+                raw=result,
+            )
+        msg_key = ((result or {}).get("data") or {}).get("msg_key", "")
+        return self.make_response(data=result, message_id=str(msg_key), raw=result)
+
+    async def _send_picture(self, rt: "_AccountRuntime", receiver_id: str, file_ref) -> dict:
+        from bilibili_api.utils.picture import Picture
+
+        pic = Picture(url=file_ref) if str(file_ref).startswith(("http://", "https://")) else Picture.from_file(str(file_ref))
+        result = await bili_session.send_msg(
+            rt.credential, int(receiver_id), bili_session.EventType.PICTURE, pic
+        )
+        code = (result or {}).get("code", -1)
+        if code != 0:
+            return self.make_error(retcode=33100, message=f"B 站接口返回 code={code}", raw=result)
+        msg_key = ((result or {}).get("data") or {}).get("msg_key", "")
+        return self.make_response(data=result, message_id=str(msg_key), raw=result)
+
+    # ==================== 发送 ====================
+
+    class Send(BaseAdapter.Send):
+        """Bilibili 消息发送（text / image；其余段报错说明）"""
+
+        def Raw_ob12(self, message, **kwargs):
+            ctx = self.send_context
+
+            async def _send():
+                adapter = self._adapter
+                rt = adapter._runtimes.get(ctx.get("account_id") or next(iter(adapter._runtimes)))
+                if rt is None:
+                    return adapter.make_error(retcode=10003, message="账户不存在或未启动")
+                target_id = ctx.get("target_id")
+                if not target_id:
+                    return adapter.make_error(retcode=10003, message="无法确定发送目标（需要 To('user', <uid>)）")
+
+                texts, pictures, unsupported = [], [], []
+                for seg in self._apply_modifiers(message):
+                    stype = seg.get("type")
+                    data = seg.get("data", {}) or {}
+                    if stype == "text":
+                        texts.append(str(data.get("text", "")))
+                    elif stype == "image":
+                        pictures.append(data.get("file"))
+                    elif stype == "reply":
+                        continue
+                    else:
+                        unsupported.append(stype)
+
+                result = None
+                if texts:
+                    result = await adapter._send_text(rt, target_id, "".join(texts))
+                for pic in pictures:
+                    result = await adapter._send_picture(rt, target_id, pic)
+                if not texts and not pictures:
+                    return adapter.make_error(
+                        retcode=10002,
+                        message="B 站私信仅支持 text/image 段"
+                        + (f"，收到不支持段: {unsupported}" if unsupported else "，且消息为空"),
+                    )
+                return result
+
+            return asyncio.create_task(_send())
+
+    # ==================== Api ====================
+
+    class Api(BaseAdapter.Api):
+        """Bilibili 标准 API 动作"""
+
+        async def get_self_info(self) -> dict:
+            rt = self._adapter._current_runtime()
+            info = await bili_session.get_self_info(rt.credential)
+            data = info or {}
+            return self._adapter.make_response(
+                data={
+                    "user_id": str(data.get("mid", "")),
+                    "user_name": data.get("name", ""),
+                    "avatar": data.get("face", ""),
+                },
+                raw=info,
+            )
+
+        async def get_status(self) -> dict:
+            return self._adapter.make_response(data={"status": "ok"})
+
+        async def get_version(self) -> dict:
+            from . import __version__
+
+            return self._adapter.make_response(data={"version": __version__})
+
+        async def get_supported_actions(self) -> dict:
+            return self._adapter.make_response(
+                data={
+                    "actions": [
+                        "get_self_info", "get_status", "get_version",
+                        "get_supported_actions", "send_message",
+                        "get_user_info", "get_session_msgs",
+                    ]
+                }
+            )
+
+        async def get_user_info(self, user_id: str) -> dict:
+            """获取用户公开信息（昵称/头像）"""
+            from bilibili_api import user as bili_user
+
+            rt = self._adapter._current_runtime()
+            u = bili_user.User(int(user_id), credential=rt.credential)
+            info = await u.get_info()
+            data = info or {}
+            return self._adapter.make_response(
+                data={
+                    "user_id": str(data.get("mid", user_id)),
+                    "user_name": data.get("name", ""),
+                    "avatar": data.get("face", ""),
+                },
+                raw=info,
+            )
+
+        async def get_session_msgs(self, talker_id: str, begin_seqno: int = 0) -> dict:
+            """拉取指定会话的历史消息"""
+            rt = self._adapter._current_runtime()
+            result = await bili_session.fetch_session_msgs(
+                int(talker_id), rt.credential, begin_seqno=begin_seqno
+            )
+            return self._adapter.make_response(data=result, raw=result)
+
+    def _current_runtime(self):
+        name = getattr(self, "_api_account_id", None)
+        if name and name in self._runtimes:
+            return self._runtimes[name]
+        return next(iter(self._runtimes.values()))
+
+    # ==================== 扫码登录（面板扩展区） ====================
+
+    def _setup_dashboard_section(self):
+        def _register():
+            try:
+                dashboard = sdk.Dashboard
+            except Exception:
+                return False
+            try:
+                dashboard.register_section(
+                    id="bilibili-qr",
+                    target="account_wizard",
+                    title="扫码登录 B 站",
+                    title_en="Scan QR to log in",
+                    icon_svg='<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="7" height="7" rx="1"/><rect x="14" y="3" width="7" height="7" rx="1"/><rect x="3" y="14" width="7" height="7" rx="1"/><path d="M14 14h3v3h-3zM21 14v.01M14 21v.01M17.5 17.5L21 21"/></svg>',
+                    platforms=["bilibili"],
+                    html=self._qr_section_html(),
+                    order=10,
+                )
+                self.logger.info("已注册面板扫码登录扩展区")
+                return True
+            except Exception as e:
+                self.logger.debug(f"面板扩展区注册失败: {e}")
+                return False
+
+        if _register():
+            return
+
+        async def _on_module_load(data):
+            if (
+                isinstance(data, dict)
+                and data.get("module_name") == "Dashboard"
+                and data.get("success")
+            ):
+                _register()
+                sdk.lifecycle.unregister("module.load", _on_module_load)
+
+        try:
+            sdk.lifecycle.register("module.load", _on_module_load)
+        except Exception:
+            pass
+
+    def _ensure_qr_routes(self):
+        """扫码端点注册（幂等）"""
+        if getattr(self, "_qr_routes_ready", False):
+            return
+        from ErisPulse.Core import router
+
+        self._qr_sessions: Dict[str, Any] = {}
+
+        async def _qr_start(request):
+            from fastapi.responses import JSONResponse
+
+            qrl = login_v2.QrCodeLogin(login_v2.QrCodeLoginChannel.WEB)
+            await qrl.generate_qrcode()
+            pic = qrl.get_qrcode_picture()
+            import secrets as _secrets
+
+            poll_token = _secrets.token_urlsafe(24)
+            task_id = uuid.uuid4().hex
+            self._qr_sessions[task_id] = {"qrl": qrl, "token": poll_token}
+            return JSONResponse(
+                {
+                    "success": True,
+                    "task_id": task_id,
+                    "poll_token": poll_token,
+                    "qr_url": pic.url or "",
+                }
+            )
+
+        async def _qr_poll(request):
+            from fastapi.responses import JSONResponse
+
+            body = {}
+            try:
+                body = await request.json()
+            except Exception:
+                pass
+            task_id = str(body.get("task_id") or "")
+            token = str(body.get("poll_token") or "")
+            entry = self._qr_sessions.get(task_id)
+            if not entry or entry["token"] != token:
+                return JSONResponse({"success": False, "error": "unauthorized"}, status_code=403)
+            qrl = entry["qrl"]
+            try:
+                state = await qrl.check_state()
+            except Exception as e:
+                return JSONResponse({"success": False, "error": str(e)}, status_code=500)
+            out = {"success": True, "status": str(state.value) if hasattr(state, "value") else str(state)}
+            if state == login_v2.QrCodeLoginEvents.DONE:
+                cred = await qrl.get_credential()
+                from ErisPulse.Core import config as _cfg
+
+                key = "BilibiliAdapter.accounts"
+                data = _cfg.getConfig(key) or {}
+                if not isinstance(data, dict):
+                    data = {}
+                dft = data.get("default")
+                if isinstance(dft, dict) and not dft.get("sessdata"):
+                    name = "default"
+                else:
+                    base, i, name = "qr", 1, "qr"
+                    while name in data and data[name].get("sessdata"):
+                        i += 1
+                        name = f"{base}{i}"
+                data[name] = {
+                    "login_mode": "qrcode",
+                    "sessdata": cred.sessdata or "",
+                    "bili_jct": cred.bili_jct or "",
+                    "buvid3": cred.buvid3 or "",
+                    "dedeuserid": cred.dedeuserid or "",
+                    "bot_id": cred.dedeuserid or "",
+                    "enabled": True,
+                }
+                _cfg.setConfig(key, data)
+                self._qr_sessions.pop(task_id, None)
+                out["account"] = name
+                self.logger.info(f"扫码登录完成，凭据已写入账户 {name}")
+            elif state == login_v2.QrCodeLoginEvents.TIMEOUT:
+                self._qr_sessions.pop(task_id, None)
+            return JSONResponse(out)
+
+        router.register_http_route("bilibili", "/qr/start", _qr_start, methods=["POST"])
+        router.register_http_route("bilibili", "/qr/poll", _qr_poll, methods=["POST"])
+        self._qr_routes_ready = True
+        self.logger.debug("扫码登录端点已注册 (/bilibili/qr/*)")
+
+    @staticmethod
+    def _qr_section_html() -> str:
+        return '''<!DOCTYPE html>
+<html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<style>
+:root{color-scheme:light dark}
+body{margin:0;padding:18px;font-family:system-ui,-apple-system,"Segoe UI",sans-serif;background:transparent;color:inherit;display:flex;flex-direction:column;align-items:center;gap:12px}
+#qr{border-radius:12px;overflow:hidden;box-shadow:0 0 0 1px rgba(128,128,128,.25);background:#fff;padding:8px;min-width:200px;min-height:200px;display:flex;align-items:center;justify-content:center}
+#qr img{width:200px;height:200px;image-rendering:pixelated}
+.st{font-size:13px;opacity:.75;text-align:center}
+.ok{color:#16a34a;font-weight:600}
+button{padding:8px 18px;border-radius:10px;border:1px solid rgba(128,128,128,.4);background:transparent;cursor:pointer;font-size:13px}
+</style></head><body>
+<div id="qr">…</div>
+<div class="st" id="st">正在获取二维码…</div>
+<button id="re" style="display:none" onclick="location.reload()">重新获取</button>
+<script>
+(async function(){
+  try{
+    var r = await fetch("/bilibili/qr/start", {method:"POST"});
+    var d = await r.json();
+    if(!d.success) throw new Error(d.error || "start failed");
+    document.getElementById("qr").innerHTML = '<img src="' + d.qr_url + '" alt="QR">';
+    document.getElementById("st").textContent = "请使用 B 站 APP 扫码并确认登录";
+    var taskId = d.task_id, token = d.poll_token, n = 0;
+    var timer = setInterval(async function(){
+      n++;
+      if(n > 90){ clearInterval(timer); document.getElementById("st").textContent="二维码已过期"; document.getElementById("re").style.display=""; return; }
+      try{
+        var pr = await fetch("/bilibili/qr/poll", {method:"POST", headers:{"Content-Type":"application/json"}, body: JSON.stringify({task_id:taskId, poll_token:token})});
+        var pd = await pr.json();
+        if(pd.success && pd.status === "done"){
+          clearInterval(timer);
+          document.getElementById("st").className = "st ok";
+          document.getElementById("st").textContent = "登录成功，凭据已写入账户 " + (pd.account || "");
+          setTimeout(function(){ parent.postMessage({type:"ep_section_done", success:true}, "*"); }, 900);
+        } else if(pd.success && pd.status === "timeout"){
+          clearInterval(timer);
+          document.getElementById("st").textContent = "二维码已过期";
+          document.getElementById("re").style.display="";
+        } else if(pd.success && pd.status === "scan"){
+          document.getElementById("st").textContent = "已扫码，请在手机上确认";
+        }
+      }catch(e){}
+    }, 2000);
+  }catch(e){
+    document.getElementById("st").textContent = "获取二维码失败: " + e.message;
+    document.getElementById("re").style.display="";
+  }
+})();
+</script></body></html>'''
+
+
+class _AccountRuntime:
+    """单个账户运行时状态"""
+
+    __slots__ = ("name", "config", "bot_id", "credential", "user_name")
+
+    def __init__(self, name: str, config, bot_id: str, credential):
+        self.name = name
+        self.config = config
+        self.bot_id = bot_id
+        self.credential = credential
+        self.user_name = ""

erispulse_bilibiliadapter-0.1.0/BilibiliAdapter/__init__.py

@@ -0,0 +1,3 @@
+from .Core import BilibiliAdapter, __version__
+
+__all__ = ["BilibiliAdapter", "__version__"]

erispulse_bilibiliadapter-0.1.0/ErisPulse_BilibiliAdapter.egg-info/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: ErisPulse-BilibiliAdapter
+Version: 0.1.0
+Summary: ErisPulse Bilibili 私信适配器 — Cookie/扫码双登录、事件驱动收发、多账户
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ErisPulse>=2.7.1
+Requires-Dist: bilibili-api-python>=16.3.0
+Dynamic: license-file
+
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/ErisPulseLogo.png" width="180" alt="ErisPulse-BilibiliAdapter" />
+
+# ErisPulse-BilibiliAdapter
+
+**ErisPulse Bilibili DM adapter — QR/Cookie login, event-driven DMs, multi-account**
+
+<p>
+  <a href="https://pypi.org/project/ErisPulse-BilibiliAdapter/"><img src="https://img.shields.io/pypi/v/ErisPulse-BilibiliAdapter?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ErisPulse-BilibiliAdapter/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse-BilibiliAdapter/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <img src="https://raw.githubusercontent.com/ErisPulse/.github/main/assets/badges/adapter.svg" alt="ErisPulse">
+</p>
+
+</div>
+
+---
+
+## Introduction
+
+BilibiliAdapter is a Bilibili direct-message adapter built on [bilibili-api-python](https://github.com/Passkou/bilibili-api), providing event-driven DM send/receive.
+
+**Highlights:**
+- **Dual login**: Dashboard QR-code login (credentials written to config automatically) / manual Cookie credentials
+- **Event-driven DMs**: text / picture messages received in real time as standard OneBot12 events
+- **Picture in/out**: inbound as image segment (URL); outbound supports URL / local path
+- **Multi-account**: one Bilibili account per entry under `accounts`, independent session listeners
+- **Safe QR flow**: QR session tokens prevent unauthorized polling; credentials shown as passwords in the panel
+
+## Installation
+
+```bash
+epsdk install BilibiliAdapter
+```
+
+или:
+
+```bash
+pip install ErisPulse-BilibiliAdapter
+```
+
+## Configuration
+
+**Option 1: QR-code login (recommended)**
+
+```toml
+[BilibiliAdapter.accounts.default]
+login_mode = "qrcode"
+bot_id = ""                    # auto-detect
+enabled = true
+```
+
+> After saving, open **Dashboard → Component Config → Bilibili → Add account wizard**, choose "Scan QR to log in", scan with the Bilibili APP and credentials are written to config automatically.
+
+**Option 2: Cookie credentials**
+
+```toml
+[BilibiliAdapter.accounts.default]
+login_mode = "cookie"
+sessdata = "YOUR_SESSDATA"     # required
+bili_jct = "YOUR_BILI_JCT"     # required
+buvid3 = "YOUR_BUVID3"         # optional
+dedeuserid = "YOUR_UID"        # optional
+bot_id = ""                    # auto-detect
+enabled = true
+```
+
+> To get cookies: log in to Bilibili in your browser → F12 devtools → Application → Cookies → copy the fields.
+
+**Configuration notes (per account):**
+- `login_mode`: `cookie` (manual credentials) or `qrcode` (panel scan, recommended)
+- `sessdata` / `bili_jct`: login cookies (required for cookie mode, shown as passwords)
+- `buvid3`: device fingerprint cookie (optional, reduces risk-control probability)
+- `dedeuserid`: account UID (optional, default source for bot_id)
+- `bot_id`: account UID (auto-detected after login when empty)
+
+## Messaging examples
+
+```python
+from ErisPulse import sdk
+bili = sdk.adapter.get("bilibili")
+
+# Send a text DM (target is the peer UID)
+await bili.Send.To("user", "123456789").Text("Hello Bilibili!")
+
+# Send a picture (URL or local path)
+await bili.Send.To("user", "123456789").Image("https://example.com/pic.jpg")
+
+# Reply (chained modifier)
+await bili.Send.To("user", "123456789").Reply("msg_key").Text("Got it!")
+
+# Multi-account
+await bili.Send.Using("account2").To("user", "123456789").Text("From the second account")
+
+# OneBot12 standard segments
+message = [
+    {"type": "text", "data": {"text": "line one"}},
+    {"type": "image", "data": {"file": "https://example.com/img.jpg"}},
+]
+await bili.Send.To("user", "123456789").Raw_ob12(message)
+```
+
+## Standard Api actions
+
+```python
+# Self info
+result = await bili.Api.get_self_info()           # {user_id, user_name, avatar}
+
+# Public user info (nickname / avatar)
+result = await bili.Api.get_user_info("123456789")
+
+# Fetch history messages of a session
+result = await bili.Api.get_session_msgs("123456789", begin_seqno=0)
+
+# Status & version
+result = await bili.Api.get_status()
+result = await bili.Api.get_version()
+
+# Multi-account
+result = await bili.Api.Using("account2").get_self_info()
+```
+
+## Event listening examples
+
+### Using the Event module (recommended)
+
+```python
+@sdk.adapter.on_message()
+async def on_message(event):
+    if event["platform"] == "bilibili":
+        sender = event["user_id"]             # peer UID
+        text = event["alt_message"]           # plain text content
+        await event.reply("Got it!")          # quick reply
+```
+
+### Using platform raw events
+
+```python
+@sdk.adapter.on("message")
+async def handle_message(event):
+    if event["platform"] == "bilibili":
+        raw = event["bilibili_raw"]           # raw Bilibili DM payload
+        print(f"DM from: {raw.get('sender_uid')}")
+```
+
+## Platform event mapping
+
+| Bilibili DM event | Adapter event |
+|-------------------|---------------|
+| TEXT (text message) | message (text segment) |
+| PICTURE (picture message) | message (image segment) |
+| WITHDRAW (recall) | logged only |
+
+## Important notes:
+1. **Bilibili has no official personal Bot API** — this adapter uses the web DM interface via simulated login (unofficial)
+2. **Throttle your sends**: high-frequency / bulk DMs easily trigger risk control (DM功能 temporary ban); add rate limiting on the module side
+3. Do not use for harassment or bulk marketing; follow Bilibili community rules
+4. Cookies equal full account access — keep them safe; credential fields are masked in the panel
+5. Only direct chats are supported; fan-group chats are not
+6. Inbound pictures become image segments (URL); outbound pictures accept URL / local path
+7. When the login state expires (cookies stale) the adapter logs errors — re-scan or update cookies
+
+---
+
+### Reference links
+- [ErisPulse main repository](https://github.com/ErisPulse/ErisPulse/)
+- [bilibili-api-python](https://github.com/Passkou/bilibili-api)
+- [bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
+- [Module development guide](https://www.erisdev.com/#docs/developer-guide/README.md)

erispulse_bilibiliadapter-0.1.0/ErisPulse_BilibiliAdapter.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+BilibiliAdapter/Core.py
+BilibiliAdapter/__init__.py
+ErisPulse_BilibiliAdapter.egg-info/PKG-INFO
+ErisPulse_BilibiliAdapter.egg-info/SOURCES.txt
+ErisPulse_BilibiliAdapter.egg-info/dependency_links.txt
+ErisPulse_BilibiliAdapter.egg-info/entry_points.txt
+ErisPulse_BilibiliAdapter.egg-info/requires.txt
+ErisPulse_BilibiliAdapter.egg-info/top_level.txt

erispulse_bilibiliadapter-0.1.0/ErisPulse_BilibiliAdapter.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

erispulse_bilibiliadapter-0.1.0/ErisPulse_BilibiliAdapter.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[erispulse.adapter]
+bilibili = BilibiliAdapter:BilibiliAdapter

erispulse_bilibiliadapter-0.1.0/ErisPulse_BilibiliAdapter.egg-info/requires.txt

@@ -0,0 +1,2 @@
+ErisPulse>=2.7.1
+bilibili-api-python>=16.3.0

erispulse_bilibiliadapter-0.1.0/ErisPulse_BilibiliAdapter.egg-info/top_level.txt

@@ -0,0 +1 @@
+BilibiliAdapter

erispulse_bilibiliadapter-0.1.0/LICENSE

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

erispulse_bilibiliadapter-0.1.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: ErisPulse-BilibiliAdapter
+Version: 0.1.0
+Summary: ErisPulse Bilibili 私信适配器 — Cookie/扫码双登录、事件驱动收发、多账户
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ErisPulse>=2.7.1
+Requires-Dist: bilibili-api-python>=16.3.0
+Dynamic: license-file
+
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/ErisPulseLogo.png" width="180" alt="ErisPulse-BilibiliAdapter" />
+
+# ErisPulse-BilibiliAdapter
+
+**ErisPulse Bilibili DM adapter — QR/Cookie login, event-driven DMs, multi-account**
+
+<p>
+  <a href="https://pypi.org/project/ErisPulse-BilibiliAdapter/"><img src="https://img.shields.io/pypi/v/ErisPulse-BilibiliAdapter?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ErisPulse-BilibiliAdapter/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse-BilibiliAdapter/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <img src="https://raw.githubusercontent.com/ErisPulse/.github/main/assets/badges/adapter.svg" alt="ErisPulse">
+</p>
+
+</div>
+
+---
+
+## Introduction
+
+BilibiliAdapter is a Bilibili direct-message adapter built on [bilibili-api-python](https://github.com/Passkou/bilibili-api), providing event-driven DM send/receive.
+
+**Highlights:**
+- **Dual login**: Dashboard QR-code login (credentials written to config automatically) / manual Cookie credentials
+- **Event-driven DMs**: text / picture messages received in real time as standard OneBot12 events
+- **Picture in/out**: inbound as image segment (URL); outbound supports URL / local path
+- **Multi-account**: one Bilibili account per entry under `accounts`, independent session listeners
+- **Safe QR flow**: QR session tokens prevent unauthorized polling; credentials shown as passwords in the panel
+
+## Installation
+
+```bash
+epsdk install BilibiliAdapter
+```
+
+или:
+
+```bash
+pip install ErisPulse-BilibiliAdapter
+```
+
+## Configuration
+
+**Option 1: QR-code login (recommended)**
+
+```toml
+[BilibiliAdapter.accounts.default]
+login_mode = "qrcode"
+bot_id = ""                    # auto-detect
+enabled = true
+```
+
+> After saving, open **Dashboard → Component Config → Bilibili → Add account wizard**, choose "Scan QR to log in", scan with the Bilibili APP and credentials are written to config automatically.
+
+**Option 2: Cookie credentials**
+
+```toml
+[BilibiliAdapter.accounts.default]
+login_mode = "cookie"
+sessdata = "YOUR_SESSDATA"     # required
+bili_jct = "YOUR_BILI_JCT"     # required
+buvid3 = "YOUR_BUVID3"         # optional
+dedeuserid = "YOUR_UID"        # optional
+bot_id = ""                    # auto-detect
+enabled = true
+```
+
+> To get cookies: log in to Bilibili in your browser → F12 devtools → Application → Cookies → copy the fields.
+
+**Configuration notes (per account):**
+- `login_mode`: `cookie` (manual credentials) or `qrcode` (panel scan, recommended)
+- `sessdata` / `bili_jct`: login cookies (required for cookie mode, shown as passwords)
+- `buvid3`: device fingerprint cookie (optional, reduces risk-control probability)
+- `dedeuserid`: account UID (optional, default source for bot_id)
+- `bot_id`: account UID (auto-detected after login when empty)
+
+## Messaging examples
+
+```python
+from ErisPulse import sdk
+bili = sdk.adapter.get("bilibili")
+
+# Send a text DM (target is the peer UID)
+await bili.Send.To("user", "123456789").Text("Hello Bilibili!")
+
+# Send a picture (URL or local path)
+await bili.Send.To("user", "123456789").Image("https://example.com/pic.jpg")
+
+# Reply (chained modifier)
+await bili.Send.To("user", "123456789").Reply("msg_key").Text("Got it!")
+
+# Multi-account
+await bili.Send.Using("account2").To("user", "123456789").Text("From the second account")
+
+# OneBot12 standard segments
+message = [
+    {"type": "text", "data": {"text": "line one"}},
+    {"type": "image", "data": {"file": "https://example.com/img.jpg"}},
+]
+await bili.Send.To("user", "123456789").Raw_ob12(message)
+```
+
+## Standard Api actions
+
+```python
+# Self info
+result = await bili.Api.get_self_info()           # {user_id, user_name, avatar}
+
+# Public user info (nickname / avatar)
+result = await bili.Api.get_user_info("123456789")
+
+# Fetch history messages of a session
+result = await bili.Api.get_session_msgs("123456789", begin_seqno=0)
+
+# Status & version
+result = await bili.Api.get_status()
+result = await bili.Api.get_version()
+
+# Multi-account
+result = await bili.Api.Using("account2").get_self_info()
+```
+
+## Event listening examples
+
+### Using the Event module (recommended)
+
+```python
+@sdk.adapter.on_message()
+async def on_message(event):
+    if event["platform"] == "bilibili":
+        sender = event["user_id"]             # peer UID
+        text = event["alt_message"]           # plain text content
+        await event.reply("Got it!")          # quick reply
+```
+
+### Using platform raw events
+
+```python
+@sdk.adapter.on("message")
+async def handle_message(event):
+    if event["platform"] == "bilibili":
+        raw = event["bilibili_raw"]           # raw Bilibili DM payload
+        print(f"DM from: {raw.get('sender_uid')}")
+```
+
+## Platform event mapping
+
+| Bilibili DM event | Adapter event |
+|-------------------|---------------|
+| TEXT (text message) | message (text segment) |
+| PICTURE (picture message) | message (image segment) |
+| WITHDRAW (recall) | logged only |
+
+## Important notes:
+1. **Bilibili has no official personal Bot API** — this adapter uses the web DM interface via simulated login (unofficial)
+2. **Throttle your sends**: high-frequency / bulk DMs easily trigger risk control (DM功能 temporary ban); add rate limiting on the module side
+3. Do not use for harassment or bulk marketing; follow Bilibili community rules
+4. Cookies equal full account access — keep them safe; credential fields are masked in the panel
+5. Only direct chats are supported; fan-group chats are not
+6. Inbound pictures become image segments (URL); outbound pictures accept URL / local path
+7. When the login state expires (cookies stale) the adapter logs errors — re-scan or update cookies
+
+---
+
+### Reference links
+- [ErisPulse main repository](https://github.com/ErisPulse/ErisPulse/)
+- [bilibili-api-python](https://github.com/Passkou/bilibili-api)
+- [bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
+- [Module development guide](https://www.erisdev.com/#docs/developer-guide/README.md)

erispulse_bilibiliadapter-0.1.0/README.md

@@ -0,0 +1,172 @@
+[English](README.en.md) | [简体中文](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/ErisPulseLogo.png" width="180" alt="ErisPulse-BilibiliAdapter" />
+
+# ErisPulse-BilibiliAdapter
+
+**ErisPulse Bilibili DM adapter — QR/Cookie login, event-driven DMs, multi-account**
+
+<p>
+  <a href="https://pypi.org/project/ErisPulse-BilibiliAdapter/"><img src="https://img.shields.io/pypi/v/ErisPulse-BilibiliAdapter?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ErisPulse-BilibiliAdapter/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse-BilibiliAdapter/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <img src="https://raw.githubusercontent.com/ErisPulse/.github/main/assets/badges/adapter.svg" alt="ErisPulse">
+</p>
+
+</div>
+
+---
+
+## Introduction
+
+BilibiliAdapter is a Bilibili direct-message adapter built on [bilibili-api-python](https://github.com/Passkou/bilibili-api), providing event-driven DM send/receive.
+
+**Highlights:**
+- **Dual login**: Dashboard QR-code login (credentials written to config automatically) / manual Cookie credentials
+- **Event-driven DMs**: text / picture messages received in real time as standard OneBot12 events
+- **Picture in/out**: inbound as image segment (URL); outbound supports URL / local path
+- **Multi-account**: one Bilibili account per entry under `accounts`, independent session listeners
+- **Safe QR flow**: QR session tokens prevent unauthorized polling; credentials shown as passwords in the panel
+
+## Installation
+
+```bash
+epsdk install BilibiliAdapter
+```
+
+или:
+
+```bash
+pip install ErisPulse-BilibiliAdapter
+```
+
+## Configuration
+
+**Option 1: QR-code login (recommended)**
+
+```toml
+[BilibiliAdapter.accounts.default]
+login_mode = "qrcode"
+bot_id = ""                    # auto-detect
+enabled = true
+```
+
+> After saving, open **Dashboard → Component Config → Bilibili → Add account wizard**, choose "Scan QR to log in", scan with the Bilibili APP and credentials are written to config automatically.
+
+**Option 2: Cookie credentials**
+
+```toml
+[BilibiliAdapter.accounts.default]
+login_mode = "cookie"
+sessdata = "YOUR_SESSDATA"     # required
+bili_jct = "YOUR_BILI_JCT"     # required
+buvid3 = "YOUR_BUVID3"         # optional
+dedeuserid = "YOUR_UID"        # optional
+bot_id = ""                    # auto-detect
+enabled = true
+```
+
+> To get cookies: log in to Bilibili in your browser → F12 devtools → Application → Cookies → copy the fields.
+
+**Configuration notes (per account):**
+- `login_mode`: `cookie` (manual credentials) or `qrcode` (panel scan, recommended)
+- `sessdata` / `bili_jct`: login cookies (required for cookie mode, shown as passwords)
+- `buvid3`: device fingerprint cookie (optional, reduces risk-control probability)
+- `dedeuserid`: account UID (optional, default source for bot_id)
+- `bot_id`: account UID (auto-detected after login when empty)
+
+## Messaging examples
+
+```python
+from ErisPulse import sdk
+bili = sdk.adapter.get("bilibili")
+
+# Send a text DM (target is the peer UID)
+await bili.Send.To("user", "123456789").Text("Hello Bilibili!")
+
+# Send a picture (URL or local path)
+await bili.Send.To("user", "123456789").Image("https://example.com/pic.jpg")
+
+# Reply (chained modifier)
+await bili.Send.To("user", "123456789").Reply("msg_key").Text("Got it!")
+
+# Multi-account
+await bili.Send.Using("account2").To("user", "123456789").Text("From the second account")
+
+# OneBot12 standard segments
+message = [
+    {"type": "text", "data": {"text": "line one"}},
+    {"type": "image", "data": {"file": "https://example.com/img.jpg"}},
+]
+await bili.Send.To("user", "123456789").Raw_ob12(message)
+```
+
+## Standard Api actions
+
+```python
+# Self info
+result = await bili.Api.get_self_info()           # {user_id, user_name, avatar}
+
+# Public user info (nickname / avatar)
+result = await bili.Api.get_user_info("123456789")
+
+# Fetch history messages of a session
+result = await bili.Api.get_session_msgs("123456789", begin_seqno=0)
+
+# Status & version
+result = await bili.Api.get_status()
+result = await bili.Api.get_version()
+
+# Multi-account
+result = await bili.Api.Using("account2").get_self_info()
+```
+
+## Event listening examples
+
+### Using the Event module (recommended)
+
+```python
+@sdk.adapter.on_message()
+async def on_message(event):
+    if event["platform"] == "bilibili":
+        sender = event["user_id"]             # peer UID
+        text = event["alt_message"]           # plain text content
+        await event.reply("Got it!")          # quick reply
+```
+
+### Using platform raw events
+
+```python
+@sdk.adapter.on("message")
+async def handle_message(event):
+    if event["platform"] == "bilibili":
+        raw = event["bilibili_raw"]           # raw Bilibili DM payload
+        print(f"DM from: {raw.get('sender_uid')}")
+```
+
+## Platform event mapping
+
+| Bilibili DM event | Adapter event |
+|-------------------|---------------|
+| TEXT (text message) | message (text segment) |
+| PICTURE (picture message) | message (image segment) |
+| WITHDRAW (recall) | logged only |
+
+## Important notes:
+1. **Bilibili has no official personal Bot API** — this adapter uses the web DM interface via simulated login (unofficial)
+2. **Throttle your sends**: high-frequency / bulk DMs easily trigger risk control (DM功能 temporary ban); add rate limiting on the module side
+3. Do not use for harassment or bulk marketing; follow Bilibili community rules
+4. Cookies equal full account access — keep them safe; credential fields are masked in the panel
+5. Only direct chats are supported; fan-group chats are not
+6. Inbound pictures become image segments (URL); outbound pictures accept URL / local path
+7. When the login state expires (cookies stale) the adapter logs errors — re-scan or update cookies
+
+---
+
+### Reference links
+- [ErisPulse main repository](https://github.com/ErisPulse/ErisPulse/)
+- [bilibili-api-python](https://github.com/Passkou/bilibili-api)
+- [bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
+- [Module development guide](https://www.erisdev.com/#docs/developer-guide/README.md)

erispulse_bilibiliadapter-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ErisPulse-BilibiliAdapter"
+version = "0.1.0"
+description = "ErisPulse Bilibili 私信适配器 — Cookie/扫码双登录、事件驱动收发、多账户"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "ErisPulse>=2.7.1",
+    "bilibili-api-python>=16.3.0",
+]
+
+[project.entry-points."erispulse.adapter"]
+bilibili = "BilibiliAdapter:BilibiliAdapter"
+
+[tool.setuptools.packages.find]
+include = ["BilibiliAdapter"]

erispulse_bilibiliadapter-0.1.0/setup.cfg

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