插件管理

管理面板 → 扩展管理 → 插件，统一管理两类扩展，分两个选项卡：

JS 插件：兼容海豹 SealDice 的 JavaScript 插件（seal.* API）。
Lua 模组：兼容原版 Dice! 的 Lua mod（目录型 msg_reply 模块与单文件 msg_order 插件）。

上传与加载

点「上传插件」选择文件，按扩展名自动分流：

文件	去向
`.js`	JS 插件
`.lua`	Lua 单文件插件
`.zip`	Lua 目录型模组（含 reply 因果回复 / speech 模板 / 人物卡等）

也可以直接把文件放进数据目录（Lua 放 data/mod）再点「重新加载」——重载会同时刷新 JS 与 Lua 两侧，无需重启。

插件卡片

每个插件显示名称、版本、作者、简介与注册的指令列表，右侧操作：

启停开关：单个插件即时启用 / 禁用。
配置：JS 插件注册过配置项时出现，弹窗按类型渲染表单（开关 / 下拉选项 / 多行模板 / 数字 / 文本），保存后立即生效。
查看详情：版本、语言、许可、文件名、主页、完整简介、注册的指令；Lua 模组额外区分指令触发词类型（指令 / 关键词 / 含此词即触发）与帮助词条（用 .help <词条> 查询）；还可展开「存储的数据」查看插件持久化的键值，支持导出 JSON 与清空。
删除：连文件一起从磁盘删除（有确认弹窗）。

特殊标记：

JS兼容规则：以 seal.gameSystem / coc.registerRule 形式提供规则系统的 JS 插件，自动归入 data/mod，与原生 JSON 规则包区分。
旧版（已被顶替）：同名插件上传新版后旧版自动置灰停用。

更新检测

声明了更新地址的 JS 插件可单个「检查更新」或页头「检查更新」批量检查；发现新版本后一键「更新」替换。

分群启停

插件默认全局生效，群内可用指令按群控制（仅群主 / 管理员）：

.plugin list            列出插件与本群状态
.plugin on|off <名称>   启停某插件
.plugin all on|off      批量启停

兼容性

Lua 侧兼容原版 Dice! mod 生态，JS 侧兼容海豹 SealDice 插件（含 seal.vars 人物卡桥接、commands.disable 覆盖内置指令等）。海豹规则类插件还可以转换打包成规则包分发，实战示例见海豹插件转规则包与规则包开发。

群名片与显示名

群聊中，入站消息携带的群名片会优先使用；没有群名片时才回退 QQ 昵称。私聊没有群名片。

字段	值
`ctx.player.name`	统一显示名：群名片优先，否则 QQ 昵称
`ctx.player.card` / `msg.sender.card`	当前群名片；未设置或私聊时为空字符串
`msg.sender.nickname`	QQ 昵称（不受群名片影响）

cmd.solve = (ctx, msg) => {
  const displayName = ctx.player.name;
  const groupCard = ctx.player.card; // 需要严格读取群名片时使用
  seal.replyToSender(ctx, msg, `${displayName} / ${groupCard || '未设群名片'}`);
  return seal.ext.newCmdExecuteResult(true);
};

Lua 模组模板中，{nick} 是 QQ 昵称，{card} 是当前群名片（未设置时为空）。

插件管理 ​

上传与加载 ​

插件卡片 ​

更新检测 ​

分群启停 ​

兼容性 ​

群名片与显示名 ​