nonebot-plugin-botui 0.1.0__tar.gz → 0.1.1__tar.gz

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nonebot-plugin-botui
-Version: 0.1.0
+Version: 0.1.1
 Summary: 一个 QQ 风格的 WebUI 控制台：查看机器人收发的全部消息，并以机器人的身份发消息。
 Author: Lonely-Sails
 Requires-Dist: aiosqlite>=0.20.0,<1.0.0
@@ -215,6 +215,7 @@ LOCALSTORE_PLUGIN_DATA_DIR={"nonebot_plugin_botui": "/srv/botui/data"}
 - **多机器人**：每个机器人（`self_id`）的会话彼此独立 —— 会话 key 采用 `self_id:kind_id` 的形式内嵌机器人 ID，同名群在 A、B 两个机器人下就是两条不同的会话；每条消息都带上产生它的适配器名与 `self_id`。WebUI 的发送只会用**会话自己的机器人**，它不在线时返回 503 而不会改用别的机器人。
 - 只要适配器支持对应的能力就能用：私聊/群聊识别、消息段解析、以及通过 alconna 的 exporter 发送消息。召回（撤回）需要该适配器在 alconna 里实现了对应的 exporter，不支持时网页会提示「适配器 xxx 不支持撤回」。
 - `BOTUI_EXCLUDE_ADAPTERS` 可以按适配器名（如 `["OneBot V12"]`）排除某些平台的记录。
+- **QQ 表情**：官方 QQ 适配器的 `emoji` 段只给一个编号（`data.id`，即 QQNT 的 emojiId），网页按这个编号显示表情图并带上中文名（如 `67 → 心碎`、`179 → doge`），图缺失时退回「[中文名]」文字标签。表情图与名称表随插件分发在 `static/face/`（327 张 64×64 WebP，约 600 KB + 运行时惰性加载的 `names.json`），素材取自 [QFace](https://koishi.js.org/QFace/)（MIT），按 QQNT 索引同步，与旧 QZone 编号不通用。
 
 ## 🧪 开发 / 测试
 
@@ -229,3 +230,5 @@ uv run poe bump patch    # 版本号变更（bump-my-version）
 ## 📄 协议
 
 MIT © 2026 Lonely-Sails
+
+内置的 QQ 表情素材（`static/face/`）来自 [QFace](https://koishi.js.org/QFace/)，遵循其 MIT 协议；表情形象版权归腾讯所有，仅用于本地展示消息中的表情。

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/README.md

@@ -196,6 +196,7 @@ LOCALSTORE_PLUGIN_DATA_DIR={"nonebot_plugin_botui": "/srv/botui/data"}
 - **多机器人**：每个机器人（`self_id`）的会话彼此独立 —— 会话 key 采用 `self_id:kind_id` 的形式内嵌机器人 ID，同名群在 A、B 两个机器人下就是两条不同的会话；每条消息都带上产生它的适配器名与 `self_id`。WebUI 的发送只会用**会话自己的机器人**，它不在线时返回 503 而不会改用别的机器人。
 - 只要适配器支持对应的能力就能用：私聊/群聊识别、消息段解析、以及通过 alconna 的 exporter 发送消息。召回（撤回）需要该适配器在 alconna 里实现了对应的 exporter，不支持时网页会提示「适配器 xxx 不支持撤回」。
 - `BOTUI_EXCLUDE_ADAPTERS` 可以按适配器名（如 `["OneBot V12"]`）排除某些平台的记录。
+- **QQ 表情**：官方 QQ 适配器的 `emoji` 段只给一个编号（`data.id`，即 QQNT 的 emojiId），网页按这个编号显示表情图并带上中文名（如 `67 → 心碎`、`179 → doge`），图缺失时退回「[中文名]」文字标签。表情图与名称表随插件分发在 `static/face/`（327 张 64×64 WebP，约 600 KB + 运行时惰性加载的 `names.json`），素材取自 [QFace](https://koishi.js.org/QFace/)（MIT），按 QQNT 索引同步，与旧 QZone 编号不通用。
 
 ## 🧪 开发 / 测试
 
@@ -210,3 +211,5 @@ uv run poe bump patch    # 版本号变更（bump-my-version）
 ## 📄 协议
 
 MIT © 2026 Lonely-Sails
+
+内置的 QQ 表情素材（`static/face/`）来自 [QFace](https://koishi.js.org/QFace/)，遵循其 MIT 协议；表情形象版权归腾讯所有，仅用于本地展示消息中的表情。

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-botui"
-version = "0.1.0"
+version = "0.1.1"
 description = "一个 QQ 风格的 WebUI 控制台：查看机器人收发的全部消息，并以机器人的身份发消息。"
 readme = "README.md"
 requires-python = ">= 3.10, < 4.0"
@@ -48,7 +48,7 @@ requires = ["uv_build >= 0.9.0,<0.11.0"]
 build-backend = "uv_build"
 
 [tool.bumpversion]
-current_version = "0.1.0"
+current_version = "0.1.1"
 commit = true
 message = "release: bump version from {current_version} to {new_version}"
 tag = true

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-botui"
-version = "0.1.0"
+version = "0.1.1"
 description = "一个 QQ 风格的 WebUI 控制台：查看机器人收发的全部消息，并以机器人的身份发消息。"
 readme = "README.md"
 requires-python = ">= 3.10, < 4.0"
@@ -50,7 +50,7 @@ requires = ["uv_build >= 0.9.0,<0.11.0"]
 build-backend = "uv_build"
 
 [tool.bumpversion]
-current_version = "0.1.0"
+current_version = "0.1.1"
 commit = true
 message = "release: bump version from {current_version} to {new_version}"
 tag = true

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/src/nonebot_plugin_botui/api.py

@@ -41,7 +41,7 @@ if TYPE_CHECKING:
     from .webui import WebUIServer
     from .mediastore import MediaRecord
 
-VERSION = '0.1.0'
+VERSION = '0.1.1'
 
 # WebSocket 空闲心跳间隔（秒）：两层作用，一是挡掉反向代理的空闲断连，
 # 二是让服务端在下一次发送时发现已经断掉的连接。
@@ -1209,9 +1209,17 @@ async def post_recall(request: Request) -> dict[str, Any]:
 
 
 # ── 页面资源 ────────────────────────────────────────────────────────────
-@router.get('/static/{filename}')
+@router.get('/static/{filename:path}')
 async def get_static(filename: str) -> FileResponse:
-    if not filename or '/' in filename or '\\' in filename or filename.startswith('.'):
+    """静态资源。
+
+    允许子目录（表情图在 ``static/face/`` 下），但仍然只接受插件自己的
+    静态目录内的文件：``..``、绝对路径、``.`` 开头的隐藏文件一律拒绝。
+    """
+    parts = filename.replace('\\', '/').split('/')
+    if not parts or any(
+        part in ('', '.', '..') or part.startswith('.') for part in parts
+    ):
         raise HTTPException(status_code=400, detail='非法的资源名')
     path = (_static_dir / filename).resolve()
     if _static_dir.resolve() not in path.parents or not path.is_file():
@@ -1220,8 +1228,11 @@ async def get_static(filename: str) -> FileResponse:
         '.css': 'text/css; charset=utf-8',
         '.js': 'application/javascript; charset=utf-8',
         '.html': 'text/html; charset=utf-8',
+        '.json': 'application/json; charset=utf-8',
         '.svg': 'image/svg+xml',
         '.png': 'image/png',
+        '.webp': 'image/webp',
+        '.gif': 'image/gif',
         '.ico': 'image/x-icon',
     }.get(path.suffix.lower(), 'application/octet-stream')
     return FileResponse(path, media_type=media)

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/src/nonebot_plugin_botui/config.py

@@ -3,7 +3,8 @@
 from __future__ import annotations
 
 from nonebot import get_driver, get_plugin_config
-from pydantic import BaseModel, field_validator
+from pydantic import BaseModel
+from nonebot.compat import field_validator
 
 # 机器人发送消息时可能调用的 API 名称（用于区分“发出”的消息）
 SEND_APIS: frozenset[str] = frozenset(

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/src/nonebot_plugin_botui/segments.py

@@ -726,7 +726,9 @@ def _fallback_segments(message: Any) -> list[dict[str, Any]]:
                 )
             else:
                 out.append(_seg_media_dict(kind, url))
-        elif rtype == 'face':
+        elif rtype in ('face', 'emoji'):
+            # 官方 QQ 适配器把表情段叫作 emoji（data 里只有一个 id，就是小黄脸
+            # 编号）；OneBot V11 叫 face，两边用的是同一套编号，统一成 face。
             out.append(
                 {
                     'type': 'face',

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/src/nonebot_plugin_botui/static/app.css

@@ -735,6 +735,16 @@ html[data-theme="light"] .hit-text mark.hit { background: rgba(255, 200, 0, 0.42
 .msg.out .chip.seg-unknown { color: rgba(255, 255, 255, 0.72); }
 .chip.seg-reply::before { content: "↩"; font-size: 11px; opacity: 0.85; }
 .chip.seg-face::before { content: "☺"; font-size: 11px; opacity: 0.85; }
+/* QQ 小黄脸：内联小图，跟着文字基线走，不把气泡撑成图片块 */
+.seg-face-img {
+  width: 20px;
+  height: 20px;
+  margin: 0 1px;
+  vertical-align: -4px;
+  object-fit: contain;
+}
+/* 段里直接给的是 emoji 字符（非 QQ 编号）时原样显示 */
+.seg-emoji-char { font-size: 18px; line-height: 1; vertical-align: -2px; }
 .chip .chip-link { color: var(--accent); text-decoration: none; }
 .msg.out .chip .chip-link { color: #fff; text-decoration: underline; }
 .chip .chip-link:hover { text-decoration: underline; }

{nonebot_plugin_botui-0.1.0 → nonebot_plugin_botui-0.1.1}/src/nonebot_plugin_botui/static/app.js

@@ -1793,7 +1793,7 @@ function buildBubble(segments) {
         bubble.appendChild(buildImage(seg));
         return;
       case 'face':
-        bubble.appendChild(h('span', 'chip seg-face', '[表情 ' + (hasText(seg.id) ? seg.id : '?') + ']'));
+        bubble.appendChild(buildFace(seg));
         return;
       case 'reply': {
         bubble.appendChild(buildQuote(seg));
@@ -2212,6 +2212,108 @@ function externalLink(href, text) {
   return a;
 }
 
+/* ---------- QQ 表情 ----------
+ *
+ * 官方 QQ 适配器的 emoji 段只给一个编号（data.id），这个编号就是 QQNT 的
+ * emojiId。表情图与中文名随插件一起分发（static/face/），数据取自
+ * koishi.js.org/QFace（QQNT 索引，由 QQ 服务端定义同步而来），所以
+ * 「67 → 心碎」「179 → doge」这类映射是准的。
+ *
+ * 注意别再用旧的 QZone 表情地址（按 qzoneCode 拼出来的 gif 链接）：那套用的是
+ * QZone 编号（QFace 里的 qzoneCode），和适配器给的 emojiId 差了一整套映射，
+ * 直接拼会显示成完全不相干的表情。
+ */
+const FACE_DIR = ROOT_BASE + '/static/face/';
+const FACE_NAMES_URL = FACE_DIR + 'names.json';
+
+// id -> 中文名，从 names.json 惰性加载一次
+let faceNames = null;
+let faceNamesLoading = null;
+
+function loadFaceNames() {
+  if (faceNames) return Promise.resolve(faceNames);
+  if (faceNamesLoading) return faceNamesLoading;
+  faceNamesLoading = fetch(FACE_NAMES_URL, { cache: 'force-cache' })
+    .then((resp) => (resp.ok ? resp.json() : {}))
+    .then((data) => {
+      faceNames = data && typeof data === 'object' ? data : {};
+      return faceNames;
+    })
+    .catch(() => {
+      faceNames = {};
+      return faceNames;
+    });
+  return faceNamesLoading;
+}
+
+/** 表情的显示名（拿不到名称表时退回编号） */
+function faceLabel(seg) {
+  const id = hasText(seg && seg.id) ? String(seg.id).trim() : '';
+  // 适配器有时把编号塞进 name，那种 name 不是可读名
+  const raw = hasText(seg && seg.name) ? String(seg.name).trim() : '';
+  if (raw && !/^\d+$/.test(raw)) return raw;
+  if (id && faceNames && hasText(faceNames[id])) return String(faceNames[id]);
+  return id ? '表情 ' + id : '表情';
+}
+
+/**
+ * 表情图片地址。
+ *
+ * 优先用段里自带的 url（部分适配器直接把表情图放进来），其次就是本插件
+ * 随包分发的 static/face/<id>.webp。编号不像表情时返回空串。
+ */
+function faceImageUrl(seg) {
+  const own = safeUrl(seg && seg.url);
+  if (own) return own;
+  const id = hasText(seg && seg.id) ? String(seg.id).trim() : '';
+  if (!/^\d{1,4}$/.test(id)) return '';
+  return FACE_DIR + Number(id) + '.webp';
+}
+
+/**
+ * 表情段。
+ *
+ * 早先这里直接渲染成「[表情 67]」——官方适配器只给编号，界面上就只剩一串数字。
+ * 现在按编号显示本地表情图；图片缺失（新表情 / 老编号）或加载失败时，退回
+ * 「[中文名]」文字标签，至少能看出是哪个表情。
+ */
+function buildFace(seg) {
+  const id = hasText(seg && seg.id) ? String(seg.id).trim() : '';
+  const numeric = /^\d+$/.test(id);
+  const label = faceLabel(seg);
+  const textFallback = () => h('span', 'chip seg-face', '[' + label + ']');
+
+  // 编号本身就是字符（部分平台直接把 emoji 字符放进 id）时原样显示，
+  // 但段里若另外给了图片，仍以图片为准
+  if (id && !numeric && !safeUrl(seg.url)) return h('span', 'seg-emoji-char', id);
+
+  const url = faceImageUrl(seg);
+  if (!url) return textFallback();
+
+  const img = document.createElement('img');
+  img.className = 'seg-face-img';
+  img.loading = 'lazy';
+  img.decoding = 'async';
+  img.referrerPolicy = 'no-referrer';
+  img.alt = label;
+  img.title = label;
+  img.src = url;
+  img.addEventListener('error', () => {
+    if (!img.parentNode) return;
+    // 图没下载到就先看一眼名称表，拿到中文名再退化，比直接显示编号友好
+    const swap = () => {
+      if (!img.parentNode) return;
+      img.parentNode.replaceChild(
+        id && !numeric ? h('span', 'seg-emoji-char', id) : textFallback(),
+        img
+      );
+    };
+    if (faceNames) swap();
+    else loadFaceNames().then(swap);
+  });
+  return img;
+}
+
 function buildImage(seg) {
   const wrap = h('span', 'seg-block');
   const source = safeUrl(seg.url);