Skip to content

高级教程

应用

列表

点击群应用卡片,即可进入子级应用,应用一共分四级,项目、模块、应用、指令 | 页面,对应群内机器人回复菜单层级结构

image-20240314150608057

修改

点击群应用卡片修改按钮,可打开应用修改窗口,可对应用基础信息进行修改

  • 匹配规则,支持 正则表达式,修改后,群内必须使用您修改后的指令才可触发当前应用功能
  • 显示名称,群内发送菜单指令,响应的菜单列表上显示的指令名称,一般需要与匹配规则一同修改
  • 可用频道,若勾选,则机器人只能在对应频道内触发当前应用功能,若不勾选,则默认全部频道可用
  • 状态,若选择正常,则可正常触发当前应用,若选择停用,则将无法触发当前应用

image-20240314145217995

重置

点击群应用卡片重置按钮,应用基础信息将恢复默认值,一般用于应用修改后无法正常触发回复时

image-20240314150019485

配置

列表

点击群应用卡片配置按钮,可进入应用配置列表页面,可查看当前应用关联的所有配置

  • 向下兼容,即父应用上的配置,其子应用上均可使用,例如在项目级别的应用上维护了配置,那么其关联的所有模块、应用、指令级别的应用均可使用该配置

image-20240314154118555

修改

点击配置卡片修改按钮,可打开配置修改窗口,可对应用配置进行修改

  • 配置值,支持文本、数字、表格等多种类型,请严格控制输入的配置值类型,若默认配置值为数字,请务必不要使用字母等文本,否则有可能导致应用异常,功能无法触发

image-20240314154153421

重置

点击配置卡片重置按钮,应用配置将恢复默认值,一般用于配置修改后无法正常触发回复时

image-20240314154435151

输出

列表

点击群应用卡片输出按钮,可进入应用输出列表页面,可查看当前应用关联的所有输出

向下兼容,即父应用上的输出,其子应用上均可使用,例如在项目级别的应用上维护了输出,那么其关联的所有模块、应用、指令均可使用该输出

image-20240314154554605

详情

点击输出卡片详情按钮,可打开输出详情窗口,可对应用输出模型进行查看

image-20240314154934696

模型

输出详情中的输出模型为模板内容提供数据结构支持,详情中仅记录了model字段值,其他字段对于不同输出,结构都是一样的

  • 数据不同,由于每次请求的群、成员、指令等参数都不尽相同,因此每次应用请求后输出的模型数据都是不一样的
  • 参考示例,详情中给到的数据仅为示例,不过相同输出,模型结构都是一样的,可根据其结构来定义消息模板

完整结构

json
{
	"app":{
		"author":"梦幻云平台",
		"uniq":"menu",
		"icon":"🤖",
		"match_regex":"(菜单)",
		"name":"菜单",
		"avatar":"https://oss.drea.cc/cloud/img/bot/app/app.png?v=7",
		"id":1706717208514629633,
		"display_name":"菜单",
		"type":"0"
	},
	"output":{
		"uniq":"success",
		"name":"成功",
		"avatar":"https://oss.drea.cc/cloud/img/bot/template/success.png?v=1",
		"type":"0"
	},
	"core":{
		"now_time":"2024-03-14 15:48:56",
		"is_at":0,
		"now":"2024-03-14 15:48:56",
		"now_date":"2024-03-14",
		"integral_name":"金币"
	},
	"bot":{
		"no":"2854207322",
		"uniq":"1109672765864994378",
		"name":"奇幻助手",
		"avatar":"https://oss.drea.cc/cloud/img/bot/info/2.png",
		"id":100,
		"platform":"2"
	},
	"island":{
		"no":"1001",
		"uniq":"7B0603DC71AAE8CC70EDEA3345E53D39",
		"name":"梦幻测试群",
		"avatar":"https://oss.drea.cc/cloud/img/bot/island/1.png?v=1",
		"id":1000
	},
	"channel":{
		"uniq":"7B0603DC71AAE8CC70EDEA3345E53D39",
		"name":""
	},
	"member":{
		"no":"1",
		"integral":2639,
		"uniq":"FBBDF38B4D04DF5A528BF4E726682303",
		"name":"Rhyheart",
		"avatar":"https://oss.drea.cc/cloud/img/bot/member/1.png?v=1",
		"id":1
	},
	"model":{
		"menu_list":[
			{
				"author":"梦幻云平台",
				"uniq":"personal_module",
				"icon":"🧑‍💼",
				"match_regex":"(个人模块)",
				"name":"个人模块",
				"avatar":"https://oss.drea.cc/cloud/img/bot/app/personal.png?v=7",
				"id":1706719345147613185,
				"display_name":"个人模块",
				"type":"1"
			},
			{
				"author":"梦幻云平台",
				"uniq":"game_module",
				"icon":"🎮",
				"match_regex":"(游戏模块)",
				"name":"游戏模块",
				"avatar":"https://oss.drea.cc/cloud/img/bot/app/game.png?v=7",
				"id":1706893152021860353,
				"display_name":"游戏模块",
				"type":"1"
			}
		]
	},
	"message":{
		"uniq":"ROBOT1.0_f0voMkMMf9OF-7CBrgAlRPfiUXzIzrVdernO-TPGdZ6Hko7xGSbhkltwa1jEMhT3ICy3c6UR0pMYivmhU6LK2A!!",
		"body":"菜单"
	},
	"atList":[]
}

模板

列表

点击输出卡片模板按钮,可进入输出模板列表页面,可查看当前输出关联的所有模板

  • 多模板,同一输出,支持文本、Markdown、卡片等多种模板类型,不同平台支持的模板类型也不尽相同,指令回复样式则不同
  • 类型互斥,对输出模板进行修改时,可以看到表单上的状态项,单个输出每次只能使用一个模板,若您启用了Markdown模板,那么其他模板,例如文本模板将自动停用,那么机器人将按照 Markdown 格式进行指令回复

image-20240314162042050

修改

点击模板卡片修改按钮,可打开模板修改窗口,可对输出模板进行修改

  • 输出模型输出模型 为模板内容提供数据结构支持

  • 模板内容,模板内容使用Velocity作为模板引擎,您可以使用Velocity语法来定义您的模板,例如占位符、判断语句、循环语句等

image-20240314164426128

重置

点击模板卡片重置按钮,输出模板将恢复默认值,一般用于模板修改后无法正常触发回复时

image-20240314170051981

页面

列表

点击应用卡片页面按钮,可进入应用页面,可查看当前应用关联的页面

  • 多种多样,每种应用的页面都不尽相同,有显示应用基础数据的页面,也有显示应用用户数据的页面
  • 强自定义,您可以对应用页面上的数据进行增删改,定义专属应用数据源,当然,系统内置的数据您暂时还无法修改

image-20240314170447251

新增

点击页面左上角新增按钮,可打开数据新增窗口,可对页面数据进行新增

image-20240314171519066

修改

点击数据卡片修改按钮,可打开数据修改窗口,可对页面数据进行修改,系统内置数据禁止修改

image-20240314171541559

删除

点击数据卡片删除按钮,可删除指定数据,系统内置数据禁止删除

image-20240314171614375

基于 MIT 许可发布