turt2live/matrix-dimension

Dimension：Matrix客户端集成管理器

镜像概述

Dimension是一款针对Matrix客户端（如Element）的开源集成管理器，旨在简化用户与 homeserver 提供的各类集成服务（如机器人、桥接器、小部件等）的交互与配置过程。

项目状态

⚠️ 项目不再维护
请注意，Dimension已不再正式维护。Bug将不会被修复，新功能也不会被开发。项目支持极其有限——使用前请务必查看问题跟踪器。
未来Dimension可能会被替代或淘汰，但目前暂无明确计划。

通常情况下，您可能并不需要集成管理器：

• Element Web/Desktop可通过/addwidget命令添加小部件
• 自托管机器人和桥接器可完全通过命令管理
• 贴纸功能可通过https://github.com/maunium/stickerpicker%E6%88%96%E6%94%AF%E6%8C%81MSC2545%E7%9A%84%E5%AE%A2%E6%88%B7%E7%AB%AF%EF%BC%88%E5%A6%82Nheko%EF%BC%89%E5%AE%9E%E7%8E%B0

安装与运行

有关运行Dimension的详细信息，请参见安装文档。

"无法联系集成服务器"错误排查

1. 检查homeserver的联邦功能是否启用并正常工作：如果并非有意在非联邦环境中运行Dimension，请确保homeserver配置正确。若运行于非联邦环境，请参考非联邦环境文档。
2. 检查SRV记录和.well-known delegation：如果使用SRV记录指向联邦端口，确保主机名和端口正确，且HTTPS在该端口监听。Dimension将使用第一条记录并仅通过HTTPS通信。若使用.well-known进行联邦委托，请双重检查配置。
3. 验证配置中的homeserver信息：名称、访问令牌和客户端/服务器API URL均需指向您的homeserver。若运行私有服务器，可能还需设置联邦URL。
4. 运行故障排除工具：若使用Element，在私人房间中输入/addwidget https://dimension.t2bot.io/widgets/manager-test并点击按钮。

是否需要集成管理器？

集成管理器旨在简化用户与homeserver提供的各类服务的交互。Element提供的默认集成管理器通常已足够使用，但在以下情况运行自己的集成管理器更有意义：

• 希望自托管所有服务组件（客户端、homeserver和集成服务）
• 希望宣传特定于您的homeserver的自定义机器人
• 企业或封闭环境中默认集成管理器无法使用

集成管理器工作原理

集成管理器充当用户与集成服务（机器人、桥接器等）之间的中介，帮助用户配置房间集成。集成管理器只能管理其已配置的集成服务。例如，Modular仅能配置matrix.org上的桥接器和机器人，而Dimension可配置您自己的机器人和桥接器。

基础设施架构如下：
!infrastructure

开发

有关Dimension开发的更多信息，请参见DEVELOPMENT.md。

许可证

有关Dimension的许可证信息，请参见仓库中包含的LICENSE文件。