nonebot-plugin-dnddicer 0.4.2__tar.gz → 0.4.4__tar.gz

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/CHANGELOG.md

@@ -8,6 +8,47 @@
 - 打 `v*` 标签前，请先在下方补好该版本的小节（标题格式 `## [x.y.z] - 日期`）：发布时 `.github/workflows/release.yml` 会提取与所推标签同名的小节作为 GitHub Release 的说明正文，缺小节即会在构建前直接失败。
 -->
 
+## [0.4.4] - 2026-09-30
+
+### 修复
+
+- **配置项写数字不再导致插件加载失败**：`.env` 里把骰主 QQ（`dnddicer_master_qq`）、骰主交流群（`dnddicer_master_group`）、联系方式等直接写成数字时，此前会因类型校验不通过让整个插件不加载（骰娘不响应任何命令），加引号也无效；现在数字写法与字符串写法都能正常读取。
+
+### 文档
+
+- 《快速开始》补充字体家族（`dnddicer_query_image_font_family`）在 `.env` 里的写法说明：家族名不要带半角双引号，否则该行会被配置加载器丢弃、字体回落内置字体栈。
+
+## [0.4.3] - 2026-09-30
+
+### 新增
+
+- **武器名模糊匹配**：除 `设置武器` 之外，`.X攻击` / `.X命中` / `.X伤害`、`.hp` 等命令的武器均支持模糊匹配，即精确优先、子串匹配。
+- **一条命令结算多件武器**：`.刺剑伤害、匕首副手伤害`（分隔符 `、` / `，` / `/` 均可），逐件掷伤后给出一行合计；伤害类型不同时按类型分组报出，后缀与临时加值各项独立。多武器攻击同样支持（`.刺剑攻击优势、匕首攻击+2`），`.hp` 的伤害位置也已接入。
+- **`.master <消息>` 反馈骰主**：群聊与私聊均支持，由骰娘私聊转达给骰主；单条限 200 字、同一人 60 秒限一条。
+- **新增四个配置项**：
+    - `dnddicer_master_qq`：骰主 QQ 号，`.master` 的收件人
+    - `dnddicer_master_contact`：只在 `.help 联系` 展示
+    - `dnddicer_master_group`：只在 `.help 联系` 展示
+    - `dnddicer_query_image_default`：查询默认展示形态
+
+### 变更
+
+- **`.help` 帮助体系重构**：无参数看总览，`.help 命令` 给七组目录，`.help <组名>` 给组清单，`.help <命令>` 给「用法 + 缩进说明」的简版详情；另有 `.help 链接` / `.help 关于` / `.help 骰主` / `.help 联系` 四个入口。长帮助不再刷屏。
+- **帮助详情给文档深链**：详情末尾的链接行指向该命令对应的文档页（不再一律指向站点首页）；`.help 链接 on/off` 按处开关，群聊默认关、私聊默认开。
+- **`.dnd` / `.dndx` 次数上限由 10 提到 20**：次数越界（含 0 与负数）不再静默按 1 次掷点，改为提示并拒绝执行。
+- **`.角色卡模板` 提示更新**：熟练段补充「六属性 / 技能 / 豁免条目 / 先攻」，并精简额外加值两行。
+
+### 修复
+
+- **速查条目拿错卡、丢正文**：修 `.查询法术 火墙术` 返回排在它前面的生物卡、召唤类法术丢失法术正文等问题（改为判断标题是否落在数据卡内）。
+- **图片卡片排版**：修正文上下大片空白、句中折行与孤字行，以及文字模式跟着图片一起折行（消息里多出换行）三个问题。
+- **图片中英文错位**：卡片字体栈改为中文优先且中西文同源，服务器上不再中英各用一套字体、中文也不再回退成日文字形；可用新增配置项 `dnddicer_query_image_font_family` 指定字体。
+
+### 文档
+
+- README 顶部新增 logo 头图，简介区新增交流反馈 QQ 群入口。
+- 《武器与攻击》新增「两把武器一起结算（多武器写法）」与「武器名支持模糊匹配」两节；《群管理与 FAQ》新增「联系骰主」小节；《快速开始》《命令总览》与 README 同步新帮助入口、`.master` 与配置项。
+
 ## [0.4.2] - 2026-09-26
 
 ### 变更

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nonebot-plugin-dnddicer
-Version: 0.4.2
+Version: 0.4.4
 Summary: 专精 DND5e/5r 跑团的 NoneBot2 骰娘插件（屠龙骰）：掷骰表达式、角色卡与检定、自定义武器与攻击、属性生成、HP 管理、先攻列表、战斗轮、规则查询等
 Project-URL: Homepage, https://github.com/H-Elden/nonebot-plugin-dnddicer
 Project-URL: Issues, https://github.com/H-Elden/nonebot-plugin-dnddicer/issues
@@ -30,18 +30,24 @@ Provides-Extra: render
 Requires-Dist: nonebot-plugin-htmlkit>=0.1.0rc5; extra == 'render'
 Description-Content-Type: text/markdown
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/H-Elden/nonebot-plugin-dnddicer/main/logo/dnddicer-logo.svg" alt="屠龙骰 DNDDicer" width="140">
+</p>
+
 # 屠龙骰（DNDDicer / nonebot-plugin-dnddicer）
 
 > 专精 **DND5e / DND5r** 跑团的 [NoneBot2](https://nonebot.dev/) 骰娘插件（OneBot V11 适配器），致力于做功能最全面、体验最好的 DND 骰娘。
 >
-> 当前版本：**v0.4.2** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**（[国内镜像](https://dnddicer.netlify.app/)，GitHub Pages 访问不畅时用）
+> 当前版本：**v0.4.4** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**（[国内镜像](https://dnddicer.netlify.app/)）
+>
+> 交流反馈 QQ 群：[![QQ群](https://img.shields.io/badge/QQ%E7%BE%A4-1107879441-12B7F5?logo=tencentqq&logoColor=white)](https://qun.qq.com/universal-share/share?ac=1&authKey=eUFiLk5ktomkYgDWCMnJnLNQW%2FJwmfR7wXKRrYyQeJy5uaYtwDsm4ABDiofKx6%2BN&busi_data=eyJncm91cENvZGUiOiIxMTA3ODc5NDQxIiwidG9rZW4iOiIvWHlQbDlNeUdBOVpQSnB1WU1RNUFmRCtBNlgwTXpnN2VOSlh6UkJ1YTFUdmREdEExYmEwSXo4SXFiR21zb0tsIiwidWluIjoiMjk4NDQ5NTc3NCJ9&data=JWJQw7qsywgzyHnQ-HJ_PzqF_Y1otBjTRkehoSmk6faB87xzjGf4PA_p1KNPhLvkkOwlLEuNH9jTN8XxNbxRPQ&svctype=4&tempid=h5_group_info)
 
 ## ✨ 简介
 
 DNDDicer 的目标是填补「NoneBot 商店中缺少 **DND5e/5r 专业 + 现代维护 + 插件形态** 骰娘」的空位：围绕 DND 跑团全流程持续做深做全，致力于提供功能最全面、体验最好的 DND 骰娘，零配置可加载，供任何已有机器人从商店安装即用。
 
 - **掷骰引擎**：内置 AST 表达式引擎（Lark 文法），支持 `2d20kh1`、优势/劣势、爆炸骰、连掷、暗骰等完整掷骰语法；
-- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免点命令 → 自定义武器与攻击（`.X攻击`/`.X伤害`）/ HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮 → 规则查询（`.查询`/`.搜索`，可限定书目、可出图）；
+- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免点命令 → 自定义武器与攻击（`.X攻击`/`.X伤害`，支持两把武器一条命令结算）/ HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮 → 规则查询（`.查询`/`.搜索`，可限定书目、可出图）；
 - **规则范围**：仅 DND5e/5r：专精 DND 定位，不做 COC/D100 体系与 `.mode` 模式切换；
 - **商店合规**：零配置可加载、本地存储走 `nonebot-plugin-localstore`、元数据完整、全程异步。
 
@@ -87,6 +93,9 @@ plugins = ["nonebot_plugin_dnddicer"]
 | `dnddicer_default_face` | `int` | `20` | 全局默认骰面（DND 惯例 D20；已配置 `.dset` 的群以群配置为准，此项作兜底） |
 | `dnddicer_enabled` | `bool` | `true` | 功能总开关，`false` 时只加载骨架、不注册命令 |
 | `dnddicer_use_host_command_starts` | `bool` | `false` | 是否兼容宿主 `COMMAND_START` 起始符（NoneBot 默认 `/`，开启后 `/.help` 等亦可触发）。默认只匹配 `.` / `。`，避免 `/help`、`/bot` 等常见单词命令与其他插件同时命中（冲突） |
+| `dnddicer_master_qq` | `str` | 空 | 骰主 QQ 号（**单个**）：`.master` 反馈的收件人，留空则 `.master` 回「骰主未配置」 |
+| `dnddicer_master_contact` | `str` | 空 | 骰主联系方式（自由文本），仅用于 `.help 联系` 展示，留空不显示该行 |
+| `dnddicer_master_group` | `str` | 空 | 骰主交流群群号，仅用于 `.help 联系` 展示，留空不显示该行 |
 
 ## 🎲 用法
 
@@ -121,9 +130,10 @@ plugins = ["nonebot_plugin_dnddicer"]
 
 | 命令 | 说明 |
 | --- | --- |
-| `.刺剑攻击` / `.刺剑命中` | 用卡上该武器的命中加值掷攻击检定（`优势`/`劣势`、`N#` 连掷、`±` 临时加值、`@玩家` 代掷；天然 20 提示重击） |
-| `.刺剑伤害` | 掷该武器伤害并报出类型；后缀 `副手`（不加任何加值）/ `重击`（骰数翻倍）/ `偷袭`（游荡者按等级自动附加偷袭骰）可组合，尾部可加 `±` 临时加值（如升环 `.火球术伤害+1d6`） |
-| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 删除，多个用 `/` 分隔；`.设置武器` 无参数列出当前武器） |
+| `.刺剑攻击` / `.刺剑命中` | 用卡上该武器的命中加值掷攻击检定（`优势`/`劣势`、`N#` 连掷、`±` 临时加值、`@玩家` 代掷；天然 20 提示重击；武器名支持模糊匹配） |
+| `.刺剑伤害` | 掷该武器伤害并报出类型；后缀 `副手`（不加任何加值）/ `重击`（骰数翻倍）/ `偷袭`（游荡者按等级自动附加偷袭骰）可组合，尾部可加 `±` 临时加值（如升环 `.火球术伤害+1d6`）；武器名支持模糊匹配 |
+| `.刺剑伤害、匕首副手伤害` | 一条命令结算多件武器（`、`/`，`/`/` 分隔，各件的后缀与加值各写各的）：逐件掷伤 + 一行合计；攻击同理（`.刺剑攻击、匕首攻击`） |
+| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 按名称删除，名称支持模糊匹配，多个用 `/` 分隔；`.设置武器` 无参数列出当前武器） |
 
 详见 [武器与攻击](./docs/guide/weapons.md)。
 
@@ -139,7 +149,7 @@ plugins = ["nonebot_plugin_dnddicer"]
 | 命令 | 说明 |
 | --- | --- |
 | `.hp [对象] 20/30 (5)` | 设置自己/队友/NPC HP（含临时 HP；先 `.ri 名称` 入先攻表后即可记录 NPC 血量） |
-| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；伤害位置可直接写 `-武器名伤害`，如 `-战锤重击伤害+1d4`，对应发送者卡上武器项、尾部括号可指定来源代发；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
+| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；伤害位置可直接写 `-武器名伤害`，如 `-战锤重击伤害+1d4`、多武器 `-刺剑伤害、匕首副手伤害`，对应发送者卡上武器项、尾部括号可指定来源代发；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
 | `.hp @玩家 …` / `.hp @玩家` | 对 @ 的玩家角色卡结算 / 查看（`.hp @玩家 -4d6`、`.hp @玩家;地精 -d4` 与名称混写；需该玩家已建卡） |
 | `.hp` / `.hp list` | 查看自己 / 本群列表（PC + NPC） |
 | `.hp del 名称` / `.hp clr` | 删除单个 / 清空全部 NPC 血量记录（玩家角色卡请用 `.角色卡清除`，玩家先攻条目用 `.init del`） |
@@ -181,7 +191,8 @@ plugins = ["nonebot_plugin_dnddicer"]
 | --- | --- |
 | `.dset [表达式]` | 设置/查看群默认骰面（群主/管理员） |
 | `.bot [on/off]` | 插件信息查询 / 本群服务开关（群主/管理员，需 @） |
-| `.帮助` / `.help [命令]` | 命令总览 / 指定命令详细用法（如 `.help r`） |
+| `.帮助` / `.help [命令 \| 分组 \| 链接 \| 关于 \| 骰主 \| 联系]` | 帮助入口：总览 / 命令目录 / 分组清单 / 命令详情 / 相关链接 / 插件信息 / 骰主指令 / 联系方式 |
+| `.master <消息>` | 把问题或建议发给骰主：骰娘私聊转达（附群号与 QQ 号；单条 200 字、同一人 60 秒一条；骰主 QQ 号由 `dnddicer_master_qq` 配置） |
 
 > 一期范围外功能会**显式提示而非静默**：`.r exp` 期望值采样、`.r a/n` 特殊判定；牌堆/随机表（T2）与法术位/死亡豁免/BUFF 表（T3 候选）见下方路线。
 
@@ -195,8 +206,10 @@ plugins = ["nonebot_plugin_dnddicer"]
 6. ✅ **v0.4.0**：**规则查询**（`.查询` / `.搜索` 两种检索、候选选择与翻页、`.查询图片` 图片模式、`.查询范围` 书目限定与 `.规则书`）；**文档站按前置条件重排为四章**（基础操作 / 玩家进阶 / DM 进阶 / 最佳实践）；大成功/大失败播报另起一行、修饰符回显加括号；
 7. ✅ **v0.4.1**：**规则查询速查子命令**（8 条 `.查询法术` 等，推荐优先使用）与**骰主命令 `.查询索引`**（状态 / 按类刷新）；词条正文升级为站点样式渲染（卡片 / 数据卡 / 关键词高亮）；**文档站新增国内镜像**（GitHub Pages 访问不畅时用）；
 8. ✅ **v0.4.2**：`.bot` 插件信息与 `.help` 命令总览的回复末尾新增「详细帮助文档」链接（指向文档站国内镜像），群内可直达使用手册；
-9. ⏳ **第二期余下**：牌堆/随机表；
-10. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
+9. ✅ **v0.4.3**：**`.help` 帮助体系重做**（总览 / 七组目录 / 组清单 / 简版详情，另设链接、关于、骰主、联系四入口）；**武器名模糊匹配**与**一条命令结算多件武器**；**`.master` 反馈骰主**与三个骰主配置项；`.dnd` / `.dndx` 次数上限提到 20；规则查询速查切片、图片卡片排版与字体三项修复；
+10. ✅ **v0.4.4**：修复配置项写数字（如骰主 QQ、交流群）导致插件不加载的问题；《快速开始》补充字体家族在 `.env` 里的写法说明；
+11. ⏳ **第二期余下**：牌堆/随机表；
+12. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
 
 每版完整变更（新增 / 变更 / 修复 / 文档）见 [CHANGELOG.md](./CHANGELOG.md)。
 

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/README.md

@@ -1,15 +1,21 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/H-Elden/nonebot-plugin-dnddicer/main/logo/dnddicer-logo.svg" alt="屠龙骰 DNDDicer" width="140">
+</p>
+
 # 屠龙骰（DNDDicer / nonebot-plugin-dnddicer）
 
 > 专精 **DND5e / DND5r** 跑团的 [NoneBot2](https://nonebot.dev/) 骰娘插件（OneBot V11 适配器），致力于做功能最全面、体验最好的 DND 骰娘。
 >
-> 当前版本：**v0.4.2** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**（[国内镜像](https://dnddicer.netlify.app/)，GitHub Pages 访问不畅时用）
+> 当前版本：**v0.4.4** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**（[国内镜像](https://dnddicer.netlify.app/)）
+>
+> 交流反馈 QQ 群：[![QQ群](https://img.shields.io/badge/QQ%E7%BE%A4-1107879441-12B7F5?logo=tencentqq&logoColor=white)](https://qun.qq.com/universal-share/share?ac=1&authKey=eUFiLk5ktomkYgDWCMnJnLNQW%2FJwmfR7wXKRrYyQeJy5uaYtwDsm4ABDiofKx6%2BN&busi_data=eyJncm91cENvZGUiOiIxMTA3ODc5NDQxIiwidG9rZW4iOiIvWHlQbDlNeUdBOVpQSnB1WU1RNUFmRCtBNlgwTXpnN2VOSlh6UkJ1YTFUdmREdEExYmEwSXo4SXFiR21zb0tsIiwidWluIjoiMjk4NDQ5NTc3NCJ9&data=JWJQw7qsywgzyHnQ-HJ_PzqF_Y1otBjTRkehoSmk6faB87xzjGf4PA_p1KNPhLvkkOwlLEuNH9jTN8XxNbxRPQ&svctype=4&tempid=h5_group_info)
 
 ## ✨ 简介
 
 DNDDicer 的目标是填补「NoneBot 商店中缺少 **DND5e/5r 专业 + 现代维护 + 插件形态** 骰娘」的空位：围绕 DND 跑团全流程持续做深做全，致力于提供功能最全面、体验最好的 DND 骰娘，零配置可加载，供任何已有机器人从商店安装即用。
 
 - **掷骰引擎**：内置 AST 表达式引擎（Lark 文法），支持 `2d20kh1`、优势/劣势、爆炸骰、连掷、暗骰等完整掷骰语法；
-- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免点命令 → 自定义武器与攻击（`.X攻击`/`.X伤害`）/ HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮 → 规则查询（`.查询`/`.搜索`，可限定书目、可出图）；
+- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免点命令 → 自定义武器与攻击（`.X攻击`/`.X伤害`，支持两把武器一条命令结算）/ HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮 → 规则查询（`.查询`/`.搜索`，可限定书目、可出图）；
 - **规则范围**：仅 DND5e/5r：专精 DND 定位，不做 COC/D100 体系与 `.mode` 模式切换；
 - **商店合规**：零配置可加载、本地存储走 `nonebot-plugin-localstore`、元数据完整、全程异步。
 
@@ -55,6 +61,9 @@ plugins = ["nonebot_plugin_dnddicer"]
 | `dnddicer_default_face` | `int` | `20` | 全局默认骰面（DND 惯例 D20；已配置 `.dset` 的群以群配置为准，此项作兜底） |
 | `dnddicer_enabled` | `bool` | `true` | 功能总开关，`false` 时只加载骨架、不注册命令 |
 | `dnddicer_use_host_command_starts` | `bool` | `false` | 是否兼容宿主 `COMMAND_START` 起始符（NoneBot 默认 `/`，开启后 `/.help` 等亦可触发）。默认只匹配 `.` / `。`，避免 `/help`、`/bot` 等常见单词命令与其他插件同时命中（冲突） |
+| `dnddicer_master_qq` | `str` | 空 | 骰主 QQ 号（**单个**）：`.master` 反馈的收件人，留空则 `.master` 回「骰主未配置」 |
+| `dnddicer_master_contact` | `str` | 空 | 骰主联系方式（自由文本），仅用于 `.help 联系` 展示，留空不显示该行 |
+| `dnddicer_master_group` | `str` | 空 | 骰主交流群群号，仅用于 `.help 联系` 展示，留空不显示该行 |
 
 ## 🎲 用法
 
@@ -89,9 +98,10 @@ plugins = ["nonebot_plugin_dnddicer"]
 
 | 命令 | 说明 |
 | --- | --- |
-| `.刺剑攻击` / `.刺剑命中` | 用卡上该武器的命中加值掷攻击检定（`优势`/`劣势`、`N#` 连掷、`±` 临时加值、`@玩家` 代掷；天然 20 提示重击） |
-| `.刺剑伤害` | 掷该武器伤害并报出类型；后缀 `副手`（不加任何加值）/ `重击`（骰数翻倍）/ `偷袭`（游荡者按等级自动附加偷袭骰）可组合，尾部可加 `±` 临时加值（如升环 `.火球术伤害+1d6`） |
-| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 删除，多个用 `/` 分隔；`.设置武器` 无参数列出当前武器） |
+| `.刺剑攻击` / `.刺剑命中` | 用卡上该武器的命中加值掷攻击检定（`优势`/`劣势`、`N#` 连掷、`±` 临时加值、`@玩家` 代掷；天然 20 提示重击；武器名支持模糊匹配） |
+| `.刺剑伤害` | 掷该武器伤害并报出类型；后缀 `副手`（不加任何加值）/ `重击`（骰数翻倍）/ `偷袭`（游荡者按等级自动附加偷袭骰）可组合，尾部可加 `±` 临时加值（如升环 `.火球术伤害+1d6`）；武器名支持模糊匹配 |
+| `.刺剑伤害、匕首副手伤害` | 一条命令结算多件武器（`、`/`，`/`/` 分隔，各件的后缀与加值各写各的）：逐件掷伤 + 一行合计；攻击同理（`.刺剑攻击、匕首攻击`） |
+| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 按名称删除，名称支持模糊匹配，多个用 `/` 分隔；`.设置武器` 无参数列出当前武器） |
 
 详见 [武器与攻击](./docs/guide/weapons.md)。
 
@@ -107,7 +117,7 @@ plugins = ["nonebot_plugin_dnddicer"]
 | 命令 | 说明 |
 | --- | --- |
 | `.hp [对象] 20/30 (5)` | 设置自己/队友/NPC HP（含临时 HP；先 `.ri 名称` 入先攻表后即可记录 NPC 血量） |
-| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；伤害位置可直接写 `-武器名伤害`，如 `-战锤重击伤害+1d4`，对应发送者卡上武器项、尾部括号可指定来源代发；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
+| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；伤害位置可直接写 `-武器名伤害`，如 `-战锤重击伤害+1d4`、多武器 `-刺剑伤害、匕首副手伤害`，对应发送者卡上武器项、尾部括号可指定来源代发；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
 | `.hp @玩家 …` / `.hp @玩家` | 对 @ 的玩家角色卡结算 / 查看（`.hp @玩家 -4d6`、`.hp @玩家;地精 -d4` 与名称混写；需该玩家已建卡） |
 | `.hp` / `.hp list` | 查看自己 / 本群列表（PC + NPC） |
 | `.hp del 名称` / `.hp clr` | 删除单个 / 清空全部 NPC 血量记录（玩家角色卡请用 `.角色卡清除`，玩家先攻条目用 `.init del`） |
@@ -149,7 +159,8 @@ plugins = ["nonebot_plugin_dnddicer"]
 | --- | --- |
 | `.dset [表达式]` | 设置/查看群默认骰面（群主/管理员） |
 | `.bot [on/off]` | 插件信息查询 / 本群服务开关（群主/管理员，需 @） |
-| `.帮助` / `.help [命令]` | 命令总览 / 指定命令详细用法（如 `.help r`） |
+| `.帮助` / `.help [命令 \| 分组 \| 链接 \| 关于 \| 骰主 \| 联系]` | 帮助入口：总览 / 命令目录 / 分组清单 / 命令详情 / 相关链接 / 插件信息 / 骰主指令 / 联系方式 |
+| `.master <消息>` | 把问题或建议发给骰主：骰娘私聊转达（附群号与 QQ 号；单条 200 字、同一人 60 秒一条；骰主 QQ 号由 `dnddicer_master_qq` 配置） |
 
 > 一期范围外功能会**显式提示而非静默**：`.r exp` 期望值采样、`.r a/n` 特殊判定；牌堆/随机表（T2）与法术位/死亡豁免/BUFF 表（T3 候选）见下方路线。
 
@@ -163,8 +174,10 @@ plugins = ["nonebot_plugin_dnddicer"]
 6. ✅ **v0.4.0**：**规则查询**（`.查询` / `.搜索` 两种检索、候选选择与翻页、`.查询图片` 图片模式、`.查询范围` 书目限定与 `.规则书`）；**文档站按前置条件重排为四章**（基础操作 / 玩家进阶 / DM 进阶 / 最佳实践）；大成功/大失败播报另起一行、修饰符回显加括号；
 7. ✅ **v0.4.1**：**规则查询速查子命令**（8 条 `.查询法术` 等，推荐优先使用）与**骰主命令 `.查询索引`**（状态 / 按类刷新）；词条正文升级为站点样式渲染（卡片 / 数据卡 / 关键词高亮）；**文档站新增国内镜像**（GitHub Pages 访问不畅时用）；
 8. ✅ **v0.4.2**：`.bot` 插件信息与 `.help` 命令总览的回复末尾新增「详细帮助文档」链接（指向文档站国内镜像），群内可直达使用手册；
-9. ⏳ **第二期余下**：牌堆/随机表；
-10. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
+9. ✅ **v0.4.3**：**`.help` 帮助体系重做**（总览 / 七组目录 / 组清单 / 简版详情，另设链接、关于、骰主、联系四入口）；**武器名模糊匹配**与**一条命令结算多件武器**；**`.master` 反馈骰主**与三个骰主配置项；`.dnd` / `.dndx` 次数上限提到 20；规则查询速查切片、图片卡片排版与字体三项修复；
+10. ✅ **v0.4.4**：修复配置项写数字（如骰主 QQ、交流群）导致插件不加载的问题；《快速开始》补充字体家族在 `.env` 里的写法说明；
+11. ⏳ **第二期余下**：牌堆/随机表；
+12. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
 
 每版完整变更（新增 / 变更 / 修复 / 文档）见 [CHANGELOG.md](./CHANGELOG.md)。
 

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/best-practices.md

@@ -21,7 +21,7 @@
 
 ### 开卡：让骰娘替玩家掷点（.dnd / .dndx）
 
-希望玩家用掷点确定属性值时，骰娘提供了两种方式：`.dndx` 按固定顺序**直接绑定属性名**（掷出即定，抄进角色卡即可）；`.dnd` 只出一组降序数值（玩家自行分配）。两个命令后均可跟数字多掷几组（如 `.dnd5`，上限 10）。小鹿试掷了一组：
+希望玩家用掷点确定属性值时，骰娘提供了两种方式：`.dndx` 按固定顺序**直接绑定属性名**（掷出即定，抄进角色卡即可）；`.dnd` 只出一组降序数值（玩家自行分配）。两个命令后均可跟数字多掷几组（如 `.dnd5`，上限 20）。小鹿试掷了一组：
 
 ::: chat
 小鹿 | .dndx

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/changelog.md

@@ -14,6 +14,47 @@ editLink: false
 - 打 `v*` 标签前，请先在下方补好该版本的小节（标题格式 `## [x.y.z] - 日期`）：发布时 `.github/workflows/release.yml` 会提取与所推标签同名的小节作为 GitHub Release 的说明正文，缺小节即会在构建前直接失败。
 -->
 
+## [0.4.4] - 2026-09-30
+
+### 修复
+
+- **配置项写数字不再导致插件加载失败**：`.env` 里把骰主 QQ（`dnddicer_master_qq`）、骰主交流群（`dnddicer_master_group`）、联系方式等直接写成数字时，此前会因类型校验不通过让整个插件不加载（骰娘不响应任何命令），加引号也无效；现在数字写法与字符串写法都能正常读取。
+
+### 文档
+
+- 《快速开始》补充字体家族（`dnddicer_query_image_font_family`）在 `.env` 里的写法说明：家族名不要带半角双引号，否则该行会被配置加载器丢弃、字体回落内置字体栈。
+
+## [0.4.3] - 2026-09-30
+
+### 新增
+
+- **武器名模糊匹配**：除 `设置武器` 之外，`.X攻击` / `.X命中` / `.X伤害`、`.hp` 等命令的武器均支持模糊匹配，即精确优先、子串匹配。
+- **一条命令结算多件武器**：`.刺剑伤害、匕首副手伤害`（分隔符 `、` / `，` / `/` 均可），逐件掷伤后给出一行合计；伤害类型不同时按类型分组报出，后缀与临时加值各项独立。多武器攻击同样支持（`.刺剑攻击优势、匕首攻击+2`），`.hp` 的伤害位置也已接入。
+- **`.master <消息>` 反馈骰主**：群聊与私聊均支持，由骰娘私聊转达给骰主；单条限 200 字、同一人 60 秒限一条。
+- **新增四个配置项**：
+    - `dnddicer_master_qq`：骰主 QQ 号，`.master` 的收件人
+    - `dnddicer_master_contact`：只在 `.help 联系` 展示
+    - `dnddicer_master_group`：只在 `.help 联系` 展示
+    - `dnddicer_query_image_default`：查询默认展示形态
+
+### 变更
+
+- **`.help` 帮助体系重构**：无参数看总览，`.help 命令` 给七组目录，`.help <组名>` 给组清单，`.help <命令>` 给「用法 + 缩进说明」的简版详情；另有 `.help 链接` / `.help 关于` / `.help 骰主` / `.help 联系` 四个入口。长帮助不再刷屏。
+- **帮助详情给文档深链**：详情末尾的链接行指向该命令对应的文档页（不再一律指向站点首页）；`.help 链接 on/off` 按处开关，群聊默认关、私聊默认开。
+- **`.dnd` / `.dndx` 次数上限由 10 提到 20**：次数越界（含 0 与负数）不再静默按 1 次掷点，改为提示并拒绝执行。
+- **`.角色卡模板` 提示更新**：熟练段补充「六属性 / 技能 / 豁免条目 / 先攻」，并精简额外加值两行。
+
+### 修复
+
+- **速查条目拿错卡、丢正文**：修 `.查询法术 火墙术` 返回排在它前面的生物卡、召唤类法术丢失法术正文等问题（改为判断标题是否落在数据卡内）。
+- **图片卡片排版**：修正文上下大片空白、句中折行与孤字行，以及文字模式跟着图片一起折行（消息里多出换行）三个问题。
+- **图片中英文错位**：卡片字体栈改为中文优先且中西文同源，服务器上不再中英各用一套字体、中文也不再回退成日文字形；可用新增配置项 `dnddicer_query_image_font_family` 指定字体。
+
+### 文档
+
+- README 顶部新增 logo 头图，简介区新增交流反馈 QQ 群入口。
+- 《武器与攻击》新增「两把武器一起结算（多武器写法）」与「武器名支持模糊匹配」两节；《群管理与 FAQ》新增「联系骰主」小节；《快速开始》《命令总览》与 README 同步新帮助入口、`.master` 与配置项。
+
 ## [0.4.2] - 2026-09-26
 
 ### 变更

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/character-card.md

@@ -25,7 +25,7 @@ DND 建卡的六属性有两条路：**购点**是纸面计算，**掷点**交
 | `.dnd` | 六项数值的**降序**列表（只出数值，不绑定） | 想自行把数值分配给六属性 |
 | `.dndx` | 数值按固定顺序**直接绑定属性名**（不排序） | 掷出即定，直接抄进角色卡 |
 
-命令后可跟**次数**与**原因**：`.dnd2` 一次掷两组（上限 10），原因会写进标题。DM 给客串 NPC 掷点：
+命令后可跟**次数**与**原因**：`.dnd2` 一次掷两组（上限 20），原因会写进标题。DM 给客串 NPC 掷点：
 
 ::: chat
 白鸦 | .dnd
@@ -39,6 +39,15 @@ DND 建卡的六属性有两条路：**购点**是纸面计算，**掷点**交
 
 读法：`74` 是六项合计，`[18, 14, …]` 是六项数值的降序列表（第一项 18 出自 `6,6,6,1`，去掉 1 后 6+6+6），自行挑六个数字分配给属性即可。
 
+次数写错时骰娘会直接说明，既不掷点、也不悄悄改次数：
+
+::: chat
+白鸦 | .dnd30
+屠龙骰 | 次数超出上限：最多 20 次
+白鸦 | .dndx 0
+屠龙骰 | 次数至少为 1
+:::
+
 `.dndx` 的顺序与 `$属性$` 行完全一致（力量/敏捷/体质/智力/感知/魅力），掷出即定、按序抄写；小鹿试掷并登记：
 
 ::: chat
@@ -73,9 +82,9 @@ $武器$ 短剑+4,1d4+2穿刺
 
 ——提示（记录时请仅复制上方模板段并修改）——
 属性段六个数值依次对应: 力量/敏捷/体质/智力/感知/魅力
-额外加值段键 = 六属性/技能/豁免条目, 另有作用于全部豁免的全局键: 豁免
-额外加值取值 = 可选 优势/劣势 前缀 + ±掷骰表达式, 如: 隐匿:优势+2
-职业段填 12 职业名之一（如 游荡者），游荡者的偷袭后缀会按等级自动附加偷袭骰
+熟练段 = 六属性/技能/豁免条目/先攻
+额外加值段键 = 六属性/技能/豁免条目/豁免（作用于全部豁免）
+额外加值取值 = 可选 优势/劣势 ±掷骰表达式, 如: 隐匿:优势+2
 武器段格式 = 名称+命中加值,伤害表达式+类型（多项用 / 分隔），如 短剑+4,1d4+2穿刺
 :::
 
@@ -93,7 +102,7 @@ $武器$ 短剑+4,1d4+2穿刺
 | **`$属性$`** | 六个数值，用 `/` 分隔，依次对应 **力量 / 敏捷 / 体质 / 智力 / 感知 / 魅力**；<br>骰娘自动计算：调整值 = (数值 − 10) ÷ 2 向下取整 | **必填** |
 | `$生命值$` | `当前/最大(临时)`，如 `54/54`、`20/30 (5)`；<br>HP 结算改的是这里，见[生命值管理](./hp.md) | 可选 |
 | `$生命骰$` | `当前/总数 D骰面`，如 `5/5 D8`；长休按此回复生命骰 | 可选 |
-| `$熟练$` | 熟练条目，用 `/` 分隔；`2*隐匿` 为**专精**（双倍熟练），`0*隐匿` 显式关闭 | 可选 |
+| `$熟练$` | 熟练条目，用 `/` 分隔；`2*隐匿` 为**专精**（双倍熟练）；**先攻**也支持 | 可选 |
 | `$额外加值$` | 见[下节](#额外加值) | 可选 |
 | `$武器$` | 自定义武器/法术项：`名称+命中加值,伤害表达式+类型`（如 `短剑+4,1d4+2穿刺`），多项用 `/` 分隔；<br>名称尾加 `x` 表示不可攻击检定（如 `火球术x,8d6火焰`）；见[武器与攻击](./weapons.md) | 可选 |
 

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/dm-settlement.md

@@ -17,7 +17,7 @@
 ::: chat
 白鸦 | .hp 骷髅a;骷髅b;木乃伊易伤 -8d6
 屠龙骰 | 骷髅a: 当前HP减少[2+3+1+4+2+5+1+3]=21; HP:3/13 -> HP:0/13 昏迷
-骷髅b: 当前HP减少[2+3+1+4+2+5+1+3]=21; HP:6/13 -> HP:0/13 昏迷
+骷髅b: 当前HP减少[2+3+1+4+2+5+1+3]=21; HP:4/13 -> HP:0/13 昏迷
 木乃伊: 当前HP减少[2+3+1+4+2+5+1+3]=21（易伤加倍→42）; 损失HP:3 -> 损失HP:45
 
 注：小满去接水了，洛恩的火球术由 DM 代发；三大目标里只有木乃伊对火焰易伤。
@@ -93,6 +93,21 @@ HP:13/13 -> HP:9/13
 HP:9/13 -> HP:6/13
 :::
 
+一轮里打了两种伤害（两武器、法术 + 武器）时，把两件写进同一条命令即可：逐件掷伤 + 一行合计，扣血按合计值一次结算：
+
+::: chat
+白鸦 | .hp 骷髅b -刺剑伤害、匕首副手伤害（塔莉）
+屠龙骰 | 塔莉用【刺剑、匕首】造成了 9 点穿刺伤害：
+1. 塔莉用【刺剑】造成了 8 点穿刺伤害：
+1D8+4=[4]+4=8
+2. 塔莉用【匕首】造成了 1 点穿刺伤害（副手：不加任何加值）：
+1D4=[1]=1
+
+共计造成了 9 点穿刺伤害
+骷髅b: 当前HP减少[4]+4+[1]=9
+HP:13/13 -> HP:4/13
+:::
+
 ## 结算速记
 
 | 场景 | 写法 |
@@ -102,6 +117,7 @@ HP:9/13 -> HP:6/13
 | 玩家受伤（代结算） | `.hp @玩家 -4d6`（或名称写法 `.hp 角色名 -8`） |
 | 玩家治疗 | `.hp @玩家 +2d8+4` |
 | 代发武器伤害 | `.hp 骷髅b易伤 -火焰箭伤害（洛恩）` |
+| 代发两武器伤害 | `.hp 骷髅b -刺剑伤害、匕首副手伤害（塔莉）`（逐件掷伤 + 合计，扣血一次结算） |
 | 代玩家收尾 | `.长休 @玩家` |
 
 上一站：[代掷与代操作](./dm-proxy.md)；接下来：[查询范围](./query-scope.md)：开团前收窄本团可查的规则。

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/faq.md

@@ -72,11 +72,45 @@
 
 **两个按处设置**（群聊对该群全员生效、私聊仅影响本人；无需管理权限、设置持久保存）：
 
-- `.查询图片 on` / `off`：本处的词条正文用图片还是文字（需骰主先开启图片模式，未开启时开启会被拒绝并继续用文字）；
+- `.查询图片 on` / `off`：本处的词条正文用图片还是文字（需骰主先开启图片模式，未开启时开启会被拒绝并继续用文字）；骰主可用 `dnddicer_query_image_default` 让**未显式设置过的**私聊或群聊默认出图，用户仍可自己 `off` 改回文字；
 - `.查询范围 <缩写>`：把本处可查的书目收窄到指定几本（中文名与缩写对照见 `.规则书`，完整说明见[查询范围](./query-scope.md)），默认全部开放、`.查询范围 全部` 恢复。
 
 **收不到结果时分两种**：提示里带「查询范围为 …」= 被范围挡住，用 `.查询范围 全部` 放开；否则换个关键词、或改用 `.搜索` 全文检索。发送 `.查询` 收到「规则查询功能未开启，请联系骰主解决」= 骰主尚未开启该功能（群聊里即使已开启查询，也仍受本群服务开关管辖）。
 
+## 联系骰主
+
+遇到问题、想提建议，用 `.master <消息>` 发给骰主：**群聊与私聊都可以用**，骰娘收到后私聊转达给骰主，转发内容带上你的群号与 QQ 号（群名片优先），方便骰主定位。发送者看到的回执：
+
+::: chat
+小鹿 | .master 先攻列表的顺序好像不对，能看看吗
+屠龙骰 | 已发送给骰主，感谢反馈。
+
+注：以下内容发生在私聊对话框
+
+小满 | .master 火球术的伤害好像少算了一次
+屠龙骰（私聊） | 已发送给骰主，感谢反馈。
+:::
+
+骰主在私聊里收到的就是上面两条反馈（转发先行，回执随后）：
+
+::: chat
+注：以下是骰主与骰娘的私聊对话框
+
+屠龙骰（私聊） | 【骰娘反馈】来自群 76000001（小鹿 / QQ 76010006）
+先攻列表的顺序好像不对，能看看吗
+屠龙骰（私聊） | 【骰娘反馈】来自私聊（QQ 76010003）
+火球术的伤害好像少算了一次
+:::
+
+几条约定：
+
+- 消息上限 **200 字**，超出截断并在转发末尾标注「（已截断）」；
+- 同一人 **60 秒最多一条**，发太快会提示还需等待多少秒；
+- 骰主可在 `.help 联系` 里留下联系方式与交流群（两项都由骰主配置，没配就不显示）；
+- 骰主没配 QQ 号时回「骰主未配置，暂时发不出去。」；骰娘不在骰主好友列表时回「消息没能发出去，骰主可能还没加骰娘好友。」。
+
+骰主侧的配置方法见[快速开始 - 联系骰主](./quickstart.md#联系骰主)。
+
 ## 与宿主机器人协同
 
 ### 命令起始符（骰主可改）

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/hp-advanced.md

@@ -6,7 +6,7 @@
 
 ## 用卡上的武器掷伤害（.hp -X伤害）
 
-伤害位置直接写角色卡 `$武器$` 段里的武器名，骰娘用**发送者本人**的角色卡取出该武器，掷出伤害并同时扣血；`副手` / `重击` / `偷袭` 后缀与 `±` 临时加值都支持（如 `-战锤重击伤害+1d4`），不必每次手写算式：
+伤害位置直接写角色卡 `$武器$` 段里的武器名，骰娘用**发送者本人**的角色卡取出该武器，掷出伤害并同时扣血；`副手` / `重击` / `偷袭` 后缀与 `±` 临时加值都支持（如 `-战锤重击伤害+1d4`），不必每次手写算式（武器名支持模糊匹配，见[武器与攻击](./weapons.md)）：
 
 ::: chat
 阿岩 | .hp 骷髅a易伤 -战锤伤害
@@ -28,6 +28,23 @@ HP:13/13 -> HP:3/13
 
 DM 代不在场的玩家结算时，把**武器来源**写在尾部括号里（角色名支持模糊匹配、中英文括号皆可，也可以直接 @玩家）；完整代发说明见[血量与伤害结算](./dm-settlement.md)。
 
+两把武器也能一条命令打完：伤害位置与 `.X伤害` 同款支持多项写法（用 `、`/`，`/`/` 分隔，各件的后缀与加值各写各的），逐件掷伤后接一行合计，再扣血：
+
+::: chat
+白鸦 | .hp 骷髅b -刺剑伤害、匕首副手伤害（塔莉）
+屠龙骰 | 塔莉用【刺剑、匕首】造成了 9 点穿刺伤害：
+1. 塔莉用【刺剑】造成了 8 点穿刺伤害：
+1D8+4=[4]+4=8
+2. 塔莉用【匕首】造成了 1 点穿刺伤害（副手：不加任何加值）：
+1D4=[1]=1
+
+共计造成了 9 点穿刺伤害
+骷髅b: 当前HP减少[4]+4+[1]=9
+HP:13/13 -> HP:4/13
+
+注：伤害位置写多项时，`/` 仍按「多武器」解析（末项没写「伤害」会提示写法，不会当成「当前/最大」去改血）。
+:::
+
 ## 长休（.长休）
 
 一次长休结算三件事：**HP 回复至上限**、**临时 HP 清零**（有剩余时会提示失效）、**回复一半生命骰**（回复量为总数的一半向下取整、至少 1，且不超过总数）：

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/overview.md

@@ -4,7 +4,7 @@
 
 本页是全量速查：先在[功能一览](#功能一览)挑功能、读[名称显示规则](#名称显示规则)与 [@ 提及目标](#提及目标-dm-代操作)了解通用约定，再到[命令总表](#命令总表)查写法；不知从哪下手就按[开始使用](#开始使用)的三步走。
 
-> **版本**：v0.4.2。规则范围：**仅支持 DND5e/5r**。安装与配置见 [快速开始](./quickstart.md)。
+> **版本**：v0.4.4。规则范围：**仅支持 DND5e/5r**。安装与配置见 [快速开始](./quickstart.md)。
 
 ## 功能一览
 
@@ -100,12 +100,13 @@ HP:12/12 -> HP:5/12
 | `.xx检定`（属性/技能/先攻） | 如 `.力量检定`、`.2#察觉检定+1` | 仅群聊 |
 | `.xx豁免` | 属性豁免检定点命令，如 `.体质豁免+d4`、`.感知豁免优势` | 仅群聊 |
 | `.xx检定/豁免 … @玩家` | 表达式右侧加 @ 代掷（用目标角色的属性/熟练/加值） | 仅群聊 |
-| `.武器名攻击` / `.武器名命中` | 用卡上该武器的命中加值掷攻击检定（如 `.刺剑攻击优势`、`.2#刺剑攻击+2`、`.刺剑攻击 @玩家`） | 仅群聊 |
-| `.武器名伤害` | 掷该武器伤害并报出类型；后缀 `副手`/`重击`/`偷袭` 可组合（如 `.刺剑重击偷袭伤害`），尾部可加 `±` 临时加值（如 `.火球术伤害+1d6`） | 仅群聊 |
-| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 删除，多个用 `/` 分隔；`.设置武器` 无参数列出） | 仅群聊 |
+| `.武器名攻击` / `.武器名命中` | 用卡上该武器的命中加值掷攻击检定（如 `.刺剑攻击优势`、`.2#刺剑攻击+2`、`.刺剑攻击 @玩家`；武器名支持模糊匹配） | 仅群聊 |
+| `.武器名伤害` | 掷该武器伤害并报出类型；后缀 `副手`/`重击`/`偷袭` 可组合（如 `.刺剑重击偷袭伤害`），尾部可加 `±` 临时加值（如 `.火球术伤害+1d6`）；武器名支持模糊匹配 | 仅群聊 |
+| `.武器名伤害、武器名伤害` | 一次结算多件武器（`、` / `，` / `/` 分隔，各件的后缀与加值各写各的），逐件掷伤 + 合计；攻击同理（`.刺剑攻击、匕首攻击`） | 仅群聊 |
+| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 按名称删除，名称支持模糊匹配，多个用 `/` 分隔；`.设置武器` 无参数列出） | 仅群聊 |
 | `.先攻检定` / `.先攻检定 @玩家` | 掷先攻并自动写入本群先攻列表（@ 形式以该玩家为归属入表） | 仅群聊 |
 | `.hp [对象] 20/30 (5)` | 设置自己 / 队友 / NPC 的 HP（含临时 HP） | 仅群聊 |
-| `.hp [对象] -10` / `+2d6` | 伤害 / 治疗（支持掷骰表达式与临时 HP；伤害位置可直接写 `-X伤害` 用卡上武器项，括号可指定来源代发） | 仅群聊 |
+| `.hp [对象] -10` / `+2d6` | 伤害 / 治疗（支持掷骰表达式与临时 HP；伤害位置可直接写 `-X伤害` 用卡上武器项，支持多武器写法，括号可指定来源代发） | 仅群聊 |
 | `.hp @玩家 …` / `.hp @玩家` | 对 @ 的玩家角色卡结算 / 查看（@ 与名称可混写） | 仅群聊 |
 | `.hp` / `.hp list` | 查看自己 / 本群列表（PC 在前、NPC 在后） | 仅群聊 |
 | `.hp del 名称` / `.hp clr` | 删除单个 / 清空全部 NPC 血量记录（玩家角色卡请用 `.角色卡清除`） | 仅群聊 |
@@ -139,7 +140,7 @@ HP:12/12 -> HP:5/12
 | `.查询单位 <名称>` | 查单位换算小节（长度 / 重量 / 温度 / 体积 / 货币） | 群聊 / 私聊 |
 | `.查询 <关键词>` | 按名称检索《5e不全书》（`.q`）；**多关键词**：空格=同时满足、`\|`=或；唯一命中**直接出词条**、多个候选**回数字看词条**（多于一页时 `+` / `-` 翻页；60 秒内有效、只认发起者本人） | 群聊 / 私聊 |
 | `.搜索 <关键词>` | 全文检索（`.s` / `.检索`），适合记不清名称时；关键词写法与 `.查询` 相同 | 群聊 / 私聊 |
-| `.查询图片 [on/off]` | 查看 / 切换**本处**的词条图片显示（群聊按群、私聊按本人）；需骰主先开启图片模式，否则报错并仍以文字显示 | 群聊 / 私聊 |
+| `.查询图片 [on/off]` | 查看 / 切换**本处**的词条图片显示（群聊按群、私聊按本人）；需骰主先开启图片模式，否则报错并仍以文字显示；没设置过的地方按骰主配置的默认形态 | 群聊 / 私聊 |
 | `.查询范围 [缩写…]` | 查看 / 收窄**本处**可查询的书目范围（如 `.查询范围 PHB24,MM25`；`.查询范围 全部` 恢复）；不设置即全部开放 | 群聊 / 私聊 |
 | `.规则书` | 列出可设置的书目缩写与中文名对照（`.qbooks`；骰主开启图片模式时默认出图） | 群聊 / 私聊 |
 
@@ -159,8 +160,17 @@ HP:12/12 -> HP:5/12
 
 | 命令 | 说明 | 场景 |
 | --- | --- | --- |
-| `.帮助` / `.help` | 命令总览 | 群聊 / 私聊 |
-| `.help <命令>` | 指定命令的详细用法（如 `.help r`、`.帮助 战斗轮`） | 群聊 / 私聊 |
+| `.帮助` / `.help` | 帮助总览：版本、开关骰娘与各入口指引 | 群聊 / 私聊 |
+| `.help 命令` | 命令目录：7 组各一行（掷骰 / 角色 / 武器 / 生命 / 先攻 / 查询 / 管理） | 群聊 / 私聊 |
+| `.help <组名>` | 该组命令清单（如 `.help 生命`、`.help 先攻`） | 群聊 / 私聊 |
+| `.help <命令>` | 命令详情（如 `.help r`、`.help hp`；检定点与武器命令写 `.help 力量检定`、`.help 刺剑伤害`） | 群聊 / 私聊 |
+| `.help 链接 [on/off]` | 相关链接；并切换本处帮助回复是否附带文档站链接行（群聊默认关、私聊默认开） | 群聊 / 私聊 |
+| `.help 关于` | 插件版本、项目地址与交流群 | 群聊 / 私聊 |
+| `.help 骰主` | 骰主专用指令清单 | 群聊 / 私聊 |
+| `.help 联系` | 联系骰主的方式（骰主可留联系方式与交流群，未配置则不显示） | 群聊 / 私聊 |
+| `.master <消息>` | 把问题或建议发给骰主：骰娘私聊转达（附群号与 QQ 号；单条 200 字、同一人 60 秒一条） | 群聊 / 私聊 |
+
+帮助回复末尾会附一行「帮助文档：<地址>」，地址指向该命令或该组**对应的文档页**（没有对应页时给站点首页），从聊天里一步跳到相关章节；这行由 `.help 链接 on/off` 按群 / 私聊分别控制，**群聊默认关闭、私聊默认开启**。
 
 ## 开始使用
 

{nonebot_plugin_dnddicer-0.4.2 → nonebot_plugin_dnddicer-0.4.4}/docs/guide/query.md

@@ -198,7 +198,7 @@ DM 还可以给每个群限定**可查的书目**，只开放本团允许的那
 
 ## 图片显示：`.查询图片`
 
-词条正文默认以文字发送，若骰主开启图片模式（并装好可选渲染依赖）后，用户可以自己决定本群或本私聊要不要图片：
+词条正文默认以文字发送；骰主开启图片模式（并装好可选渲染依赖）后，用户可以自己决定本群或本私聊要不要图片：
 
 | 命令 | 作用 |
 | --- | --- |
@@ -206,9 +206,13 @@ DM 还可以给每个群限定**可查的书目**，只开放本团允许的那
 | `.查询图片 on` | 本处的词条正文改为卡片图 |
 | `.查询图片 off` | 本处改回文字 |
 
-「骰主总开关」与「本处开关」是**两级**关系：
+图片的「能不能用」与「没设置过的地方默认用不用」由骰主配置，「本处用不用」由用户自己决定：
 
-总开关决定**能不能用**图片，本处开关决定**本处用不用**（默认文字）。所以骰主没配置时，用户自己开是开不起来的，会明确报错并继续以文字显示：
+- **总开关**（`dnddicer_query_image_enabled`）决定**能不能用**图片：没开时用户自己开也开不起来，会明确报错并继续以文字显示；
+- **默认形态**（`dnddicer_query_image_default`，默认 `false`）决定**未显式设置过的**私聊或群聊初始用不用图片：设为 `true` 后群聊与私聊都默认出图，骰主可以用它把图片设为常态；
+- **本处设置**（`.查询图片 on` / `off`）决定**本处用不用**：一经写下就固定下来、不再随默认形态变化，群成员随时可以自己改回文字或改回图片。
+
+骰主没配置时（总开关未开或渲染依赖未装），用户自己开是开不起来的，会明确报错并继续以文字显示：
 
 ::: chat
 阿茶 | .查询图片
@@ -219,10 +223,12 @@ DM 还可以给每个群限定**可查的书目**，只开放本团允许的那
 注：报错说明骰主尚未开启图片模式（或未安装渲染依赖）；此时无论怎么设置都会以文字显示。
 :::
 
-设置无需管理权限、持久保存；候选列表与各类提示始终是文字，**只有词条正文出图**。
+设置无需管理权限、持久保存；候选列表与各类提示始终是文字，**只有词条正文出图**。骰主把默认形态设为图片后，没设置过的地方直接出图，用户用 `.查询图片 off` 就能单独改回文字，不必打扰骰主。
 
 开启图片模式的方法（渲染依赖与平台要求）见[快速开始 - 可选依赖项](./quickstart.md#可选依赖项)，骰主开关见[快速开始 - 规则查询](./quickstart.md#规则查询)。
 
+卡片里的中文字体由系统提供（fontconfig），插件的字体栈中文优先、中西文同源，这样同一行里的中英文才会字重与基线一致。若卡片里的中英文看着不齐、或者中文显示为方框，多半是服务器字体不全：用 `fc-list :lang=zh family` 看有哪些中文字体，`fc-match ':charset=0041'`（拉丁）与 `fc-match ':charset=56fd'`（汉字）看两者是否落在同一字体文件；装 `fonts-noto-cjk` 后重启骰娘即可，也可以用配置项 `dnddicer_query_image_font_family` 指定服务器上实际存在的家族。
+
 ## 查询范围：由 DM 收窄书目
 
 一个跑团群通常只开放核心书与几本扩展。`.查询范围` 可按处收窄本处可查的书目（群聊对该群全员生效、私聊按本人），**不设置就是全部开放**；设置命令、书目缩写对照表（`.规则书`）与整目录键（`3PP` / `FR` / `ADV` / `MISC`）见[查询范围](./query-scope.md)。
@@ -243,7 +249,7 @@ DM 还可以给每个群限定**可查的书目**，只开放本团允许的那
 
 两条纪律：
 
-- **仅骰主私聊可用**：群聊里发送不会有任何回应（也不向群成员暴露这条命令的存在），私聊里非骰主会收到一句提示；它也不会出现在 `.帮助` 的列表与详情里；
+- **仅骰主私聊可用**：群聊里发送不会有任何回应（也不向群成员暴露这条命令的存在），私聊里非骰主会收到一句提示；它不进任何命令清单（`.help 骰主` 会列出它，`.help 查询索引` 可查看它的详情）；
 - **重建在后台执行**：发完命令先收到「正在重建…」，完成后回报各类的条目数；站点不可达或解析异常时回报失败并**保留原索引**；若新构建的条目数明显偏少（不足旧值一半，疑似站点异常或改版），同样保留旧数据、不覆盖。
 
 ::: chat