gehongyan / kook.net Goto Github PK

卡片消息这类渲染成 UI 的组件，使用 XML 语言定义比较直观（类似于 HTML、XAML）。相比使用 CardBuilder，使用 XML 文件来定义还可以在不改动代码的情况下修改预定义的卡片。对于需要运行时才能决定的值，可以使用 Liquid Template 对 XML 进行修改。

目前已经实现了使用 XSD 来定义 XML 格式，和将 XML 反序列化至 List<ICard>

• XSD
• Example 1
• Example 2
• Deserializer

如果觉得可以我再发起 PR

• 语音频道创建事件中缺失 voice_quality 与 limit_amount
• 语音频道更新事件中缺失 voice_quality
• Bot 当前用户信息更新时没有事件下发
• 分组频道删除没有事件下发（现在会下发 sort_channel，可以通过 API 更新获知分组频道删除事件）
• 用户更新事件下发的 target_id 内容异常
• /guild/user-list 中的用户有 color 字段，但 /user/view 中的用户没有 color 字段
• 消息创建事件中包含 nav_channels 但消息更新事件中缺失 nav_channels
• 消息创建事件中包含 kmarkdown.raw_content 但 API 获取消息详情时缺失该字段
• 消息创建事件中的 embeds 永远为空（已通过 embeds_append 事件解决）
• 消息创建事件中的 quote 中表示被引用的消息 ID 为 rong_id
• direct-message/list 接口返回的每条消息的信息中都包含了 author 的详情，direct-message/view 接口返回的单条信息中没有 author 字段
• message/view 接口中的 author 相比 quote.author 缺失一些字段
• sort_channel 事件中并未包含所有频道的 level 值。实际上，移动某频道会实际变更该频道及其新旧位置中间所包围的其它频道的 level，又是甚至会更新整个服务器所有频道的 level，KOOK 所推荐的最佳实践是在收到 sort_channel 时重新获取所有整个服务器的所有频道的 level 值吗
• 角色排序时下发的服务器更新事件中没有包含角色信息（仅能通过 API 重新获取）
• 切换服务器小工具时下发了服务器事件，但事件参数中没有相关字段
• 服务器事件参数中包含 show_boost_process，但是切换是否显示服务器助力条时没有事件下发
• 服务器安全设置与审计日志无相关接口与事件
• batch_updated_channel 事件中 added_channel 有新频道时为 object，无新频道时为 array
• batch_added_channel 事件中创建的文字频道包含了不应该包含的语音频道专有参数
• 用户授予与撤销角色时无事件下发
• 删除有用户连接中的语音频道时未下发用户断开语音频道连接事件

未文档化的事件列表

• embeds_append
• sort_channel
• updated_server_type
• batch_added_channel
• batch_updated_channel
• batch_deleted_channel
• live_status_changed
• PERSON 类型的 updated_guild
• add_guild_mute
• delete_guild_mute
• unread_count_changed

此 Issue 跟踪 kaiheila/api-docs#168

计划新增 API

由于缺少相关事件，暂时不会将相关信息写入 Socket 缓存