Union Sync是一个简单信息同步协议，使用星形网络的中心化架构，支持自定义子协议，用于在MUA的各成员之间发布公告。目前该协议通过QQ Bot和联合大厅服务器发布同步通知。
各校的负责人你们好，经过将近三个月的开发与测试，我们于2023年10月7日正式发布了MUA的通知机器人。目前机器人能为MC组织交流群提供MUA信息通知功能、MC服务器可视化查询、问答库等功能。现在只需要详细阅读本篇文章，就可以轻松掌握使用机器人的办法。遇到问题可以直接咨询西交-岱岱（Q1659388154）/燕大-顾梵（Q3388673897），他们会协助你。
这段时间来，各个高校之间的交流活动越来越多，我们殷切希望能进一步推动高校交流，拉近天南海北MC爱好者的距离。但我们了解到，目前各个高校之间的信息流通尚且比较匮乏；跨校宣传很是麻烦。为了解决这个问题，就有了这个消息同步机制。
机器人目前有两大主要功能：发布通知、显示服务器状态。
您可以私聊机器人以设置通知，机器人将会渲染通知为图片，发送到各群聊中；同时，您可以为您的群聊设置一个服务器列表，通过机器人方便地查询列表中各服务器的状态。
本项目的开发者是上海交通大学的FTC/Art1st/Unicorn。
本项目的MUA负责人是：西交-岱岱（Q1659388154）/燕大-顾梵（Q3388673897），接入机器人请联系他们。
机器人功能仍在持续开发，您可持续关注。也欢迎您向我们提出进一步的开发建议。
由于单个机器人加入过多群聊可能会导致风控，故而需要更多QQ号以部署机器人。若您能提供服务器/空闲QQ号，也请麻烦联系上述两位同学。
联系负责人岱岱（Q1659388154）或顾梵（Q3388673897），将某一机器人拉入您的群聊，并给予负责人该群内的权限。每个接入的群聊都需完成这些流程。
负责人将告知机器人的QQ号，您可以自行拉入群聊；同时，您需要告知负责人您要接入的群聊QQ号，负责人将初始化机器人。
私聊机器人，输入-muabind [UnionAPIID] [token]，验证您代表高校MC组织发表通知的权限，并绑定到您的QQ号。此命令中的两个参数获取方式如下：
如果您学校的皮肤站已接入Union联合认证，请使用管理员帐户登入您学校的皮肤站，在“管理面板→插件配置→Yggdrasil API“中，”Union相关配置→Union Member Key”即为”token”，”皮肤站列表“中您皮肤站对应的”皮肤站缩写“即为您的”UnionAPIID”。
如果您的学校皮肤站未接入MUAUnion，我们首先建议您完成接入。如果没有或者不想接入，则需要手动生成UnionAPIID和token，请联系负责人，提供您希望使用的UnionAPIID名称，我们将为您生成对应token。
如果您是该群聊的群主，您可以发送：-sudo 以获取权限；如果您不是群主，请在和群主联系后给予您权限，即依次在群聊发送以下信息并等待回复OK：
-sudo-grpcfg enable permission-addadmin [@user] 其中[@user]即直接at需要被给予权限的QQ账号之后请您在群聊中依次发送以下消息，每次发送后等待机器人回复OK。
-grpcfg enable mua-muagroupbind [UnionAPIID]查看更多机器人功能、获取帮助请输入：-help
查看更多通知功能请输入：-annhelp
当有新通知发布时，机器人会自动在群内推送。
在群内发送-mca可查看当前所有通知的详情，发送-mcb可查看当前所有通知的摘要。
发送faq help可查看问答库功能的帮助，发送-mcs可查看MC服务器状态。
通知的发布需要具有特定MUAID（即高校组织代表身份），完成了准备工作的绑定了token的QQ号即具有了对应MUAID的权限。
如果您需要使本校的其他管理员具备该MUAID的权限，则需要私聊机器人，发送-muaempower [MUAID] [要给予的管理员的QQ号]
每次发布通知分为三步：新建/编辑/发布。您也可以删除通知。
发布通知相关帮助可以私聊机器人发送-annhelp。
新建空白通知：-annnew [通知关键字]
通知关键字可以理解为变量名，可以取为“sjmcgame0903”等类似格式。通知关键字可自由填写中英文，但不能包含空格或换行等空字符，长度限制在64字符内。
每个通知包含了标题/正文/频道/目标/标签几个可修改的参数
-annttl [标题] 修改通知的标题，通知标题长度限制在100字符内。-anntg [自定义标签列表] 添加一个副标题类型的标签。标签关键字间以空格隔开，总长度限制在200字符内。-annctt [正文] 添加正文，若原本已有正文，则添加至末尾。内容长度限制在2000字符内。annctt支持添加图片，但每次只能添加一张。
特别注意！！！添加图片时，-annctt和图片之间依旧需要添加一个空格。
-annrmctt 可以清空正文的当前所有内容。-anncnl [原版/模组/小游戏/其他]，可选频道有“原版“、”模组“、“小游戏”和“其他”。-anntgt [MUAID] 可以指向性的发布信息通知到指定的群聊中。
MUAID填写您希望看到这条通知的高校；如YSUMC（指向燕山大学）或者XJTUMC（指向西安交通大学）；
如果想要发布到多个学校请使用空格分隔开相关ID。
当你只需要发到MUA相关群聊时只需要在MUAID填写MUA即可，而当你没有指定群聊时，你将把信息发布到所有群聊中。
-annstp [时间字符串]，时间字符串格式2023-09-19 23:59:59，不设置则默认失效时间为15天。-anntk [MUAID]，MUAID指代的是准备工作中需要绑定的MUAID。-annprv，在正式发布通知之前，可以通过该指令预览通知效果。-annrls，当你正式需要发布通知时就使用该指令。如果你想要修改已经发布的通知请按照下面的办法来操作：
-anncp [原通知关键字] [新通知关键字]，复制一份你需要重新编辑的通知。你可以通过-annls查询已有的通知关键字。通知关键字不能与之前（未删除）通知的关键字相同。-anndel [原通知关键字]，删除修改前的的通知。机器人提供了一个方便查看服务器状态的功能，其使用方式如下：（发送消息并等待机器人回复OK）
-grpcfg enable mcs-mcsadd [address]其中[address]为你希望添加的服务器的地址-mcssetfooter [text]其中[text]为你想添加的footer文本内容进行完以上三步后，您可以通过-mcs呼出服务器状态查询界面。