nonebot-plugin-receipts 0.2.2__tar.gz → 0.2.4__tar.gz

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot_plugin_receipts
-Version: 0.2.2
+Version: 0.2.4
 Summary: NoneBot2 plugin for sending text and image messages to receipts-spooler
 Project-URL: homepage, https://github.com/Effect-Wei/nonebot_plugin_receipts
 Project-URL: repository, https://github.com/Effect-Wei/nonebot_plugin_receipts
@@ -23,7 +23,7 @@ Requires-Dist: ruff; extra == "dev"
 
 ## 功能
 
-- 提供 `ticket`、`小票`、`receipt` 指令，三者互为别名
+- 提供 `ticket`、`receipt` 指令，二者互为别名
 - 支持命令后直接附带文本和图片
 - 如果命令后没有内容，会继续追问下一条消息
 - 将文本和图片合成为一张热敏小票图，再编码为 ESC/POS 栅格打印命令
@@ -62,6 +62,8 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 | `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`                   | 等待用户补发打印内容的超时时间（秒）  |
 | `RECEIPT_FEED_LINES`              | `4`                     | 打印后走纸行数                        |
 | `RECEIPT_ENABLE_CUT`              | `true`                  | 是否附加切纸命令                      |
+| `RECEIPT_ALLOWED_USER_IDS`        | 空                      | 允许提交打印任务的 QQ 号白名单        |
+| `RECEIPT_ALLOWED_GROUP_IDS`       | 空                      | 允许提交打印任务的 QQ 群号白名单      |
 
 ### 渲染模式
 
@@ -70,6 +72,28 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 
 `hybrid` 模式下，中文是否正常输出取决于打印机对中英文字符集的支持情况。
 
+### 白名单
+
+可以通过以下配置限制谁能提交打印任务：
+
+- `RECEIPT_ALLOWED_USER_IDS`：允许提交的 QQ 号白名单
+- `RECEIPT_ALLOWED_GROUP_IDS`：允许提交的 QQ 群号白名单
+
+两个配置都为空时，默认允许所有会话使用。  
+只要命中任意一个条件就会放行：
+
+- 发送者 QQ 号在 `RECEIPT_ALLOWED_USER_IDS` 中
+- 当前群号在 `RECEIPT_ALLOWED_GROUP_IDS` 中
+
+未命中白名单的消息会被直接忽略，不会回复任何提示。
+
+环境变量可以写成逗号分隔，例如：
+
+```env
+RECEIPT_ALLOWED_USER_IDS=123456,234567
+RECEIPT_ALLOWED_GROUP_IDS=345678,456789
+```
+
 ### 渲染模板
 
 如果你想单独调整小票布局，可以配置 `RECEIPT_TEMPLATE_PATH` 指向一个 JSON 文件。项目根目录里附带了一个示例文件 [`receipt_template.example.json`](receipt_template.example.json)。
@@ -113,18 +137,18 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 直接在命令后附带内容：
 
 ```text
-/小票 今晚睡大觉
+/ticket 今晚睡大觉
 ```
 
 或者：
 
-1. 发送 `/小票`
+1. 发送 `/ticket` 或 `/receipt`
 2. 按提示继续发送一条包含文本、图片或两者混合的消息
 
 插件会把纯文本和图片消息段一起打印，并在提交成功后回复当前队列长度。
 
 如果命令后没有直接附带内容，插件会提示用户继续发送，并明确说明多久后超时。  
-如果用户在该时间窗口后才继续回复，插件会提示“已超时”，并直接结束本次等待；此时需要重新发送 `/小票` 开始新的打印流程。
+如果用户在该时间窗口后才继续回复，插件会提示“已超时”，并直接结束本次等待；此时需要重新发送 `/ticket` 或 `/receipt` 开始新的打印流程。
 
 `RECEIPT_SESSION_TIMEOUT_SECONDS` 的实际生效时间不会超过 NoneBot 全局 `SESSION_EXPIRE_TIMEOUT`，建议两者保持一致或让前者更小。
 

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/README.md

@@ -6,7 +6,7 @@
 
 ## 功能
 
-- 提供 `ticket`、`小票`、`receipt` 指令，三者互为别名
+- 提供 `ticket`、`receipt` 指令，二者互为别名
 - 支持命令后直接附带文本和图片
 - 如果命令后没有内容，会继续追问下一条消息
 - 将文本和图片合成为一张热敏小票图，再编码为 ESC/POS 栅格打印命令
@@ -45,6 +45,8 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 | `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`                   | 等待用户补发打印内容的超时时间（秒）  |
 | `RECEIPT_FEED_LINES`              | `4`                     | 打印后走纸行数                        |
 | `RECEIPT_ENABLE_CUT`              | `true`                  | 是否附加切纸命令                      |
+| `RECEIPT_ALLOWED_USER_IDS`        | 空                      | 允许提交打印任务的 QQ 号白名单        |
+| `RECEIPT_ALLOWED_GROUP_IDS`       | 空                      | 允许提交打印任务的 QQ 群号白名单      |
 
 ### 渲染模式
 
@@ -53,6 +55,28 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 
 `hybrid` 模式下，中文是否正常输出取决于打印机对中英文字符集的支持情况。
 
+### 白名单
+
+可以通过以下配置限制谁能提交打印任务：
+
+- `RECEIPT_ALLOWED_USER_IDS`：允许提交的 QQ 号白名单
+- `RECEIPT_ALLOWED_GROUP_IDS`：允许提交的 QQ 群号白名单
+
+两个配置都为空时，默认允许所有会话使用。  
+只要命中任意一个条件就会放行：
+
+- 发送者 QQ 号在 `RECEIPT_ALLOWED_USER_IDS` 中
+- 当前群号在 `RECEIPT_ALLOWED_GROUP_IDS` 中
+
+未命中白名单的消息会被直接忽略，不会回复任何提示。
+
+环境变量可以写成逗号分隔，例如：
+
+```env
+RECEIPT_ALLOWED_USER_IDS=123456,234567
+RECEIPT_ALLOWED_GROUP_IDS=345678,456789
+```
+
 ### 渲染模板
 
 如果你想单独调整小票布局，可以配置 `RECEIPT_TEMPLATE_PATH` 指向一个 JSON 文件。项目根目录里附带了一个示例文件 [`receipt_template.example.json`](receipt_template.example.json)。
@@ -96,18 +120,18 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 直接在命令后附带内容：
 
 ```text
-/小票 今晚睡大觉
+/ticket 今晚睡大觉
 ```
 
 或者：
 
-1. 发送 `/小票`
+1. 发送 `/ticket` 或 `/receipt`
 2. 按提示继续发送一条包含文本、图片或两者混合的消息
 
 插件会把纯文本和图片消息段一起打印，并在提交成功后回复当前队列长度。
 
 如果命令后没有直接附带内容，插件会提示用户继续发送，并明确说明多久后超时。  
-如果用户在该时间窗口后才继续回复，插件会提示“已超时”，并直接结束本次等待；此时需要重新发送 `/小票` 开始新的打印流程。
+如果用户在该时间窗口后才继续回复，插件会提示“已超时”，并直接结束本次等待；此时需要重新发送 `/ticket` 或 `/receipt` 开始新的打印流程。
 
 `RECEIPT_SESSION_TIMEOUT_SECONDS` 的实际生效时间不会超过 NoneBot 全局 `SESSION_EXPIRE_TIMEOUT`，建议两者保持一致或让前者更小。
 

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/nonebot_plugin_receipts/__init__.py

@@ -8,7 +8,8 @@ __plugin_meta__ = PluginMetadata(
     name="小票打印",
     description="将发送给 Bot 的文本和图片消息通过 receipts-spooler 打印",
     usage=(
-        "发送 /小票 后附带文本/图片，或单独发送命令后按提示再发送一条要打印的消息。"
+        "发送 /ticket 或 /receipt 后附带文本/图片，"
+        "或单独发送命令后按提示再发送一条要打印的消息。"
     ),
     type="application",
     config=Config,
@@ -19,7 +20,7 @@ __plugin_meta__ = PluginMetadata(
 try:
     ReceiptPrint = on_command(
         "ticket",
-        aliases={"小票", "ticket", "receipt"},
+        aliases={"ticket", "receipt"},
         block=True,
         priority=10,
     )

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/nonebot_plugin_receipts/command_handlers.py

@@ -4,6 +4,7 @@ from time import monotonic
 
 from nonebot import get_driver, get_plugin_config
 from nonebot.adapters.onebot.v11 import Message, MessageEvent  # noqa: TC002
+from nonebot.exception import FinishedException
 from nonebot.matcher import Matcher  # noqa: TC002
 from nonebot.params import Arg, CommandArg
 
@@ -20,8 +21,11 @@ def register_receipt_handlers(receipt_print: type[Matcher]) -> None:
 
     @receipt_print.handle()
     async def handle_print_command(
-        matcher: Matcher, message: Message = CommandArg()
+        matcher: Matcher, event: MessageEvent, message: Message = CommandArg()
     ) -> None:
+        if not is_receipt_submission_allowed(event):
+            raise FinishedException
+
         if has_printable_content(message):
             matcher.set_arg("receipt_content", message)
             return
@@ -38,6 +42,9 @@ def register_receipt_handlers(receipt_print: type[Matcher]) -> None:
         event: MessageEvent,
         receipt_content: Message = Arg("receipt_content"),
     ) -> None:
+        if not is_receipt_submission_allowed(event):
+            raise FinishedException
+
         timeout_seconds = get_effective_session_timeout_seconds()
         if is_receipt_timeout_expired(matcher):
             await receipt_print.finish(build_timeout_receipt_prompt(timeout_seconds))
@@ -102,6 +109,35 @@ def get_runtime_config() -> Config:
     return get_plugin_config(Config)
 
 
+def is_receipt_submission_allowed(event: MessageEvent) -> bool:
+    """Return whether the incoming event is allowed to submit a print job."""
+    config = get_runtime_config()
+    allowed_user_ids = set(config.allowed_user_ids)
+    allowed_group_ids = set(config.allowed_group_ids)
+
+    if not allowed_user_ids and not allowed_group_ids:
+        return True
+
+    user_id = get_event_user_id(event)
+    if user_id and user_id in allowed_user_ids:
+        return True
+
+    group_id = get_event_group_id(event)
+    return bool(group_id and group_id in allowed_group_ids)
+
+
+def get_event_user_id(event: MessageEvent) -> str:
+    """Extract the normalized sender QQ id from an event."""
+    user_id = getattr(event, "user_id", None)
+    return str(user_id).strip() if user_id is not None else ""
+
+
+def get_event_group_id(event: MessageEvent) -> str:
+    """Extract the normalized group QQ id from an event, if any."""
+    group_id = getattr(event, "group_id", None)
+    return str(group_id).strip() if group_id is not None else ""
+
+
 def get_effective_session_timeout_seconds() -> int:
     """Return the effective wait timeout bounded by NoneBot's session timeout."""
     plugin_timeout = get_runtime_config().receipt_session_timeout_seconds

nonebot_plugin_receipts-0.2.4/nonebot_plugin_receipts/config.py

@@ -0,0 +1,66 @@
+import json
+import re
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field, field_validator
+
+
+def normalize_whitelist_ids(value: Any) -> list[str]:
+    if value is None:
+        return []
+
+    if isinstance(value, str):
+        stripped = value.strip()
+        if not stripped:
+            return []
+
+        try:
+            value = json.loads(stripped)
+        except json.JSONDecodeError:
+            return [
+                item
+                for part in re.split(r"[\s,，]+", stripped)
+                if (item := part.strip())
+            ]
+
+    if isinstance(value, list | tuple | set | frozenset):
+        return [item for entry in value if (item := str(entry).strip())]
+
+    item = str(value).strip()
+    return [item] if item else []
+
+
+class Config(BaseModel):
+    receipts_spooler_url: str = "http://127.0.0.1:8000"
+    receipts_spooler_token: str | None = None
+    receipts_spooler_timeout: float = 5.0
+    receipt_image_fetch_timeout: float = 5.0
+    receipt_render_mode: Literal["raster", "hybrid"] = "raster"
+    receipt_printer_width: int = Field(default=576, ge=128, le=576)
+    receipt_template_path: str | None = None
+    receipt_font_path: str | None = None
+    receipt_font_size: int = Field(default=24, ge=12, le=96)
+    receipt_line_spacing: int = Field(default=6, ge=0, le=40)
+    receipt_section_gap: int = Field(default=6, ge=0, le=100)
+    receipt_session_timeout_seconds: int = Field(default=120, ge=10, le=3600)
+    receipt_feed_lines: int = Field(default=4, ge=0, le=10)
+    receipt_enable_cut: bool = True
+    receipt_allowed_user_ids: str | list[str] | None = Field(default_factory=list)
+    receipt_allowed_group_ids: str | list[str] | None = Field(default_factory=list)
+
+    @field_validator(
+        "receipt_allowed_user_ids",
+        "receipt_allowed_group_ids",
+        mode="before",
+    )
+    @classmethod
+    def normalize_whitelist_ids(cls, value: Any) -> list[str]:
+        return normalize_whitelist_ids(value)
+
+    @property
+    def allowed_user_ids(self) -> list[str]:
+        return normalize_whitelist_ids(self.receipt_allowed_user_ids)
+
+    @property
+    def allowed_group_ids(self) -> list[str]:
+        return normalize_whitelist_ids(self.receipt_allowed_group_ids)

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/nonebot_plugin_receipts.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot_plugin_receipts
-Version: 0.2.2
+Version: 0.2.4
 Summary: NoneBot2 plugin for sending text and image messages to receipts-spooler
 Project-URL: homepage, https://github.com/Effect-Wei/nonebot_plugin_receipts
 Project-URL: repository, https://github.com/Effect-Wei/nonebot_plugin_receipts
@@ -23,7 +23,7 @@ Requires-Dist: ruff; extra == "dev"
 
 ## 功能
 
-- 提供 `ticket`、`小票`、`receipt` 指令，三者互为别名
+- 提供 `ticket`、`receipt` 指令，二者互为别名
 - 支持命令后直接附带文本和图片
 - 如果命令后没有内容，会继续追问下一条消息
 - 将文本和图片合成为一张热敏小票图，再编码为 ESC/POS 栅格打印命令
@@ -62,6 +62,8 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 | `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`                   | 等待用户补发打印内容的超时时间（秒）  |
 | `RECEIPT_FEED_LINES`              | `4`                     | 打印后走纸行数                        |
 | `RECEIPT_ENABLE_CUT`              | `true`                  | 是否附加切纸命令                      |
+| `RECEIPT_ALLOWED_USER_IDS`        | 空                      | 允许提交打印任务的 QQ 号白名单        |
+| `RECEIPT_ALLOWED_GROUP_IDS`       | 空                      | 允许提交打印任务的 QQ 群号白名单      |
 
 ### 渲染模式
 
@@ -70,6 +72,28 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 
 `hybrid` 模式下，中文是否正常输出取决于打印机对中英文字符集的支持情况。
 
+### 白名单
+
+可以通过以下配置限制谁能提交打印任务：
+
+- `RECEIPT_ALLOWED_USER_IDS`：允许提交的 QQ 号白名单
+- `RECEIPT_ALLOWED_GROUP_IDS`：允许提交的 QQ 群号白名单
+
+两个配置都为空时，默认允许所有会话使用。  
+只要命中任意一个条件就会放行：
+
+- 发送者 QQ 号在 `RECEIPT_ALLOWED_USER_IDS` 中
+- 当前群号在 `RECEIPT_ALLOWED_GROUP_IDS` 中
+
+未命中白名单的消息会被直接忽略，不会回复任何提示。
+
+环境变量可以写成逗号分隔，例如：
+
+```env
+RECEIPT_ALLOWED_USER_IDS=123456,234567
+RECEIPT_ALLOWED_GROUP_IDS=345678,456789
+```
+
 ### 渲染模板
 
 如果你想单独调整小票布局，可以配置 `RECEIPT_TEMPLATE_PATH` 指向一个 JSON 文件。项目根目录里附带了一个示例文件 [`receipt_template.example.json`](receipt_template.example.json)。
@@ -113,18 +137,18 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 直接在命令后附带内容：
 
 ```text
-/小票 今晚睡大觉
+/ticket 今晚睡大觉
 ```
 
 或者：
 
-1. 发送 `/小票`
+1. 发送 `/ticket` 或 `/receipt`
 2. 按提示继续发送一条包含文本、图片或两者混合的消息
 
 插件会把纯文本和图片消息段一起打印，并在提交成功后回复当前队列长度。
 
 如果命令后没有直接附带内容，插件会提示用户继续发送，并明确说明多久后超时。  
-如果用户在该时间窗口后才继续回复，插件会提示“已超时”，并直接结束本次等待；此时需要重新发送 `/小票` 开始新的打印流程。
+如果用户在该时间窗口后才继续回复，插件会提示“已超时”，并直接结束本次等待；此时需要重新发送 `/ticket` 或 `/receipt` 开始新的打印流程。
 
 `RECEIPT_SESSION_TIMEOUT_SECONDS` 的实际生效时间不会超过 NoneBot 全局 `SESSION_EXPIRE_TIMEOUT`，建议两者保持一致或让前者更小。
 

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/nonebot_plugin_receipts.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ nonebot_plugin_receipts.egg-info/dependency_links.txt
 nonebot_plugin_receipts.egg-info/requires.txt
 nonebot_plugin_receipts.egg-info/top_level.txt
 tests/test_command_handlers.py
+tests/test_config.py
 tests/test_render_blocks.py
 tests/test_renderer.py
 tests/test_text_markup.py

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nonebot_plugin_receipts"
-version = "0.2.2"
+version = "0.2.4"
 description = "NoneBot2 plugin for sending text and image messages to receipts-spooler"
 readme = "README.md"
 requires-python = ">=3.12, <4.0"

{nonebot_plugin_receipts-0.2.2 → nonebot_plugin_receipts-0.2.4}/tests/test_command_handlers.py

@@ -5,12 +5,17 @@ from types import SimpleNamespace
 from typing import TYPE_CHECKING, Any, cast
 from unittest.mock import AsyncMock, patch
 
+from nonebot.exception import FinishedException
+
 from nonebot_plugin_receipts.command_handlers import (
     RECEIPT_TIMEOUT_DEADLINE_KEY,
     build_initial_receipt_prompt,
     build_timeout_receipt_prompt,
     format_timeout_duration,
     get_effective_session_timeout_seconds,
+    get_event_group_id,
+    get_event_user_id,
+    is_receipt_submission_allowed,
     is_receipt_timeout_expired,
     register_receipt_handlers,
     reset_receipt_timeout_deadline,
@@ -99,8 +104,23 @@ class DummyDriver:
 
 
 class DummyPluginConfig:
-    def __init__(self, seconds: int) -> None:
+    def __init__(
+        self,
+        seconds: int,
+        allowed_user_ids: list[str] | None = None,
+        allowed_group_ids: list[str] | None = None,
+    ) -> None:
         self.receipt_session_timeout_seconds = seconds
+        self.receipt_allowed_user_ids = allowed_user_ids or []
+        self.receipt_allowed_group_ids = allowed_group_ids or []
+
+    @property
+    def allowed_user_ids(self) -> list[str]:
+        return self.receipt_allowed_user_ids
+
+    @property
+    def allowed_group_ids(self) -> list[str]:
+        return self.receipt_allowed_group_ids
 
 
 class CommandHandlersTestCase(unittest.TestCase):
@@ -142,6 +162,54 @@ class CommandHandlersTestCase(unittest.TestCase):
         matcher.state[RECEIPT_TIMEOUT_DEADLINE_KEY] = 0
         self.assertTrue(is_receipt_timeout_expired(cast("Any", matcher)))
 
+    def test_get_event_ids(self) -> None:
+        private_event = SimpleNamespace(user_id=123456)
+        group_event = SimpleNamespace(user_id=123456, group_id=654321)
+
+        self.assertEqual(get_event_user_id(cast("Any", private_event)), "123456")
+        self.assertEqual(get_event_group_id(cast("Any", private_event)), "")
+        self.assertEqual(get_event_group_id(cast("Any", group_event)), "654321")
+
+    def test_submission_allowed_when_whitelist_empty(self) -> None:
+        event = SimpleNamespace(user_id=123456, group_id=654321)
+
+        with patch(
+            "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+            return_value=DummyPluginConfig(120),
+        ):
+            self.assertTrue(is_receipt_submission_allowed(cast("Any", event)))
+
+    def test_submission_allowed_for_whitelisted_user(self) -> None:
+        event = SimpleNamespace(user_id=123456)
+
+        with patch(
+            "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+            return_value=DummyPluginConfig(120, allowed_user_ids=["123456"]),
+        ):
+            self.assertTrue(is_receipt_submission_allowed(cast("Any", event)))
+
+    def test_submission_allowed_for_whitelisted_group(self) -> None:
+        event = SimpleNamespace(user_id=111111, group_id=654321)
+
+        with patch(
+            "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+            return_value=DummyPluginConfig(120, allowed_group_ids=["654321"]),
+        ):
+            self.assertTrue(is_receipt_submission_allowed(cast("Any", event)))
+
+    def test_submission_denied_for_non_whitelisted_sender(self) -> None:
+        event = SimpleNamespace(user_id=111111, group_id=222222)
+
+        with patch(
+            "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+            return_value=DummyPluginConfig(
+                120,
+                allowed_user_ids=["123456"],
+                allowed_group_ids=["654321"],
+            ),
+        ):
+            self.assertFalse(is_receipt_submission_allowed(cast("Any", event)))
+
 
 class CommandHandlerFlowTestCase(unittest.IsolatedAsyncioTestCase):
     def setUp(self) -> None:
@@ -153,23 +221,55 @@ class CommandHandlerFlowTestCase(unittest.IsolatedAsyncioTestCase):
         self,
     ) -> None:
         matcher = SimpleNamespace(state={}, send=AsyncMock(), set_arg=AsyncMock())
+        event = SimpleNamespace(user_id=123456)
         message = DummyMessage()
 
-        with patch(
-            "nonebot_plugin_receipts.command_handlers.get_effective_session_timeout_seconds",
-            return_value=119,
+        with (
+            patch(
+                "nonebot_plugin_receipts.command_handlers.get_effective_session_timeout_seconds",
+                return_value=119,
+            ),
+            patch(
+                "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+                return_value=DummyPluginConfig(120),
+            ),
         ):
-            await call_registered_handler(require_handle_handler(), matcher, message)
+            await call_registered_handler(
+                require_handle_handler(), matcher, event, message
+            )
 
         matcher.send.assert_awaited_once()
         prompt = matcher.send.await_args.args[0]
         self.assertIn("1 分 59 秒", prompt)
         self.assertIn(RECEIPT_TIMEOUT_DEADLINE_KEY, matcher.state)
 
+    async def test_handle_print_command_ignores_non_whitelisted_sender(self) -> None:
+        matcher = SimpleNamespace(state={}, send=AsyncMock(), set_arg=AsyncMock())
+        event = SimpleNamespace(user_id=111111, group_id=222222)
+        message = DummyMessage(text="hello")
+
+        with (
+            self.assertRaises(FinishedException),
+            patch(
+                "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+                return_value=DummyPluginConfig(
+                    120,
+                    allowed_user_ids=["123456"],
+                    allowed_group_ids=["654321"],
+                ),
+            ),
+        ):
+            await call_registered_handler(
+                require_handle_handler(), matcher, event, message
+            )
+
+        matcher.send.assert_not_awaited()
+        matcher.set_arg.assert_not_awaited()
+
     async def test_handle_receipt_content_finishes_when_timeout_expired(self) -> None:
         matcher = DummyMatcher()
         matcher.state[RECEIPT_TIMEOUT_DEADLINE_KEY] = 0
-        event = SimpleNamespace()
+        event = SimpleNamespace(user_id=123456)
         receipt_content = DummyMessage(text="late")
 
         with (
@@ -178,6 +278,10 @@ class CommandHandlerFlowTestCase(unittest.IsolatedAsyncioTestCase):
                 "nonebot_plugin_receipts.command_handlers.get_effective_session_timeout_seconds",
                 return_value=119,
             ),
+            patch(
+                "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+                return_value=DummyPluginConfig(120),
+            ),
         ):
             await call_registered_handler(
                 require_got_handler(), matcher, event, receipt_content
@@ -186,6 +290,26 @@ class CommandHandlerFlowTestCase(unittest.IsolatedAsyncioTestCase):
         self.assertIn("已超时", str(exc_info.exception))
         self.assertIn("/小票", str(exc_info.exception))
 
+    async def test_handle_receipt_content_ignores_non_whitelisted_sender(self) -> None:
+        matcher = DummyMatcher()
+        event = SimpleNamespace(user_id=111111, group_id=222222)
+        receipt_content = DummyMessage(text="late")
+
+        with (
+            self.assertRaises(FinishedException),
+            patch(
+                "nonebot_plugin_receipts.command_handlers.get_runtime_config",
+                return_value=DummyPluginConfig(
+                    120,
+                    allowed_user_ids=["123456"],
+                    allowed_group_ids=["654321"],
+                ),
+            ),
+        ):
+            await call_registered_handler(
+                require_got_handler(), matcher, event, receipt_content
+            )
+
 
 if __name__ == "__main__":
     unittest.main()

nonebot_plugin_receipts-0.2.4/tests/test_config.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+import os
+import unittest
+from unittest.mock import patch
+
+from nonebot.config import BaseSettings
+from nonebot_plugin_receipts.config import Config
+
+
+class ConfigTestCase(unittest.TestCase):
+    def test_whitelist_defaults_to_empty_lists(self) -> None:
+        config = Config()
+
+        self.assertEqual(config.allowed_user_ids, [])
+        self.assertEqual(config.allowed_group_ids, [])
+
+    def test_whitelist_accepts_comma_separated_strings(self) -> None:
+        config = Config.model_validate(
+            {
+                "receipt_allowed_user_ids": "123456, 234567，345678",
+                "receipt_allowed_group_ids": "456789 567890",
+            }
+        )
+
+        self.assertEqual(
+            config.allowed_user_ids,
+            ["123456", "234567", "345678"],
+        )
+        self.assertEqual(
+            config.allowed_group_ids,
+            ["456789", "567890"],
+        )
+
+    def test_whitelist_accepts_json_arrays(self) -> None:
+        config = Config.model_validate(
+            {
+                "receipt_allowed_user_ids": '["123456", 234567, ""]',
+                "receipt_allowed_group_ids": [456789, "567890", ""],
+            }
+        )
+
+        self.assertEqual(config.allowed_user_ids, ["123456", "234567"])
+        self.assertEqual(config.allowed_group_ids, ["456789", "567890"])
+
+    def test_whitelist_accepts_nonebot_env_style_values(self) -> None:
+        with patch.dict(
+            os.environ,
+            {
+                "RECEIPT_ALLOWED_USER_IDS": "123456,234567",
+                "RECEIPT_ALLOWED_GROUP_IDS": "[\"345678\", \"456789\"]",
+            },
+            clear=False,
+        ):
+            values = BaseSettings._settings_build_values(
+                Config,
+                {},
+                env_file=None,
+                env_file_encoding="utf-8",
+                env_nested_delimiter="__",
+            )
+            config = Config.model_validate(values)
+
+        self.assertEqual(config.allowed_user_ids, ["123456", "234567"])
+        self.assertEqual(config.allowed_group_ids, ["345678", "456789"])
+
+
+if __name__ == "__main__":
+    unittest.main()

nonebot_plugin_receipts-0.2.2/nonebot_plugin_receipts/config.py

@@ -1,20 +0,0 @@
-from typing import Literal
-
-from pydantic import BaseModel, Field
-
-
-class Config(BaseModel):
-    receipts_spooler_url: str = "http://127.0.0.1:8000"
-    receipts_spooler_token: str | None = None
-    receipts_spooler_timeout: float = 5.0
-    receipt_image_fetch_timeout: float = 5.0
-    receipt_render_mode: Literal["raster", "hybrid"] = "raster"
-    receipt_printer_width: int = Field(default=576, ge=128, le=576)
-    receipt_template_path: str | None = None
-    receipt_font_path: str | None = None
-    receipt_font_size: int = Field(default=24, ge=12, le=96)
-    receipt_line_spacing: int = Field(default=6, ge=0, le=40)
-    receipt_section_gap: int = Field(default=6, ge=0, le=100)
-    receipt_session_timeout_seconds: int = Field(default=120, ge=10, le=3600)
-    receipt_feed_lines: int = Field(default=4, ge=0, le=10)
-    receipt_enable_cut: bool = True