nonebot-plugin-dnddicer 0.1.0__py3-none-any.whl

nonebot_plugin_dnddicer/__init__.py

@@ -0,0 +1,72 @@
+"""DNDDicer（屠龙骰）：专精 DND5e / DND5r 的 NoneBot2 骰娘插件（OneBot V11）。
+
+项目定位与决策依据：
+- 掷骰引擎移植自 nonebot-dicepp 的 ast_engine（MIT，Copyright (c) 2022 pear-studio，
+  移植落地时引擎文件头保留版权声明与 MIT 许可全文）；
+- 业务层全部自研；范围为 DND5e/5r（不做 COC/d100 体系、不做 .mode）；
+- 商店合规：零配置可加载、localstore 存储、__plugin_meta__ 完整、全程异步。
+"""
+
+from nonebot import require
+
+
+def _nonebot_initialized() -> bool:
+    """判断 NoneBot 是否已完成初始化（require 的前提）。
+
+    本包可能被两种方式导入：
+    - NoneBot 加载流程（NoneBot load / NoneBug 夹具）：已初始化，require 必须执行；
+    - 直接导入（例如引擎随迁单测在 pytest 收集阶段 import engine 子模块）：
+      尚未初始化，此时略过 require 即可（localstore 真正缺失时，在已初始化
+      场景下 require 会正常抛错，不会被此判断掩盖）。
+    """
+    try:
+        from nonebot import get_driver
+
+        get_driver()
+        return True
+    except ValueError:
+        return False
+
+
+# 商店合规：依赖其他插件必须先 require() 再 import()
+# （本地数据存储统一走 nonebot-plugin-localstore）
+if _nonebot_initialized():
+    require("nonebot_plugin_localstore")
+
+from nonebot.plugin import PluginMetadata  # noqa: E402
+
+from .config import Config  # noqa: E402
+from .version import __version__  # noqa: E402
+
+# 插件元数据必须位于 __init__.py 最外层（NoneFlow 商店自动检查要求）
+__plugin_meta__ = PluginMetadata(
+    # 基本信息
+    name="屠龙骰",
+    description=(
+        "专精 DND5e/5r 跑团的骰娘：掷骰表达式（d20/优势劣势/爆炸骰等）、"
+        "角色卡与检定/豁免/攻击、属性生成、HP 管理、先攻列表、战斗轮（.br/.ed）、"
+        "群配置、牌堆与规则查询（规划中）。命令手感对齐 nonebot-dicepp。"
+    ),
+    usage=(
+        "发送 .r 2d20kh1+4 掷骰（.rh 为暗骰）；.帮助 查看全部指令。"
+        "详细指令表随功能落地逐步补充，见 README「用法」节。"
+    ),
+    # 发布额外信息
+    type="application",
+    homepage="https://github.com/H-Elden/nonebot-plugin-dnddicer",
+    config=Config,
+    # 仅支持 OneBot V11 适配器（~ 代表前缀 nonebot.adapters.）
+    supported_adapters={"~onebot.v11"},
+    extra={"version": __version__},
+)
+
+# 子模块导入策略：
+# - engine（掷骰引擎）无初始化副作用，随包导入以尽早暴露导入错误（引擎单测在
+#   pytest 收集阶段直接 import 本包时也需要可用）；
+# - commands（命令注册：顶层创建 on_message matcher 并读取插件配置）与 data
+#   （localstore 存储）必须在 NoneBot 初始化后的加载流程中导入，否则略过——
+#   这正是 NoneBot 加载本插件时的场景（NoneFlow/宿主加载），matcher 照常注册。
+if _nonebot_initialized():
+    from . import commands  # noqa: E402,F401
+    from . import data  # noqa: E402,F401
+from . import engine  # noqa: E402,F401

nonebot_plugin_dnddicer/character/__init__.py

@@ -0,0 +1,25 @@
+"""DND5e 角色卡/检定业务包（自研，语义对齐 nonebot-dicepp character/dnd5e）。
+
+- ``constants``：六属性/18 技能/豁免/攻击词汇表与统一检定条目索引；
+- ``models``：AbilityInfo / HPInfo / DNDCharacter（每人在每群一张卡）；
+- ``services``：模板解析（CharacterService.parse）、属性初始化与检定
+  （AbilityService.initialize / perform_check）。
+"""
+
+from .models import AbilityInfo, DNDCharacter, HPInfo  # noqa: F401
+from .services import (  # noqa: F401
+    AbilityService,
+    CharacterService,
+    gen_template_char,
+    parse_template_to_dict,
+)
+
+__all__ = [
+    "AbilityInfo",
+    "HPInfo",
+    "DNDCharacter",
+    "AbilityService",
+    "CharacterService",
+    "gen_template_char",
+    "parse_template_to_dict",
+]

nonebot_plugin_dnddicer/character/constants.py

@@ -0,0 +1,89 @@
+"""DND5e 角色卡/检定词汇表与索引常量。
+
+词汇与索引结构与 nonebot-dicepp（module/character + core/data/models/character.py）
+保持一致——六属性 / 18 技能（DND5e 官方技能表，其中「先攻」归入敏捷技能组）/
+六豁免 / 六攻击，全部汇入统一的「检定条目表」，并附技能→属性、同义词映射；
+这样规则别名与手感可与 DicePP 对齐，且新增条目只改此处（声明式建模，T3 友好）。
+"""
+
+# ── 六属性 ──────────────────────────────────────────────────────────────
+ABILITY_LIST = ["力量", "敏捷", "体质", "智力", "感知", "魅力"]
+ABILITY_NUM = len(ABILITY_LIST)
+
+# ── 技能（DND5e 18 技能；DicePP 将「先攻」纳入敏捷组技能）────────────────
+SKILL_LIST = [
+    # 力量
+    "运动",
+    # 敏捷
+    "体操", "巧手", "隐匿", "先攻",
+    # 智力
+    "奥秘", "历史", "调查", "自然", "宗教",
+    # 感知
+    "驯兽", "洞悉", "医药", "察觉", "求生",
+    # 魅力
+    "欺瞒", "威吓", "表演", "游说",
+]
+SKILL_NUM = len(SKILL_LIST)
+
+#: 技能 → 关联属性
+SKILL_PARENT_DICT = {
+    "运动": "力量",
+    "体操": "敏捷", "巧手": "敏捷", "隐匿": "敏捷", "先攻": "敏捷",
+    "奥秘": "智力", "历史": "智力", "调查": "智力", "自然": "智力", "宗教": "智力",
+    "驯兽": "感知", "洞悉": "感知", "医药": "感知", "察觉": "感知", "求生": "感知",
+    "欺瞒": "魅力", "威吓": "魅力", "表演": "魅力", "游说": "魅力",
+}
+
+#: 技能/属性常见中文别名（与 DicePP 对齐，避免玩家用词差异）
+SKILL_SYNONYM_DICT = {
+    "特技": "体操", "妙手": "巧手", 
+    "潜行": "隐匿", "隐蔽": "隐匿",
+    "隐秘": "隐匿", "躲藏": "隐匿",
+    "驯养": "驯兽", "驯服": "驯兽",
+    "医疗": "医药", "医术": "医药",
+    "观察": "察觉", "生存": "求生",
+    "欺骗": "欺瞒", "欺诈": "欺瞒", 
+    "哄骗": "欺瞒", "唬骗": "欺瞒",
+    "威胁": "威吓", "说服": "游说",
+}
+
+# ── 豁免与攻击（按属性派生）──────────────────────────────────────────────
+SAVING_LIST = ["力量豁免", "敏捷豁免", "体质豁免", "智力豁免", "感知豁免", "魅力豁免"]
+SAVING_PARENT_DICT = {
+    "力量豁免": "力量", "敏捷豁免": "敏捷", "体质豁免": "体质",
+    "智力豁免": "智力", "感知豁免": "感知", "魅力豁免": "魅力",
+}
+
+ATTACK_LIST = ["力量攻击", "敏捷攻击", "体质攻击", "智力攻击", "感知攻击", "魅力攻击"]
+ATTACK_PARENT_DICT = {
+    "力量攻击": "力量", "敏捷攻击": "敏捷", "体质攻击": "体质",
+    "智力攻击": "智力", "感知攻击": "感知", "魅力攻击": "魅力",
+}
+
+# ── 统一检定条目表（属性 + 技能 + 豁免 + 攻击）───────────────────────────
+CHECK_ITEM_LIST = ABILITY_LIST + SKILL_LIST + SAVING_LIST + ATTACK_LIST
+CHECK_ITEM_INDEX_DICT = {name: i for i, name in enumerate(CHECK_ITEM_LIST)}
+
+#: 全局附加加值键：作用于所有豁免 / 所有攻击
+SAVING_ALL_KEY = "豁免"
+ATTACK_ALL_KEY = "攻击"
+EXT_ITEM_LIST = CHECK_ITEM_LIST + [SAVING_ALL_KEY, ATTACK_ALL_KEY]
+EXT_ITEM_INDEX_DICT = {name: i for i, name in enumerate(EXT_ITEM_LIST)}
+
+# ── 角色卡关键字（$xxx$ 模板段落）────────────────────────────────────────
+CHAR_INFO_KEY_NAME = "$姓名$"
+CHAR_INFO_KEY_LEVEL = "$等级$"
+CHAR_INFO_KEY_HP = "$生命值$"
+CHAR_INFO_KEY_HP_DICE = "$生命骰$"
+CHAR_INFO_KEY_ABILITY = "$属性$"
+CHAR_INFO_KEY_PROF = "$熟练$"
+CHAR_INFO_KEY_EXT = "$额外加值$"
+CHAR_INFO_KEY_LIST = [
+    CHAR_INFO_KEY_NAME,
+    CHAR_INFO_KEY_LEVEL,
+    CHAR_INFO_KEY_HP,
+    CHAR_INFO_KEY_HP_DICE,
+    CHAR_INFO_KEY_ABILITY,
+    CHAR_INFO_KEY_PROF,
+    CHAR_INFO_KEY_EXT,
+]

nonebot_plugin_dnddicer/character/models.py

@@ -0,0 +1,229 @@
+"""DND5e 角色数据模型（Pydantic，纯数据与基础展示方法）。
+
+字段与计算语义对齐 nonebot-dicepp（core/data/models/character.py，参考实现）；
+存储/检定等复杂业务见 data/characters.py 与 character/services.py。
+
+一期范围：角色卡记录/查看/状态与检定所需字段；生命骰消耗、伤害/治疗、长休等
+行为逻辑在 T1「HP 管理」模块落地时补充（本模型字段已预留）。
+"""
+
+from __future__ import annotations
+
+from typing import List
+
+from pydantic import BaseModel, Field
+
+from .constants import (
+    ABILITY_NUM,
+    CHECK_ITEM_INDEX_DICT,
+    CHECK_ITEM_LIST,
+    CHAR_INFO_KEY_ABILITY,
+    CHAR_INFO_KEY_EXT,
+    CHAR_INFO_KEY_HP,
+    CHAR_INFO_KEY_HP_DICE,
+    CHAR_INFO_KEY_LEVEL,
+    CHAR_INFO_KEY_NAME,
+    CHAR_INFO_KEY_PROF,
+    EXT_ITEM_INDEX_DICT,
+    EXT_ITEM_LIST,
+)
+
+
+class HPInfo(BaseModel):
+    """生命值信息（字段兼容 DicePP；行为逻辑 T1 补全）。"""
+
+    is_init: bool = False
+    is_alive: bool = True
+    hp_cur: int = 0       # 当前生命值
+    hp_max: int = 0       # 最大生命值
+    hp_temp: int = 0      # 临时生命值
+    hp_dice_type: int = 0  # 生命骰面数
+    hp_dice_num: int = 0   # 当前生命骰数量
+    hp_dice_max: int = 0   # 生命骰最大数量
+
+    def initialize(
+        self,
+        hp_cur: int,
+        hp_max: int = 0,
+        hp_temp: int = 0,
+        hp_dice_type: int = 0,
+        hp_dice_num: int = 0,
+        hp_dice_max: int = 0,
+    ) -> None:
+        """按模板字符串解析结果初始化 HP。"""
+        assert 0 <= hp_cur <= hp_max, f"无效的生命值信息: {hp_cur}/{hp_max}"
+        assert hp_temp >= 0, f"无效的临时生命值信息: {hp_temp}"
+        assert 0 <= hp_dice_type <= 100 and 0 <= hp_dice_max <= 1000, \
+            f"无效的生命骰信息: {hp_dice_max}颗{hp_dice_type}面骰"
+        self.is_init = True
+        self.is_alive = True
+        self.hp_cur = hp_cur
+        self.hp_max = hp_max
+        self.hp_temp = hp_temp
+        self.hp_dice_type = hp_dice_type
+        self.hp_dice_num = hp_dice_num
+        self.hp_dice_max = hp_dice_max
+
+    def is_record_normal(self) -> bool:
+        """当前是否正常记录生命值（拥有 HP 值，而非单纯记录受损）。"""
+        return self.hp_cur > 0 or (self.hp_cur == 0 and not self.is_alive)
+
+    def is_record_damage(self) -> bool:
+        """当前是否是记录受损生命值的情况。"""
+        return not self.is_record_normal()
+
+    def take_damage(self, value: int) -> None:
+        """受到伤害：临时 HP 先吸收，溢出扣当前 HP；降至 0 昏迷。"""
+        if self.hp_temp > 0:
+            if self.hp_temp >= value:
+                self.hp_temp -= value
+                return
+            else:
+                value -= self.hp_temp
+                self.hp_temp = 0
+        if self.is_alive:
+            if self.hp_cur > 0:
+                if self.hp_cur > value:
+                    self.hp_cur -= value
+                else:
+                    self.hp_cur = 0
+                    self.is_alive = False
+            else:
+                self.hp_cur -= value
+
+    def heal(self, value: int) -> None:
+        """治疗：不超过最大 HP；受损模式下向 0 恢复。"""
+        if self.is_record_normal():
+            if self.hp_max == 0:
+                self.hp_cur += value
+            else:
+                self.hp_cur = min(self.hp_max, self.hp_cur + value)
+        else:
+            self.hp_cur = min(0, self.hp_cur + value)
+        self.is_alive = True
+
+    def long_rest(self) -> str:
+        """长休：恢复 HP 至上限、清除临时 HP、回复一半生命骰（至少 1）。"""
+        info = ""
+        if self.hp_max != 0:
+            info = f"生命值回复至上限({self.hp_max})"
+            self.hp_cur = self.hp_max
+        if self.hp_temp != 0:
+            info += f" {self.hp_temp}点临时生命值失效"
+            self.hp_temp = 0
+        if self.hp_dice_max != 0 and self.hp_dice_type != 0:
+            prev_num = self.hp_dice_num
+            self.hp_dice_num = int(max(1, min(
+                self.hp_dice_max,
+                self.hp_dice_num + self.hp_dice_max // 2
+            )))
+            info += f"\n回复{self.hp_dice_num - prev_num}个生命骰, "
+            info += f"当前拥有{self.hp_dice_num}/{self.hp_dice_max}个D{self.hp_dice_type}生命骰"
+        return info.strip()
+
+    def get_info(self) -> str:
+        """HP 摘要，如 ``HP:5/10 (4)`` 或 ``损失HP:3``。"""
+        temp_info = f" ({self.hp_temp})" if self.hp_temp != 0 else ""
+        if self.is_record_normal():
+            max_info = f"/{self.hp_max}" if self.hp_max != 0 else ""
+            info = f"HP:{self.hp_cur}{max_info}{temp_info}"
+            if not self.is_alive:
+                info += " 昏迷"
+        else:
+            info = f"损失HP:{-self.hp_cur}{temp_info}"
+        return info
+
+    def get_char_info(self) -> str:
+        """角色卡段落，如 ``$生命值$ 5/10 (4)``。"""
+        if not self.is_init:
+            return ""
+        info = f"{CHAR_INFO_KEY_HP} {self.hp_cur}"
+        if self.hp_max > 0:
+            info += f"/{self.hp_max}"
+        if self.hp_temp > 0:
+            info += f" ({self.hp_temp})"
+        if self.hp_dice_type > 0:
+            info += f"\n{CHAR_INFO_KEY_HP_DICE} {self.hp_dice_num}/{self.hp_dice_max} D{self.hp_dice_type}"
+        return info
+
+
+class AbilityInfo(BaseModel):
+    """属性与检定信息。
+
+    - ``ability``：六属性原始值（力量~魅力）；
+    - ``check_prof``：每个检定条目的熟练系数（0=未熟练，1=熟练，2=双倍熟练……）；
+    - ``check_ext``：每个检定条目的额外加值表达式片段（可含全局豁免/攻击键）；
+    - ``check_adv``：每个条目自带优劣势（1 优势 / -1 劣势 / 0 无）。
+    """
+
+    is_init: bool = False
+    version: int = 1
+    level: int = 0
+    ability: List[int] = Field(default_factory=lambda: [0] * ABILITY_NUM)
+    check_prof: List[int] = Field(default_factory=lambda: [0] * len(CHECK_ITEM_LIST))
+    check_ext: List[str] = Field(default_factory=lambda: [""] * len(EXT_ITEM_LIST))
+    check_adv: List[int] = Field(default_factory=lambda: [0] * len(EXT_ITEM_LIST))
+
+    def get_prof_bonus(self) -> int:
+        """熟练加值：2 + (等级-1)//4（5e 规则）。"""
+        return 2 + (self.level - 1) // 4
+
+    def get_modifier(self, ability_index: int) -> int:
+        """属性调整值：(值-10)//2（5e 向下取整）。"""
+        return (self.ability[ability_index] - 10) // 2
+
+    def get_char_info(self) -> str:
+        """角色卡属性段落（可直接复制再记录，用于自行保存多卡）。"""
+        info = f"{CHAR_INFO_KEY_LEVEL} {self.level}\n"
+        info += f"{CHAR_INFO_KEY_ABILITY} {'/'.join(str(v) for v in self.ability)}\n"
+
+        prof_parts = []
+        for index, scale in enumerate(self.check_prof):
+            if scale <= 0:
+                continue
+            name = CHECK_ITEM_LIST[index]
+            prof_parts.append(name if scale == 1 else f"{scale}*{name}")
+        if prof_parts:
+            info += f"{CHAR_INFO_KEY_PROF} {'/'.join(prof_parts)}\n"
+
+        adv_dict = {
+            EXT_ITEM_LIST[i]: flag
+            for i, flag in enumerate(self.check_adv) if flag != 0
+        }
+        ext_parts = []
+        for index, ext_str in enumerate(self.check_ext):
+            if not ext_str:
+                continue
+            name = EXT_ITEM_LIST[index]
+            prefix = ""
+            if name in adv_dict:
+                prefix = "优势" if adv_dict[name] > 0 else "劣势"
+            ext_parts.append(f"{name}:{prefix}{ext_str}")
+        if ext_parts:
+            info += f"{CHAR_INFO_KEY_EXT} {'/'.join(ext_parts)}\n"
+
+        return info.strip()
+
+
+class DNDCharacter(BaseModel):
+    """DND5e 角色卡（每人在每群一张，键 = 群 + QQ）。"""
+
+    group_id: str
+    user_id: str
+    name: str = ""
+    hp_info: HPInfo = Field(default_factory=HPInfo)
+    ability_info: AbilityInfo = Field(default_factory=AbilityInfo)
+    is_init: bool = False
+
+    def get_char_info(self) -> str:
+        """完整角色卡文本（$xxx$ 段落格式，可再次 .角色卡记录）。"""
+        parts = []
+        if self.name:
+            parts.append(f"{CHAR_INFO_KEY_NAME} {self.name}")
+        hp_part = self.hp_info.get_char_info()
+        if hp_part:
+            parts.append(hp_part)
+        ability_part = self.ability_info.get_char_info()
+        if ability_part:
+            parts.append(ability_part)
+        return "\n".join(parts)