Skip to content

Milky 的长远改进目标 #103

@Wesley-Young

Description

@Wesley-Young

众所周知,任何协议都不可能是完美无缺的,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 的迭代,将考虑对这些部分进行改动。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions