Koishi 4.12 Iteration Plan

[shigma]

数据库更新

• 数据结构变动
  • user 表中中的平台相关字段被移除，迁移到一个新的 binding 表中
  • 用户名改动：user.name -> user.nickname，同时新增 user.username 字段
• 新的绑定 / 登录机制
  • 允许一个用户绑定同一平台下的多个账户
  • 绑定后初始数据被封存，解绑后自动恢复到封存数据
• 修改目前的 ABC 插件 (auth / bind / callme)，适配新特性
  • auth 插件增加 admin.enabled 配置项，默认开启
  • 如果启用，增加 admin.username / admin.password 配置项 (必选)

加载机制更新

• @koishijs/plugin-hmr：负责目前的热重载功能
• 增加 .env.local 支持：用于覆盖 .env 中的配置

Backlog

• Feature: 关于过滤器的一些需求 #957
• Bug: QQ频道Adapter两个BUG #965
• Feature: 更细粒度的 watch #990
• Feature: support internal API for kook (kaiheila) satorijs/satori#26
• Feature: 增加 KOOK 适配器更多事件支持 satorijs/satori#49
• Feature: resource elements capability enhancement satorijs/satori#72
• Feature: 在控制台的数据库界面，添加刷新数据功能 koishi-plugin-dataview#8
• Bug: 分组收起需要点击两次 webui#108
• Bug: 顶部提示信息不居中 webui#110
• Feature: 为 WebSocket 增加心跳包机制 webui#114
• Feature: 一键更新插件 webui#115
• Bug: 沙盒数据没有完全隔离 webui#144
• Feature: 沙盒支持更多通用 API webui#145

[srk24]

目前session user相关id有点多，我一开始以为uid指的是主键id，但是后来发现uid指的是拿到的却是sandbox+sandbox.value，userId拿到的是sandbox.value，id拿到的是主键id。而且session.getUser()中使用的参数是sandbox.value，而不是主键id。这块东西后面也会一并处理吗？

[shigma]

Koishi 各种 ID 的用法介绍

首先我们区分一下两个基础概念：

• 平台用户：指接入聊天平台的用户账户，例如 QQ 号 123456789 就是平台 QQ 上的用户 ID
• Koishi 用户：指 Koishi 用户系统中的账户，可以绑定一个或多个平台用户

然后下面是会话对象上的各种 ID：

• session.id: number 会话的唯一 ID
• session.platform: string 会话的平台
• session.userId: string 会话用户的平台 ID
• session.uid: string 会话的平台+用户的平台 ID，可用于作为平台用户的唯一标识符
• session.user.id: number 会话用户的 Koishi ID

如何请求用户数据

请求平台用户的数据：

ctx.database.getUser(platform, userId, fields)

请求 Koishi 用户的数据：

ctx.database.get('user', id, fields)

上面两种写法不能混用。

沙盒中的用户

沙盒被视为一个特殊的聊天平台，平台名为 sandbox，用户 ID 直接是 Alice。

[srk24]

目前代码里面getUser()没有要填写platform吧?

 getUser<K extends User.Field = never>(id?: string, fields?: K[]): Promise<User>;

[shigma]

你从哪看到的 getUser 用法……

[srk24]

抱歉看错了，我用的是session.getUser()

[shigma]

session.getUser() 用法不受影响，相当于 database.getUser() 少了一个一参数。