Update translations

This commit is contained in:
CDN 2025-04-20 16:13:37 +08:00
parent 4af1379d1e
commit 1030e735c0
Signed by: CDN
GPG key ID: 0C656827F9F80080
96 changed files with 13449 additions and 0 deletions

View file

@ -0,0 +1,72 @@
---
title: 房间版本
type: docs
weight: 60
---
{{< 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 >}}
房间是 Matrix 运行的核心,并对其内容有严格的规则限制。房间还可以拥有处理不同任务的各种算法,例如当两个或多个事件在底层 DAG 结构中发生冲突时的处理方式。为了便于通过新算法或新规则对房间功能进行改进Matrix 采用“房间版本”来管理每个房间的一组预期行为。根据需要分配新的房间版本。
房间版本之间没有隐式排序或层级关系,并且一旦被纳入规范,其原则不可更改。尽管有一组推荐使用的版本,有些房间可能会受益于其他版本所引入的功能。房间可通过“升级”至所需版本,在不同版本间切换。由于版本不具备排序或层级特性,这意味着房间完全可以从版本 2 “升级”到版本 1只要有此需求。
## 功能矩阵
某些功能仅在特定房间版本中可用,比如 knocking敲门加入。下表展示了不同版本从客户端视角支持哪些功能。服务器实现同样可以参考该表但实际开发中往往会更关心各版本的详细规范。
<!--
开发提示:当房间版本的列数过多时,可以将 1 到 6 合并为“1 ... 6”或类似形式因为这些版本未增加新功能。
或者,可以考虑调整表格的行列排列,将功能名称放在上方,版本放在左侧。
-->
| 功能 \ 版本 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 |
|----------------------------|---|---|---|---|---|---|---|---|---|----|----|
| **Knocking敲门加入** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ | ✔ | ✔ | ✔ |
| **受限加入规则** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ | ✔ | ✔ |
| **`knock_restricted` 加入规则** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ |
## 房间版本完整列表
房间版本分为两大类稳定版stable和非稳定版unstable。稳定房间版本可安全用于房间创建。非稳定版本则包括所有未在规范中列出或因其他原因被标记为不稳定的版本。各版本状态可能因多种原因如发现安全漏洞、版本老化等而定期在稳定与非稳定之间切换。
如果房间已在运行稳定版本,客户端不应要求房间管理员升级房间。服务器在新建房间时,**强烈建议默认使用房间版本 11**。
可选房间版本如下:
- [版本 1](/rooms/v1) - **稳定**。初始房间版本。
- [版本 2](/rooms/v2) - **稳定**。实现了 State Resolution Version 2状态解析版本 2
- [版本 3](/rooms/v3) - **稳定**。引入事件 ID 即事件哈希值的机制。
- [版本 4](/rooms/v4) - **稳定**。基于 v3 ,事件 ID 使用 URL 安全的 base64 编码。
- [版本 5](/rooms/v5) - **稳定**。引入对签名密钥有效期的强制校验。
- [版本 6](/rooms/v6) - **稳定**。修改了多项事件授权规则。
- [版本 7](/rooms/v7) - **稳定**。新增 knocking 功能。
- [版本 8](/rooms/v8) - **稳定**。添加新加入规则,允许其他房间成员无需邀请即可加入。
- [版本 9](/rooms/v9) - **稳定**。基于 v8修复了撤回部分成员事件时的问题。
- [版本 10](/rooms/v10) - **稳定**。仅允许权限等级为整数,并新增 `knock_restricted` 加入规则。
- [版本 11](/rooms/v11) - **稳定**。进一步明确撤回redaction算法。
## 房间版本语法规范
房间版本用于指定房间属性的变更,这些属性可能无法与其他服务器兼容。例如,更改事件授权规则可能导致旧服务器因无法理解新规则而出现分裂脑(split-brain)状态。
一个房间版本被定义为不超过 32 个码点的字符串。房间版本不能为空,且只能包含字符 `a-z``0-9``.``-`
房间版本号不应被解析,应视为不透明的标识符。仅包含 `0-9``.` 的房间版本号,保留给未来 Matrix 协议使用。
合法房间版本的完整语法为:
room_version = 1*room_version_char
room_version_char = DIGIT
/ %x61-7A ; a-z
/ "-" / "."
合法房间版本示例:
- `1`(将由 Matrix 协议保留)
- `1.2`(将由 Matrix 协议保留)
- `1.2-beta`
- `com.example.version`