404
页面不存在
这 是 四 零 四 !
无论是普通用户还是开发者，我们都非常欢迎你参与海豹的开发，一起努力让海豹变得更好。
海豹的所有源代码都托管在 海豹开源组织 GitHub 下，每个模块都存放在对应的仓库中，可阅读对应仓库的 Readme 获取更多信息。
几个比较重要的仓库：
所有的 Bug 和功能建议都可反馈在 核心 仓库的 issue 中，按照模板填写可方便开发组快速定位问题。
无法访问 GitHub？
受限于各种原因，不是所有人都能顺利访问 GitHub，如有 Bug 可以加入官方群进行反馈。但如果有条件，我们还是建议在 GitHub 向开发组反馈问题。
欢迎各种类型的 pr 提交，可以帮助改进代码，增加功能，也可以是完善文档等等。向对应仓库发起 pr 即可。
进行使用即代表同意此声明：
尊敬的用户，欢迎您选择由木落等研发的海豹骰点核心（SealDice），在您使用海豹骰点核心前，请务必仔细阅读使用须知，使用即代表您已同意使用须知的内容，使用造成的任何后果与海豹开发组无关。
您需了解，海豹核心官方版只支持 TRPG 功能，娱乐功能定制化请自便，和海豹无关。
您清楚并明白您对通过骰子提供的全部内容负责，包括自定义回复、非自带的插件、牌堆。海豹骰不对非自身提供以外的内容合法性负责。您不得在使用海豹骰服务时，导入包括但不限于以下情形的内容：
(1) 反对中华人民共和国宪法所确定的基本原则的；
(2) 危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的;
(3) 损害国家荣誉和利益的;
(4) 煽动民族仇恨、民族歧视、破坏民族团结的；
(5) 破坏国家宗教政策，宣扬邪教和封建迷信的;
(6) 散布谣言，扰乱社会秩序，破坏社会稳定的；
(7) 散布淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的；
(8) 侮辱或者诽谤他人，侵害他人合法权益的；
(9) 宣扬、教唆使用外挂、私服、病毒、恶意代码、木马及其相关内容的；
(10) 侵犯他人知识产权或涉及第三方商业秘密及其他专有权利的；
(11) 散布任何贬损、诋毁、恶意攻击海豹骰及开发人员、海洋馆工作人员、mod 编写人员、关联合作者的；
(12) 含有中华人民共和国法律、行政法规、政策、上级主管部门下发通知中所禁止的其他内容的。
一旦您有以上禁止行为，请立即停用海豹骰。
本节内容
本节将展示复杂文案的编写技巧，请善用侧边栏和搜索，按需阅读文档。
在文案中通常会有结果变量，通过对结果变量的判断来实现展示不同文案。如修改 .r 骰点_单项结果文本 文案为例
{$t表达式文本}{$t计算过程}={$t计算结果}{%
+$t计算结果 == 100 ? " 乐！",
+$t计算结果 == 1 ? " 啧！"
+%}
+展示：
.r
+回复：<测试人员>掷出了 D100=1 啧！
+
+.r
+回复：<测试人员>掷出了 D100=100 乐！
+正则匹配：mode switch(.*)
回复：
{%
+if $t1==""||$t1==" 默认" {$g文案模式 = 0; $t输出="默认模式启用"};
+if $t1==" 模式1" {$g文案模式 = 1; $t输出="模式1启用"};
+if $t1==" 模式2" {$g文案模式 = 2; $t输出="模式2启用"};
+if $t1!=""&&$t1!=" 默认"&&$t1!=" 模式1"&&$t1!=" 模式2" {$t输出=`不存在指定模式{$t1}`};
+$t输出
+%}
+精确匹配：mode show
回复：
{%
+$g文案模式==0 ? "当前在默认模式",
+$g文案模式==1 ? "当前在模式1" ,
+$g文案模式==2 ? "当前在模式2"
+%}
+按如下模式调整你的自定义文案项：
{
+if $g文案模式 == 0 {$t目标文案 = `（这里填你个性化的默认模式文案）`};
+if $g文案模式 == 1 {$t目标文案 = `（这里填你个性化的模式1文案）`};
+if $g文案模式 == 2 {$t目标文案 = `（这里填你个性化的模式2文案）`}
+}{$t目标文案}
+以修改了 .jrrp 的文案为例：
mode show
+输出：默认模式启用
+
+mode switch 模式1
+输出：模式1启用
+
+mode show
+输出：当前在模式1
+
+.jrrp
+输出：（这里填你个性化的模式1文案）
+
+mode switch 模式2
+输出：模式2启用
+
+.jrrp
+输出：（这里填你个性化的模式2文案）
+
+mode switch
+输出：默认模式启用
+
+.jrrp
+输出：（这里填你个性化的默认模式文案）
+海豹核心目前支持 toml（新） json yaml 格式的牌堆。
如果对其中某种格式的语法有了解，建议选择熟悉的格式。如果都不了解，建议选择使用适用性最广的 json 格式。
当然，如果你的海豹版本较新，我们也非常推荐你尝试 toml 格式的牌堆编写。toml 格式诞生较晚，语法支持更多现代特性，海豹为这种格式的牌堆支持了更多功能。
牌堆文件的编码
永远使用「UTF-8 编码」来编写牌堆。
我们将简单介绍 toml json yaml 的语法，仅说明牌堆编写中会用到的部分，帮助你快速了解它们。
务必注意使用半角符号！
下面的语法中涉及到的符号都是半角符号，如果你出现了奇怪的问题，记得检查是否在输入法的中文输入状态，导致输入了错误的符号。
比如应该为 , 却使用了 ，，应该为 "" 却使用了 “”。
使用专业的编辑器能帮助你检查这些问题。
注释以 # 开头，用来记录相关说明性内容。
# 这是注释
+
+key = "value" # 注释也可以放在行尾
+「键值对」是 TOML 文档最基本的元素。
key = "value"
+键名在等号的左边而值在右边，键、等号和值必须在同一行（有些值可以跨多行），不允许没有值。
值需要是下述类型之一：
"" '' 或 """ """ 包裹起来的一串文字true 和 false1919-08-10 1919-08-10 11:45:14[] 包裹的一系列值{} 包裹的一系列键值对键值对后必须换行（或结束文件）。
键名可以是裸键名，也可以是用 "" 引起来的字符串，都将被看作是字符串（哪怕裸键是 1234 也是这样）。
A-Za-z0-9_-）。裸键名不支持中文
使用中文作为键名时，必须用引号包裹。
使用 "" 或者 '' 包裹的内容作为字符串。任何 Unicode 字符都可以使用，支持转义（如换行 \n、反斜杠 \ ）。
如果字符串有很多行，可以使用多行字符串语法：
key = """
+这是多行字符串的语法，它支持你直接使用换行。
+不用再拼接 \n 来换行了，好耶！
+但是这样写在最前面会多出换行，因为第一行的空换行也直接读取了。
+"""
+
+key2 = """\
+这样写就没有开头的空行问题了。
+"""
+多行换行符中，如果一行的最后一个非空白字符是未被转义的 \ 时，它会连同它后面的所有空白（包括换行）一起被去除，直到下一个非空白字符或结束引号为止。
表（哈希表、字典、对象，含义相同）是键值对的集合。「表头」为一个单独的 [] 包裹的行作为表名，后面的行都是该表的内容。
["海豹核心"]
+"简介" = "一个简单易用的跑团骰子系统"
+"状态" = "持续开发中"
+
+["狐狸核心"]
+"简介" = "一个更加简单易用的跑团骰子系统（什"
+"状态" = "根本不存在"
+以上结构相当于 JSON 中的：
{
+ "海豹核心": {
+ "简介": "一个简单易用的跑团骰子系统",
+ "状态": "持续开发中"
+ },
+ "狐狸核心": {
+ "简介": "一个更加简单易用的跑团骰子系统（什",
+ "状态": "根本不存在"
+ }
+}
+表还有一种更紧凑的内联表示法，必须在同一行内，且不支持尾逗号：
"海豹核心" = { "简介" = "一个简单易用的跑团骰子系统", "状态" = "持续开发中" }
+数组是用 [] 包裹的一系列值，子元素由 , 分隔。
TRPG = [
+ { name = "CoC", version = "7" },
+ { name = "D&D", version = "5e" }, # 多出一个逗号也是可以的
+]
+标准 JSON 而不是 JSON5
海豹支持的 JSON 牌堆是「标准 JSON」格式，诸如注释，尾逗号等语法不属于 JSON 语法，而是 JSON5 这个扩展标准的语法，出错时请严格检查。
目前暂不考虑支持 JSON5 标准，如果对注释等有需要可以尝试其它格式的牌堆。
JSON 键值对以 "key": value 的形式表达，需要包裹在 {} 或 [] 中。
{
+ "key": "value"
+}
+其中键名必须用 "" 包裹，值可以是如下类型：
"" 包裹，不可以是 ''）true 或 false）[] 包裹的一组值{} 包裹的一组键值对null：空由 [] 包裹的一组值，使用 , 分割。
[
+ "CoC",
+ "D&D"
+]
+最后一个元素后不可以有逗号。
由 [] 包裹的一组键值对，使用 , 分割。
{
+ "海豹核心": {
+ "简介": "一个简单易用的跑团骰子系统",
+ "状态": "持续开发中"
+ },
+ "狐狸核心": {
+ "简介": "一个更加简单易用的跑团骰子系统（什",
+ "状态": "根本不存在"
+ }
+}
+最后一个键值对后不可以有逗号。
注释以 # 开头。
YAML 键值对使用冒号结构表示 key: value，冒号后面要加一个空格。
值可以是如下类型：
这是一段字符串"" 或者 ''包裹，双引号不会对特殊字符转义：'Hello world'true false~ 表示可以使用行内语法表示对象：
海豹核心: { 简介: 一个简单易用的跑团骰子系统, 状态: 持续开发中 }
+狐狸核心: { 简介: 一个更加简单易用的跑团骰子系统（什, 状态: 根本不存在 }
+也可以使用缩进层级表示对象关系（推荐）：
海豹核心:
+ 简介: 一个简单易用的跑团骰子系统
+ 状态: 持续开发中
+狐狸核心:
+ 简介: 一个更加简单易用的跑团骰子系统（什
+ 状态: 根本不存在
+缩进是有含义的
在 YAML 中，缩进是有含义的，缩进的长度表示了层级。
缩进不允许 tab，只允许使用空格。缩进的空格数并不重要，但相同层级的元素必须左对齐。
当你在复制粘贴 YAML 文本时，请务必注意这一点，格式错乱会无法识别。
YAML 可以使用行内语法表示数组：
[ A, B, C ]
+也可以使用以 - 开头的行表示构成一个数组：
- A
+- B
+- C
+数据结构的子成员是一个数组，则可以在该项下面缩进一个空格：
TRPG:
+ - name: CoC
+ version: '7'
+ - name: D&D
+ version: 5e
+复杂的 YAML
YAML 的语法极其灵活，同一种形式在 YAML 中可以有多种等价表示方法，这里只列出了常见的。
如果你在阅读其它人的 YAML 牌堆时遇上了看不懂的内容，建议通过更系统的教程学习。
海豹的抽取指令为 .draw <key>，而牌堆就是可以提供一些 key 作为牌组的文件。
我们从编写一个最简单的牌堆开始，我们希望：
快端上来罢 和 数字论证 两个牌组； .draw 快端上来罢 可以抽取出 哼哼哼啊啊啊啊啊 你是一个一个一个牌堆结果 这两个结果；.draw 数字论证 可以抽取出 114514 1919810 这两个结果。这个牌堆编写如下，你可以选择以下任意一种格式来学习：
# 元信息表
+[meta]
+title = "野兽牌堆"
+author = "田所浩二"
+# 有多个作者时可以使用，两者仅需保留一行
+authors = ["田所浩二"]
+version = "1.0"
+license = "CC-BY-NC-SA 4.0"
+date = 1919-08-10
+update_date = 1919-08-10
+desc = "这个示例牌堆怎么这么臭（恼）"
+
+# 牌组表
+[decks]
+"快端上来罢" = [
+ "哼哼哼啊啊啊啊啊",
+ "你是一个一个一个牌堆结果"
+]
+"数字论证" = [
+ "114514",
+ "1919810"
+]
+一个 TOML 牌堆的最基本格式如上。其中 meta 表中的信息不是必须的，但我们非常建议你保留并填写这些项，它们能在分享时说明更多信息：
title：牌堆的标题；author/authors：牌堆作者；date：牌堆创建日期；updateDate：牌堆更新日期；desc：牌堆简介；version：牌堆版本；license：牌堆协议。可以将上述内容保存名为 野兽牌堆.toml（名称任意，但必须是以 .toml 为后缀扩展名）的文件进行测试。
{
+ "_title": [ "野兽牌堆" ],
+ "_author": [ "田所浩二" ],
+ "_date": [ "1919-08-10" ],
+ "_updateDate": [ "1919-08-10" ],
+ "_brief": [ "这个示例牌堆怎么这么臭（恼）" ],
+ "_version": [ "1.0" ],
+ "_license": [ "CC-BY-NC-SA 4.0" ],
+ "快端上来罢": [
+ "哼哼哼啊啊啊啊啊",
+ "你是一个一个一个牌堆结果"
+ ],
+ "数字论证": [
+ "114514",
+ "1919810"
+ ]
+}
+一个 JSON 牌堆的最基本格式如上。其中以 _ 开头的项不是必须的，但是我们非常建议你保留并填写这些项，它们能在分享时说明更多信息：
_title：牌堆的标题；_author：牌堆作者；_date：牌堆创建日期；_updateDate：牌堆更新日期；_brief：牌堆简介；_version：牌堆版本；_license：牌堆协议。可以将上述内容保存名为 野兽牌堆.json（名称任意，但必须是以 .json 为后缀扩展名）的文件进行测试。
name: 野兽牌堆
+author: 田所浩二
+version: '1.0'
+license: CC-BY-NC-SA 4.0
+desc: 这个示例牌堆怎么这么臭（恼）
+command:
+
+快端上来罢:
+ - 哼哼哼啊啊啊啊啊
+ - 你是一个一个一个牌堆结果
+数字论证:
+ - '114514'
+ - '1919810'
+一个 YAML 牌堆的最基本格式如上。其中上半部分的一些项不是必须的，但是我们非常建议你保留并填写这些项，它们能在分享时说明更多信息：
name：牌堆的标题；author：牌堆作者；version：牌堆版本；license：牌堆协议；desc：牌堆简介。可以将上述内容保存名为 野兽牌堆.yaml（名称任意，但必须是以 .yaml 或 .yml 为后缀扩展名）的文件进行测试。
牌堆文件扩展名正确吗？
保存文件时务必确认开启了操作系统的扩展名显示，避免出现看上去保存了 xxx.json 文件，但实际上的文件名是 xxx.json.txt。
牌堆抽取结果字符串中，可以实现抽取其他项，将内容拼接进该结果。
{key} 表示不放回抽取；{%key} 表示放回抽取。[decks]
+"时间点" = [
+ "早上",
+ "中午",
+ "晚上",
+]
+"追尾了" = [
+ "在{%时间点}追尾了一辆高级黑色轿车",
+]
+{
+ "时间点": [
+ "早上",
+ "中午",
+ "晚上"
+ ],
+ "追尾了": [
+ "在{%时间点}追尾了一辆高级黑色轿车"
+ ]
+}
+YAML 的放回表示
YAML 牌堆中的表示正好相反：
{key} 表示放回抽取；{%key} 表示不放回抽取。时间点:
+ - 早上
+ - 中午
+ - 晚上
+追尾了:
+ - 在{时间点}追尾了一辆高级黑色轿车
+放回与不放回
放回抽取表示每次抽取该项后，下次抽取还是从同样的结果中抽取。
不放回抽取表示抽取一次后，下一次会在剩余结果中抽取，直到抽完所有结果后再重新开始。
抽取结果字符串中的 [exp]，会先执行其中的掷骰表达式 exp，再组合到原字符串里。
如：抽取 企鹅早该爆金币辣！v我[1d10]个金币 的结果可能是 企鹅早该爆金币辣！v我1个金币。
研究旧牌堆，可能会发现有牌堆通过下面这样的写法来实现这个功能，现在请不要这么做了。
{
+ "数字": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
+ "爆金币": "企鹅早该爆金币辣！v我{%数字}个金币"
+}
+抽取结果字符串中最前面的 ::value:: 表示该项的权重，可以理解为该项重复了几次。
权重可以是随机的：::[1d10]::
示例：有 1/10 的几率出现闪光海豹
[decks]
+"捕捉海豹" = [
+ "::9::海豹",
+ "✨闪光海豹✨"
+]
+{
+ "捕捉海豹": [
+ "::9::海豹",
+ "✨闪光海豹✨"
+ ]
+}
+捕捉海豹:
+ - ::9::海豹
+ - ✨闪光海豹✨
+研究旧牌堆，可能会发现有牌堆通过下面这样的写法来实现这个功能，现在请不要这么做了。
{
+ "捕捉海豹": [
+ "海豹", "海豹", "海豹", "海豹", "海豹", "海豹", "海豹", "海豹", "海豹",
+ "✨闪光海豹✨"
+ ]
+}
+抽取结果字符串中可以插入 CQ 码和海豹码，比如 [图:data/images/sealdice.png]。
.draw keys 指令会列出所有允许抽取的牌组，但在牌堆编写过程中，经常会需要用到辅助的牌组，这些辅助项是不希望暴露给用户的。我们可以通过一定方式来隐藏这些项。
在 TOML 牌堆中，当牌组的名称以 _ 开头，那么这个牌组将不会暴露在 .draw keys 中。
[decks]
+"_时间点" = [
+ "早上",
+ "中午",
+ "晚上",
+]
+"追尾了" = [
+ "在{%_时间点}追尾了一辆高级黑色轿车",
+]
+这样在 .draw keys 中就不会展示 _时间点 这一牌组。
在 JSON 牌堆中，可以通过配置牌堆文件的 _keys 指定所有显示的牌组，未指定在列表中的牌组将不会暴露在 .draw keys 中。
{
+ "_keys": [ "追尾了" ],
+ "时间点": [
+ "早上",
+ "中午",
+ "晚上"
+ ],
+ "追尾了": [
+ "在{%时间点}追尾了一辆高级黑色轿车"
+ ]
+}
+这样在 .draw keys 中就不会展示 时间点 这一牌组。
被隐藏的项不会在 .draw keys 中展示，但依然可以通过指定 .draw <key> 的方法抽取。如果你希望某些牌组彻底隐藏，只能在牌堆内部调用，可以通过配置它们的导出来实现：
在 TOML 牌堆中，当牌组的名称以 __（双下划线）开头，那么这个牌组将不导出，即无法使用 .draw <key> 进行抽取，更不会显示在列表中。
[decks]
+"__时间点" = [
+ "早上",
+ "中午",
+ "晚上",
+]
+"追尾了" = [
+ "在{%__时间点}追尾了一辆高级黑色轿车",
+]
+在 JSON 牌堆中，当牌组的名称以 _ 开头，那么这个牌组将不导出，即无法使用 .draw <key> 进行抽取，更不会显示在列表中。
{
+ "_时间点": [
+ "早上",
+ "中午",
+ "晚上"
+ ],
+ "追尾了": [
+ "在{%_时间点}追尾了一辆高级黑色轿车"
+ ]
+}
+这样 _时间点 这一牌组无法再用 .draw _时间点 抽取了。
此外，通过配置牌堆文件的 _export/ _exports 可以指定所有的导出项。未指定在列表中的牌组将无法使用 .draw <key> 进行抽取，更不会显示在列表中。
{
+ "_exports": [ "追尾了" ],
+ "时间点": [
+ "早上",
+ "中午",
+ "晚上"
+ ],
+ "追尾了": [
+ "在{%时间点}追尾了一辆高级黑色轿车"
+ ]
+}
+UI 中识别隐藏的牌组
你可以通过查看牌堆管理界面中的「牌堆列表」来识别牌组是否隐藏。
灰色的牌组是隐藏的，即不展示在列表中，但能够被 .draw <key> 抽取。
未导出（不展示也不能抽取）的牌组不展示在该列表中。
很多时候，牌堆内容不是一成不变的。而使用牌堆的用户需要手动去获取最新的牌堆，才能获得作者们提供的最新内容。
我们为牌堆提供了配置更新链接的机制，方便骰主快速获取牌堆更新。有能力的牌堆作者可以配置更新链接，便于分享最新的牌堆内容。
配置牌堆文件的 updateUrls 以指定对应的更新链接：
[meta]
+title = "野兽牌堆"
+updateUrls = [
+ "https://updateurl.com" # 此处填写你的更新链接
+]
+
+# 牌组表
+[decks]
+"快端上来罢" = [
+ "哼哼哼啊啊啊啊啊",
+ "你是一个一个一个牌堆结果"
+]
+"数字论证" = [
+ "114514",
+ "1919810"
+]
+配置牌堆文件的 _updateUrls 以指定对应的更新链接：
{
+ "_title": [ "野兽牌堆" ],
+ "_updateUrls": [ "https://updateurl.com" ],
+ "快端上来罢": [
+ "哼哼哼啊啊啊啊啊",
+ "你是一个一个一个牌堆结果"
+ ],
+ "数字论证": [
+ "114514",
+ "1919810"
+ ]
+}
+配置牌堆文件的 update_urls 以指定对应的更新链接：
name: 野兽牌堆
+update_urls:
+ - 'https://updateurl.com'
+
+快端上来罢:
+ - 哼哼哼啊啊啊啊啊
+ - 你是一个一个一个牌堆结果
+数字论证:
+ - '114514'
+ - '1919810'
+有多个更新链接时，海豹将依次从上往下检查更新。
TOML 牌堆中，你可以以表的形式来创建更复杂的牌组，这允许你更精细的控制每个牌组的选项。
复杂牌组和普通牌组在使用上没有什么区别，仅仅是提供了配置选项的能力。
[meta]
+title = "野兽牌堆"
+updateUrls = [
+ "https://updateurl.com" # 此处填写你的更新链接
+]
+
+# 简单牌组表
+[decks]
+"快端上来罢" = [
+ "哼哼哼啊啊啊啊啊",
+ "你是一个一个一个牌堆结果"
+]
+
+# 复杂牌组
+["数字论证"]
+export = true
+visible = true
+aliases = [ "恶臭论证" ]
+options = [
+ "114514",
+ "1919810",
+]
+表名将作为这个牌组的名称，复杂牌组提供以下选项：
export：是否导出该牌组；visible：该牌组是否可见，不可见的将不展示在 .draw keys 列表中；aliases：牌组的别名，可以使用别名抽取改牌组，如上述示例中可以使用 .draw 数字论证 或 .draw 恶臭论证 来抽取；options：该牌组的项。施工中……
施工中……
你可以直接按照以下格式书写 <helpdoc>.json：
{
+ "mod": "名字",
+ "author": "作者",
+ "brief": "概述",
+ "comment": "备注",
+ "helpdoc": {
+ "词条A": "词条 A 的具体内容。",
+ "词条B": "词条 B 的具体内容。",
+ "词条C": "[图:data/images/sealdice.png] 词条 C 的图片与内容。"
+ }
+}
+若你的文本需要换行，你可以使用 \n 作为换行符，而不是在编写时直接换行，这会导致格式错误。你还可以使用 \f 或 {FormFeed} 作为分页符。
标准 JSON 而不是 JSON5
海豹支持的 JSON 帮助文档是「标准 JSON」格式，诸如注释，尾逗号等语法不属于 JSON 语法，而是 JSON5 这个扩展标准的语法，出错时请严格检查。
目前暂不考虑支持 JSON5 标准。
文件编码
请永远使用 UTF-8 编码编写 helpdoc。
你可以在 JSON 格式的帮助文档中嵌套引用其它条目：
{
+ "helpdoc": {
+ "词条A": "词条 A 的具体内容。",
+ "词条B": "{词条A}词条 B 的具体内容。",
+ "词条C": "你还可以 {词条A}\n{词条B}"
+ }
+}
+如此一来当你发送 .help 词条 B 时，骰子将回复：「词条 A 的具体内容。词条 B 的具体内容。」。
{
+ "mod": "KIYTarot",
+ "author": "浣熊旅記",
+ "brief": "KIY 塔罗牌",
+ "comment": "释义来源网络。",
+ "helpdoc": {
+ "愚者逆位": "漂泊，冒险，鲁莽，冒失，疯狂，无视物质损失，灵魂堕落，内心空虚，感情轻浮。",
+ "魔术师逆位": "方向错误，被骗或失败，局面失控，二流角色，缺乏热忱和创造力，爱情难有进展。",
+ "女祭司逆位": "挑剔，贪心，目光短浅，洁癖，不适宜的激情，自尊心太强，锋芒外露，单相思。",
+ "女皇逆位": "冷淡，缺乏上进心，困难，享乐，环境险恶，贴近自然，自负，纠纷，感情挫折。",
+ "皇帝逆位": "幼稚，挫折，武断，滥用权利，冷酷，占有欲和控制力强烈，感情勉强。"
+ }
+}
+你还可以按照以下格式书写 <helpdoc>.xlsx：
| Key | Synonym | Content | Description | Catalogue | Tag |
|---|---|---|---|---|---|
| 词条 A | 词条同义词 | 词条内容 | 对词条的简述 | 所属目录 | 内容 TAG |
| 海豹骰 | 豹骰/海豹/sealdice | 一个简单易用的跑团骰子系统。 形象是海豹，可以被叫做海豹骰、豹骰，豹子骰之类。 |
Excel 格式的 helpdoc 分为 Key、Synonym、Content、Description、Catalogue、Tag 六块，其中第二列、后三项为选填，一般情况下你都可以留空。
Synonym 列可以填写多个同义词，使用 / 分隔即可。\n 来换行，但不支持其它换行符与分页符），因此它常用来快速编写有大段文字的帮助文档。测试，则对应的词条会显示为 测试:词条 A。由于海豹的 .find 指令会对词条进行模糊检索，所以你不必担心前缀对查询带来的影响。必须保留首行！
不要删去第一行的 Key、Synonym 等词。请从第二行开始编写词条。
EXCEL 格式的帮助文档
<helpdoc>.xlsx 原本是梨骰用于 D&D 词条查询的格式，但海豹同样可以读取它。
本节内容
本节将介绍 JavaScript 脚本的编写，请善用侧边栏和搜索，按需阅读文档。
我们假定你熟悉 JavaScript / TypeScript，编程语言的教学超出了本文档的目的，如果你还不熟悉它们，可以从互联网上寻找到很多优秀的教程。如：
VS Code 可以安装 SealDice Snippets 插件，提供了一些常见代码片段，帮助快速生成模板代码。
如果你打算使用 TypeScript，海豹提供了相应的 模板工程，注册扩展和指令的代码已经写好，可以直接编译出一个可直接装载的 JS 扩展文件。使用见 使用 TS 模板。
使用 TypeScript
我们更推荐使用 TypeScript 来编写插件，编译到 ES6 后使用即可。不过先从 JavaScript 开始也是没有任何问题的。
我们从最简单的扩展开始，这个扩展只会在日志中打印一条 Hello World!。
// ==UserScript==
+// @name 示例：如何开始
+// @author 木落
+// @version 1.0.0
+// @description 这是一个演示脚本，并没有任何实际作用。
+// @timestamp 1671368035
+// 2022-12-18
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+
+console.log('Hello World!');
+海豹对 JavaScript 的支持
海豹使用 goja 作为 js 脚本引擎。goja 目前支持了 ES6 基本上全部的特性，包括 async/await，promise 和 generator。
需要注意引擎的整型为 32 位，请小心溢出问题。
打印日志
console 打印出来的东西不仅会在控制台中出现，在日志中也会显示。
涉及网络请求或延迟执行的内容，有时候不会在控制台调试面板上显示出来，而在日志中能看到。
每个 JS 扩展需要在开头以固定格式注释的形式留下信息，以便使用和分享：
// ==UserScript==
+// @name 脚本的名字
+// @author 木落
+// @version 1.0.0
+// @description 这是一个演示脚本，并没有任何实际作用。
+// @timestamp 1672066028
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+| 属性 | 含义 |
|---|---|
| @name | JS 扩展的名称，会展示在插件列表页面 |
| @author | 作者名 |
| @version | 版本号，可以自己定义，但建议遵循 语义版本控制（Semantic Versioning） |
| @description | 对扩展的功能的描述 |
| @timestamp | 最后更新时间，以秒为单位的 unix 时间戳，新版本支持了直接使用时间字符串，如 2023-10-30。 |
| @license | 开源协议，示例中的 Apache-2 是一个比较自由的协议，允许任意使用和分发（包括商用），当然你也可以使用其它协议（MIT GPL 等） |
| @homepageURL | 你的扩展的主页链接，有 GitHub 仓库可以填仓库链接，没有则可以填海豹官方插件仓库 |
在海豹中，所有指令必须归属于某个扩展，而一个扩展可以包含多条指令。
JS 脚本中创建扩展的方式如下，在创建扩展后，还需要注册扩展，才能让扩展起效，不要漏掉哦！
// 如何建立一个扩展
+
+// 首先检查是否已经存在
+if (!seal.ext.find('test')) {
+ // 不存在，那么建立扩展，名为 test，作者“木落”，版本 1.0.0
+ const ext = seal.ext.new('test', '木落', '1.0.0');
+ // 注册扩展
+ seal.ext.register(ext);
+}
+JS 脚本和扩展
在实现上，海豹允许你在一个 JS 脚本文件中注册多个扩展，但我们不建议这样做。一般来说，一个 JS 脚本文件只会注册一个扩展。
修改内置功能？
出于对公平性的考虑，JS 脚本不能替换内置指令和内置扩展。
想要创建一条自定义指令，首先需要创建一个扩展（seal.ExtInfo），写好自定义指令的实现逻辑之后，再注册到扩展中。
接上面的代码，假定目前已经注册好了一个名为 test 的扩展，现在要写一个名为 seal 的指令：
.seal ABC，那么文案中将海豹命名为「ABC」；第一步，创建新的自定义指令，设置好名字和帮助信息。
const cmdSeal = seal.ext.newCmdItemInfo();
+cmdSeal.name = 'seal'; // 指令名字，可用中文
+cmdSeal.help = '召唤一只海豹，可用 .seal <名字> 命名';
+命令的帮助信息
命令的帮助信息是在使用 .help <命令> 时会返回的帮助内容。
帮助信息不要以 . 开头，防止查看帮助时骰子的回复触发其他骰子。
第二步，编写指令的具体处理代码。
你需要编写指令对象的 solve 函数，在使用该指令的时候，海豹核心会调用你写的这个函数。
cmdSeal.solve = (ctx, msg, cmdArgs) => {
+ // 这里是你需要编写的内容
+};
+| 参数 | 说明 |
|---|---|
ctx | 主要是和当前环境以及用户相关的内容，如当前发指令用户，当前群组信息等 |
msg | 原始指令内容，如指令文本，发送平台，发送时间等 |
cmdArgs | 指令信息，会将用户发的信息进行分段，方便快速取用 |
这里仅说明需要用到的接口，详细可见 插件仓库 examp_ts 下的 seal.d.ts 文件，里面包含了目前开放的接口的定义及其注释说明。
假设用户发送过来的消息是 .seal A B C，那么可以用 cmdArgs.getArgN(1) 获取到 A，cmdArgs.getArgN(2) 获取到 B，cmdArgs.getArgN(3) 获取到 C。
通常会对参数值进行判断，随后作出响应。
以下代码处理的是 .seal help 的情形：
cmdSeal.solve = (ctx, msg, cmdArgs) => {
+ // 获取第一个参数，例如 .seal A B C
+ // 这里 cmdArgs.getArgN(1) 的结果即是 A，传参为 2 的话结果是 B
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case 'help': {
+ // 命令为 .seal help
+ // 创建一个结果对象，并将 showHelp 标记为 true，这会自动给用户发送帮助
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ default: {
+ // 没有传入参数时的代码
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ }
+};
+返回执行结果
在执行完自己的代码之后，需要返回指令结果对象，其参数是是否执行成功。
给消息发送者回应，需要使用 seal.replyToSender() 函数，前两个参数和 solve() 函数接收的参数一致，第三个参数是你要发送的文本。
发送的文本中，可以包含 变量（例如{$t玩家}），也可以包含 CQ 码，用来实现回复发送者、@发送者、发送图片、发送分享卡片等功能。
在这个例子中，我们需要获取作为海豹名字的参数，获取不到就使用默认值，随后向消息发送者发送回应。
在刚刚的位置填入核心代码，就可以完成了。
cmdSeal.solve = (ctx, msg, cmdArgs) => {
+ // 获取第一个参数，例如 .seal A B C
+ // 这里 cmdArgs.getArgN(1) 的结果即是 A，传参为 2 的话结果是 B
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case 'help': {
+ // 命令为 .seal help
+ // 创建一个结果对象，并将 showHelp 标记为 true，这会自动给用户发送帮助
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ default: {
+ // 命令为 .seal XXXX，取第一个参数为名字
+ if (!val) val = '氪豹';
+ // 进行回复，如果是群聊发送那么在群里回复，私聊发送则在私聊回复 (听起来是废话文学，但详细区别见暗骰例子)
+ seal.replyToSender(ctx, msg, `你抓到一只海豹！取名为${val}\n它的逃跑意愿为${Math.ceil(Math.random() * 100)}`);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ }
+};
+第三步，将命令注册到扩展中。
ext.cmdMap['seal'] = cmdSeal;
+如果你想要给这个命令起一个别名，也就是增加一个触发词，可以这样写：
ext.cmdMap['seal'] = cmdSeal; // 注册 .seal 指令
+ext.cmdMap['海豹'] = cmdSeal; // 注册 .海豹 指令，等效于 .seal
+完整的代码如下：
// ==UserScript==
+// @name 示例：编写一条自定义指令
+// @author 木落
+// @version 1.0.0
+// @description 召唤一只海豹，可用.seal <名字> 命名
+// @timestamp 1671368035
+// 2022-12-18
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+
+// 编写一条自定义指令
+// 先将扩展模块创建出来，如果已创建就直接使用
+let ext = seal.ext.find('test');
+if (!ext) {
+ ext = seal.ext.new('test', '木落', '1.0.0');
+ seal.ext.register(ext);
+}
+
+// 创建指令 .seal
+// 这个命令的功能为，显示「抓到一只海豹」的文案；
+// 如果命令写 .seal ABC，那么文案中将海豹命名为「ABC」；
+// 如果命令中没写名字，那么命名为默认值「氪豹」。
+const cmdSeal = seal.ext.newCmdItemInfo();
+cmdSeal.name = 'seal'; // 指令名字，可用中文
+cmdSeal.help = '召唤一只海豹，可用 .seal <名字> 命名';
+
+// 主函数，指令解析器会将指令信息解析，并储存在几个参数中
+// ctx 主要是和当前环境以及用户相关的内容，如当前发指令用户，当前群组信息等
+// msg 为原生态的指令内容，如指令文本，发送平台，发送时间等
+// cmdArgs 为指令信息，会将用户发的信息进行分段，方便快速取用
+cmdSeal.solve = (ctx, msg, cmdArgs) => {
+ // 获取第一个参数，例如 .seal A B C
+ // 这里 cmdArgs.getArgN(1) 的结果即是 A，传参为 2 的话结果是 B
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case 'help': {
+ // 命令为 .seal help
+ // 创建一个结果对象，并将 showHelp 标记为 true，这会自动给用户发送帮助
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ default: {
+ // 命令为 .seal XXXX，取第一个参数为名字
+ if (!val) val = '氪豹';
+ // 进行回复，如果是群聊发送那么在群里回复，私聊发送则在私聊回复 (听起来是废话文学，但详细区别见暗骰例子)
+ seal.replyToSender(ctx, msg, `你抓到一只海豹！取名为${val}\n它的逃跑意愿为${Math.ceil(Math.random() * 100)}`);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ }
+};
+
+// 将命令注册到扩展中
+ext.cmdMap['seal'] = cmdSeal;
+
+// 无实际意义，用于消除编译报错
+export {}
+这就是最基本的模板了。
可以使用以下函数生成随机整数：
/**
+ * 生成随机整数
+ * @param min 最小值
+ * @param max 最大值
+ * @returns 位于 [min,max] 区间的随机整数
+ */
+function randomInt(min, max) {
+ return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+施工中……
相关的 API 是两个函数，ExtInfo.storageSet(key, value) 函数和 ExtInfo.storageGet(key)，一个存，一个取。
关于 key：
存储时需要指定 key，你可以设定为你的扩展的名字，也可以设定为其他的，注意不要和别的扩展的 key 重名就可以了。
就好比你在商场门口想要把随身物品存进暂存柜中，需要先找到个和别人不重复的柜子，避免放错地方或者取错东西。
关于 value：
存放的数据是字符串类型，且只能存一个，但如果想要存放更多的数据以及非字符串类型的数据怎么办？
答案是使用 JSON.stringify() 函数将存储了数据的 JS 对象转换为 JSON 字符串，存储起来，需要取出的时候，再使用 JSON.parse() 函数将数据再转换为 JS 对象。。
// ==UserScript==
+// @name 示例：存储数据
+// @author 木落
+// @version 1.0.0
+// @description 投喂，格式 .投喂 <物品>
+// @timestamp 1672423909
+// 2022-12-31
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+
+// 先将扩展模块创建出来，如果已创建就直接使用
+let ext = seal.ext.find('test');
+if (!ext) {
+ ext = seal.ext.new('test', '木落', '1.0.0');
+ seal.ext.register(ext);
+}
+const cmdFeed = seal.ext.newCmdItemInfo();
+cmdFeed.name = '投喂';
+cmdFeed.help = '投喂，格式：.投喂 <物品>\n.投喂 记录 // 查看记录';
+cmdFeed.solve = (ctx, msg, cmdArgs) => {
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case 'help':
+ case '': {
+ // .投喂 help
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ case '列表':
+ case '记录':
+ case 'list': {
+ const data = JSON.parse(ext.storageGet('feedInfo') || '{}');
+ const lst = [];
+ for (let [k, v] of Object.entries(data)) {
+ lst.push(`- ${k}: 数量 ${v}`);
+ }
+ seal.replyToSender(ctx, msg, `投喂记录:\n${lst.join('\n')}`);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ default: {
+ const data = JSON.parse(ext.storageGet('feedInfo') || '{}');
+ const name = val || '空气';
+ if (data[name] === undefined) {
+ data[name] = 0;
+ }
+ data[name] += 1;
+ ext.storageSet('feedInfo', JSON.stringify(data));
+ seal.replyToSender(ctx, msg, `你给海豹投喂了${name}，要爱护动物！`);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ }
+};
+// 将命令注册到扩展中
+ext.cmdMap['投喂'] = cmdFeed;
+ext.cmdMap['feed'] = cmdFeed;
+这是关于数据的增加、删除、查询等操作的实现示例（修改的话就是删除之后增加）
// ==UserScript==
+// @name 群内安价收集
+// @author 憧憬少
+// @version 1.0.0
+// @description 在群内收集群友给出的安价选项，并掷骰得出结果
+// @timestamp 1676386517
+// 2023-02-14 22:55:17
+// @license MIT
+// @homepageURL https://github.com/ChangingSelf/sealdice-js-ext-anchor
+// ==/UserScript==
+
+(() => {
+ // src/index.ts
+ const HELP = `群内安价收集 (ak 是アンカー罗马字缩写)
+注意 ak 后面有空格，“.ak”也可以换成“.安价”
+
+.ak help // 查看帮助
+.ak # 标题 // 新建一轮分歧并设标题
+.ak + 选项 // 需要添加的选项的内容
+.ak - 序号 // 需要移除的选项的序号
+.ak ? // 列出目前所有选项
+.ak = // 随机抽取 1 个选项并继续
+.ak = n // 随机抽取 n 个选项并继续
+`;
+ const STORAGE_KEY = "anchor";
+ const OPTION_NUM_PER_PAGE = 15; // 列出所有选项时，每页放多少个选项
+ function akNew(ctx, msg, ext, title) {
+ const data = {
+ "title": title,
+ "options": []
+ };
+ ext.storageSet(STORAGE_KEY, JSON.stringify(data));
+ seal.replyToSender(ctx, msg, `已新建分歧:${title}`);
+ }
+ function akAdd(ctx, msg, ext, option) {
+ const data = JSON.parse(ext.storageGet(STORAGE_KEY) || '{"title":"","options":[]}');
+ data.options.push(option);
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}
+已添加第${data.options.length}个选项:${option}`);
+ ext.storageSet(STORAGE_KEY, JSON.stringify(data));
+ }
+ function akDel(ctx, msg, ext, index) {
+ const data = JSON.parse(ext.storageGet(STORAGE_KEY) || '{"title":"","options":[]}');
+ const removed = data.options.splice(index - 1, 1)[0];
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}
+已移除第${index}个选项:${removed}`);
+ ext.storageSet(STORAGE_KEY, JSON.stringify(data));
+ }
+ function akList(ctx, msg, ext) {
+ const data = JSON.parse(ext.storageGet(STORAGE_KEY) || '{"title":"","options":[]}');
+ if (data.options.length === 0) {
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}
+还没有任何选项呢`);
+ return;
+ }
+ let optStr = "";
+ let curPageRows = 0;
+ data.options.forEach((value, index) => {
+ optStr += `${index + 1}.${value}
+`;
+ ++curPageRows;
+ if (curPageRows >= OPTION_NUM_PER_PAGE) {
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}
+${optStr}`);
+ optStr = "";
+ curPageRows = 0;
+ }
+ });
+ if (curPageRows > 0) {
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}
+${optStr}`);
+ }
+ }
+ function randomInt(min, max) {
+ return Math.floor(Math.random() * (max - min + 1)) + min;
+ }
+ function akGet(ctx, msg, ext, num = 1) {
+ const data = JSON.parse(ext.storageGet(STORAGE_KEY) || '{"title":"","options":[]}');
+ if (data.options.length === 0) {
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}
+还没有任何选项呢`);
+ return;
+ }
+ akList(ctx, msg, ext);
+ let optStr = "";
+ for (let i = 0; i < num; ++i) {
+ const r = randomInt(1, data.options.length);
+ const result = data.options.splice(r - 1, 1);
+ optStr += `${i + 1}.${result}
+`;
+ }
+ seal.replyToSender(ctx, msg, `结果是:
+${optStr}`);
+ ext.storageSet(STORAGE_KEY, JSON.stringify(data));
+ }
+ function main() {
+ let ext = seal.ext.find("anchor");
+ if (!ext) {
+ ext = seal.ext.new("anchor", "憧憬少", "1.0.0");
+ seal.ext.register(ext);
+ }
+ const cmdSeal = seal.ext.newCmdItemInfo();
+ cmdSeal.name = "安价";
+ cmdSeal.help = HELP;
+ cmdSeal.solve = (ctx, msg, cmdArgs) => {
+ try {
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case "#": {
+ const title = cmdArgs.getArgN(2);
+ akNew(ctx, msg, ext, title);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ case "+": {
+ const option = cmdArgs.getArgN(2);
+ akAdd(ctx, msg, ext, option);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ case "-": {
+ const index = Number(cmdArgs.getArgN(2));
+ akDel(ctx, msg, ext, index);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ case "?":
+ case "？": {
+ akList(ctx, msg, ext);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ case "=": {
+ let num = 1;
+ if (cmdArgs.args.length >= 2) {
+ num = Number(cmdArgs.getArgN(2));
+ }
+ akGet(ctx, msg, ext, num);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ case "help":
+ default: {
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ }
+ } catch (error) {
+ seal.replyToSender(ctx, msg, error.Message);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ };
+ ext.cmdMap["安价"] = cmdSeal;
+ ext.cmdMap["ak"] = cmdSeal;
+ }
+ main();
+})();
+
+关于取出数据来修改的函数，可以参考如下代码：
const STORAGE_KEY = "anchor"; // 将你的 key 抽出来单独作为一个常量，方便开发阶段修改（使用了之后就不要修改了）
+//函数：添加选项
+function akAdd(ctx, msg, ext, option) {
+ //取出数据
+ const data = JSON.parse(ext.storageGet(STORAGE_KEY) || '{"title":"","options":[]}');
+
+ //处理数据
+ data.options.push(option);
+
+ //响应发送者
+ seal.replyToSender(ctx, msg, `当前分歧:${data.title}\n已添加第${data.options.length}个选项:${option}`);
+
+ //将处理完的数据写回去
+ ext.storageSet(STORAGE_KEY, JSON.stringify(data));
+}
+可以查看下文的 API。
如下：
// ==UserScript==
+// @name 示例：编写暗骰指令
+// @author 流溪
+// @version 1.0.0
+// @description 暗骰，格式.hide 原因
+// @timestamp 1671540835
+// 2022-12-20
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+ext = seal.ext.find('hide');
+if (!ext){
+ ext = seal.ext.new('hide','流溪','0.0.1');
+ seal.ext.register(ext);
+}
+const cmdHide = seal.ext.newCmdItemInfo;
+cmdHide.name = 'hide';
+cmdHide.help = '暗骰，使用 .hide 面数 暗骰';
+cmdHide.solve = (ctx, msg, cmdArgs) => {
+ if (msg.messageType !== 'group'){
+ seal.replyToSender(ctx, msg, '暗骰只能在群内触发');
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ function rd(x){
+ // 这里写的时候有点不清醒了，感觉是对的，如果不对请拷打我
+ return Math.round(Math.random() * (x - 1) + 1);
+ }
+ let x = cmdArgs.getArgN(1);
+ if (x === 'help'){
+ return seal.ext.newCmdExecuteResult(true).showhelp = true;
+ } else if (isNaN(Number(x))){
+ // 我知道这里有更好的判断是否为数字的方法但是我不会.jpg
+ seal.replyToSender(ctx, msg, `骰子面数应是数字`);
+ return seal.ext.newCmdExecuteResult(true);
+ } else {
+ // 这就是暗骰 api 哒！
+ seal.replyPerson(ctx, msg, `你在群${msg.groupId}的掷骰结果为：${rd(x)}`);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+}
+ext.cmdMap['hide'] = cmdHide;
+可以看到使用seal.replyPerson做到暗骰的效果。
// ==UserScript==
+// @name 示例：编写代骰指令
+// @author 木落
+// @version 1.0.0
+// @description 捕捉某人，格式.catch <@名字>
+// @timestamp 1671540835
+// 2022-12-20
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+
+// 编写代骰指令
+// 先将扩展模块创建出来，如果已创建就直接使用
+let ext = seal.ext.find('test');
+if (!ext) {
+ ext = seal.ext.new('test', '木落', '1.0.0');
+ seal.ext.register(ext);
+}
+// 创建指令 .catch
+// 这个命令的功能为，显示“试图捕捉某人”，并给出成功率
+// 如果命令写“.catch @张三”，那么就会试着捕捉张三
+const cmdCatch = seal.ext.newCmdItemInfo();
+cmdCatch.name = 'catch';
+cmdCatch.help = '捕捉某人，格式.catch <@名字>';
+// 对这个指令启用使用代骰功能，即@某人时，可获取对方的数据，以对方身份进行骰点
+cmdCatch.allowDelegate = true;
+cmdCatch.solve = (ctx, msg, cmdArgs) => {
+ // 获取对方数据，之后用 mctx 替代 ctx，mctx 下读出的数据即被代骰者的个人数据
+ const mctx = seal.getCtxProxyFirst(ctx, msg);
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case 'help': {
+ // 命令为 .catch help
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ default: {
+ const text = `正在试图捕捉${mctx.player.name}，成功率为${Math.ceil(Math.random() * 100)}%`;
+ seal.replyToSender(mctx, msg, text);
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ }
+};
+// 将命令注册到扩展中
+ext.cmdMap['catch'] = cmdCatch;
+
+主要使用 Fetch API 进行网络请求，详细文档见链接。
// 你可以使用 async/await 和 generator 来重写这段代码，欢迎 pr
+// 访问网址
+fetch('https://api-music.imsyy.top/cloudsearch?keywords=稻香').then((resp) => {
+ // 在返回对象的基础上，将文本流作为 json 解析
+ resp.json().then((data) => {
+ // 打印解析出的数据
+ console.log(JSON.stringify(data));
+ });
+});
+套用这个模板，你可以写出很多调用 API 的简单扩展。
比如核心代码只有一行的「随机猫猫图片」扩展：
seal.replyToSender(ctx, msg, `[CQ:image,file=https://thiscatdoesnotexist.com/,cache=0]`);
+核心代码同样只有一行的「随机二次元图片」扩展：
seal.replyToSender(ctx, msg, `[CQ:image,file=https://api.oick.cn/random/api.php?type=${val},cache=0]`);
+当然，也有稍微复杂的，比如「AI 骰娘」扩展，但也没有太复杂，只是处理了一下发送者传过来的消息，再发送给网络 API，收到响应之后再回应发送者。
它的核心代码如下：
const BID = ''; // 填入你的骰娘的大脑的 id
+const KEY = ''; // 填入你的 key
+/**
+ * 给 AI 主脑发送消息并接收回复
+ * @param ctx 主要是和当前环境以及用户相关的内容，如当前发指令用户，当前群组信息等
+ * @param msg 为原生态的指令内容，如指令文本，发送平台，发送时间等
+ * @param message 要发送给骰娘的具体消息
+ */
+function chatWithBot(ctx,msg,message) {
+ fetch(`http://api.brainshop.ai/get?bid=${BID}&key=${KEY}&uid=${msg.sender.userId}&msg=${message}`).then(response => {
+ if (!response.ok) {
+ seal.replyToSender(ctx, msg, `抱歉，我连接不上主脑了。它传递过来的信息是：${response.status}`);
+ return seal.ext.newCmdExecuteResult(false);
+ } else {
+ response.json().then(data => {
+ seal.replyToSender(ctx, msg, data["cnt"]);
+ return seal.ext.newCmdExecuteResult(true);
+ });
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ });
+}
+// ==UserScript==
+// @name 示例：自定义 COC 规则
+// @author 木落
+// @version 1.0.0
+// @description 自设规则，出 1 大成功，出 100 大失败。困难极难等保持原样
+// @timestamp 1671886435
+// 2022-12-24
+// @license Apache-2
+// @homepageURL https://github.com/sealdice/javascript
+// ==/UserScript==
+
+const rule = seal.coc.newRule();
+rule.index = 20; // 自定义序号必须大于等于 20，代表可用.setcoc 20 切换
+rule.key = '测试'; // 代表可用 .setcoc 测试 切换
+rule.name = '自设规则'; // 已切换至规则文本 name: desc
+rule.desc = '出 1 大成功\n出 100 大失败';
+// d100 为出目，checkValue 为技能点数
+rule.check = (ctx, d100, checkValue) => {
+ let successRank = 0;
+ const criticalSuccessValue = 1;
+ const fumbleValue = 100;
+ if (d100 <= checkValue) {
+ successRank = 1;
+ } else {
+ successRank = -1;
+ }
+ // 成功判定
+ if (successRank == 1) {
+ // 区分大成功、困难成功、极难成功等
+ if (d100 <= checkValue / 2) {
+ //suffix = "成功(困难)"
+ successRank = 2;
+ }
+ if (d100 <= checkValue / 5) {
+ //suffix = "成功(极难)"
+ successRank = 3;
+ }
+ if (d100 <= criticalSuccessValue) {
+ //suffix = "大成功！"
+ successRank = 4;
+ }
+ } else {
+ if (d100 >= fumbleValue) {
+ //suffix = "大失败！"
+ successRank = -2;
+ }
+ }
+ let ret = seal.coc.newRuleCheckResult();
+ ret.successRank = successRank;
+ ret.criticalSuccessValue = criticalSuccessValue;
+ return ret;
+};
+// 注册规则
+seal.coc.registerRule(rule);
+
+你是否因为自定义回复能实现的功能有限而烦恼？你是否因为自定义回复的匹配方式不全而愤怒？你是否因为自定义回复只能调用图片 api 而感到焦头烂额？
不要紧张，我的朋友，试试非指令关键词，这会非常有用。
通常情况下，我们使用 ext.onNotCommandReceived 作为非指令关键词的标志；这限定了只有在未收到命令且未达成自定义回复时，海豹才会触发此流程。
一个完整的非指令关键词模板如下：
// 必要流程，注册扩展，注意即使是非指令关键词也是依附于扩展的
+if (!seal.ext.find('xxx')){
+ ext = seal.ext.new('xxx','xxx','x.x.x');
+ seal.ext.register(ext);
+ // 这里其实是编写处理函数
+ ext.onNotCommandReceived = (ctx, msg) => {
+ let message = msg.message;
+ // 这里请自己处理要如何达成 message 的匹配条件，js 那么多的匹配方法，足够你玩出花来。
+ if(xxx){
+ // 匹配到关键词了，要干什么？
+ xxx;
+ }
+ }
+}
+插件若要在 UI 中注册可供用户修改的配置项，需要在插件注册后调用 seal.ext.registerXXXConfig() 函数注册配置项。
XXX 为配置项的类型，目前支持 string、int、float、bool、template、option 六种类型。注意按照小驼峰命名法大写
同样的，插件也可以使用 seal.ext.getXXXConfig() 函数获取配置项的值。
你也可以直接使用 seal.ext.getConfig() 函数获取配置项的值，这个函数会返回一个 ConfigItem 对象，
包含了配置项的类型、值、默认值等信息。
ConfigItem 对象的类型定义如下，调用时请使用 jsbind 中的值作为 key
type ConfigItem struct {
+ Key string `json:"key" jsbind:"key"`
+ Type string `json:"type" jsbind:"type"`
+ DefaultValue interface{} `json:"defaultValue" jsbind:"defaultValue"`
+ Value interface{} `json:"value,omitempty" jsbind:"value"`
+ Option interface{} `json:"option,omitempty" jsbind:"option"`
+ Deprecated bool `json:"deprecated,omitempty" jsbind:"deprecated"`
+}
+更原始的 API
seal.ext.registerConfig() 函数也是可以使用的，你需要自己通过 seal.ext.newConfigItem() 来获取一个新的 ConfigItem 对象。
在对你的 ConfigItem 对象进行修改后，再调用 seal.ext.registerConfig() 函数进行注册。
// ==UserScript==
+// @name js-config-example
+// @author Szzrain
+// @version 1.0.0
+// @description 演示 js 配置项的用法
+// @timestamp 1698636875
+// @license MIT
+// ==/UserScript==
+
+if (!seal.ext.find('js-config-example')) {
+ const ext = seal.ext.new('js-config-example', 'SzzRain', '1.0.0');
+ // 创建一个命令
+ const cmdgetConfig = seal.ext.newCmdItemInfo();
+ cmdgetConfig.name = 'getconfig';
+ cmdgetConfig.help = '使用.getconfig <key> 来获取配置项，仅 master 可用';
+ cmdgetConfig.allowDelegate = true;
+ cmdgetConfig.solve = (ctx, msg, cmdArgs) => {
+ let val = cmdArgs.getArgN(1);
+ switch (val) {
+ case 'help': {
+ const ret = seal.ext.newCmdExecuteResult(true);
+ ret.showHelp = true;
+ return ret;
+ }
+ default: {
+ if (ctx.privilegeLevel === 100) {
+ let config = seal.ext.getConfig(ext, val);
+ if (config) {
+ seal.replyToSender(ctx, msg, config.value);
+ }
+ } else {
+ seal.replyToSender(ctx, msg, "你没有权限执行此命令");
+ }
+ return seal.ext.newCmdExecuteResult(true);
+ }
+ }
+ }
+ // 注册命令
+ ext.cmdMap['getconfig'] = cmdgetConfig;
+
+ // 注册扩展
+ seal.ext.register(ext);
+
+ // 注册配置项需在 ext 注册后进行
+ // 通常来说，register 函数的参数为 ext, key, defaultValue
+ seal.ext.registerStringConfig(ext,"testkey","testvalue");
+ seal.ext.registerIntConfig(ext,"testkey2", 123);
+ seal.ext.registerFloatConfig(ext,"testkey2", 123.456);
+ seal.ext.registerBoolConfig(ext,"testkey3", true);
+ seal.ext.registerTemplateConfig(ext,"testkey4", ["1","2","3","4"]);
+ // 注册单选项函数的参数为 ext, key, defaultValue, options
+ seal.ext.registerOptionConfig(ext, "testkey5", "1", ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10"]);
+}
+注册后的配置项会在 UI 中显示，可以在 UI 中修改配置项的值
推荐的流程：
git clone 到本地，进行开发。如果你没有 GitHub 账号，也不会用 git：
TS 插件代码需要编译为 js 文件才能被海豹核心加载。
开始使用模板工程时，需要先将所需依赖包安装好。在确认你所使用的包管理器后，在命令行使用如下命令：
npm install
+pnpm install
+当你写好了代码，需要将 ts 文件转换为 js 文件以便上传到海豹骰时，在命令行使用如下命令：
npm run build
+pnpm run build
+编译成功的 js 文件在 dist 目录下，默认的名字是 sealdce-js-ext.js。
当插件开发完成后（或者开始开发时），你还需要修改几处地方：
header.txt：这个文件是你插件的描述信息；tools/build-config.js：最开头一行 var filename = 'sealdce-js-ext.js'; 改成你中意的名字，注意不要与现有的重名。只列出其中主要的一些文件
srcindex.ts：你的扩展的代码就写在这个文件里。toolsbuild-config：一些编译的配置，影响 index.ts 编译成 js 文件的方式；build.js：在命令 npm run build 执行时所运行的脚本，用于读取 build-config 并按照配置进行编译。typesseal.d.ts：类型文件，海豹核心提供的扩展 API。header.txt：扩展头信息，会在编译时自动加到目标文件头部；package.json：命令 npm install 时就在安装这个文件里面所指示的依赖包；tsconfig.json：typescript 的配置。这里只是粗略的整理，具体请看 jsvm 源码。
按类别整理。
其中 ctx 为信息的 MsgContext，msg 为信息的 Message，一般会在定义指令函数时就声明，如：
cmd.solve = (ctx, msg, cmdArgs) => {
+ someFunction;
+}
+下面是 api 的说明（完全了吧......应该？）：
//被注释掉的 api 是可以提供的，但是在源码中被注释。
+//seal.setVarInt(ctx, `$XXX`, valueToSet) //`$XXX`即 rollvm（初阶豹语）中的变量，其会将$XXX 的值设定为 int 类型的 valueToSet。
+//seal.setVarStr(ctx, `$XXX`, valueToSet) //同上，区别是设定的为 str 类型的 valueToSet。
+seal.replyGroup(ctx, msg, something) //向收到指令的群中发送 something。
+seal.replyPerson(ctx, msg, something) //顾名思义，类似暗骰，向指令触发者（若为好友）私信 something。
+seal.replyToSender(ctx, msg, something) //同上，区别是群内收到就群内发送，私聊收到就私聊发送。
+seal.memberBan(ctx, groupID, userID, dur) //将指定群的指定用户封禁指定时间 (似乎只实现了 walleq 协议？)
+seal.memberKick(ctx, groupID, userID) //将指定群的指定用户踢出 (似乎也只实现了 walleq 协议？)
+seal.format(ctx, something) //将 something 经过一层 rollvm 转译并返回，注意需要配合 replyToSender 才能发送给触发者！
+seal.formatTmpl(ctx, something) //调用自定义文案 something
+seal.getCtxProxyFirst(ctx, cmdArgs) //获取被 at 的第一个人，等价于 getCtxProxyAtPos(ctx, 0)
+seal.vars.intGet(ctx, `$XXX`) //返回一个数组，其为 `[int 类型的触发者的该变量的值，bool]` 当 strGet 一个 int 或 intGet 一个 str 时 bool 为 false，若一切正常则为 true。（之所以会有这么奇怪的说法是因为 rollvm 的「个人变量」机制）。
+seal.vars.intSet(ctx, `$XXX`, valueToSet) //`$XXX` 即 rollvm（初阶豹语）中的变量，其会将 $XXX 的值设定为 int 类型的 valueToSet。
+seal.vars.strGet(ctx, `$XXX`) //返回一个数组，其为 `[str 类型的触发者的该变量的值，bool]`（之所以会有这么奇怪的说法是因为 rollvm 的「个人变量」机制），当 strGet 一个 int 或 intGet 一个 str 时 bool 为 false，如果一切正常则为 true。
+seal.vars.strSet(ctx, `$XXX`, valueToSet) //`$XXX` 即 rollvm（初阶豹语）中的变量，其会将 $XXX 的值设定为 str 类型的 valueToSet。
+//seal.vars.varSet(ctx, `$XXX`, valueToSet) //可能是根据数据类型自动推断 int 或 str？
+//seal.vars.varGet(ctx, `$XXX`) //同上
+seal.ext.newCmdItemInfo() //用来定义新的指令；没有参数，个人觉得可以视其为类（class）。
+seal.ext.newCmdExecuteResult(bool) //用于判断指令执行结果，true 为成功，false 为失败。
+seal.ext.new(extName, extAuthor, Version) //用于建立一个名为 extName，作者为 extAuthor，版本为 Version 的扩展。注意，extName，extAuthor 和 Version 均为字符串。
+seal.ext.find(extName) //用于查找名为 extname 的扩展，若存在则返回 true，否则返回 false。
+seal.ext.register(newExt) //将扩展 newExt 注册到系统中。注意 newExt 是 seal.ext.new 的返回值，将 register 视为 seal.ext.new() 是错误的。
+seal.coc.newRule() //用来创建自定义 coc 规则，github.com/sealdice/javascript/examples 中已有详细例子，不多赘述。
+seal.coc.newRuleCheckResult() //同上，不多赘述。
+seal.coc.registerRule(rule) //同上，不多赘述。
+seal.deck.draw(ctx, deckname, isShuffle) //他会返回一个抽取牌堆的结果。这里有些复杂：deckname 为需要抽取的牌堆名，而 isShuffle 则是一个布尔值，它决定是否放回抽取；false 为放回，true 为不放回。
+seal.deck.reload() //重新加载牌堆。
+//下面是 1.2 新增 api
+seal.newMessage() //返回一个空白的 Message 对象，结构与收到消息的 msg 相同
+seal.createTempCtx(endpoint, msg) // 制作一个 ctx, 需要 msg.MessageType 和 msg.Sender.UserId
+seal.applyPlayerGroupCardByTemplate(ctx, tmpl) // 设定当前 ctx 玩家的自动名片格式
+seal.gameSystem.newTemplate(string) //从 json 解析新的游戏规则。
+seal.gameSystem.newTemplateByYaml(string) //从 yaml 解析新的游戏规则。
+seal.getCtxProxyAtPos(ctx, pos) //获取第 pos 个被 at 的人，pos 从 0 开始计数
+seal.atob(base64String) //返回被解码的 base64 编码
+seal.btoa(string) //将 string 编码为 base64 并返回
+注
声明和注册扩展的代码部分已省略。
replyGroup replyPerson replyToSender//在私聊触发 replyGroup 不会回复
+seal.replyGroup(ctx, msg, 'something'); //触发者会收到"something"的回复
+seal.replyPerson(ctx, msg, 'something'); //触发者会收到"something"的私聊回复
+seal.replyToSender(ctx, msg, 'something'); //触发者会收到"something"的回复
+memberBan memberKick是否保留待议
//注意这些似乎只能在 WQ 协议上实现;
+seal.memberBan(ctx, groupID, userID, dur) //将群为 groupID，userid 为 userID 的人封禁 dur（单位未知）
+seal.memberKick(ctx, groupID, userID) //将群为 groupID，userid 为 userID 的人踢出那个群
+format formatTmpl//注意 format 不会自动 reply，而是 return，所以请套一层 reply
+seal.replyToSender(ctx, msg, seal.format(`{$t玩家}的人品为：{$t人品}`))
+//{$t人品} 是一个 rollvm 变量，其值等于 .jrrp 出的数值
+//回复：
+//群主的人品为：87
+seal.replyToSender(ctx, msg, seal.formatTmpl(unknown))
+//这里等大佬来了再研究
+getCtxProxyFirst getCtxProxyAtPoscmd.solve = (ctx, msg, cmdArgs) => {
+ let ctxFirst = seal.getCtxProxyFirst(ctx, cmdArgs)
+ seal.replyToSender(ctx, msg, ctxFirst.player,name)
+}
+ext.cmdMap['test'] = cmd
+//输入：.test @A @B
+//返回：A 的名称。这里其实获取的是 A 玩家的 ctx，具体见 ctx 数据结构。
+cmd.solve = (ctx, msg, cmdArgs) => {
+ let ctx3 = seal.getCtxProxyAtPos(ctx, 3)
+ seal.replyToSender(ctx, msg, ctx3.player,name)
+}
+ext.cmdMap['test'] = cmd
+//输入：.test @A @B @C
+//返回：C（第三个被@的人）的名称。这里其实获取的是 C 玩家的 ctx，具体见 ctx 数据结构。
+vars// 要看懂这里你可能需要学习一下初阶豹语
+seal.vars.intSet(ctx, `$m今日打卡次数`, 8) //将触发者的该个人变量设置为 8
+seal.vars.intGet(ctx, `$m今日打卡次数`) //返回 [8,true]
+seal.vars.strSet(ctx, `$g群友经典语录`, `我要 Git Blame 一下看看是谁写的`) //将群内的该群组变量设置为“我要 Git Blame 一下看看是谁写的”
+seal.vars.strGet(ctx, `$g群友经典语录`) //返回 ["我要 Git Blame 一下看看是谁写的",true]
+ext//用于注册扩展和定义指令的 api，已有详细示例，不多赘述
+coc//用于创建 coc 村规的 api，已有详细示例，不多赘述
+deckseal.deck.draw(ctx, `煤气灯`, false) //返回 放回抽取牌堆“煤气灯”的结果
+seal.deck.draw(ctx, `煤气灯`, true) //返回 不放回抽取牌堆“煤气灯”的结果
+seal.deck.reload() //重新加载牌堆
+//这里实在不知道如何举例了
+seal.gameSystem.newTemplate(string) //从 json 解析新的游戏规则。
+seal.gameSystem.newTemplateByYaml(string) //从 yaml 解析新的游戏规则。
+seal.applyPlayerGroupCardByTemplate(ctx, tmpl) // 设定当前 ctx 玩家的自动名片格式
+seal.newMessage() //返回一个空白的 Message 对象，结构与收到消息的 msg 相同
+seal.createTempCtx(endpoint, msg) // 制作一个 ctx, 需要 msg.MessageType 和 msg.Sender.UserId
+seal.atob(base64String) //返回被解码的 base64 编码
+seal.btoa(string) //将 string 编码为 base64 并返回
+seal.getEndPoints() //返回骰子（应该？）的 EndPoints
+seal.getVersion() //返回一个 map，键值为 version 和 versionCode
+ctx 的内容//在 github.com/sealdice/javascript/examples_ts/seal.d.ts 中有完整内容
+// 成员
+ctx.group // 当前群信息 (对象)
+ctx.player // 当前玩家数据 (对象)
+ctx.endPoint // 接入点数据 (对象)
+// 以上三个对象内容暂略
+ctx.isCurGroupBotOn // bool
+ctx.isPrivate // bool 是否私聊
+ctx.privilegeLevel // int 权限等级：40 邀请者、50 管理、60 群主、70 信任、100 master
+ctx.delegateText // string 代骰附加文本
+// 方法 (太长，懒.)
+chBindCur
+chBindCurGet
+chBindGet
+chBindGetList
+chExists
+chGet
+chLoad
+chNew
+chUnbind
+chUnbindCur
+chVarsClear
+chVarsGet
+chVarsNumGet
+chVarsUpdateTime
+loadGroupVars
+loadPlayerGlobalVars
+loadPlayerGroupVars,notice
+ctx.group 的内容// 成员
+active
+groupId
+guildId
+groupName
+cocRuleIndex
+logCurName
+logOn
+recentDiceSendTime
+showGroupWelcome
+groupWelcomeMessage
+enteredTime
+inviteUserId
+// 方法
+extActive
+extClear
+extGetActive
+extInactive
+extInactiveByName
+getCharTemplate
+isActive
+playerGet
+ctx.player 的内容// 成员
+name
+userId
+lastCommandTime
+autoSetNameTemplate
+// 方法
+getValueNameByAlias
+ctx.endPoint 的内容// 成员
+baseInfo
+id
+nickname
+state
+userId
+groupNum
+cmdExecutedNum
+cmdExecutedLastTime
+onlineTotalTime
+platform
+enable
+// 方法
+adapterSetup
+refreshGroupNum
+setEnable
+unmarshalYAML
+msg 的内容// 成员
+msg.time // int64 发送时间
+msg.messageType // string group 群聊 private 私聊
+msg.groupId // string 如果是群聊，群号
+msg.guildId // string 服务器群组号，会在 discord,kook,dodo 等平台见到
+msg.sender // 发送者信息 (对象)
+ sender.nickname
+ sender.userId
+msg.message
+msg.rawId // 原始信息 ID, 用于撤回等
+msg.platform // 平台
+// 方法
+// (似乎目前没有？)
+cmdArgs 的内容// 成员
+.command // string
+.args // []string
+.kwargs // []Kwarg
+.at // []AtInfo
+.rawArgs // string
+.amIBeMentioned // bool (为何要加一个 Be?)
+.cleanArgs // string 一种格式化后的参数，也就是中间所有分隔符都用一个空格替代
+.specialExecuteTimes // 特殊的执行次数，对应 3# 这种
+// 方法
+.isArgEqual(n, ss...) // 返回 bool, 检查第 n 个参数是否在 ss 中
+.eatPrefixWith(ss...) // 似乎是从 cleanArgs 中去除 ss 中第一个匹配的前缀
+.chopPrefixToArgsWith(ss...) // 不懂
+.getArgN(n) // -> string
+.getKwarg(str) // -> Kwarg 如果有名为 str 的 flag，返回对象，否则返回 null/undefined(不确定)
+.getRestArgsFrom(n) // -> string 获取从第 n 个参数之后的所有参数，用空格拼接成一个字符串
+本节内容
本节将展示自定义回复编写的进阶部分，请善用侧边栏和搜索，按需阅读文档。
在部分内容中，我们假定你了解海豹变量机制和正则表达式。如果你对正则表达式还很陌生，可以阅读以下教程或在互联网自行搜索学习。
首先我们打开「自定义回复」页，新建一项自定义回复。
使用 .text 帮助测试
.text <文本> 将是你的一大助力，它会输出后面文本的执行结果，你可以将它看成不需要触发词的自定义回复。
当然，在采用 .text 指令进行 debug 时，可能出现因为测试的内容对变量造成影响，而不得不频繁复制黏贴清空指令的情况。此时建议专门开一个一两个字即可触发的自定义回复，用来测试。
嵌入 CQ 码
返回内容可以嵌入 CQ 码。CQ 码文档见 CQ 码列表。
自定义回复中分「条件」和「结果」两个部分。在 配置 - 自定义回复 中，我们已经了解了一些简单的回复编写，下面将补充介绍进阶内容。
模糊匹配将比较收到的消息与指定文本，内容相似时触发。
比较定义在 dice/ext_reply_logic.go 中，内容 jaro 和 hamming 平均值高于阈值（0.7）被认为是相似：
func strCompare(a string, b string) float64 {
+ va := strsim.Compare(a, b, strsim.Jaro())
+ vb := strsim.Compare(a, b, strsim.Hamming())
+ return (va + vb) / 2
+}
+模糊匹配未命中
模糊匹配可能出现感觉能匹配上，但实际上没办法匹配上的情况。我们更建议你使用「包含文本」或「正则匹配」。
使用正则匹配时，直接在要匹配的文本一栏中写入正则表达式即可。
正则匹配可以将回复中的一部分存入变量中以备调用：
正则匹配：^购买(.+)
+输出文本：{$t玩家}购买了{$t1}
+
+购买猫粮
+Dice: <于言诺>购买了猫粮
+正则匹配会将满足匹配的整条消息存入 $t0，而正则中的分组会按顺序存入 $t1 $t2 等中。在如上例子中，就是将 购买 后用括号括起来的部分存入了 $t1 中，从而可以进行调用。
如额外存在组名，如 (?P<A>cc)，将会额外存入 $tA。
不要使用某些前缀！
由于 . 。 / ! 等符号会作为海豹中指令的前缀，因此作为前缀时可能导致将其识别为指令而非自定义回复的情况，建议换成别的前缀。
正则中匹配 CQ 码
海豹支持用正则匹配 CQ 码，但是如果你这么做了，请在 [ ] 前面进行转义。
示例：^\[CQ:xxx,xx=xxx\]
在「表达式为真」匹配中，只需要直接在匹配文本中写出形如 变量名 == 需要的值 的形式即可，不需要使用任何 {} 。
在回复文本中，可以调用一些 变量，也可以嵌入 内置脚本语言。
.text {$t玩家}进行测试
+
+返回：<测试用户>进行测试
+.text {d100}
+
+1 // 此处返回 d100 的结果
+未赋值的变量
所有变量在未被赋值时被调用的值都为 0。
{% %} 被称为执行块。由 {% %} 括起来的部分会被作为代码执行，输出最后一个语句的结果。执行块中的两个语句之间要使用 ; 隔开。
如果想要输出字符串，则应该用 ` / " / ' 括上。
{% \$t1="114514" %} 的式子会输出 114514。结果中调用变量
若想在结果中调用变量，请用反引号。目前海豹只支持在反引号中调用变量。
下面是一个简单的示例，这里的第一句也是最后一句，所以它的结果会被输出。
.text {% $t测试=1 %}
+if{%
+$t测试=1;
+if $t测试==1 {$t输出="赞美木落"};
+if $t测试==2 {$t输出="快点更新"};
+if $t测试!=2&&$t测试!=1 {$t输出="群主女装"}
+%}
+{$t输出}
+首先给 $t测试赋值为 1，然后进入判断：
$t测试 等于 1，则变量 $t输出 等于 "赞美木落"；$t测试 等于 2，则变量 $t输出 等于 "快点更新"；$t测试 既不等于 2 也不等于 1，则变量 $t输出 等于 "群主女装";最后，输出变量 $t输出。
容易误解的 if 使用
目前海豹语并不支持 else if，if 和 else 是一对一匹配的。所以当形如：
if xxx {xxx};
+if xxx {xxx}
+else {xxx}
+的语句出现时，并不是 if elseif elseif else 的关系！即使满足了第一个 if，其结果也是执行 else 中的内容！
{%
+$t0=1;
+$tRand=d6;
+if $t0==1 {$t0=$t0+$tRand}
+%}
+{$t0}
+在这个例子里，我们先给 $t0 赋值为 1，然后判断 $t0 是否等于 1，若通过则 $t0 的值增加 1d6，最后输出结果。
以养猫功能中猫好感度为例：
{%
+$mCatFavor<=100 ? `#{DRAW-第一档猫好感}`,
+$mCatFavor<=250 ? `#{DRAW-第二档猫好感}` ,
+$mCatFavor<=600 ? `#{DRAW-第三档猫好感}` ,
+$mCatFavor<=1500 ? `#{DRAW-第四档猫好感}` ,
+$mCatFavor<=2500 ? `#{DRAW-第五档猫好感}` ,
+1 ? `#{DRAW-第六档猫好感}`
+%}
+在这一脚本中，根据猫好感度 $mCatFavor 不同，需要输出不同回复的机制。
除了形如
{%
+判断1 ? `#{DRAW-牌组1}`,
+判断2 ? `#{DRAW-牌组2}`,
+判断3 ? `#{DRAW-牌组3}`,
+1 ? `#{DRAW-牌组4}`,
+ %}
+的写法外，还可以使用：
{%
+if 判断1 {
+ $tRand=d6;
+ $t输出=$tRand==1?`内容1`,
+ $t输出=$tRand==2?`内容2`,
+ $t输出=$tRand==3?`内容3`,
+ $t输出=$tRand==4?`内容4`,
+ $t输出=$tRand==5?`内容5`,
+ $t输出=$tRand==6?`内容6`
+ };
+if 判断2 {$tRand=d10;$t输出=$tRand==1?`内容1`,……};
+if 判断3 {$tRand=d10;$t输出=$tRand==1?`内容1`,……};
+ %}
+实质上没有太大区别，可根据喜好选择。
以踢海豹为例，这一自定义回复的多行输出实现上并不是：
{$t输出0}
+{$t输出1}
+{$t输出2}
+{$t输出3}
+而是在为四个 $t输出 变量赋值时，于内部写上 \n，采用 {$t输出0}{$t输出1}{$t输出2}{$t输出3} 的形式。
这是因为如果某一变量可能为空时，如果采用第一种分行的写法，会出现这样的效果：
踢海豹
+
+回复：
+Dice: <于言诺>一脚踢向海豹，踢了3格。
+海豹现在离终点还有37格。
+
+海豹的逃走骰：1d100=60，海豹没能逃脱凶猛恶汉们的掌控！
+可以看见，在中间会出现突兀的空行。这是因为虽然并没有在变量内部赋值 \n，但是由于海豹读取时会按照写的格式读取，因此在应当是 $t输出2 的一行中，会照样调用 {$t输出2}，照常空行。
所以，如果想要某个变量为空时，看不出来这里应该存在什么，就最好多做几次实验，好好规划一下换行符 \n 的位置。
海豹提供了一系列时间变量来调用，以打卡指令为例，可以采用如下两种写法中的一种（示例为每人每天一次，如要每群自行将 $m 换成 $g）：
写法 1
文本匹配：你需要的文本
表达式为真：$m变量 != $tDate
回复：{if 1 {$m变量=$tDate}}你需要的回复文本
$m变量 作为标记变量，用 if 是防止它出现在回复文本中。文本匹配：你需要的文本
表达式为真：$m变量==$tDate
回复：在一天触发多次时的回复
写法 2
文本匹配：你需要的文本
回复：
{%
+if $m变量!=$tDate {
+ $t输出=`你需要的回复文本`;
+ $m变量=$tDate//对其赋值，作为标记
+} else {
+ $t输出=`在一天触发多次时的回复`
+ }
+ %}
+{$t输出}
+以上两种写法实现效果没有差别，具体使用哪种请自行决断。
以石头剪刀布为例，为了实现骰子随机出招的效果，令 $tRand=d3，然后根据 $tRand 的情况赋值 $tDicePlay。通过骰子出招和玩家出招两个变量判断，输出游戏结果，并记录场次。
为了防止直接使用 {%%} 进行赋值导致的变量显示，需要在最外面写 if 1 ，则在生成 $tRand之后再次判断的时候，可以使用 $tDicePlay=条件算符，或是再新开一行用条件算符或者条件语句实现。
以下给出在同一个 if 内直接赋值的写法和新开一行使用条件语句的写法：
{% //在同一个if内直接赋值。可以在赋值时使用条件算符。
+if 1 {
+ $tRand=d3;
+ $tDicePlay=$tRand==1?"石头",
+ $tRand==2?"剪刀",
+ 1?"布"
+ }
+%}
+
+{% //新开一行赋值
+if 1 {
+ $tRand=d3;
+ } ;
+if $tRand==1 {$tDicePlay="石头"};
+if $tRand==2 {$tDicePlay="剪刀"};
+if $tRand==3 {$tDicePlay="布"}
+%}
+两种写法实现效果相同，石头剪刀布内在这里采用了第一种，实际上没有差别。
生成骰子出招并获取玩家出招之后，就开始判断。这里除了平局可以使用 $tDicePlay==$t0 省事之外，其他的都需要在条件中用多个进行嵌套。
条件判断
豹语语法中，判断时条件中的 || 和 && 是从左往右计算的，如果后面有需要优先计算与或的东西，请加好括号。
if $t0==$tDicePlay {
+ $t输出=`那我出{$tDicePlay}！{$t玩家}出的是{$t0}啊，我们平局了。`;
+ $mPlayerTime=$mPlayerTime+1
+ };
+if $t0=="剪刀"&&$tDicePlay=="石头"||($t0=="石头"&&$tDicePlay=="布")||($t0=="布"&&$tDicePlay=="剪刀") {
+ //后两个与需要单独计算，加上括号
+ $t输出=`那我出{$tDicePlay}！{$t玩家}出的是{$t0}啊，我赢了。`;
+ $mPlayerTime=$mPlayerTime+1;
+ $mPlayerLose=$mPlayerLose+1
+ };
+if $t0=="石头"&&$tDicePlay=="剪刀"||($t0=="布"&&$tDicePlay=="石头")||($t0=="剪刀"&&$tDicePlay=="布") {
+ $t输出=`那我出{$tDicePlay}！{$t玩家}出的是{$t0}啊，你赢了。`;
+ $mPlayerTime=$mPlayerTime+1;
+ $mPlayerWin=$mPlayerWin+1
+ }
+AxxxxxxxB 型文本前缀匹配：A
后缀匹配：B
回复：怎么辉石呢
输入：A
+无回复
+
+输入：B
+无回复
+
+输入：AB
+怎么辉石呢
+
+输入：A间隔B
+怎么辉石呢
+
具体实现，第一段
第二段
这两段较为常规，第三段开始变形了：
{%
+ if $mStory == 4 { $mStory = 5 };
+ if $mStory == 3 { $mStory = 4 };
+ if $mStory == 2 { $mStory = 3 };
+
+ $mStory == 3 ? '这个村子有一户人家，门前有两棵树',
+ $mStory == 4 ? '一棵是函树，一棵是反函树',
+ $mStory == 5 ? '我讲完了。',
+ 1 ? '？'
+%}
+
+{% if $mStory == 5 { $mStory=0 } %}
+本节内容
本节将介绍敏感词库的编写，请善用侧边栏和搜索，按需阅读文档。
你可以直接按照以下格式书写 <words>.txt：
#notice
+提醒级词汇 1
+提醒级词汇 2
+
+#caution
+注意级词汇 1
+注意级词汇 2
+
+#warning
+警告级词汇
+
+#danger
+危险级词汇
+你可以直接按照以下格式书写 <words>.toml：
# 元信息，用于填写一些额外的展示内容
+[meta]
+# 词库名称
+name = '测试词库'
+# 作者，和 authors 存在一个即可
+author = ''
+# 作者（多个），和 author 存在一个即可
+authors = [ '<匿名>' ]
+# 版本，建议使用语义化版本号
+version = '1.0'
+# 简介
+desc = '一个测试词库'
+# 协议
+license = 'CC-BY-NC-SA 4.0'
+# 创建日期，使用 RFC 3339 格式
+date = 2023-10-30
+# 更新日期，使用 RFC 3339 格式
+updateDate = 2023-10-30
+
+# 词表，出现相同词汇时按最高级别判断
+[words]
+# 忽略级词表，没有实际作用
+ignore = []
+# 提醒级词表
+notice = [
+ '提醒级词汇 1',
+ '提醒级词汇 2'
+]
+# 注意级词表
+caution = [
+ '注意级词汇 1',
+ '注意级词汇 2'
+]
+# 警告级词表
+warning = [
+ '警告级词汇 1',
+ '警告级词汇 2'
+]
+# 危险级词表
+danger = [
+ '危险级词汇 1',
+ '危险级词汇 2'
+]
+本节内容
本节将介绍海豹扩展功能的进阶内容，请善用侧边栏和搜索，按需阅读文档。
海豹核心提供了多种扩展功能，这些功能能让你实现更多的个性化功能，但通常也需要你具备一些知识。
我们建议，在尝试使用对应功能进行个性化前，先阅读本章的对应小节，帮助你快速掌握相关内容。
阅读完小节教程后，如果在使用中依然存在疑问，可以在官方群内寻求帮助。
在很多地方为了实现一些逻辑，都需要用到海豹所提供的一种简单的脚本语言，可以称为「海豹语」「豹语」等。
我们非常建议你在扩展功能的编写中，先了解海豹语。见 扩展-内置脚本语言。
在牌堆、JS 插件、敏感词库等的编写中，我们通常需要在对应格式的文件进行编写。
务必使用更专业的编辑器，如果你不知道选择什么，可以尝试使用 vscode、sublime text或 MT 管理器（Android）等，这些都是被广泛使用的优秀编辑器。
更专业的编辑器能更好地帮助你编写相关格式的文件。这些编辑器提供的语法高亮、自动补全、格式化、错误检查、编码转换等诸多功能，能为你带来更好的编写体验。
不建议使用 Windows 记事本、Notepad++ 编写。
如何获取安装包？
官网应当是你下载软件的首选途径，请不要被搜索引擎等误导进各种下载站，它们很可能会提供二次封装后、捆绑大量流氓软件的安装包。
但由于各种原因，官网下载可能会十分缓慢，你还可以选择从海豹官方群的群文件中获取安装包。通常群文件的「工具＆内置文件」中，请善用搜索。
本节内容
本节将介绍海豹内置的脚本语言，请善用侧边栏和搜索，按需阅读文档。
为了在很多地方支持实现一些逻辑，但又不至于直接使用学习门槛较高的正式编程语言，海豹提供了一种简单易学的脚本语言，可以称为「海豹语」「豹语」等。
你可能注意到，在自定义文案等地方，出现了一些以 $t 开头的东西，这些是海豹中的变量。
变量的名称可以是汉字、字母和数字，$t 是一个特殊的变量前缀，还有其它的前缀。不同前缀代表不同的作用域：
| 变量名字 | 用途 | 举例 |
|---|---|---|
| 普通名字 | 玩家的角色属性 | 理智、力量、智力 |
$t开头 | 个人临时变量，不存数据库 | $t随机点数 |
$m开头 | 个人变量，跨群存在 | $m今日人品 |
$g开头 | 群变量，群内所有人共享 | $g群主体重 |
所有变量均可以在 .rx / .rxh / .ra/ .text 等指令以及「自定义文案」中使用。
变量不生效？
如果一部分变量无效，请检查海豹是否为最新版本。
一些内置变量
| 变量名 | 内容 | 示例结果 |
|---|---|---|
$t玩家 | 当前人物卡的名字，如果不存在则为群昵称或 QQ 昵称。 | <木落> |
$t玩家_RAW | 同上，但没有<> | 木落 |
$tQQ昵称 | QQ 昵称 | <木落> |
$t账号ID | 海豹格式的 ID | QQ:123456789 |
$t账号ID_RAW | 原始格式的 ID | 123456789 |
$tQQ | 海豹格式的 ID | QQ:123456789 |
$t群名 | 群名 | 海豹核心·SealDice 用户群 |
$t群号 | 海豹格式的 ID | QQ-Group:987654321 |
$t群号_RAW | 原始格式的 ID | 987654321 |
$t个人骰子面数 | 个人骰子面数 | 100 |
$tDate | 数字格式的现日期 | 20230109 |
$tYear | 数字格式的年份 | 2023 |
$tMonth | 数字格式的现月份 | 1 |
$tDay | 数字格式的现日期 | 9 |
$tWeekday | 数字格式的星期（1-7） | 1 |
$tHour | 数字格式的现时间（小时） | 15 |
$tMinute | 数字格式的现时间（分钟） | 41 |
$tSecond | 数字格式的现时间（秒） | 55 |
$tTimestamp | 数字格式的 10 位时间戳 | 1673250115 |
$t文本长度 | 触发消息的文本，汉字长度为 3，英文字母和数字长度为 1。 | 6 |
$t平台 | 触发的平台 | |
$t游戏模式 | 随 .set coc/dnd 改变 | coc7 |
$t消息类型 | 触发位置为群还是私聊（group/private） | group |
娱乐:今日人品 | 自定义文案 | <木落> 的今日人品为 0 |
常量:APPNAME | 软件名 | SealDice |
常量:VERSION | 版本号 | 1.4.0 |
$tMsgID | 消息 ID，仅自定义回复中可用。 | -123 |
所有自定义文案也均为可用变量。
// 注意，目前并不支持写注释，此为教程中便于展示
+// 文本类型
+$t0 = '文本'
+$t0 = "也是文本"
+$t0 = `特殊文本类型，可以插入表达式，例如，玩家的力量数值: {力量}`
+$t0 = `另一种插入表达式的写法 {% 力量 %} `
+
+// 数字类型
+$t0 = 1
+
+// 布尔类型：没有专门的布尔类型，0 或空字符串被视为 False，非零和非空字符串为 True
+$t0 > 1
+$t0 >= 1
+$t0 == 1
+$t0 != 1
+$t0 < 1
+$t0 <= 1
+多个语句可以用 ; 分隔，取分隔后的最后一项的值，为整个表达式的值，例如：
$t0 = 1;2;3
+此时 $t0 的值为 3
加减乘除余 + -* / %
+乘方 ^ ** // 2 ** 3 或 2 ^ 3，即 2 的 3 次方
+d 常规骰子算符，用法举例 d20 2d20k1 d20 优势
f 命运骰，随机骰 4 次，每骰结果可能是 -1 0 1，记为 - 0 +
b 奖励骰 (COC)
p 惩罚骰 (COC)
c 双十字
?灵视 >= 40 ? '如果灵视达到40以上，你就能看到这句话'
+可以用这个指令测试，下同：
.st 灵视 41
+.text {灵视 >= 40 ? '如果灵视达到 40 以上，你就能看到这句话'}
+? ,灵视 >= 80 ? '看得很清楚吗？',
+灵视 >= 50 ? '不错，再靠近一点……',
+灵视 >= 30 ? '仔细听……',
+灵视 >= 0 ? '呵，无知之人。'
+应用举例，默认的 jrrp
{$t玩家} 今日人品为{$t人品}，{%
+ $t人品 > 95 ? '人品爆表！',
+ $t人品 > 80 ? '运气还不错！',
+ $t人品 > 50 ? '人品还行吧',
+ $t人品 > 10 ? '今天不太行',
+ 1 ? '流年不利啊！'
+%}
+? :灵视 >= 40 ? '如果灵视达到 40 以上，你就能看到这句话' : '无知亦是幸运'
+if $t0 > 10 {
+ $t1 = "aaa"
+} else {
+ $t1 = 'bbb'
+}
+出现格式化错误
如果上面的代码输出「格式化错误」，那是因为你的 $t0 不是数值。字符串当然不能和数值比较大小，所以会报错。
解决方法：.text {$t0=0}
实际测试：
.text {% if $t0 > 10 { $t1="aaa"} else { $t1 = 'bbb' }; $t1 %}
+本节内容
本节将介绍海豹在 CoC 和 D&D 规则中默认使用的同义词。
属性同义词是在录入和存储角色数据时，将若干个属性名视为同一个属性、互相可以替代使用。
这一设计是为了解决下面这样的问题：（由于笔者的游戏栈，使用 CoC 举例）
场景举例
用户可能使用某些自动工具创建了一名调查员，由工具生成了录入数据的指令。这指令可能包含了类似这样的内容：
.st 力量50str50
+我们知道，「str」是「力量」属性的英文缩写法，它们完全指代的是同一属性。
因此，我们期待这样的指令实际只录入一条属性，但是用户仍然可以用「力量」或「str」的任何一个名字使用这一属性。
$ .st 力量50str50
+<木落>的属性录入完成，本次共记录了2条数据 （其中1条为同义词）
+
+# 实际上只有一条属性
+$ .st show
+<木落>的个人属性为：力量: 50
+
+# 可以用各种名字使用
+$ .ra 力量
+<木落>尝试使用"力量"技能：D100=64/50 失败
+$ .ra STR
+<木落>尝试使用"力量"技能：D100=78/50 失败
+
+# 可以用各种名字修改
+$ .st str+10
+<木落>的属性变化：
+力量: 50 ➯ 60 (增加10=10)
+$ .ra 力量
+<木落>尝试使用"力量"技能：D100=90/60 失败
+类似地，在 CoC 中，「智力」与「灵感」是规则书规定的同一属性的两个名字。它们也被视为同义词。
一些分支专精技能的名字，如「冲锋枪」，我们将「射击：冲锋枪」作为它的同义词，以适配尽量多的用法。
我们在选择同义词时遵循以下几条原则：
智力 与 灵感，教育 与 知识；力量 与 str；理智 与 理智值，根据原则 2，san 和 san值 也指向同一属性；侦查 与 侦察；快速交谈 与 7 版的 话术；又如 7 版的 魅惑 与 取悦；体质 与 體質；克苏鲁神话 与 克苏鲁 与 克苏鲁神话知识。为了确保你不会获取到过时内容，我们决定不将列表放在手册中，敬请理解。
这些同义词都是符合直觉的，你通常也无需专门查阅列表。如果你确实想了解，请参考以下内容。
`,11),u={href:"https://github.com/sealdice/sealdice-core/blob/master/dice/ext_coc7_template.go",target:"_blank",rel:"noopener noreferrer"},p=a(`D&D 规则的同义词可在骰子启动后，在本地文件 data/default/extensions/dnd5e/attribute.yaml 中查看。
这个文件遵守以下格式。其中，ac 位置上的名字是海豹核心选用的主要名字，后续列出的是它的同义词。
alias:
+ ac:
+ - AC
+ - 护甲等级
+ - 护甲值
+ - 护甲
+ - 護甲等級
+ - 護甲值
+ - 護甲
+ - 装甲
+ - 裝甲
+