--- title: v1.12 变更日志 linkTitle: v1.12 type: docs layout: changelog outputs: - html - checklist date: 2024-10-07 --- {{< boxes/warning >}} 本页面的翻译未经核对，可能存在翻译质量不佳、错翻、漏翻等情况。您可以在 Forgejo 存储库 打开 Issue、提交 Pull Request 或邮件联系我们提出改进建议和参与翻译与核对。 {{< /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))