Skip to content

自动生成配置字段参考

本页由源码与 JSON Schema 自动生成,请勿手工编辑。叙事、示例与配置方法见配置参考

  • 生成命令: pnpm docs:config
  • 漂移检查: pnpm check:config-reference

Host 顶层字段

权威契约来自 Runtime 实际消费的 packages/im/runtime/src/host-config-schema.json;消费位置见 basic/cli/src/plugin-runtime/console-api-installer.ts

路径类型说明来源
httpobjectHTTP、Console、REST/RPC/SSE 与 Webhook Host。source
databaseobjectDatabase Host 与方言连接参数。source
aiobjectProvider、Agent、会话、记忆、工具与执行安全策略。source
mcpobject把 Bot 工具公开为 MCP Server。source
a2aobjectA2A Agent Card、远程执行与 Workroom 回调。source
speechobject语音识别与语音合成 Host。source
htmlRendererobjectHTML/图片渲染参数。source
assistantobject调度任务、事件入口和失败通知。source
log_levelstring | numberRuntime 日志级别。source
pluginobjectRoot Plugin 配置;组合时由项目 Schema 替换。source

插件实例字段

以下字段直接读取仓库中每个插件发布的 schema.jsonplugins.<name> 中的 <name> 是默认 instanceKey。

dingtalk

plugins/adapters/dingtalk/schema.json

路径类型必填默认值说明
plugins.dingtalk.apiBaseUrlstring"https://oapi.dingtalk.com"
plugins.dingtalk.masterstring | number框架 master(DingTalk userid;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.dingtalk.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.dingtalk.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.dingtalk.endpoints[].masterstring | number本 endpoint 的框架 master(DingTalk userid);覆盖顶层 master
plugins.dingtalk.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.dingtalk.endpoints[].appKeystringDingtalk app key
plugins.dingtalk.endpoints[].appSecretstringDingtalk app secret
plugins.dingtalk.endpoints[].webhookPathstringDingtalk webhook path
plugins.dingtalk.endpoints[].robotCodestringDingtalk robot code
plugins.dingtalk.endpoints[].idstringDingtalk bot name
plugins.dingtalk.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

discord

plugins/adapters/discord/schema.json

路径类型必填默认值说明
plugins.discord.connectionstring: "gateway", "interactions""gateway"Gateway WebSocket (default). interactions uses httpHostToken POST + Ed25519 verify.
plugins.discord.intentsarray<number>
plugins.discord.enableSlashCommandsbooleanfalse
plugins.discord.globalCommandsbooleanfalse
plugins.discord.defaultActivityobject
plugins.discord.defaultActivity.namestring
plugins.discord.defaultActivity.typestring: "PLAYING", "STREAMING", "LISTENING", "WATCHING", "COMPETING"
plugins.discord.defaultActivity.urlstring
plugins.discord.slashCommandsarray<object>
plugins.discord.applicationIdstringRequired when connection is interactions.
plugins.discord.publicKeystringRequired when connection is interactions (hex Ed25519 public key).
plugins.discord.interactionsPathstring"/discord/interactions"POST path on httpHostToken when connection is interactions.
plugins.discord.masterstring | number框架 master(Discord user snowflake;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.discord.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.discord.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.discord.endpoints[].masterstring | number本 endpoint 的框架 master(Discord user snowflake);覆盖顶层 master
plugins.discord.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.discord.endpoints[].tokenstringDiscord bot token
plugins.discord.endpoints[].idstringDiscord bot name
plugins.discord.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

email

plugins/adapters/email/schema.json

路径类型必填默认值说明
plugins.email.masterstring | number框架 master(email address;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.email.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.email.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.email.endpoints[].masterstring | number本 endpoint 的框架 master(email address);覆盖顶层 master
plugins.email.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.email.endpoints[].smtpobject
plugins.email.endpoints[].smtp.hoststring
plugins.email.endpoints[].smtp.portnumber
plugins.email.endpoints[].smtp.secureboolean
plugins.email.endpoints[].smtp.authobject
plugins.email.endpoints[].smtp.auth.userstring
plugins.email.endpoints[].smtp.auth.passstring
plugins.email.endpoints[].imapobject
plugins.email.endpoints[].imap.hoststring
plugins.email.endpoints[].imap.portnumber
plugins.email.endpoints[].imap.tlsboolean
plugins.email.endpoints[].imap.userstring
plugins.email.endpoints[].imap.passwordstring
plugins.email.endpoints[].imap.checkIntervalnumber60000
plugins.email.endpoints[].imap.mailboxstring"INBOX"
plugins.email.endpoints[].imap.markSeenbooleantrue
plugins.email.endpoints[].attachmentsobject
plugins.email.endpoints[].attachments.enabledbooleanfalse
plugins.email.endpoints[].attachments.downloadPathstring
plugins.email.endpoints[].attachments.maxFileSizenumber
plugins.email.endpoints[].attachments.allowedTypesarray<string>
plugins.email.endpoints[].idstringEmail bot name
plugins.email.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

github

plugins/adapters/github/schema.json

路径类型必填默认值说明
plugins.github.hoststringGitHub Enterprise hostname (default github.com)
plugins.github.webhook_pathstring"/github/webhook"
plugins.github.webhookPathstring"/github/webhook"
plugins.github.poll_intervalnumber60Deferred: polling fallback was removed in the Plugin Runtime migration; currently parsed but unused
plugins.github.auto_reply_reposarray<string>Repos whose Issue/PR comments auto-trigger AI without @bot
plugins.github.bot_loginstringOverride App bot login (default {slug}[bot])
plugins.github.workspace_rootstringManaged git workspace root
plugins.github.masterstring | number框架 master(GitHub user login or id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.github.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.github.endpointsarray<object>多账号:一个插件实例挂多个 endpoint
plugins.github.endpoints[].masterstring | number本 endpoint 的框架 master(GitHub user login or id);覆盖顶层 master
plugins.github.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.github.endpoints[].app_idstring | numberGitHub App ID
plugins.github.endpoints[].appIdstring | numberGitHub App ID (camelCase alias)
plugins.github.endpoints[].private_keystringGitHub App private key (PEM content or file path)
plugins.github.endpoints[].privateKeystringGitHub App private key (camelCase alias)
plugins.github.endpoints[].webhook_secretstringWebhook HMAC secret; enables httpHostToken POST route
plugins.github.endpoints[].webhookSecretstringWebhook HMAC secret (camelCase alias)
plugins.github.endpoints[].idstringGitHub App bot name
plugins.github.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

icqq

plugins/adapters/icqq/schema.json

路径类型必填默认值说明
plugins.icqq.masterstring | number框架 master QQ uin(/approve、AI/工具权限);endpoints[i].master 可逐项覆盖
plugins.icqq.trustedarray<string | number>框架 trusted QQ uin 列表(弱于 master)
plugins.icqq.passwordstringQQ 密码(可选,不填则扫码登录)
plugins.icqq.platformnumber: 1, 2, 3, 4, 5, 6, 71登录设备平台:1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom
plugins.icqq.verstring协议版本号,仅在对应 platform 有多个版本时有效,不填则使用最新版本
plugins.icqq.signApiAddrstring签名服务器地址;未配置时若安装了 @icqqjs/qqsign 则自动使用本地签名
plugins.icqq.dataDirstring数据存储文件夹路径,默认为主模块下的 data 文件夹
plugins.icqq.autoReconnectbooleantrue断线后是否自动重连(默认 true)
plugins.icqq.outboundMediastring: "file", "base64""file"出站媒体模式:file=落盘本地路径(默认); base64=CQ base64:// 内联
plugins.icqq.ignoreSelfbooleantrue群聊和频道中是否过滤自己的消息(默认 true)
plugins.icqq.resendbooleanfalse被风控时是否尝试用分片发送(默认 false)
plugins.icqq.cacheGroupMemberbooleantrue是否缓存群员列表(默认 true);群多时(500+)会多占约 100MB+ 内存
plugins.icqq.autoServerbooleantrue是否自动选择最优服务器(默认 true)
plugins.icqq.qqntbooleantrue是否使用 QQNT 协议(默认 true)
plugins.icqq.ntLoginboolean是否使用 NT 登录方式
plugins.icqq.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.icqq.endpoints[].idstringQQ uin
plugins.icqq.endpoints[].masterstring | number本 endpoint 的 master QQ uin;覆盖顶层 master
plugins.icqq.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.icqq.endpoints[].passwordstring本 endpoint 的 QQ 密码
plugins.icqq.endpoints[].platformnumber: 1, 2, 3, 4, 5, 6, 7登录设备平台:1=Android, 2=aPad, 3=Watch, 4=iMac, 5=iPad, 6=Tim, 7=Custom
plugins.icqq.endpoints[].verstring协议版本号
plugins.icqq.endpoints[].signApiAddrstring签名服务器地址
plugins.icqq.endpoints[].dataDirstring数据存储文件夹路径
plugins.icqq.endpoints[].autoReconnectboolean断线后是否自动重连
plugins.icqq.endpoints[].outboundMediastring: "file", "base64"出站媒体模式
plugins.icqq.endpoints[].ignoreSelfboolean是否过滤自己的消息
plugins.icqq.endpoints[].resendboolean被风控时是否分片发送
plugins.icqq.endpoints[].cacheGroupMemberboolean是否缓存群员列表
plugins.icqq.endpoints[].autoServerboolean是否自动选择最优服务器
plugins.icqq.endpoints[].qqntboolean是否使用 QQNT 协议
plugins.icqq.endpoints[].ntLoginboolean是否使用 NT 登录方式
plugins.icqq.commandPrefixstring""命令前缀(默认 '' 无前缀)。endpoints[i] 可逐项覆盖

kook

plugins/adapters/kook/schema.json

路径类型必填默认值说明
plugins.kook.connectionstring: "websocket", "webhook""websocket"WebSocket gateway (default). webhook requires httpHostToken, verify_token, and a public HTTPS callback URL.
plugins.kook.webhookPathstring"/kook/webhook"POST path registered via httpHostToken when connection is webhook.
plugins.kook.data_dirstring
plugins.kook.timeoutnumber10000
plugins.kook.max_retrynumber3
plugins.kook.ignorestring: "bot", "self""bot"
plugins.kook.logLevelstring: "trace", "debug", "info", "warn", "error", "fatal", "mark", "off""info"
plugins.kook.masterstring | number框架 master(KOOK user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.kook.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.kook.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.kook.endpoints[].masterstring | number本 endpoint 的框架 master(KOOK user id);覆盖顶层 master
plugins.kook.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.kook.endpoints[].tokenstringKOOK bot token
plugins.kook.endpoints[].verify_tokenstringKOOK developer console verify token (required for webhook mode).
plugins.kook.endpoints[].encrypt_keystringOptional Encrypt Key when message encryption is enabled in KOOK console.
plugins.kook.endpoints[].idstringKOOK bot name
plugins.kook.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

lark

plugins/adapters/lark/schema.json

路径类型必填默认值说明
plugins.lark.webhookPathstring"/lark/webhook"
plugins.lark.apiBaseUrlstring
plugins.lark.isFeishubooleantrue
plugins.lark.masterstring | number框架 master(Lark/Feishu open_id or user_id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.lark.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.lark.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.lark.endpoints[].masterstring | number本 endpoint 的框架 master(Lark/Feishu open_id or user_id);覆盖顶层 master
plugins.lark.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.lark.endpoints[].appIdstringLark app ID
plugins.lark.endpoints[].appSecretstringLark app secret
plugins.lark.endpoints[].encryptKeystringLark encrypt key
plugins.lark.endpoints[].verificationTokenstringLark verification token
plugins.lark.endpoints[].idstringLark bot name
plugins.lark.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

line

plugins/adapters/line/schema.json

路径类型必填默认值说明
plugins.line.webhookPathstring"/line/webhook"
plugins.line.apiBaseUrlstring"https://api.line.me"
plugins.line.masterstring | number框架 master(LINE user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.line.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.line.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.line.endpoints[].masterstring | number本 endpoint 的框架 master(LINE user id);覆盖顶层 master
plugins.line.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.line.endpoints[].channelSecretstringLINE channel secret
plugins.line.endpoints[].channelAccessTokenstringLINE channel access token
plugins.line.endpoints[].idstringLINE bot name
plugins.line.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

milky

plugins/adapters/milky/schema.json

路径类型必填默认值说明
plugins.milky.connectionstring: "ws", "sse", "webhook", "wss""ws"ws (default), sse (EventSource client), webhook or wss (webhook/wss via httpHostToken)
plugins.milky.reconnect_intervalnumber5000
plugins.milky.heartbeat_intervalnumber30000
plugins.milky.masterstring | number框架 master(QQ uin;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.milky.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.milky.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.milky.endpoints[].masterstring | number本 endpoint 的框架 master(QQ uin);覆盖顶层 master
plugins.milky.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.milky.endpoints[].baseUrlstringMilky HTTP API base URL (required); WS event path is derived as ws(s)😕/host/event
plugins.milky.endpoints[].pathstringPath for webhook / reverse-wss
plugins.milky.endpoints[].access_tokenstringMilky access token
plugins.milky.endpoints[].idstringMilky bot name
plugins.milky.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

napcat

plugins/adapters/napcat/schema.json

路径类型必填默认值说明
plugins.napcat.connectionstring: "ws", "wss", "http""ws"ws (default), wss (reverse WS), or http (POST webhook + HTTP API outbound)
plugins.napcat.reconnect_intervalnumber5000
plugins.napcat.heartbeat_intervalnumber30000
plugins.napcat.poll_intervalnumber30000
plugins.napcat.masterstring | number框架 master(QQ uin;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.napcat.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.napcat.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.napcat.endpoints[].masterstring | number本 endpoint 的框架 master(QQ uin);覆盖顶层 master
plugins.napcat.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.napcat.endpoints[].urlstringNapCat WebSocket URL (required for connection: ws)
plugins.napcat.endpoints[].pathstringWS path for reverse-wss
plugins.napcat.endpoints[].http_urlstringHTTP API base URL (connection: http outbound)
plugins.napcat.endpoints[].post_pathstringHTTP POST event path (connection: http inbound)
plugins.napcat.endpoints[].access_tokenstringNapCat access token
plugins.napcat.endpoints[].idstringNapCat bot name
plugins.napcat.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

onebot11

plugins/adapters/onebot11/schema.json

路径类型必填默认值说明
plugins.onebot11.connectionstring: "ws", "wss""ws"connection: ws (forward WS client, default) or wss (reverse WS via httpHostToken)
plugins.onebot11.reconnect_intervalnumber5000
plugins.onebot11.heartbeat_intervalnumber30000
plugins.onebot11.masterstring | number框架 master(platform user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.onebot11.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.onebot11.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.onebot11.endpoints[].masterstring | number本 endpoint 的框架 master(platform user id);覆盖顶层 master
plugins.onebot11.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.onebot11.endpoints[].urlstringOneBot implementation WebSocket URL (required for connection: ws)
plugins.onebot11.endpoints[].pathstringWS path for reverse-wss (connection: wss)
plugins.onebot11.endpoints[].access_tokenstringOneBot access token
plugins.onebot11.endpoints[].idstringOneBot11 bot name
plugins.onebot11.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

onebot12

plugins/adapters/onebot12/schema.json

路径类型必填默认值说明
plugins.onebot12.connectionstring: "ws", "webhook", "wss""ws"ws (default), webhook (httpHostToken POST), or wss (reverse WS via httpHostToken)
plugins.onebot12.reconnect_intervalnumber5000
plugins.onebot12.heartbeat_intervalnumber30000
plugins.onebot12.masterstring | number框架 master(platform user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.onebot12.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.onebot12.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.onebot12.endpoints[].masterstring | number本 endpoint 的框架 master(platform user id);覆盖顶层 master
plugins.onebot12.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.onebot12.endpoints[].urlstringOneBot implementation WebSocket URL (required for connection: ws)
plugins.onebot12.endpoints[].pathstringHTTP/WS path for webhook or reverse-wss
plugins.onebot12.endpoints[].api_urlstringHTTP action endpoint for webhook outbound (required for connection: webhook send)
plugins.onebot12.endpoints[].access_tokenstringOneBot access token
plugins.onebot12.endpoints[].idstringOneBot12 bot name
plugins.onebot12.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

qq

plugins/adapters/qq/schema.json

路径类型必填默认值说明
plugins.qq.modestring: "websocket", "webhook", "middleware""websocket"WebSocket gateway (default). webhook/middleware use httpHostToken POST.
plugins.qq.sandboxbooleanfalse
plugins.qq.botKindstring: "public", "private""public"公域/私域:均含 GROUP_AND_C2C_EVENT;频道消息分别为 PUBLIC_GUILD_MESSAGES / GUILD_MESSAGES。未显式配置 intents 时按此展开
plugins.qq.masterstring | number框架 master(endpoint 管理命令、AI/工具权限);openid。endpoints[i].master 可逐项覆盖
plugins.qq.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.qq.intentsarray<string>WebSocket Identify intents;省略时按 botKind 自动生成(public→含 PUBLIC_GUILD_MESSAGES)
plugins.qq.accessTokenUrlstring
plugins.qq.gatewayUrlstring
plugins.qq.webhookPathstring"/qq/webhook"POST path on httpHostToken for webhook/middleware modes.
plugins.qq.portnumberLegacy standalone webhook port (unused with httpHostToken).
plugins.qq.pathstringLegacy standalone webhook path (unused with httpHostToken).
plugins.qq.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.qq.endpoints[].appidstringQQ official bot app ID
plugins.qq.endpoints[].secretstringQQ official bot secret
plugins.qq.endpoints[].masterstring | number本 endpoint 的框架 master(openid);覆盖顶层 master
plugins.qq.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.qq.endpoints[].botKindstring: "public", "private"覆盖顶层 botKind(公域/私域),用于按 endpoint 生成 intents
plugins.qq.endpoints[].intentsarray<string>覆盖顶层 intents
plugins.qq.endpoints[].idstringQQ bot name
plugins.qq.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

sandbox

plugins/adapters/sandbox/schema.json

路径类型必填默认值说明
plugins.sandbox.masterstring | number框架 master(sandbox client id (distinct from endpoints[].owner);AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.sandbox.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.sandbox.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.sandbox.endpoints[].masterstring | number本 endpoint 的框架 master(sandbox client id (distinct from endpoints[].owner));覆盖顶层 master
plugins.sandbox.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.sandbox.endpoints[].contextstringSandbox context identifier
plugins.sandbox.endpoints[].ownerstringSandbox owner user ID
plugins.sandbox.endpoints[].idstringSandbox bot name
plugins.sandbox.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

satori

plugins/adapters/satori/schema.json

路径类型必填默认值说明
plugins.satori.connectionstring: "ws", "webhook""ws"ws (default) or webhook (httpHostToken POST route)
plugins.satori.heartbeat_intervalnumber10000WS PING interval in milliseconds
plugins.satori.masterstring | number框架 master(platform user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.satori.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.satori.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.satori.endpoints[].masterstring | number本 endpoint 的框架 master(platform user id);覆盖顶层 master
plugins.satori.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.satori.endpoints[].baseUrlstringSatori SDK HTTP/WS base URL (e.g. http://127.0.0.1:5140)
plugins.satori.endpoints[].tokenstringBearer token for API and WS IDENTIFY
plugins.satori.endpoints[].pathstringWebhook POST path (connection: webhook)
plugins.satori.endpoints[].idstringSatori bot name
plugins.satori.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

slack

plugins/adapters/slack/schema.json

路径类型必填默认值说明
plugins.slack.socketModebooleantruePrefer Socket Mode (default). Set false for HTTP Events via httpHostToken.
plugins.slack.webhookPathstring"/slack/events"
plugins.slack.clientPingTimeoutnumber15000Socket Mode client ping timeout (ms)
plugins.slack.masterstring | number框架 master(Slack user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.slack.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.slack.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.slack.endpoints[].masterstring | number本 endpoint 的框架 master(Slack user id);覆盖顶层 master
plugins.slack.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.slack.endpoints[].tokenstringBot User OAuth Token (xoxb-...)
plugins.slack.endpoints[].signingSecretstringRequired for HTTP Events API (socketMode: false)
plugins.slack.endpoints[].appTokenstringApp-Level Token (xapp-...) for Socket Mode
plugins.slack.endpoints[].idstringSlack bot name
plugins.slack.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

telegram

plugins/adapters/telegram/schema.json

路径类型必填默认值说明
plugins.telegram.pollingbooleantrueLong-poll getUpdates (default). Set false for webhook via httpHostToken.
plugins.telegram.webhookobjectWebhook settings when polling is false.
plugins.telegram.webhook.domainstring
plugins.telegram.webhook.pathstring"/telegram/webhook"
plugins.telegram.webhook.secretTokenstringVerified via X-Telegram-Bot-Api-Secret-Token.
plugins.telegram.allowedUpdatesarray<string>["message","callback_query"]
plugins.telegram.apiBaseUrlstring"https://api.telegram.org"
plugins.telegram.masterstring | number框架 master(Telegram user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.telegram.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.telegram.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.telegram.endpoints[].masterstring | number本 endpoint 的框架 master(Telegram user id);覆盖顶层 master
plugins.telegram.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.telegram.endpoints[].tokenstringTelegram bot token
plugins.telegram.endpoints[].idstringTelegram bot name
plugins.telegram.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

wechat-mp

plugins/adapters/wechat-mp/schema.json

路径类型必填默认值说明
plugins.wechat-mp.pathstring"/wechat/webhook"
plugins.wechat-mp.encryptbooleanfalse
plugins.wechat-mp.encryptModestring: "plain", "compatible", "secure"Default follows encrypt: 'plain' when encrypt=false, 'compatible' when encrypt=true
plugins.wechat-mp.replyModestring: "passive", "customer_service""passive"
plugins.wechat-mp.passiveReplyTimeoutMsnumber4500
plugins.wechat-mp.masterstring | number框架 master(WeChat OpenID;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.wechat-mp.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.wechat-mp.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.wechat-mp.endpoints[].masterstring | number本 endpoint 的框架 master(WeChat OpenID);覆盖顶层 master
plugins.wechat-mp.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.wechat-mp.endpoints[].appIdstringWeChat MP app ID
plugins.wechat-mp.endpoints[].appSecretstringWeChat MP app secret
plugins.wechat-mp.endpoints[].tokenstringWeChat MP callback token
plugins.wechat-mp.endpoints[].encodingAESKeystringWeChat MP encoding AES key
plugins.wechat-mp.endpoints[].idstringWeChat MP bot name
plugins.wechat-mp.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

wecom

plugins/adapters/wecom/schema.json

路径类型必填默认值说明
plugins.wecom.webhookPathstring"/wecom/callback"
plugins.wecom.apiBaseUrlstring"https://qyapi.weixin.qq.com"
plugins.wecom.masterstring | number框架 master(WeCom userid;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.wecom.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.wecom.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.wecom.endpoints[].masterstring | number本 endpoint 的框架 master(WeCom userid);覆盖顶层 master
plugins.wecom.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.wecom.endpoints[].corpIdstringWeCom corp ID
plugins.wecom.endpoints[].agentSecretstringWeCom agent secret
plugins.wecom.endpoints[].tokenstringWeCom callback token
plugins.wecom.endpoints[].encodingAESKeystringWeCom encoding AES key
plugins.wecom.endpoints[].idstringWeCom bot name
plugins.wecom.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

plugins/adapters/weixin-ilink/schema.json

路径类型必填默认值说明
plugins.weixin-ilink.botAgentstring
plugins.weixin-ilink.baseUrlstring"https://ilinkai.weixin.qq.com"
plugins.weixin-ilink.cdnBaseUrlstring"https://novac2c.cdn.weixin.qq.com/c2c"
plugins.weixin-ilink.longPollTimeoutMsnumber35000
plugins.weixin-ilink.masterstring | number框架 master(Weixin user id;AI/工具权限、endpoint 管理)。endpoints[i].master 可逐项覆盖
plugins.weixin-ilink.trustedarray<string | number>框架 trusted 用户列表(弱于 master)。endpoints[i].trusted 可逐项追加
plugins.weixin-ilink.endpointsarray<object>多账号:一个插件实例挂多个 endpoint。每项与顶层字段同构(id 必填,其余覆盖顶层)
plugins.weixin-ilink.endpoints[].masterstring | number本 endpoint 的框架 master(Weixin user id);覆盖顶层 master
plugins.weixin-ilink.endpoints[].trustedarray<string | number>本 endpoint 的 trusted 列表
plugins.weixin-ilink.endpoints[].botTokenstringiLink bot token (prefer env WEIXIN_ILINK_TOKEN or sidecar credential file)
plugins.weixin-ilink.endpoints[].idstringWeixin iLink bot name
plugins.weixin-ilink.commandPrefixstring""命令前缀(默认 '' 无前缀,任意文本按命令匹配;如 '/' 要求 / 开头)。endpoints[i] 可逐项覆盖

process-monitor

plugins/features/process-monitor/schema.json

路径类型必填默认值说明
plugins.process-monitor.enabledbooleantrue是否启用进程监控
plugins.process-monitor.notifyOnStartbooleantrue首次启动时通知
plugins.process-monitor.notifyOnRestartbooleantrue正常重启时通知
plugins.process-monitor.notifyOnCrashbooleantrue异常崩溃重启时通知
plugins.process-monitor.notifyChannelsarray<object>[]通知渠道(slice-1 仅 webhook 生效)
plugins.process-monitor.notifyChannels[].typestring: "user", "group", "webhook"
plugins.process-monitor.notifyChannels[].targetstring
plugins.process-monitor.notifyChannels[].platformstring

blackjack

plugins/games/blackjack/schema.json

该 Schema 没有声明字段。

dice-duel

plugins/games/dice-duel/schema.json

该 Schema 没有声明字段。

dungeon-expedition

plugins/games/dungeon-expedition/schema.json

该 Schema 没有声明字段。

guess-number

plugins/games/guess-number/schema.json

该 Schema 没有声明字段。

hub

plugins/games/hub/schema.json

该 Schema 没有声明字段。

idiom-chain

plugins/games/idiom-chain/schema.json

该 Schema 没有声明字段。

rps

plugins/games/rps/schema.json

该 Schema 没有声明字段。

text-adventure

plugins/games/text-adventure/schema.json

该 Schema 没有声明字段。

tic-tac-toe

plugins/games/tic-tac-toe/schema.json

该 Schema 没有声明字段。

word-riddle

plugins/games/word-riddle/schema.json

该 Schema 没有声明字段。

activity-feedback

plugins/services/activity-feedback/schema.json

路径类型必填默认值说明
plugins.activity-feedback.enabledbooleantrue
plugins.activity-feedback.defaultsobject
plugins.activity-feedback.platformsobject
plugins.activity-feedback.endpointsobject
plugins.activity-feedback.scheduleobject

60s

plugins/utils/60s/schema.json

路径类型必填默认值说明
plugins.60s.apiBasestring"https://60s.viki.moe"60s API base URL

code-runner

plugins/utils/code-runner/schema.json

该 Schema 没有声明字段。

content-moderation

plugins/utils/content-moderation/schema.json

路径类型必填默认值说明
plugins.content-moderation.enabledbooleantrue总开关
plugins.content-moderation.onErrorstring: "open", "closed""open"审查源失败时的全局默认策略:open=视为通过,closed=视为 critical
plugins.content-moderation.maskCharstring"*"文本打码字符
plugins.content-moderation.replyTemplatestring"消息含不当内容,已拦截。"reply 动作时的提示文案
plugins.content-moderation.mastersarray<string>[]额外视为 master 的 userId(兜底,与 endpoint master 合并)
plugins.content-moderation.inboundobject
plugins.content-moderation.inbound.enabledbooleantrue
plugins.content-moderation.inbound.bypassMastersbooleantruemaster 跳过入站审查
plugins.content-moderation.inbound.whitelistobject
plugins.content-moderation.inbound.whitelist.userIdsarray<string>[]
plugins.content-moderation.inbound.whitelist.conversationIdsarray<string>[]
plugins.content-moderation.outboundobject
plugins.content-moderation.outbound.enabledbooleantrue
plugins.content-moderation.outbound.bypassbooleanfalse为 true 时跳过出站审查
plugins.content-moderation.actionsobjectseverity → 动作(字符串或数组);缺省用偏严默认表
plugins.content-moderation.actions.passstring: "allow", "log", "reply", "redact", "drop", "recall" | array<string: "allow", "log", "reply", "redact", "drop", "recall">
plugins.content-moderation.actions.lowstring: "allow", "log", "reply", "redact", "drop", "recall" | array<string: "allow", "log", "reply", "redact", "drop", "recall">
plugins.content-moderation.actions.mediumstring: "allow", "log", "reply", "redact", "drop", "recall" | array<string: "allow", "log", "reply", "redact", "drop", "recall">
plugins.content-moderation.actions.highstring: "allow", "log", "reply", "redact", "drop", "recall" | array<string: "allow", "log", "reply", "redact", "drop", "recall">
plugins.content-moderation.actions.criticalstring: "allow", "log", "reply", "redact", "drop", "recall" | array<string: "allow", "log", "reply", "redact", "drop", "recall">
plugins.content-moderation.sourcesarray<object>[]
plugins.content-moderation.sources[].idstring
plugins.content-moderation.sources[].typestring: "local", "http"
plugins.content-moderation.sources[].enabledbooleantrue
plugins.content-moderation.sources[].onErrorstring: "open", "closed"
plugins.content-moderation.sources[].includeBuiltinbooleantrue是否合并内置分级违禁词词库
plugins.content-moderation.sources[].wordsarray<string | object>[]自定义词:字符串(用 defaultSeverity)或
plugins.content-moderation.sources[].wordFilesarray<string>[]词库文件;行格式 word / severity:word / word|severity
plugins.content-moderation.sources[].defaultSeveritystring: "low", "medium", "high", "critical""high"未标注分级的自定义词默认 severity
plugins.content-moderation.sources[].severitystring: "low", "medium", "high", "critical""high"兼容旧字段,等同 defaultSeverity
plugins.content-moderation.sources[].urlstring
plugins.content-moderation.sources[].headersobject
plugins.content-moderation.sources[].timeoutMsnumber5000
plugins.content-moderation.sources[].forceUploadbooleanfalse强制下载图片后上传,不传 URL

group-suite

plugins/utils/group-suite/schema.json

路径类型必填默认值说明
plugins.group-suite.keywordReplybooleanfalse
plugins.group-suite.basePointsMinnumber10
plugins.group-suite.basePointsMaxnumber30
plugins.group-suite.streakBonusnumber5
plugins.group-suite.streakCapnumber50
plugins.group-suite.rankSizenumber10
plugins.group-suite.teachMaxPerGroupnumber200
plugins.group-suite.teachCooldownMsnumber3000
plugins.group-suite.teachAllowRegexbooleantrue
plugins.group-suite.teachPageSizenumber10

plugins/utils/link-poster/schema.json

该 Schema 没有声明字段。

lottery

plugins/utils/lottery/schema.json

路径类型必填默认值说明
plugins.lottery.pickCountnumber5
plugins.lottery.scheduleCronstring"0 0 18 * * *"
plugins.lottery.historyLimitnumber500
plugins.lottery.scheduleEnabledbooleantrue
plugins.lottery.backtestEnabledbooleantrue
plugins.lottery.backtestWindownumber50
plugins.lottery.backtestRandomTrialsnumber64
plugins.lottery.backtestMinHistorynumber30
plugins.lottery.backtestAdaptivebooleantrue
plugins.lottery.weightPersistEnabledbooleantrue
plugins.lottery.weightHoldoutFallbackbooleantrue
plugins.lottery.gamesarray<string>["kl8","ssq","dlt","fc3d","pl3","pl5"]
plugins.lottery.pushTargetsarray<object>[]OutboundHost push destinations for cron/publish reports
plugins.lottery.pushTargets[].adapterstring
plugins.lottery.pushTargets[].endpointIdstring
plugins.lottery.pushTargets[].channelTypestring"private"
plugins.lottery.pushTargets[].channelIdstring
plugins.lottery.kl8object
plugins.lottery.kl8.pickCountnumber5
plugins.lottery.kl8.recommendGroupsnumber3
plugins.lottery.kl8.groupStrategiesarray<string>["balanced","hot","cold"]

music

plugins/utils/music/schema.json

该 Schema 没有声明字段。

qrcode

plugins/utils/qrcode/schema.json

该 Schema 没有声明字段。

repeater

plugins/utils/repeater/schema.json

路径类型必填默认值说明
plugins.repeater.thresholdnumber3触发复读的最少人数
plugins.repeater.cooldownnumber30000同一群冷却时间 (ms)
plugins.repeater.maxLengthnumber200消息长度上限

rss

plugins/utils/rss/schema.json

路径类型必填默认值说明
plugins.rss.pollCronstring"0 */5 * * * *"轮询频率 (6 段 Cron 表达式)
plugins.rss.maxPerGroupnumber30
plugins.rss.maxItemsnumber5
plugins.rss.timeoutnumber15000

short-url

plugins/utils/short-url/schema.json

该 Schema 没有声明字段。