更新日志

本文件按版本记录对外变化，分「新增 / 变更 / 修复 / 文档」四组，表述面向使用者（跑团玩家与 DM）。

[0.3.0] - 2026-09-25

新增

• 自定义武器与攻击系统：
  • 角色卡新增 $武器$ 段（名称+命中加值,伤害表达式+类型，多项用 / 分隔；名称尾加 x 表示不可攻击检定的纯伤害法术），并新增 $种族$ / $职业$ / $子职$ 段（游荡者的偷袭骰按等级自动计算）。
  • .武器名攻击 / .武器名命中：用卡上该武器的命中加值掷攻击检定，支持 优势/劣势、N# 连掷、± 临时加值与 @玩家 代掷；天然 20 提示重击、天然 1 提示必失。
  • .武器名伤害：掷该武器的伤害并报出伤害类型，副手 / 重击 / 偷袭 后缀可组合、可加 ± 临时加值。
  • .设置武器 / .删除武器：便捷维护卡上武器（列表查看、同名覆盖、多名称删除）。
• .hp 伤害位置支持武器写法：
  • .hp 骷髅a易伤 -战锤重击伤害+1d4 一条命令完成掷伤与扣血；回复先报「谁用【哪件武器】造成了多少伤害」，再列出各目标的扣血读数（单目标报实际结算值、含抗性/易伤折算；一发多目标报掷出的原始值）。
  • DM 代发不在场的玩家：尾部括号指定武器来源（.hp 骷髅b -火焰箭伤害（洛恩） 或 （@玩家），角色名支持模糊匹配）。

变更

• 属性攻击命令退役（破坏性变更）：.力量攻击 等六属性攻击命令整体移除，攻击检定统一走角色卡 $武器$ 项；$熟练$ 与 $额外加值$ 不再接受攻击条目（含全局「攻击」键），攻击加值一律折算进武器项。旧角色卡需重新登记：新版本读取旧卡会报错，发送 .角色卡清除 后重录即可。
• .bot 简介与插件描述补充「自定义武器与攻击」表述。

文档

• 使用文档站新增《武器与攻击》页，全站手册同步（检定与豁免、角色卡与属性、DM 实战指南、HP 与长休、命令总览与 FAQ 等）；示例团四张角色卡补齐武器与职业段，战斗示例统一到武器流程。

[0.2.2] - 2026-09-24

变更

• 定位表述统一：.bot 插件简介与插件元数据描述更新为「功能最全面、体验最好的 DND 骰娘」口径，清理旧的对齐式表述（掷骰引擎上游来源的致谢仅保留在许可位置）。

修复

• 掷骰说明文字按四则运算还原：修复算式说明里常量复合子表达式与一元负号的错位——如 .rd6+2*2 旧显示为 1D6+2*2=[4]*2+4=8（乘号挪用了骰块）、-1d6+3 丢负号、12/(1+2)、3*d6 同类错显；说明文字现与表达式结构一一对应，骰子结果与取骰规则不变。
• 私聊下的群聊限定命令不再静默：角色卡、检定/豁免/攻击点、HP、先攻与战斗轮等按群归属的命令在私聊中发送时，会如常收到「该指令仅在群聊中可用。」提示（此前部分命令族没有回应）。
• .bot 私聊回应文案修正：不再写「私聊可直接使用本插件的全部功能」，改为如实说明私聊可用范围（掷骰、属性生成、.帮助 等可用；角色卡、检定、HP、先攻与战斗轮、群配置等仅限群聊）。

文档

• 使用文档站上线：手册式 15 页（快速开始、三章教程、参考组、更新日志），配固定示例团的真实取证示例；推 v* 标签时自动构建并部署到 GitHub Pages。
• README 改为手册式目录并挂文档站入口；全站正文统一骰记法（D20 等）与命令示例的最简写法。

[0.2.1] - 2026-09-22

新增

• @ 提及目标（DM 代操作）：.hp、.npc、.ri、.init del|first|swap、.回合、.角色卡（可查看他人整卡，记录/清除仍仅限本人）、.状态、.长休 以及各检定点命令（含 .先攻检定）均可直接 @ 某位玩家，作用于其角色卡或先攻条目；游离的 @ 会被拦截并提示，不再静默按自己处理（此前 .hp @玩家 -d4 会误扣自己血量）。
• 玩家名称显示统一：凡是需要显示玩家名的场景（.r/.rh、.dnd/.dndx、检定反馈、.hp、.ri 入表名等）统一按「角色卡名 → 群名片 → QQ 昵称 → 未知玩家（QQ号）」回退，末端兜底附带 QQ 号，便于 DM 定位是谁。

变更

• .hp del / .hp clr 语义修订为仅作用于 NPC 血量：del 删除指定 NPC（支持 / 分隔多名称）、clr 清空本群全部 NPC 血量（含跨战斗保持的）；无对象时只提示用法，目标解析到玩家角色卡时改为引导使用 .角色卡清除，不再直接删除整张角色卡。

修复

• 优势/劣势别名粘连：.rd劣势20+6 这类面数错序写法不再被静默改写成错误骰式，改为报错引导；K/KL 取点超量时给出报错而非错误结果。
• .hp 目标匹配改为完全匹配优先（与 .init 一致）：修复「地精」与「熊精」并存时 .hp 地精 命中错对象、.hp del 地精 删不掉的问题。
• 伤害/治疗结算最低为 0：修复伤害掷出负值后经抗性/易伤计算反而变成回血的问题；治疗为 0 时不再触发昏迷唤醒。
• .hp 目标未命中时补充引导提示（新建 NPC 需先加入先攻表才能设置 HP）；回满提示中的命令独立成行，便于直接复制。

文档

• README 命令表与使用文档（角色卡 / HP 管理 / 先攻列表 / 战斗轮 / 快速开始）补充 @ 用法与示例。

[0.2.0] - 2026-09-21

新增

• NPC / 怪物血量：.hp 目标搜索扩展为三层（玩家角色卡 → NPC 血量 → 先攻表，NPC 经先攻表按需建立记录）；先攻列表与 .hp list 显示 NPC 血量，.hp del 支持指定对象；.init clr / .br 清理未设最大值的临时血量，.init del 连带删除对应记录。
• NPC 血量自动回满与跨战斗保持：同名 NPC 以新条目加入先攻表时自动回满并给出提示（同一场战斗内重掷不触发）；.npc 持久 / .npc 临时 控制血量是否跨战斗保持。
• .dndx 属性名绑定掷点：4D6K3 掷点后将六项数值按固定顺序绑定力量/敏捷/体质/智力/感知/魅力（不降序排列，掷出即定配对，可直接抄入角色卡），与 .dnd 并存。

修复

• .dnd 原因参数不再被静默丢弃：首词不是数字时整段视为原因（如 .dnd 开卡），分隔符放宽为任意空白。

文档

• HP 管理新增「NPC / 怪物血量」章节；先攻列表、战斗轮、FAQ、命令总表与 README 同步。

[0.1.1] - 2026-09-10

修复

• 依赖下限放宽至 NoneBot2 ≥ 2.4.0：兼容仍运行 2.4.x 的宿主（已在 2.4.0 环境实测全量测试通过）。

[0.1.0] - 2026-09-10

首个公开版本：第一期功能全部落地。

新增

• 掷骰：.r / .rh——优势/劣势、保留最高、重掷、爆炸骰、连掷、暗骰、原因后缀、群默认骰面；仅 D20 出目 20/1 播报大成功/大失败。
• 角色卡与检定：.角色卡 / .状态（$…$ 模板建卡，.角色卡模板 输出模板）；检定/豁免/攻击点命令自动代入调整值、熟练与额外加值。
• 属性生成：.dnd（4D6K3 掷点）。
• HP 管理与长休：.hp（查看 / 结算 / 列表 / 删除）、抗性/易伤与 AOE 伤害掷骰、.长休。
• 先攻列表：.init（子指令）、.ri、.先攻，.先攻检定 与角色卡联动。
• 战斗轮：.br / .ed / .回合 / .轮次。
• 群配置与帮助：.dset 群默认骰面、.帮助 / .help、.bot 插件信息与群聊服务开关（群聊默认关闭，需 @ 机器人触发）。