117 lines
9.3 KiB
Markdown
117 lines
9.3 KiB
Markdown
---
|
||
title: v1.2 更新日志
|
||
linkTitle: v1.2
|
||
type: docs
|
||
layout: changelog
|
||
outputs:
|
||
- html
|
||
- checklist
|
||
date: 2022-02-02
|
||
---
|
||
|
||
{{< boxes/warning >}}
|
||
本页面的翻译未经核对，可能存在翻译质量不佳、错翻、漏翻等情况。您可以在 <a href="https://codeberg.org/wholetrans/docs-matrix-spec">Forgejo 存储库</a> 打开 Issue、提交 Pull Request 或<a href="mailto:errata@wholetrans.org">邮件联系</a>我们提出改进建议和参与翻译与核对。
|
||
{{< /boxes/warning >}}
|
||
|
||
|
||
## 客户端-服务器 API
|
||
|
||
<strong>不兼容变更</strong>
|
||
|
||
- 根据 [MSC3442](https://github.com/matrix-org/matrix-doc/pull/3442)，`prev_content` 字段现在作为事件的 `unsigned` 属性返回，而不是顶层返回。([#3524](https://github.com/matrix-org/matrix-doc/issues/3524))
|
||
- 按照 [MSC2432](https://github.com/matrix-org/matrix-doc/pull/2432)，从 `/publicRooms` 返回的数据块中移除了 `aliases` 属性。([#3624](https://github.com/matrix-org/matrix-doc/issues/3624))
|
||
|
||
<strong>新增接口</strong>
|
||
|
||
- 增加空间层级 API (`GET /_matrix/client/v1/rooms/{roomId}/hierarchy`)，参见 [MSC2946](https://github.com/matrix-org/matrix-doc/pull/2946)。([#3610](https://github.com/matrix-org/matrix-doc/issues/3610))
|
||
- 增加 `/_matrix/client/v1/register/m.login.registration_token/validity` 接口，参见 [MSC3231](https://github.com/matrix-org/matrix-doc/pull/3231)。([#3616](https://github.com/matrix-org/matrix-doc/issues/3616))
|
||
|
||
<strong>向后兼容变更</strong>
|
||
|
||
- 扩展 `/_matrix/client/r0/login` 接口以接受 `m.login.appservice`，参见 [MSC2778](https://github.com/matrix-org/matrix-doc/pull/2778)。([#3324](https://github.com/matrix-org/matrix-doc/issues/3324))
|
||
- 增加对 `restricted` 房间的支持，参见 [MSC3083](https://github.com/matrix-org/matrix-doc/pull/3083)、[MSC3289](https://github.com/matrix-org/matrix-doc/pull/3289) 和 [MSC3375](https://github.com/matrix-org/matrix-doc/pull/3375)。([#3387](https://github.com/matrix-org/matrix-doc/issues/3387))
|
||
- 按照 [MSC3069](https://github.com/matrix-org/matrix-doc/pull/3069) 增加 `/account/whoami` 接口的 `is_guest` 字段。([#3605](https://github.com/matrix-org/matrix-doc/issues/3605))
|
||
- 按照 [MSC3419](https://github.com/matrix-org/matrix-doc/pull/3419)，扩展访客权限至可发送任意房间事件和状态事件。([#3605](https://github.com/matrix-org/matrix-doc/issues/3605))
|
||
- 按照 [MSC1772](https://github.com/matrix-org/matrix-doc/pull/1772) 和 [MSC2946](https://github.com/matrix-org/matrix-doc/pull/2946) 增加 Spaces 与房间类型。([#3610](https://github.com/matrix-org/matrix-doc/issues/3610))
|
||
- 按照 [MSC3283](https://github.com/matrix-org/matrix-doc/pull/3283) 增加新的 `m.set_displayname`、`m.set_avatar_url` 和 `m.3pid_changes` 功能。([#3614](https://github.com/matrix-org/matrix-doc/issues/3614))
|
||
- 按照 [MSC2732](https://github.com/matrix-org/matrix-doc/pull/2732) 增加后备密钥（在一次性密钥用尽后使用的可选密钥）的支持。([#3615](https://github.com/matrix-org/matrix-doc/issues/3615))
|
||
- 按照 [MSC3231](https://github.com/matrix-org/matrix-doc/pull/3231) 增加令牌认证注册支持。([#3616](https://github.com/matrix-org/matrix-doc/issues/3616))
|
||
|
||
<strong>规范释义</strong>
|
||
|
||
- 使 `AesHmacSha2KeyDescription` 与 `KeyDescription` 保持一致，将 `name` 标记为可选。([#3481](https://github.com/matrix-org/matrix-doc/issues/3481))
|
||
- 修正规范内容中的各种拼写错误。([#3482](https://github.com/matrix-org/matrix-doc/issues/3482)、[#3495](https://github.com/matrix-org/matrix-doc/issues/3495)、[#3509](https://github.com/matrix-org/matrix-doc/issues/3509)、[#3535](https://github.com/matrix-org/matrix-doc/issues/3535)、[#3591](https://github.com/matrix-org/matrix-doc/issues/3591)、[#3601](https://github.com/matrix-org/matrix-doc/issues/3601)、[#3611](https://github.com/matrix-org/matrix-doc/issues/3611)、[#3671](https://github.com/matrix-org/matrix-doc/issues/3671)、[#3680](https://github.com/matrix-org/matrix-doc/issues/3680))
|
||
- 在 `m.location` 事件定义中明确引用 RFC5870。([#3492](https://github.com/matrix-org/matrix-doc/issues/3492))
|
||
- 按照 [MSC3550](https://github.com/matrix-org/matrix-doc/pull/3550) ，为 `/profile/{userId}` 增加 `403 M_FORBIDDEN` 错误码。([#3530](https://github.com/matrix-org/matrix-doc/issues/3530))
|
||
- 明确 `/sync` API 的说明，并修正 ASCII 图示。([#3543](https://github.com/matrix-org/matrix-doc/issues/3543))
|
||
- 说明客户端 `well_known` 配置中的 `base_url` 可包含或不包含结尾斜杠。([#3562](https://github.com/matrix-org/matrix-doc/issues/3562))
|
||
- 说明解密 `m.olm.v1.curve25519-aes-sha2` 消息时应校验哪个签名。([#3573](https://github.com/matrix-org/matrix-doc/issues/3573))
|
||
- 按照 [MSC3173](https://github.com/matrix-org/matrix-doc/pull/3173) 说明“Stripped State”是什么及其作用。([#3606](https://github.com/matrix-org/matrix-doc/issues/3606))
|
||
- 说明如何理解缺失的一次性密钥计数。([#3636](https://github.com/matrix-org/matrix-doc/issues/3636))
|
||
- 修正多个 API 接口响应结构的 schema。([#3650](https://github.com/matrix-org/matrix-doc/issues/3650))
|
||
- 明确说明群体提及（group mentions）已不在规范范围内。([#3652](https://github.com/matrix-org/matrix-doc/issues/3652))
|
||
- 区分“联邦”事件格式（Federation API 交换）与客户端事件格式（Client-Server 及 AS API 使用）。([#3658](https://github.com/matrix-org/matrix-doc/issues/3658))
|
||
- 修正多个 API 接口响应内容的渲染。([#3674](https://github.com/matrix-org/matrix-doc/issues/3674))
|
||
|
||
## 服务器-服务器 API
|
||
|
||
<strong>新增接口</strong>
|
||
|
||
- 按照 [MSC2946](https://github.com/matrix-org/matrix-doc/pull/2946) 增加空间层级 API (`GET /_matrix/federation/v1/hierarchy/{roomId}`)。([#3610](https://github.com/matrix-org/matrix-doc/issues/3610)、[#3660](https://github.com/matrix-org/matrix-doc/issues/3660))
|
||
|
||
<strong>向后兼容变更</strong>
|
||
|
||
- 按照 [MSC3083](https://github.com/matrix-org/matrix-doc/pull/3083)、[MSC3289](https://github.com/matrix-org/matrix-doc/pull/3289) 和 [MSC3375](https://github.com/matrix-org/matrix-doc/pull/3375) 增加对 `restricted` 房间的支持。([#3387](https://github.com/matrix-org/matrix-doc/issues/3387))
|
||
|
||
<strong>规范释义</strong>
|
||
|
||
- 修正规范文中的各种拼写错误。([#3527](https://github.com/matrix-org/matrix-doc/issues/3527)、[#3528](https://github.com/matrix-org/matrix-doc/issues/3528))
|
||
- 说明 `GET /_matrix/federation/v1/event_auth/{roomId}/{eventId}` *不会* 返回房间完整状态下的验证链。([#3583](https://github.com/matrix-org/matrix-doc/issues/3583))
|
||
- 修正多个 API 接口响应内容的渲染。([#3674](https://github.com/matrix-org/matrix-doc/issues/3674))
|
||
|
||
## 应用服务 API
|
||
|
||
<strong>规范释义</strong>
|
||
|
||
- 区分“联邦”事件格式（Federation API 交换）与客户端事件格式（Client-Server 及 AS API 使用）。([#3658](https://github.com/matrix-org/matrix-doc/issues/3658))
|
||
- 修正多个 API 接口响应内容的渲染。([#3674](https://github.com/matrix-org/matrix-doc/issues/3674))
|
||
- 更正文档中 `GET /_matrix/app/v1/thirdparty/protocol/{protocol}` 接口响应值的说明。([#3675](https://github.com/matrix-org/matrix-doc/issues/3675))
|
||
|
||
## 身份验证服务 API
|
||
|
||
<strong>向后兼容变更</strong>
|
||
|
||
- 按照 [MSC3288](https://github.com/matrix-org/matrix-doc/pull/3288) 为存储的邀请增加 `room_type` 字段。([#3610](https://github.com/matrix-org/matrix-doc/issues/3610))
|
||
|
||
<strong>规范释义</strong>
|
||
|
||
- 修正多个 API 接口响应内容的渲染。([#3674](https://github.com/matrix-org/matrix-doc/issues/3674))
|
||
|
||
## 推送网关 API
|
||
|
||
<strong>规范释义</strong>
|
||
|
||
- 修正多个 API 接口响应内容的渲染。([#3674](https://github.com/matrix-org/matrix-doc/issues/3674))
|
||
|
||
## 房间版本
|
||
|
||
<strong>向后兼容变更</strong>
|
||
|
||
- 按照 [MSC3289](https://github.com/matrix-org/matrix-doc/pull/3289) 增加房间版本 8。([#3387](https://github.com/matrix-org/matrix-doc/issues/3387))
|
||
- 按照 [MSC3375](https://github.com/matrix-org/matrix-doc/pull/3375) 增加房间版本 9。([#3387](https://github.com/matrix-org/matrix-doc/issues/3387))
|
||
|
||
<strong>规范释义</strong>
|
||
|
||
- 完整规范房间版本，说明哪些内容继承自父版本。([#3432](https://github.com/matrix-org/matrix-doc/issues/3432)、[#3661](https://github.com/matrix-org/matrix-doc/issues/3661))
|
||
- 明确事件 ID 和事件格式相关章节。([#3501](https://github.com/matrix-org/matrix-doc/issues/3501))
|
||
- 移除若干误标为联邦 PDU `unsigned` 字段的数据项。([#3522](https://github.com/matrix-org/matrix-doc/issues/3522))
|
||
- 修正房间版本规范的标题顺序保持一致。([#3683](https://github.com/matrix-org/matrix-doc/issues/3683))
|
||
- 为房间版本 6 增补缺失的“签名密钥有效期”章节。([#3683](https://github.com/matrix-org/matrix-doc/issues/3683))
|
||
- 修正 v7/v8/v9 版本下 `knock` -> `leave` 的成员关系许可规则。([#3694](https://github.com/matrix-org/matrix-doc/issues/3694))
|
||
|
||
## 附录
|
||
|
||
<strong>向后兼容变更</strong>
|
||
|
||
- 按照 [MSC2758](https://github.com/matrix-org/matrix-doc/pull/2758) 描述“通用命名空间标识符语法”。([#3171](https://github.com/matrix-org/matrix-doc/issues/3171))
|
||
- 按照 [MSC2312](https://github.com/matrix-org/matrix-doc/pull/2312) 描述 `matrix:` URI 方案。([#3608](https://github.com/matrix-org/matrix-doc/issues/3608))
|