dscord 0.4.0-alpha.4 → 0.4.0-alpha.6

package/README.md

@@ -1,25 +1,25 @@
-# DSCord 0.4.0-alpha.4 安装与连接
+# DSCord 0.4.0-alpha.6 安装与连接
 
 > [!WARNING]
 > **实验性项目。** DSCord 目前是实验性质的项目，接口、数据格式和行为随时可能变化，不保证兼容旧版本。项目不考虑安全问题，因此将别人加入到你的服务器当中的时候，请确认你有线下找他喝茶的能力。
 
 DSCord 的 npm 包包含 Core、预构建网页/PWA、Matrix 适配器和 DSCord Bot 内核。完整服务器源码发行包另含 Compose 部署文件；同一部署的 Core、客户端和节点使用同一发行版本。
 
-本指南对应预发布版本 0.4.0-alpha.4，npm registry 和该版本的 GitHub Release 均提供安装包。Node 支持范围由 [package.json](package.json) 声明为 `>=24.19.0 <25`。Bot 宿主固定使用 DSH `0.2.2-rc.1` 的 SDK 契约，见[内核说明](dsh-connect/KERNEL.md)。Docker 服务器无需在宿主另装 Node。
+本指南对应预发布版本 0.4.0-alpha.6，npm registry 和该版本的 GitHub Release 均提供安装包。Node 支持范围由 [package.json](package.json) 声明为 `>=24.19.0 <25`。Bot 宿主固定使用 DSH `0.2.2-rc.1` 的 SDK 契约，见[内核说明](dsh-connect/KERNEL.md)。Docker 服务器无需在宿主另装 Node。
 
 ## 安装
 
-从发行页下载 `dscord-0.4.0-alpha.4.tgz` 后，可在 DSH 的 `Plugins → Add plugin` 中安装并启用 `dscord`，再登录服务器连接 Bot。发行页同时提供 `SHA256SUMS` 校验文件。[下载发行包](https://github.com/MixGeekers/dscord/releases/tag/ds-group-v0.4.0-alpha.4)
+从发行页下载 `dscord-0.4.0-alpha.6.tgz` 后，可在 DSH 的 `Plugins → Add plugin` 中安装并启用 `dscord`，再登录服务器连接 Bot。发行页同时提供 `SHA256SUMS` 校验文件。[下载发行包](https://github.com/MixGeekers/dscord/releases/tag/ds-group-v0.4.0-alpha.6)
 
 全局安装 CLI 用于服务器与独立节点管理。从 npm registry 安装当前版本，安装后核对 `dscord --version`。
 
 ```sh
-npm install --global dscord@0.4.0-alpha.4
+npm install --global dscord@0.4.0-alpha.6
 dscord --help
 dscord --version
 ```
 
-Core、CLI 和 DSH 插件使用同一发行版本。已有全局安装可用上述命令升级。当前预发布版本使用 `alpha` 标签，也可执行 `npm install --global dscord@alpha` 升级到最新 Alpha。[npm 包页面](https://www.npmjs.com/package/dscord/v/0.4.0-alpha.4)
+Core、CLI 和 DSH 插件使用同一发行版本。已有全局安装可用上述命令升级。当前预发布版本使用 `alpha` 标签，也可执行 `npm install --global dscord@alpha` 升级到最新 Alpha。[npm 包页面](https://www.npmjs.com/package/dscord/v/0.4.0-alpha.6)
 
 从源码构建 npm 包，在 `apps/ds-group/` 中执行：
 
@@ -28,11 +28,11 @@ npm ci --ignore-scripts
 npm run npm:pack
 ```
 
-该版本默认生成 `.local/npm-release/dscord-0.4.0-alpha.4.tgz`，仍应核对命令实际输出的版本、路径与校验值。构建需要开发依赖，运行已提供的预构建包不需要重新构建界面。
+该版本默认生成 `.local/npm-release/dscord-0.4.0-alpha.6.tgz`，仍应核对命令实际输出的版本、路径与校验值。构建需要开发依赖，运行已提供的预构建包不需要重新构建界面。
 
 ## 部署服务器
 
-完整服务器采用[Compose 部署指南](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.4/apps/ds-group/deploy/README.md)，先配置自己的 Matrix 身份域、公开地址和持久存储。npm CLI 不代替 Synapse 或反向代理。需要 `dscord server`、初始化及节点导入等命令时，在各终端保持同一个绝对数据路径：
+完整服务器采用[Compose 部署指南](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.6/apps/ds-group/deploy/README.md)，先配置自己的 Matrix 身份域、公开地址和持久存储。npm CLI 不代替 Synapse 或反向代理。需要 `dscord server`、初始化及节点导入等命令时，在各终端保持同一个绝对数据路径：
 
 ```sh
 export DS_GROUP_DATA_DIR="$HOME/.local/share/dscord-server"
@@ -62,7 +62,7 @@ Core 提供的 Matrix 公开地址必须能从节点访问。一个连接页使
 
 ## 升级和已有 Bot
 
-先备份服务器数据和各 DSH Bot home，再停止当前工作并升级到同一发行版本。已有 `ds-bot` 插件必须先停用，DSCord 才能在同一目录接管；同时启动两个内核会报冲突。接管会保存迁移快照，保留 Bot 与 Session 身份。[生命周期与迁移](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.4/apps/ds-group/deploy/kernel-runtime.md)
+先备份服务器数据和各 DSH Bot home，再停止当前工作并升级到同一发行版本。已有 `ds-bot` 插件必须先停用，DSCord 才能在同一目录接管；同时启动两个内核会报冲突。接管会保存迁移快照，保留 Bot 与 Session 身份。[生命周期与迁移](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.6/apps/ds-group/deploy/kernel-runtime.md)
 
 旧服务器 Bot 可在连接页绑定已有本机 Bot，保留 Matrix 身份；两套独立 Session 或记忆不会自动合并。已有原生绑定的 Bot 应从所属 DSH 连接，导出其配置不能在另一台机器创建身份副本。
 
@@ -100,11 +100,11 @@ dscord service down "$BOT_ACCOUNT"
 dscord dsh stop "$BOT_ACCOUNT"
 ```
 
-每个 Bot 同时运行一个节点，每个独立节点使用自己的数据目录和桥接端口。Linux 常驻服务见 [systemd](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.4/apps/ds-group/deploy/systemd/README.md)。
+每个 Bot 同时运行一个节点，每个独立节点使用自己的数据目录和桥接端口。Linux 常驻服务见 [systemd](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.6/apps/ds-group/deploy/systemd/README.md)。
 
 ## 存储与组件
 
-附件默认使用 Synapse 本地媒体目录，可选 S3-compatible 后端。[存储配置](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.4/apps/ds-group/deploy/storage/README.md)说明远端对象、缓存和备份关系；已有云盘扫描与历史迁移不是自动功能。
+附件默认使用 Synapse 本地媒体目录，可选 S3-compatible 后端。[存储配置](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.6/apps/ds-group/deploy/storage/README.md)说明远端对象、缓存和备份关系；已有云盘扫描与历史迁移不是自动功能。
 
 `dscord server` 运行 Core/PWA，`init` 和 `bootstrap` 初始化服务器，`admin` 管理导出与导入，`node` 运行 Matrix 适配器，`dsh` 管理独立宿主，`service` 管理本机进程，`path` 显示安装目录。
 

package/central/README.md

@@ -132,7 +132,7 @@ npm run central
 
 身份令牌是 Ed25519 签名的 JWT（`alg: EdDSA`），声明包括 `iss`、`sub`（账号编号）、`aud`（聊天服务器 origin）、`iat`、`exp`、`jti`、`username`、`gid`（全局身份 ID）、`kind`（`human` 或 `bot`）、`name`（显示名），Bot 另有 `owner`（所属人的全局身份 ID）。聊天服务器用 `central/tokens.mjs` 的 `verifyIdentityToken` 按中央公钥、`issuer` 和自己的 origin 校验。一张令牌只对写明的那台聊天服务器有效。
 
-撤销授权后，中央不再为那台服务器签发令牌；聊天服务器的本地会话是短期的，续期时要重新拿令牌，因此撤销会在一个会话周期内生效。
+撤销授权后，中央不再为那台服务器签发新的身份令牌。已经换出的聊天会话由对应 Matrix/Synapse 管理其有效期与撤销；当前网页没有自动刷新聊天令牌的协议，不能把中央撤销授权视为已经结束所有聊天会话。浏览器记住设备的 30 天上限是本地保存期限，详见[登录与恢复](https://github.com/MixGeekers/dscord/blob/ds-group-v0.4.0-alpha.6/apps/ds-group/登录与恢复.md)。
 
 ## 聊天服务器怎样接入