# Matrix Specification v1.11 更新日志

|   |   | 
|---|---|
| Git commit | https://github.com/matrix-org/matrix-spec/tree/v1.11 |
| Release date | 2024年6月20日 |

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

**弃用说明**

- [ ] 根据 [MSC4126](https://github.com/matrix-org/matrix-spec-proposals/issues/4126)，通过查询字符串进行认证现已弃用，应改为使用 `Authorization` 头。([#1808](https://github.com/matrix-org/matrix-spec/issues/1808))
- [ ] `/_matrix/media/*` 端点的使用现已弃用。已提供新的认证端点。([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))

**新增端点**

- [ ] [`GET /_matrix/client/v1/media/config`](/client-server-api/#get_matrixclientv1mediaconfig) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))
- [ ] [`GET /_matrix/client/v1/media/download/{serverName}/{mediaId}`](/client-server-api/#get_matrixclientv1mediadownloadservernamemediaid) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))
- [ ] [`GET /_matrix/client/v1/media/download/{serverName}/{mediaId}/{fileName}`](/client-server-api/#get_matrixclientv1mediadownloadservernamemediaidfilename) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))
- [ ] [`GET /_matrix/client/v1/media/preview_url`](/client-server-api/#get_matrixclientv1mediapreview_url) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))
- [ ] [`GET /_matrix/client/v1/media/thumbnail/{serverName}/{mediaId}`](/client-server-api/#get_matrixclientv1mediathumbnailservernamemediaid) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))

**向后兼容更改**

- [ ] 按照 [MSC3291](https://github.com/matrix-org/matrix-spec-proposals/pull/3291) 增加对 VoIP 通话静音功能的支持。([#1755](https://github.com/matrix-org/matrix-spec/issues/1755))
- [ ] 按照 [MSC2705](https://github.com/matrix-org/matrix-spec-proposals/pull/2705) ，为 `GET /thumbnail` 增加可选的 `animated` 查询字符串选项。([#1757](https://github.com/matrix-org/matrix-spec/issues/1757))
- [ ] 按照 [MSC1692](https://github.com/matrix-org/matrix-spec-proposals/pull/1692) ，在注册时指定服务条款。([#1812](https://github.com/matrix-org/matrix-spec/issues/1812))
- [ ] 按照 [MSC2191](https://github.com/matrix-org/matrix-spec-proposals/pull/2191) ，增加对数学消息的支持。([#1816](https://github.com/matrix-org/matrix-spec/issues/1816))
- [ ] 按照 [MSC3967](https://github.com/matrix-org/matrix-spec-proposals/pull/3967) ，首次上传交叉签名密钥时不再需要 UIA。([#1828](https://github.com/matrix-org/matrix-spec/issues/1828))
- [ ] 按照 [MSC4115](https://github.com/matrix-org/matrix-spec-proposals/pull/4115) ，为事件添加新的 `unsigned.membership` 属性。([#1847](https://github.com/matrix-org/matrix-spec/issues/1847))
- [ ] 按照 [MSC3916](https://github.com/matrix-org/matrix-spec-proposals/pull/3916) ，媒体下载和缩略图现需认证。([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))
- [ ] 按照 [MSC3916](https://github.com/matrix-org/matrix-spec-proposals/pull/3916) ，部分媒体端点已统一迁移至 `/_matrix/client/{version}/media/*`，不再使用 `/_matrix/media/*`。([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))

**规范澄清**

- [ ] 增加 `/logout` 端点，并明确哪些端点不需 JSON 请求体。([#1644](https://github.com/matrix-org/matrix-spec/issues/1644))
- [ ] 明确 `POST /login` 请求的 `type` 必须为 `GET /login` 响应返回的类型之一。([#1776](https://github.com/matrix-org/matrix-spec/issues/1776))
- [ ] 类型中链接现有语法（如适用）。([#1813](https://github.com/matrix-org/matrix-spec/issues/1813))
- [ ] 将“恢复密钥”重命名为“备份解密密钥”。([#1819](https://github.com/matrix-org/matrix-spec/issues/1819))
- [ ] 明确在二维码验证中应使用设备的 Ed25519 签名密钥（而非 Curve25519 身份密钥）。([#1829](https://github.com/matrix-org/matrix-spec/issues/1829))
- [ ] 修复规范中的各种拼写错误。([#1832](https://github.com/matrix-org/matrix-spec/issues/1832), [#1841](https://github.com/matrix-org/matrix-spec/issues/1841), [#1852](https://github.com/matrix-org/matrix-spec/issues/1852), [#1853](https://github.com/matrix-org/matrix-spec/issues/1853))
- [ ] 规范生成设备验证二维码时应使用的编码。([#1839](https://github.com/matrix-org/matrix-spec/issues/1839))
- [ ] 明确在 `POST /account/password` 和 `POST /account/deactivate` 端点访问令牌为可选项。([#1843](https://github.com/matrix-org/matrix-spec/issues/1843))
- [ ] 更一致地使用 RFC 2119 关键词。([#1846](https://github.com/matrix-org/matrix-spec/issues/1846), [#1861](https://github.com/matrix-org/matrix-spec/issues/1861))
- [ ] 将用户、房间和事件 ID 的长度限制移至附录，并明确长度以字节为单位计量。([#1850](https://github.com/matrix-org/matrix-spec/issues/1850))
- [ ] 明确关系递归应限制深度。([#1854](https://github.com/matrix-org/matrix-spec/issues/1854))
- [ ] 在功能配置表中补充缺失的 secrets、第三方邀请及房间标签模块。([#1860](https://github.com/matrix-org/matrix-spec/issues/1860))
- [ ] 明确服务器名称的使用时机并链接其定义。([#1862](https://github.com/matrix-org/matrix-spec/issues/1862))
- [ ] 明确在检查 `m.room.encrypted` 事件时密钥的存放位置。([#1863](https://github.com/matrix-org/matrix-spec/issues/1863))
- [ ] 明确 `/media/v3/upload/{serverName}/{mediaId}` 端点需要认证。([#1872](https://github.com/matrix-org/matrix-spec/issues/1872))

## 服务器-服务器 API

**弃用说明**

- [ ] 客户端-服务器 API 下的 `/_matrix/media/*` 端点使用现已弃用。已提供新的认证端点。([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))

**新增端点**

- [ ] [`GET /_matrix/federation/v1/media/download/{mediaId}`](/server-server-api/#get_matrixfederationv1mediadownloadmediaid) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))
- [ ] [`GET /_matrix/federation/v1/media/thumbnail/{mediaId}`](/server-server-api/#get_matrixfederationv1mediathumbnailmediaid) ([#1858](https://github.com/matrix-org/matrix-spec/issues/1858))

**向后兼容更改**

- [ ] 按照 [MSC3916](https://github.com/matrix-org/matrix-spec-proposals/pull/3916) ，媒体下载和缩略图现需认证。([#1858](https://github.com/matrix-org/matrix-spec/issues/1858), [#1869](https://github.com/matrix-org/matrix-spec/issues/1869))

**规范澄清**

- [ ] 类型中链接现有语法（如适用）。([#1813](https://github.com/matrix-org/matrix-spec/issues/1813))
- [ ] 明确在 `X-Matrix` `Authorization` 头的参数列表中逗号前后允许存在空格。([#1818](https://github.com/matrix-org/matrix-spec/issues/1818))
- [ ] 明确 `/v2/send_join` 响应的 `event` 字段仅在事件由本地服务器签名时才为必需。([#1834](https://github.com/matrix-org/matrix-spec/issues/1834), [#1840](https://github.com/matrix-org/matrix-spec/issues/1840))
- [ ] 更新被 RFC 9110 替代的 RFC 7235 和 RFC 7230 引用。([#1844](https://github.com/matrix-org/matrix-spec/issues/1844))
- [ ] 修复规范中的各种拼写错误。([#1877](https://github.com/matrix-org/matrix-spec/issues/1877))

## 应用服务 API

**规范澄清**

- [ ] 明确应用服务应收到与 `sender_localpart` 用户相关的事件通知。([#1810](https://github.com/matrix-org/matrix-spec/issues/1810))

## 身份服务 API

**弃用说明**

- [ ] 根据 [MSC4126](https://github.com/matrix-org/matrix-spec-proposals/issues/4126)，通过查询字符串进行认证现已弃用，应改为使用 `Authorization` 头。([#1808](https://github.com/matrix-org/matrix-spec/issues/1808))

## 推送网关 API

无重大更改。

## 房间版本

**规范澄清**

- [ ] 明确撤回事件仍须遵守所有相关认证规则。([#1824](https://github.com/matrix-org/matrix-spec/issues/1824))
- [ ] 修复规范中的各种拼写错误。([#1827](https://github.com/matrix-org/matrix-spec/issues/1827), [#1848](https://github.com/matrix-org/matrix-spec/issues/1848))
- [ ] 修复房间版本 1 和 2 的事件格式渲染问题。([#1883](https://github.com/matrix-org/matrix-spec/issues/1883))
- [ ] 使用 Hugo 而非 JavaScript 生成目录。([#1884](https://github.com/matrix-org/matrix-spec/issues/1884))

## 附录

**弃用说明**

- [ ] 按照 [MSC4132](https://github.com/matrix-org/matrix-spec-proposals/pull/4132) ，弃用通过房间别名链接房间内事件的做法。([#1823](https://github.com/matrix-org/matrix-spec/issues/1823))

**规范澄清**

- [ ] 定义“不透明标识符语法”。([#1791](https://github.com/matrix-org/matrix-spec/issues/1791))
- [ ] 定义通用加密密钥表示。([#1819](https://github.com/matrix-org/matrix-spec/issues/1819))
- [ ] 将用户、房间和事件 ID 的长度限制移至附录，并明确长度以字节为单位计量。([#1850](https://github.com/matrix-org/matrix-spec/issues/1850))

## 内部更改/工具

**规范澄清**

- [ ] 更新规范发布流程及相关文档。([#1759](https://github.com/matrix-org/matrix-spec/issues/1759))
- [ ] 修复 `@matrix-org/spec` 的 npm 发布脚本。([#1765](https://github.com/matrix-org/matrix-spec/issues/1765))
- [ ] 修正 `CONTRIBUTING.rst` 中的格式问题。([#1769](https://github.com/matrix-org/matrix-spec/issues/1769))
- [ ] 改善移动设备下的渲染效果。([#1770](https://github.com/matrix-org/matrix-spec/issues/1770), [#1771](https://github.com/matrix-org/matrix-spec/issues/1771))
- [ ] 修正安全方案的 OpenAPI 定义。([#1772](https://github.com/matrix-org/matrix-spec/issues/1772))
- [ ] 简化 `resolve-refs` partial 的使用。([#1773](https://github.com/matrix-org/matrix-spec/issues/1773))
- [ ] 修复 Hugo 警告。([#1775](https://github.com/matrix-org/matrix-spec/issues/1775), [#1788](https://github.com/matrix-org/matrix-spec/issues/1788))
- [ ] 修复 `github-labels.rst`。([#1781](https://github.com/matrix-org/matrix-spec/issues/1781))
- [ ] 更新依赖项。([#1786](https://github.com/matrix-org/matrix-spec/issues/1786), [#1803](https://github.com/matrix-org/matrix-spec/issues/1803), [#1804](https://github.com/matrix-org/matrix-spec/issues/1804))
- [ ] 在 OpenAPI 和 JSON Schemas 中递归解析 `allOf`。([#1787](https://github.com/matrix-org/matrix-spec/issues/1787))
- [ ] 修正 `render-object-table` partial 属性类型解析。([#1789](https://github.com/matrix-org/matrix-spec/issues/1789))
- [ ] 抽取出通用的 `Tag` 类型定义。([#1793](https://github.com/matrix-org/matrix-spec/issues/1793))
- [ ] 将规范渲染所用 Hugo 版本升级至 v0.124.1。([#1794](https://github.com/matrix-org/matrix-spec/issues/1794))
- [ ] 增加对 `patternProperties` 的模式格式支持。([#1796](https://github.com/matrix-org/matrix-spec/issues/1796))
- [ ] 清理 OpenAPI 定义中不必要的 `allOf`。([#1797](https://github.com/matrix-org/matrix-spec/issues/1797))
- [ ] 在对象表格中显示“附加属性”信息。([#1798](https://github.com/matrix-org/matrix-spec/issues/1798))
- [ ] 修正 `oneOf` 下 schemas 的锚点。([#1799](https://github.com/matrix-org/matrix-spec/issues/1799))
- [ ] 在 OpenAPI 定义中引用 `OneTimeKeys` schema。([#1800](https://github.com/matrix-org/matrix-spec/issues/1800))
- [ ] 不对只包含 `additionalProperties` 或 `patternProperties` 的对象使用 `title`。([#1801](https://github.com/matrix-org/matrix-spec/issues/1801))
- [ ] 在 `definition` shortcode 中添加锚点。([#1802](https://github.com/matrix-org/matrix-spec/issues/1802))
- [ ] 为 Towncrier CI 任务设置 python 版本。([#1805](https://github.com/matrix-org/matrix-spec/issues/1805))
- [ ] 在 CI 中用环境文件替换 `set-output`。([#1806](https://github.com/matrix-org/matrix-spec/issues/1806))
- [ ] 渲染响应头信息。([#1809](https://github.com/matrix-org/matrix-spec/issues/1809))
- [ ] 更多地方在受支持格式下使用 `patternProperties`。([#1813](https://github.com/matrix-org/matrix-spec/issues/1813))
- [ ] 增加对字符串格式渲染的支持。([#1814](https://github.com/matrix-org/matrix-spec/issues/1814))
- [ ] 重构内容存储库端点的 OpenAPI 定义。([#1822](https://github.com/matrix-org/matrix-spec/issues/1822))
- [ ] 清理拉取请求模板。([#1831](https://github.com/matrix-org/matrix-spec/issues/1831))
- [ ] 示例中不再添加空数组。([#1849](https://github.com/matrix-org/matrix-spec/issues/1849))
- [ ] 使用 Hugo 而非 JavaScript 生成目录。([#1851](https://github.com/matrix-org/matrix-spec/issues/1851), [#1885](https://github.com/matrix-org/matrix-spec/issues/1885))
- [ ] 修正规范发布议题模板中的语法错误。([#1856](https://github.com/matrix-org/matrix-spec/issues/1856))
- [ ] Netlify 构建任务使用环境变量。([#1865](https://github.com/matrix-org/matrix-spec/issues/1865))
- [ ] 在请求与响应内容类型信息中渲染新增/变更内容。([#1876](https://github.com/matrix-org/matrix-spec/issues/1876))
- [ ] 修正生成 HTML 的验证错误。([#1880](https://github.com/matrix-org/matrix-spec/issues/1880))
- [ ] 确保大部分生成的 HTML ID 唯一。([#1881](https://github.com/matrix-org/matrix-spec/issues/1881))
- [ ] 允许为 API 端点生成的 HTML ID 指定前缀。([#1882](https://github.com/matrix-org/matrix-spec/issues/1882))