# Matrix Specification v1.12 变更日志

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

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

**弃用**

- [ ] 按照 [MSC4156](https://github.com/matrix-org/matrix-spec-proposals/pull/4156) 的规定，弃用 `POST /_matrix/client/v3/join/{roomIdOrAlias}` 和 `POST /_matrix/client/v3/knock/{roomIdOrAlias}` 接口中的 `server_name` 查询参数。([#1933](https://github.com/matrix-org/matrix-spec/issues/1933))

**移除的接口**

- [ ] 移除对设备专属推送规则的引用。([#1842](https://github.com/matrix-org/matrix-spec/issues/1842))
- [ ] 按照 [MSC4159](https://github.com/matrix-org/matrix-spec-proposals/pull/4159) 的规定，移除 HTML 锚点元素中已弃用的 name 属性。([#1870](https://github.com/matrix-org/matrix-spec/issues/1870))

**向后兼容的变更**

- [ ] 按照 [MSC4170](https://github.com/matrix-org/matrix-spec-proposals/pull/4170) 的规定，在 `GET /_matrix/client/v3/profile/{userId}/avatar_url` 和 `GET /_matrix/client/v3/profile/{userId}/displayname` 接口中新增 403 响应。([#1867](https://github.com/matrix-org/matrix-spec/issues/1867))
- [ ] 按照 [MSC2867](https://github.com/matrix-org/matrix-spec-proposals/pull/2867)，新增对房间标记为未读的支持。([#1895](https://github.com/matrix-org/matrix-spec/issues/1895), [#1941](https://github.com/matrix-org/matrix-spec/issues/1941))
- [ ] 按照 [MSC4156](https://github.com/matrix-org/matrix-spec-proposals/pull/4156)，在 `POST /_matrix/client/v3/join/{roomIdOrAlias}` 和 `POST /_matrix/client/v3/knock/{roomIdOrAlias}` 接口中新增 `via` 查询参数。([#1933](https://github.com/matrix-org/matrix-spec/issues/1933))
- [ ] 按照 [MSC3939](https://github.com/matrix-org/matrix-spec-proposals/pull/3939)，新增账户锁定功能。([#1934](https://github.com/matrix-org/matrix-spec/issues/1934))
- [ ] 按照 [MSC4189](https://github.com/matrix-org/matrix-spec-proposals/pull/4189)，访客账户现可通过新认证接口下载/获取媒体缩略图。([#1959](https://github.com/matrix-org/matrix-spec/issues/1959))

**规范澄清**

- [ ] 重命名并排序特性概要表中的模块，以便于浏览。([#1855](https://github.com/matrix-org/matrix-spec/issues/1855))
- [ ] 明确房间头像不可加密。([#1871](https://github.com/matrix-org/matrix-spec/issues/1871))
- [ ] 记录“Secrets”部分的缩写及别名。([#1875](https://github.com/matrix-org/matrix-spec/issues/1875))
- [ ] 提高事务 ID 生成建议的准确性。([#1888](https://github.com/matrix-org/matrix-spec/issues/1888))
- [ ] 明确说明已弃用的 `dont_notify` 和 `coalesce` 推送动作必须被忽略而非拒绝。([#1890](https://github.com/matrix-org/matrix-spec/issues/1890))
- [ ] 修复规范中各处的拼写错误。([#1892](https://github.com/matrix-org/matrix-spec/issues/1892))
- [ ] 在功能表中补充缺失的 `m.set_displayname`、`m.set_avatar_url` 和 `m.3pid_changes` 的引用。([#1897](https://github.com/matrix-org/matrix-spec/issues/1897))
- [ ] 明确回退登录页面调用的是 `window.matrixLogin.onLogin` 而非 `window.onLogin`。([#1899](https://github.com/matrix-org/matrix-spec/issues/1899))
- [ ] 移除有关无任何有效条件的受限房间的混淆性描述。([#1903](https://github.com/matrix-org/matrix-spec/issues/1903))
- [ ] 明确 `window.matrixLogin.onLogin` 调用时传递的是 `POST /_matrix/client/v3/login` 的响应体。([#1905](https://github.com/matrix-org/matrix-spec/issues/1905))
- [ ] 按照 [MSC3882](https://github.com/matrix-org/matrix-spec-proposals/pull/3882)，记录 `m.get_login_token` 能力。([#1908](https://github.com/matrix-org/matrix-spec/issues/1908))
- [ ] 明确 `POST /_matrix/client/v3/login` 中的“用户标识符”对象包含依赖标识类型的其他属性。([#1909](https://github.com/matrix-org/matrix-spec/issues/1909))
- [ ] 不再特别说明 `GET /_matrix/client/v3/profile/{userId}` 可以返回附加属性，因为几乎所有接口都如此。([#1910](https://github.com/matrix-org/matrix-spec/issues/1910))
- [ ] 改进未认证媒体弃用提示框的描述，贡献者：@HarHarLinks。([#1916](https://github.com/matrix-org/matrix-spec/issues/1916))
- [ ] `GET /.well-known/matrix/client` 中的附加属性不再强制要求为对象类型。([#1920](https://github.com/matrix-org/matrix-spec/issues/1920))
- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))
- [ ] 按照 [MSC2701](https://github.com/matrix-org/matrix-spec-proposals/pull/2701) 与 [MSC2702](https://github.com/matrix-org/matrix-spec-proposals/pull/2702)，明确媒体库中 `Content-Type` 和 `Content-Disposition` 的用法。([#1935](https://github.com/matrix-org/matrix-spec/issues/1935))
- [ ] `GET /_matrix/client/v3/capabilities` 的附加键值不再强制要求为对象类型。([#1945](https://github.com/matrix-org/matrix-spec/issues/1945))


## 服务器-服务器 API

**向后兼容的变更**

- [ ] 按照 [MSC4170](https://github.com/matrix-org/matrix-spec-proposals/pull/4170)，在 `GET /_matrix/federation/v1/query/profile` 接口中新增 403 响应。([#1867](https://github.com/matrix-org/matrix-spec/issues/1867))

**规范澄清**

- [ ] 因已不再出现在 schema，移除 PDU 示例中的 `origin` 字段。([#1918](https://github.com/matrix-org/matrix-spec/issues/1918))
- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))
- [ ] 修正 `GET /_matrix/key/v2/server` 响应 schema 中的必需字段。([#1930](https://github.com/matrix-org/matrix-spec/issues/1930))
- [ ] 用“服务器名称”替代“DNS 名称”，以避免和附录中定义的“服务器名称”包含的“DNS 名称”混淆。([#1946](https://github.com/matrix-org/matrix-spec/issues/1946))


## 应用服务 API

**规范澄清**

- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))


## 身份验证服务 API

**规范澄清**

- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))


## 推送网关 API

**规范澄清**

- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))


## 房间版本

**规范澄清**

- [ ] 修复 state resolution v2 中的格式问题。([#1896](https://github.com/matrix-org/matrix-spec/issues/1896))
- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))


## 附录

**规范澄清**

- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))


## 内部变更/工具链

**规范澄清**

- [ ] Matrix.org 基金会不再要求贡献者需提供“真实”或“法律可识别”的姓名。([#1886](https://github.com/matrix-org/matrix-spec/issues/1886), [#1914](https://github.com/matrix-org/matrix-spec/issues/1914))
- [ ] 记录 `removal` 变更日志分类。([#1907](https://github.com/matrix-org/matrix-spec/issues/1907))
- [ ] 启用专用字体以更好地支持数学符号。([#1919](https://github.com/matrix-org/matrix-spec/issues/1919))
- [ ] 记录规范中使用了 [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119) 关键词。贡献者：@HarHarLinks。([#1928](https://github.com/matrix-org/matrix-spec/issues/1928))
- [ ] 为变更日志在 `/changelog/$VERSION/checklist.md` 下提供 markdown 检查表。([#1937](https://github.com/matrix-org/matrix-spec/issues/1937), [#1954](https://github.com/matrix-org/matrix-spec/issues/1954))
- [ ] 在 OpenAPI 定义和 JSON Schema 属性中新增 `deprecated` 字段。([#1940](https://github.com/matrix-org/matrix-spec/issues/1940))
- [ ] 使用相对永久链接跳转到最新变更日志。([#1956](https://github.com/matrix-org/matrix-spec/issues/1956))