众所周知,任何协议都不可能是完美无缺的,Milky 也是如此。在代码编写过程中,Milky 的一些设计缺陷逐渐暴露出来,这些缺陷并不一定影响 Milky 协议的使用,但违背了对称性、风格统一性的设计哲学,并且进行修改会破坏兼容性,列出如下:
- get API 的命名问题。部分 API 遵循 OneBot 11 的命名风格,批量获取的 API 命名为 get_xxx_list,单独获取的 API 命名为 get_xxx_info。另外一部分 API 则直接命名为 get_xxxs。
- 联合类型的风格问题。Milky 目前存在两种联合类型:一种是不同子类型一级字段完全相同,其中的 data 字段是一个嵌套结构,不同子类型的 data 字段结构不同;另外一种是不同子类型的一级字段有所不同,有共有部分,也有自己独特的部分。这严重影响了代码生成部分的代码简洁度。就近而言,应当将消息段部分的联合类型从前者迁移到后者。
未来如果有 Milky 2.x 的迭代,将考虑对这些部分进行改动。
众所周知,任何协议都不可能是完美无缺的,Milky 也是如此。在代码编写过程中,Milky 的一些设计缺陷逐渐暴露出来,这些缺陷并不一定影响 Milky 协议的使用,但违背了对称性、风格统一性的设计哲学,并且进行修改会破坏兼容性,列出如下:
未来如果有 Milky 2.x 的迭代,将考虑对这些部分进行改动。