v2.1.0

🎲 更新日志

• 支持通过模板创建玩家人物卡

  此前模板仅用于在场景面板中创建 NPC 或敌人。本次更新允许在创建玩家人物卡时也使用模板。导入的属性或技能在未指定时，将使用模板的数值填充。

  

  此外，也可以根据现有的人物卡创建模板。这可用于实现人物卡的复制功能。

  

• 人物卡模板数值支持骰子表达式

  在编辑人物卡模板时，数值栏位支持输入骰子表达式。在根据模板初始化人物卡时，会使用表达式随机出值。

  

• 支持通过指令创建/删除人物卡

  创建人物卡：.pc new [模板名] [人物卡名]

  模板名可使用 coc/dnd/简单 或任意人物卡模板的名字。省略即使用设置中的默认人物卡模板。

  人物卡名省略即使用当前用户昵称。

  

  在【配置】→【特殊指令】中，可设置创建人物卡的默认模板。

  

  删除人物卡：.pc del [人物卡名]

  人物卡名省略即使用当前玩家关联的人物卡。

  模板名和人物卡名都支持模糊搜索，无需输入全名，可以查找到唯一匹配的人物卡。

• 代骰支持未关联玩家的人物卡

  此前代骰仅支持 @ 玩家和已关联玩家的人物卡名，本次更新支持 @ 任意人物卡名代骰。

• 修复发送本地图片存在中文路径时报错的问题

• 其他优化与问题修复

---

感谢 我想长高 的发电支持！

请根据自己的操作系统选择对应的文件下载。

v2.0.1

修复牌堆引用失效问题。

可下载新版本

或基于 2.0.0 版本，下载插件 zip 文件，解压至 plugins 文件夹下，覆盖原有文件即可。

v2.0.0

🎲 更新日志

大家久等了，由于下半年工作持续繁忙，只能断断续续做点更新。这次发布 2.0 正式版本，更新内容如下：

• 支持场景&战斗面板的实时同步

  重构了场景模块的数据同步方式。现在地图与战斗信息保存在数据库中，并支持实时同步。意味着如果你多开浏览器 tab，或把机器人部署在公网，多人同时登录同个频道，可以实时地看到地图的变更。

  

  在战斗面板新建 NPC/怪物时，若为它们初始化了新的人物卡，人物卡会同时新增在”人物卡“ tab 下，并和玩家人物卡一样支持实时同步。

  注：受重构影响，旧版本的场景数据不再保留。如果有旧的还在使用中的场景，建议先不升级，或升级后手动迁移。

• 机器人支持发送本地图片

  当图片路径不以 http/https 开头时，视为发送本地图片。格式形如：<img src="logo.png" />

  

  图片需事先放在指定的目录下：

  • 自定义回复：程序同级目录的 images 文件夹下
  • 插件：插件文件夹目录下
  • 牌堆：与牌堆 JSON 文件同级

• 支持通过 satori 协议，连接到更多的平台

  较为高阶的功能，使用示例详见文档对应章节

• 网页多开和刷新后支持自动登录机器人，保留当前的状态

  close #14

  可在左上角菜单中手动退出登录

  

• 自定义检定规则支持判断 dnd d20 原值

  自定义检定规则增加 firstD20 变量，代表 dnd 规则中 d20 的掷骰结果，可用于判断暴击/miss 等。示例：

  

• 修复配置排序等问题

---

感谢 九牛、flamingo、茜茜 的发电支持！

请根据自己的操作系统选择对应的文件下载。

v2.0.0-alpha.6

QQ 群支持

接入方式

在 QQ 开放平台，机器人后台页面中，选择【沙箱配置】菜单。在【QQ 群 ID】选项中选择你要使用的 QQ 群。

在手机 QQ 中，打开 QQ 群的设置页面，找到【群机器人】菜单。点击菜单打开机器人列表，找到你的机器人（通常在列表底部），点击添加即可。

QQ 群的能力限制

由于官方接口能力不足，在 QQ 群中使用机器人会有许多限制之处。请大家在使用前了解以下限制，以提前避免不必要的疑问和困扰。

不支持获取机器人所在群的信息

影响：首次登录机器人时，在频道选择页面，需要用户在群里手动 @ 一次机器人，群的信息才会显示在列表中。且只能获取群的 OpenID，无法获取群名称和头像。

只能监听到用户 @ 机器人的消息

影响：用户必须 @ 机器人才能收到指令。log 记录无法记录没有 @ 机器人的普通消息

机器人无法获取用户的昵称

影响：机器人回复的消息和后台的用户选择器中，用户的昵称默认显示为 OpenID

为了解决这个问题，我们提供了三种方式：

1. 可以在后台为每个用户单独设置昵称

2. 用户可以在群内使用 nick 指令设置昵称

3. 当用户使用 nn 指令关联人物卡时，若用户没有昵称，会将人物卡名称作为用户的昵称

机器人无法获取回复消息和表情表态

影响：无法使用对抗检定和表情表态掷骰

机器人无法获取消息中 @ 其他人的内容

影响：无法使用常规的代骰

替代方案：在 QQ 群中不要直接 @ 他人（蓝字的 @），可以改用纯文本的 @。可以 @ 人物卡名或用户的昵称

注：@ 人物卡名时，目前限制只能 @ 到已关联了玩家的人物卡。后续会优化开发 @ npc 人物卡的功能

机器人回复的消息会开头强制 @ 发送者，且不支持其余的 @

影响：自定义回复和自定义文案中的 {{at用户}} 会被吞。建议使用 {{用户名}} 或 {{人物卡名}} 替代。

机器人私聊需配置白名单

影响：暗骰和私聊机器人需要额外配置才能生效，否则机器人无法向用户发送私信消息。

配置方式：

首先登录 QQ 机器人后台，在【沙箱配置】-> 【在消息列表配置】中添加可以和机器人私聊的用户。

其次，用户在 QQ 中打开机器人的资料卡，点击【发消息】按钮，向机器人发送任意私聊消息。（只有在机器人后台添加了这个用户，才会出现发消息按钮）

完成后检查这个用户的好友列表，在【机器人】tab 下应会出现这个机器人了。只有与机器人成为好友，机器人才可以向用户发消息。若未完成此步骤，机器人发消息会出现 消息发送失败, 无好友关系 错误提示。

机器人私聊主动消息限制每月 4 条，且不支持使用群消息 ID 发送被动消息

影响：暗骰消息容易发送失败。若发送失败（命令行出现 主动消息超过频率限制 等报错），可尝试在私聊中主动向机器人发一条消息，即可在 5min 内再次接收机器人的私信。

v2.0.0-alpha.5

数据库 & 同步机制重构一期

省流：现在人物卡和配置无需手动点击保存。修改后输入框失焦即会自动保存

---

修改后的机制允许更细粒度地加载和更新数据，简化操作且降低了修改冲突的概率。

新的数据会使用数据库存储，保存在 db 文件夹下。数据库的内容人类不可读，请勿随意修改。

如需查看内容，可在网页左上角菜单点击【导出数据】按钮导出 zip（暂不支持直接向数据库导入数据）

---

感谢 一起一起这里那里 的发电支持！

v2.0.0-alpha.4

• 修复表情表态掷骰未遵循用户输入的问题

v2.0.0-alpha.3

• 修复由于 QQ 文字子频道分组改变，导致创建子频道失败的问题
• 优化公网 IP 获取

v2.0.0-alpha.2

• 修复人物卡未正确保存的问题

v2.0.0-alpha.1

本次更新主要对项目进行重构，以提升可维护性。涉及到用户的功能改动如下：

• 支持在机器人登录时创建文字子频道。

由于 QQ 频道改版导致现在难以创建文字子频道。现在我们可以尝试使用机器人 api 进行创建。

• 私信场景支持使用部分自定义回复。自定义回复的内容读取自默认配置。
  同时插件新增了 sendMessage API，可代替原有的 sendMessageToXXX，自动根据不同场景将回复发送到频道或私信中。

• 网页 UI 库的更新升级，新增两套新的主题。
  若主题切换功能无法正常使用，请升级浏览器到 Chrome/Edge 的最新版本。

其他：

• 升级部分底层依赖
• 项目结构重构为 monorepo

---

感谢 鹿鹿子、爱发电用户_25285 的发电支持！

v2.0.0-alpha.0

功能更新：

• 升级到 QQ 机器人 v2 api（登录需传入 AppSecret）
• 新增 KOOK 平台支持

• 支持在自定义回复配置中，使用 <img> 语法发送图片消息

其他：

• 升级部分底层依赖
• 开发环境现在需要 nodejs 18+
• 构建从 ncc 迁移到 esbuild，以提升速度 & 绕过 ncc 不转译第三方库 js 的问题

已知问题：

• 由于适配缘故，暂时下线重要笔记功能支持
• 权限相关设置项对 KOOK 平台不起作用
• 受第三方库影响，暂不支持 Windows7 系统

---

感谢 兔兔子、爱发电用户_6VXj 的发电支持！