帮助与语言

Dice!Next 内置一套统一的帮助注册表：内置指令说明、规则包词条、插件注册的帮助、以及可自定义的帮助文档都汇入同一个 .help，还可以按群锁定搜索域、切换回复语言。

查帮助 `.help`

.help              → 指令总览菜单
.help ra           → 查看某条指令 / 某个词条的帮助（.help .ra 也行）
.help 克苏鲁       → 词条不限于指令，规则速查、牌堆说明等都能查
.help on / off     → 群管理开启 / 关闭本群帮助指令（持久保存）

总览菜单按用途分组：投骰、检定、人物卡、生成、牌堆、娱乐、管理、账号。

帮助的排版

最新 main 的无参数 .help 默认末尾增加以下两行反馈入口（75ec20d，尚未进入 beta.925）：

text

Dice!Next 测试群：933145116
如有故障或建议欢迎加群反馈

只调整默认主帮助文案，不影响 .help <指令> 查询；骰主已有的帮助自定义覆盖继续优先，不会被强制替换。

内置指令帮助统一为「标题行 + 一行一个指令 + // 说明」，补充说明另起一行放在末尾。参数写法为 <必填>、[可选]。空指令（例如只发 .log）给出的用法提示用同一套排版：

录卡 .st
.st <属性><值> // 录入或修改属性，如 .st 力量50 敏捷60
.st <属性>±<值> // 增减属性，支持骰子，如 hp-2、理智+1d3
.st show // 查看当前人物卡
.st clr // 清空人物卡
.st del <属性> // 删除某项属性
DND 钱币支持 pp/gp/ep/sp/cp，扣款自动换开。

四种界面语言各自维护这套文案，切换语言（见下文 .lang）会同时切换帮助的语言。

词条支持模糊匹配：唯一命中直接显示；多个候选会列出让你挑；找不到会提示。
帮助来源（按统一注册表汇总，重名自动去重）：
1. 内置指令说明；
2. 规则包自带的帮助词条（本群激活的规则包，其同名词条优先生效）；
3. 插件（JS / Lua）注册的帮助；
4. 帮助文档（data/helpdoc/ 与各规则包 helpdoc/ 目录下的 JSON）。
超长的帮助内容会自动分段发送。

溯洄引用

帮助词条内容支持溯洄格式函数：{词条} 展开另一个词条的内容（可递归），[{%_1D3}*10] 这类含 {} 的方括号块会当算式求值；不含 {} 的 [示例] 保持原样。牌堆卡面也支持同一套引用语义（见牌堆）。

自定义帮助 `.helpdoc`

.helpdoc <词条> 与 .help <词条> 等价；不带词条时给出使用提示（完整条目请到网页后台「帮助文档」页浏览 / 搜索）。

自定义帮助文档放在 data/helpdoc/ 目录（*.json，兼容海豹 SealDice 帮助文档格式）：

json

{
  "mod": "我的速查",
  "brief": "一句话简介",
  "helpdoc": {
    "词条名": "词条内容",
    "别名": "&词条名"
  }
}

值以 & 开头表示别名（指向另一词条）。规则包也可以在包内 helpdoc/ 目录随包分发帮助，词条来源会标成 <包名>/<mod>。

默认来源 `.helpdoc default`

多个来源有同名词条时（例如 dnd3r 与 dnd5r 都有「猫头鹰熊」），可指定优先来源：

.helpdoc default           → 查看当前默认来源与可选来源
.helpdoc default dnd5r     → 同名词条优先用 dnd5r
.helpdoc default clear     → 取消（恢复按加载顺序）

搜索域 `.helpdoc scope`

比默认来源更强：把本群的帮助搜索锁定在某个来源内，其余来源的词条一律过滤（内置指令说明仍保留）。适合跑某个特定规则时防止查到别家内容：

.helpdoc scope coc7包      → 本群 .help 只查该来源
.helpdoc scope clear       → 解除锁定
.helpdoc scope             → 查看当前搜索域

Web 管理

在 Web 管理面板的「帮助文档」页可以浏览、搜索全部帮助词条，并可视化编辑自定义帮助文档。

语言切换 `.lang`

骰子回复支持四种内置语言：简体中文 / 繁体中文 / English / 日本语。群管理可切换本群语言，私聊里则切换你自己的：

.lang                  → 查看当前语言与用法
.lang 繁體             → 切换（简体 / 繁體 / en / 日本語 及各种常见别名都能识别）
.lang clr              → 清除覆盖，恢复默认

自定义语言包

把翻译文件 <语言码>.json 放进 i18n/ 目录即可自动加载为新语言；包内的 _meta.keywords 声明这门语言的切换关键词（之后 .lang <关键词> 就能切过去）。目录里附带 _custom_language_example.json 模板可供参考，改内置语言的个别文案同理。

AI 翻译语言

如果 .lang 的参数既不是内置语言也没有对应翻译文件，还会查骰主在 AI 设置中登记的 AI 翻译语言：命中后该窗口的回复会在发送前由大模型实时翻译成目标语言（回复会稍有延迟，且骰点数字保证不被改动）。详见 AI 功能。

帮助与语言 ​

查帮助 .help ​

帮助的排版 ​

溯洄引用 ​

自定义帮助 .helpdoc ​

默认来源 .helpdoc default ​

搜索域 .helpdoc scope ​

Web 管理 ​

语言切换 .lang ​

自定义语言包 ​

AI 翻译语言 ​