# Matrix Specification v1.13 更新日志

|   |   | 
|---|---|
| Git commit | https://github.com/matrix-org/matrix-spec/tree/v1.13 |
| Release date | 2024年12月19日 |

{{< 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

**新增端点**

- [ ] 增加 `POST /_matrix/client/v3/rooms/{roomId}/report`，参见 [MSC4151](https://github.com/matrix-org/matrix-spec-proposals/pull/4151)。（[#1938](https://github.com/matrix-org/matrix-spec/issues/1938)、[#2028](https://github.com/matrix-org/matrix-spec/issues/2028)）

**向后兼容的修改**

- [ ] 为 requestToken 端点新增错误码，参见 [MSC4178](https://github.com/matrix-org/matrix-spec-proposals/pull/4178)。（[#1944](https://github.com/matrix-org/matrix-spec/issues/1944)）
- [ ] 移除回复降级处理，参见 [MSC2781](https://github.com/matrix-org/matrix-spec-proposals/issues/2781)。（[#1994](https://github.com/matrix-org/matrix-spec/issues/1994)）
- [ ] 明确 CORS 响应中允许的 HTTP 方法，参见 [MSC4138](https://github.com/matrix-org/matrix-spec-proposals/pull/4138)。（[#1995](https://github.com/matrix-org/matrix-spec/issues/1995)、[#2011](https://github.com/matrix-org/matrix-spec/issues/2011)）
- [ ] 新增 `M_USER_SUSPENDED` 错误码行为，参见 [MSC3823](https://github.com/matrix-org/matrix-spec-proposals/pull/3823)。（[#2014](https://github.com/matrix-org/matrix-spec/issues/2014)）

**规范澄清**

- [ ] 在 `POST /_matrix/client/v3/rooms/{roomId}/report/{eventId}` 接口中，`reason` 参数可以省略而不是留空，参见 [MSC2414](https://github.com/matrix-org/matrix-spec-proposals/pull/2414)。（[#1938](https://github.com/matrix-org/matrix-spec/issues/1938)）
- [ ] 修正 `GET /_matrix/client/v3/thirdparty/location/{protocol}` 端点中查询参数的 OpenAPI 规范。（[#1947](https://github.com/matrix-org/matrix-spec/issues/1947)）
- [ ] 语义化排序 VoIP 事件。（[#1967](https://github.com/matrix-org/matrix-spec/issues/1967)）
- [ ] 明确服务器在向推送网关发送通知时必须转发 `PusherData` 中的自定义键值对。（[#1973](https://github.com/matrix-org/matrix-spec/issues/1973)）
- [ ] 明确字符串类型的格式。（[#1978](https://github.com/matrix-org/matrix-spec/issues/1978)、[#1979](https://github.com/matrix-org/matrix-spec/issues/1979)、[#1980](https://github.com/matrix-org/matrix-spec/issues/1980)）
- [ ] 明确异步上传端点在某些情况下会返回 404。（[#1983](https://github.com/matrix-org/matrix-spec/issues/1983)）
- [ ] 移除 `StateFilter` 与 `RoomEventFilter` 之间的区别。（[#2015](https://github.com/matrix-org/matrix-spec/issues/2015)）
- [ ] 在整个规范中增加超链接。（[#2016](https://github.com/matrix-org/matrix-spec/issues/2016)）
- [ ] 语法高亮从 `json5` 改为 `json`。（[#2017](https://github.com/matrix-org/matrix-spec/issues/2017)）
- [ ] 指定 `/keys/claim` 发放一次性密钥的顺序，参见 [MSC4225](https://github.com/matrix-org/matrix-spec-proposals/pull/4225)。（[#2029](https://github.com/matrix-org/matrix-spec/issues/2029)）


## 服务器-服务器 API

**向后兼容的修改**

- [ ] 使 ACL 应用于 EDU，参见 [MSC4163](https://github.com/matrix-org/matrix-spec-proposals/pull/4163)。（[#2004](https://github.com/matrix-org/matrix-spec/issues/2004)）

**规范澄清**

- [ ] 为 `/_matrix/federation/v1/state_ids/{roomId}` 增加 403 错误响应。（[#1926](https://github.com/matrix-org/matrix-spec/issues/1926)）


## 应用服务 API

**向后兼容的修改**

- [ ] 允许向应用服务发送临时数据，参见 [MSC2409](https://github.com/matrix-org/matrix-spec-proposals/pull/2409)。（[#2018](https://github.com/matrix-org/matrix-spec/issues/2018)）


## 身份服务 API

无重大更改。


## 推送网关 API

**规范澄清**

- [ ] 记录 `PusherData` 的数据结构。（[#1968](https://github.com/matrix-org/matrix-spec/issues/1968)）
- [ ] HTTP pusher URL 的路径固定为 `/_matrix/push/v1/notify`。（[#1974](https://github.com/matrix-org/matrix-spec/issues/1974)）


## 房间版本

**规范澄清**

- [ ] 澄清房间版本 11 授权规则的 4.3.1 条，明确需要匹配哪个事件的 `sender` 和 `state_key`。（[#2024](https://github.com/matrix-org/matrix-spec/issues/2024)）


## 附录

**规范澄清**

- [ ] 移除关于参考实现的说明。（[#1966](https://github.com/matrix-org/matrix-spec/issues/1966)）


## 内部变更/工具

**规范澄清**

- [ ] 为使用 `event-group` 短代码渲染的事件排序新增 `x-weight` 属性。（[#1967](https://github.com/matrix-org/matrix-spec/issues/1967)）
- [ ] 强制端点定义各段落之间的垂直间距一致。（[#1969](https://github.com/matrix-org/matrix-spec/issues/1969)、[#2005](https://github.com/matrix-org/matrix-spec/issues/2005)）
- [ ] 移除 `boxes/added-in-paragraph` 短代码。（[#1970](https://github.com/matrix-org/matrix-spec/issues/1970)）
- [ ] 移除 `rver-fragment` 短代码的 `withVersioning` 参数。（[#1971](https://github.com/matrix-org/matrix-spec/issues/1971)）
- [ ] 从 `added-in` 和 `changed-in` 短代码中移除 `span` 元素。（[#1972](https://github.com/matrix-org/matrix-spec/issues/1972)）
- [ ] 通过使用 `%` 分隔符修正 `added-in` 与 `changed-in` 短代码的格式化问题。（[#1975](https://github.com/matrix-org/matrix-spec/issues/1975)）
- [ ] 移除有关滚动锚点的 CSS 兼容性处理。（[#1976](https://github.com/matrix-org/matrix-spec/issues/1976)）
- [ ] 将 `custom-formats.yaml` 重命名为 `string-formats.yaml`，并更新相关文档。（[#1977](https://github.com/matrix-org/matrix-spec/issues/1977)）
- [ ] 在使用自定义 `baseURL` 时修正规范的相对链接。（[#1984](https://github.com/matrix-org/matrix-spec/issues/1984)、[#1997](https://github.com/matrix-org/matrix-spec/issues/1997)）
- [ ] 将 `.htmltest.yaml` 重命名为 `.htmltest.yml`。（[#1985](https://github.com/matrix-org/matrix-spec/issues/1985)）
- [ ] 改进 JS 脚本以高亮当前目录项。（[#1991](https://github.com/matrix-org/matrix-spec/issues/1991)、[#2002](https://github.com/matrix-org/matrix-spec/issues/2002)）
- [ ] 将 docsy 升级到 0.11.0，hugo 升级到 0.139.0。（[#1996](https://github.com/matrix-org/matrix-spec/issues/1996)、[#2007](https://github.com/matrix-org/matrix-spec/issues/2007)）
- [ ] 提高渲染图表的质量（[#1999](https://github.com/matrix-org/matrix-spec/issues/1999)）
- [ ] 更新 Inter 字体，并允许浏览器在字体加载前先渲染页面（[#2000](https://github.com/matrix-org/matrix-spec/issues/2000)）
- [ ] 使用正式的 Matrix favicon（[#2001](https://github.com/matrix-org/matrix-spec/issues/2001)）
- [ ] 清理 `openapi/render-operation` 局部模板中未使用的 CSS 类。（[#2003](https://github.com/matrix-org/matrix-spec/issues/2003)）
- [ ] 修正 `changed-in` 局部模板在多段落场景下的表现。（[#2006](https://github.com/matrix-org/matrix-spec/issues/2006)）
- [ ] 通过移除未使用的选择器优化生成的 CSS。（[#2008](https://github.com/matrix-org/matrix-spec/issues/2008)）
- [ ] 在 void 类型 HTML 元素上去除多余的斜杠。（[#2009](https://github.com/matrix-org/matrix-spec/issues/2009)）
- [ ] 移除 `script` 元素的 `type` 和 `language` 属性。（[#2021](https://github.com/matrix-org/matrix-spec/issues/2021)）
- [ ] 修改信息框的无障碍访问角色为 `note`。（[#2022](https://github.com/matrix-org/matrix-spec/issues/2022)）