Hub Mod

Hub Mod 是分配的中心的持久 Direct Connect 管理客户端。它连接 使用专用帐户，从有界运行时证据中发现命令，并结合该证据 审查供应商目录，并向授权所有者提供每个命令的打印表格。它 不发明命令、接受原始命令文本或替换集线器强制执行的权限。

概述和可用性

Hub Mod 仅在启用全局功能并且当前网站用户拥有时可用 选定的中心或具有允许的管理员角色。 Hub Mod 页面结合了持久 连接、实时 Hub Chat 工作区、发现状态、命令目录、插件清单、命令 构建器和传出活动。使用专用的中心帐户，以便其身份、类别和审计跟踪 与正常人保持分离 DC++ 客户。

保存的配置文件通常在后台低 CPU 模式下运行。打开直播工作区可以切换 将其设置为交互模式，以便当前的来宾列表、公共聊天、加入和离开活动以及私人 可以进行对话。禁用 Hub Mod 会停止其工作进程并阻止自动启动； 断开连接会关闭当前套接字，而不更改启用的设置。

连接和权限

配置昵称、密码、客户端标签字段、说明、电子邮件、共享大小、集线器计数、插槽、TCP 港口, UDP 港口, TLS 端口、身份别名和 NMDC 支持标记以匹配在集线器上注册的帐户。密码仍然受到保护 秘密。身份别名可帮助共享工作区识别客户端，但不会改变其 登录昵称或权限。

新配置使用 HubMOD 作为默认昵称和 HubMOD - hublist.pwiam.com 作为默认描述。当集线器时替换任一值 需要不同的注册身份，但保留网站设置、中心帐户和选定的 连接前已对齐集线器类别。

集线器类别必须与集线器分配的类别相匹配。为命令报告的最小类别是 在建筑商开业前进行检查，但中心仍然拥有最终决定权。 10级不绕过 缺少可用性、不完整的参数模式、未知的风险分类或注入 验证。自动重连处理瞬时故障；不正确的凭证和其他 重新连接之前必须纠正永久性登录失败。

发现状态

再次发现命令会创建具有独立生成版本和进度记录的新发现运行。状态会经过 queued、running 和 validating，然后进入 completed 或 failed。状态区会显示上一次成功运行、已接受和已拒绝的证据、添加和删除的命令、提供程序版本以及有限的错误消息。

Hub Mod 读取 Hub 记录中确认的软件名称。Verlihub Hub 从固定的本地来源取得已审核的 Verlihub Core 目录。发现永远不会向主聊天、#_PH_SECURITY 或其他机器人发送 !help、+help、!lstplug、!ledohelp、!lualist 或其他探测。已连接 Hub 已公告的 NMDC $UserCommand 帧会添加已审核的插件命令，例如 Ledokol 或 Lua。

再次发现命令会根据已确认的提供程序和 Hub 公告的记录创建一个有限目录。删除命令只会删除活动目录。一个生成版本只有具备当前已审核的目录修订、可执行的已审核命令，以及提供程序或 Hub 公告命令的证据时才会激活。中断、空白、过期或无效的运行会保留之前的活动目录。

每个已宣布的菜单项都是结构化证据，不代表可以执行其中的内容。无关的公共聊天、私信、过大的 记录、格式错误的帧、重复项，以及不能匹配唯一已审查定义的语法都会被拒绝。空的、中断的、过期的 或超时的运行会保持最后一个可用目录为活动状态。只有在希望先有意丢弃该目录、再等待新的已宣布菜单 项时，才选择 删除命令。

删除命令是独立操作。它会删除活动目录，但不会在当前连接中启动发现。要立即开始替代运行，请使用再次发现命令。如果活动工作进程执行删除，只有在下一次套接字重新连接后并且启用了自动发现时，自动发现才会运行。重复昵称或被拒绝的凭据是终止性登录失败。其他连接失败在达到配置的重试上限后会保持失败状态，直到所有者修正原因后重新连接。

打开 用户面板，然后为已分配的 Hub 选择 Hub Mod，即可移除当前目录、启动替换发现，或检查连接和重试状态。

支持的提供商

verified 定义来自经过审核并固定的来源。runtime_verified 条目是已连接 Hub 公告的完整结构化命令；只有与已审核目录匹配时才能执行。unverified 条目仍可阅读，但不能执行。像 -a 或 -b 这样的标记是其父命令的参数，绝不是独立命令。

Hub Mod 读取 Hub 记录中确认的软件名称。Verlihub Hub 从固定的本地来源取得已审核的 Verlihub Core 目录。它不会向主聊天、#_PH_SECURITY 或其他机器人发送 !help、+help 或其他发现请求。已连接 Hub 公告的 $UserCommand 帧会添加已审核的插件命令，例如 Ledokol 或 Lua。

再次发现命令会根据已确认的提供程序和 Hub 已公告的 $UserCommand 帧创建新的有限目录。删除命令只会删除活动目录。一个生成版本只有具备当前目录修订、可执行的已审核命令，以及已审核提供程序或 Hub 公告命令的证据时才会激活。中断、空白、过期或无效的运行会保留之前的活动目录。

Verlihub 命令

Hub Mod 读取 Hub 记录中确认的软件名称。Verlihub Hub 从固定的本地来源取得已审核的 Verlihub Core 目录。它不会向主聊天、#_PH_SECURITY 或其他机器人发送 !help、+help 或其他发现请求。已连接 Hub 公告的 $UserCommand 帧会添加已审核的插件命令，例如 Ledokol 或 Lua。

该表将已审核的 Core 命令与 Hub 公告的命令分开。命令会打开带类型的参数字段，并显示准确语法、最低等级、风险、官方维基、已审核来源和命令通道。服务器负责构建和验证负载。等级 3 可以使用最低等级为 3 或更低的已审核命令；需要更高等级的命令会保持不可用并说明原因。

Ledokol 命令

Hub Mod 读取 Hub 记录中确认的软件名称。Verlihub Hub 从固定的本地来源取得已审核的 Verlihub Core 目录。它不会向主聊天、#_PH_SECURITY 或其他机器人发送 !help、+help 或其他发现请求。已连接 Hub 公告的 $UserCommand 帧会添加已审核的插件命令，例如 Ledokol 或 Lua。

该表将已审核的 Core 命令与 Hub 公告的命令分开。命令会打开带类型的参数字段，并显示准确语法、最低等级、风险、官方维基、已审核来源和命令通道。服务器负责构建和验证负载。等级 3 可以使用最低等级为 3 或更低的已审核命令；需要更高等级的命令会保持不可用并说明原因。

Lua 和插件命令

Hub Mod 读取 Hub 记录中确认的软件名称。Verlihub Hub 从固定的本地来源取得已审核的 Verlihub Core 目录。它不会向主聊天、#_PH_SECURITY 或其他机器人发送 !help、+help 或其他发现请求。已连接 Hub 公告的 $UserCommand 帧会添加已审核的插件命令，例如 Ledokol 或 Lua。

如果缺少 Verlihub Core 命令，请检查 Hub 的软件字段，重新连接后选择再次发现命令。如果缺少插件命令，请确认 Hub 已公告其 $UserCommand 记录。安全通知或机器人的昵称不是命令提供程序的证据。请勿将未经审核的原始命令粘贴到主聊天。

可用的命令和插件

命令表显示命令、它的作用、用法、最低类别、来源、可用和运行 集线器命令操作。当两者都适用时，提供程序和插件来源会一起出现。别名保留 附加到他们的规范定义。不可用的行解释了它的定义、风险、 运行时可用性或配置的类不足以执行。

插件表分别显示插件、版本、帮助命令、发现的命令和最后一个 见过。活动表始终属于最后完成的一代。未完成的数据暂存 run 永远不会替换它，因此所有者可以在重新发现时继续检查已知目录 正在运行或尝试失败后。

使用搜索命令可按命令、别名、描述、用法、来源或插件筛选活动表格，而不会更改目录。如果重新发现是在打开此页面后完成，旧操作绝不会指向已移除的定义：Hub Mod 会要求您重新加载命令目录。重新加载后，请打开当前行，并在发送任何内容前重新检查可用性和表单。使用“排序方式”在“用途分组”和“命令名称”之间切换。用途分组会将只读、审核、配置、服务控制、破坏性和未知风险定义放在一起；分组说明命令用途，但绝不会授予权限。

命令审核与不可用原因

只有当命令在最近一次完成的发现中被观察到，并且与已审核的提供程序、插件、规范化调用和语法签名完全一致时，才能执行。较高的 Hub 等级不能绕过审核、风险分类、目标规则或参数验证。

not_observed

最近一次完成的发现没有观察到该命令。

unknown_command

运行时命令没有匹配的已审核目录定义。

unreviewed

定义尚未完成必需的目录审核。

unknown_risk

定义没有已审核的风险分类。

insufficient_class

Hub Mod 账户未达到命令要求的最低等级。

provider_unavailable

最近一次发现中提供程序或插件不可用。

syntax_mismatch

观察到的语法与已审核定义不一致。

命令

在可用行上选择“命令”，以将该确切定义加载到 Bootstrap 模态窗口中。 该模式在任何值出现之前显示其描述、用法、来源、插件、最低类别和风险。 接受了。没有原始命令输入或通用命令条目。公共或私人 Hub Chat 仍然可用于普通对话，但类似命令的消息将定向到经过验证的 建设者。

该表单可以提供主聊天、私人消息或提供商固定的目的地。私人命令 需要一个收件人。提交表单发送定义键、结构化值、交付 选择、收件人以及服务器在需要时发出的确认令牌。服务器重新加载活动 定义并拒绝陈旧、不可用、未经授权或跨中心提交。

字段上方的信息块会重复命令说明和语法，并显示提供商或插件、最低级别、风险、审核状态、 来源修订版和证据哈希。官方 Wiki 链接会打开 Verlihub Wiki 或 Ledokol Wiki 中的提供商文档。 已审核来源链接会打开该定义使用的确切目录证据。如果已安装版本或运行时语法与来源不符， 请重新运行发现，并在差异解决前不要发送命令。

参数及命令预览

每个命令参数在模式顺序中都有一个单独的字段。必填字段必须包含一个值； 可选字段可以留空。支持的类型包括文本、昵称、整数、端口、选择、 布尔开关、持续时间、主机、集线器地址、路径和消息。该表格显示了提供商的标签， 占位符、描述、所需状态和允许的选择，而不是要求所有者解析 语法注释。

预览会随着值的变化而更新，但它只是提供信息。服务器单独组装最终的 命令，应用确定性引用和转义，保留选项顺序，强制长度和类型 限制并拒绝回车、换行、NUL 字节、管道分隔符或第二个命令 前缀。浏览器预览永远不会成为权威有效负载。

风险与确认

每个可执行定义都有一个明确的风险：read_only 用于检查，moderation 对于影响用户的操作，configuration_change 为了持久的 集线器设置，destructive 用于删除或不可逆转的更改，或 service_control 用于重新加载、重新启动和停止操作。定义为 unknown 风险无法运行。

只读命令直接提交。需要再次审查的风险显示出具体的警告 命名选定的命令和操作类，然后将提交操作更改为确认并运行。的 签名的确认令牌绑定活动定义、结构化值、目的地、接收者、 和最终的服务器构建命令。编辑任何绑定值都会使该确认无效。

外出活动

传出活动记录网站用户、定义密钥、提供商、插件、风险、目的地、 收件人、确认状态和时间戳。结构化参数值和最终命令是 静态时加密。演示代码仅显示指定所有者授权的数据或 管理员，日志上下文不包括原始有效负载、密码、令牌和私人消息内容。

活动从 queued 到 sent 当工作人员完成套接字时 写。如果无法安全地观察交货，则将变成 delivery_uncertain 并且不是 自动重播。队列或验证失败变成 failed 有界的， 消毒诊断。现有的应用程序错误记录器和电子邮件通知路径保持活动状态。

重新发现和原子替代

更改 Verlihub、Ledokol、Lua 脚本、插件、命令后再次使用发现命令 权限，或 Hub Mod 帐户类别。新的运行将命令和插件写入暂存区 一代，而上一个完成的一代仍然处于活动状态。计数显示接受、拒绝、 添加和删除条目，以便可以审核更改。

只有经过完全验证的运行才会在一次指针交换中激活其生成。激活会删除 新一代之后的上一代都很耐用。错误的响应、超时、worker 关闭、 套接字断开连接或提供程序故障会放弃暂存并保留旧目录。这可以防止 通过删除以前已知有效的命令而得到的部分发现。

错误和故障排除

使用 Hub Chat 作为共享实时客户端控件， Hub 用于中心所有权指导，Hub 用于返回分配的 枢纽。使用运行生成和活动 ID 报告持续失败，切勿使用密码， 受保护的令牌、原始私人消息或秘密命令参数。

当此页面为已连接的客户端加载时，Hub Connection 和 Connection Status 默认处于折叠状态。两个卡片标题始终可见；展开或折叠任一面板都不会断开或重新连接客户端。

当 Hub Chat、Hub GPT 或 Hub Mod 工作进程重启时，已打开的产品页面会继续监控保存的会话并自动重新连接事件流，无需刷新浏览器。如果新版本以不兼容的方式更改浏览器与服务器之间的协议，页面会停止重试，并明确要求在重新连接前重新加载。

重启提示会作为系统消息显示在已打开的 Hub Chat 记录中，因此聊天布局保持稳定。浏览器和工作进程版本不兼容时，该系统消息会包含重新加载当前页面的操作。

登录身份

上传速度

在 ADC 和 ADCS 身份数据中公布的可选上传容量。请输入数值和单位；协议接收每秒字节数。

下载速度

在 ADC 和 ADCS 身份数据中公布的可选下载容量。请输入数值和单位；协议接收每秒字节数。

可用的命令和插件

Hub Mod 读取 Hub 记录中确认的软件名称。Verlihub Hub 从固定的本地来源取得已审核的 Verlihub Core 目录。它不会向主聊天、#_PH_SECURITY 或其他机器人发送 !help、+help 或其他发现请求。已连接 Hub 公告的 $UserCommand 帧会添加已审核的插件命令，例如 Ledokol 或 Lua。

再次发现命令会根据已确认的提供程序和 Hub 已公告的 $UserCommand 帧创建新的有限目录。删除命令只会删除活动目录。一个生成版本只有具备当前目录修订、可执行的已审核命令，以及已审核提供程序或 Hub 公告命令的证据时才会激活。中断、空白、过期或无效的运行会保留之前的活动目录。

该表将已审核的 Core 命令与 Hub 公告的命令分开。命令会打开带类型的参数字段，并显示准确语法、最低等级、风险、官方维基、已审核来源和命令通道。服务器负责构建和验证负载。等级 3 可以使用最低等级为 3 或更低的已审核命令；需要更高等级的命令会保持不可用并说明原因。

如果缺少 Verlihub Core 命令，请检查 Hub 的软件字段，重新连接后选择再次发现命令。如果缺少插件命令，请确认 Hub 已公告其 $UserCommand 记录。安全通知或机器人的昵称不是命令提供程序的证据。请勿将未经审核的原始命令粘贴到主聊天。

可按命令、别名、描述、用法、来源或插件搜索。

打开此页面后，可用命令已发生变化。请在打开或发送命令前重新加载目录。

已验证的 ADC 和 ADCS 附件下载

有效的 TTH magnet 链接仍是可以打开或复制的普通链接。如果已保存消息识别出在线 ADC 或 ADCS 来源，链接前会显示独立的下载图标。显示消息时不会获取文件。

激活图标后，现有的已登录 Hub Chat 会话会向当前发送者请求这条已保存消息中的准确附件。浏览器只发送会话、消息频道、已保存消息 ID 和附件位置；主机、文件名、大小和 magnet URI 均由服务器从已保存消息中确定。

接收端会为广告中的 TTH 协商 Direct Connect 传输，将数据写入私有临时文件，并在返回下载标头前同时核对准确字节数和 Tiger Tree Hash。不匹配或不完整的文件会被丢弃，浏览器不会收到部分文件。

下载始终由用户主动发起。会话级和应用级速率及并发传输均有限制，默认大小上限为 64 MiB。来源用户必须保持在线且可访问。临时文件会在完成、失败或过期后删除。

主动接收时，传输 worker 会先绑定选定的 TCP 或 TLS 端口，再向来源公布。请在主机防火墙和上游 NAT 中开放配置的主动端口范围；ADCS 还需要配置证书和私钥。若绑定失败或等待超时，同一任务会自动尝试被动反向协商。仍然失败时，请确认同一用户在线且可连接。缺少图标表示 TTH magnet 不完整或无法识别保存的来源；原始 magnet 仍可用于桌面客户端。

当接收方忙碌时，同一传输会保留在列表中，并在五分钟后自动重试。不会创建第二条记录。您可以关闭页面提示，或在不再需要时移除该传输。

如果对等方未能及时打开传输端点，应用会自动重新尝试一次该已验证下载。若仍失败，传输列表会显示原因；确认对方仍在共享文件后，您可以手动重试。

Hub Chat

只读传输缓存

仅在通过 Hub 完成对等端授权后共享生成的 Hublist 文件。

Hub Chat、Hub GPT 和 Hub Mod 的传输缓存默认关闭。每个产品都有独立的全局开关、主机、端口、连接数上限和带宽上限；Hub 所有者不能在单个 Hub 页面启用此功能。

此功能遇到任何错误都会保持关闭。只有不可变清单、监听器、公共地址、端口以及所需 TLS 文件全部健康后，启用开关才会公布共享。

设置与默认值

启用传输缓存

仅在全部健康检查通过后，允许此产品公布生成文件的只读缓存。默认关闭。

公布的公共主机

发送给已授权 Direct Connect 对等端的公共主机名或单播 IP。私有、loopback、本地和保留地址会被拒绝。

明文传输端口

可选的 NMDC 或 ADC 对等端端口，范围为 1024 到 65535。在已启用的 Hub 产品之间必须唯一。

TLS 传输端口

可选的 NMDCS 或 ADCS 对等端端口，范围为 1024 到 65535。TLS 证书和密钥路径由环境配置管理。

最大并发传输数

此产品允许的活动对等端连接数，范围为 1 到 32。

每秒字节带宽上限

每个产品的传输上限为每秒 65,536 到 104,857,600 字节。

全局传输监控

Hub 传输管理页面会汇总所选日期范围内已完成且经过验证的上传和下载。页面默认从当前月份开始，显示每日总计，并且绝不公开对端名称、地址、文件名或传输机密。

首个和最后一个动态端口会保留一个有限的私有范围。活动传输只能获得该范围内当前空闲的端口。清单区分已分配、过期、被操作系统占用和可用端口，并根据已保存范围计算使用率。

传输状态会在建立对端连接之前停止新的工作。允许的角色限制传输工作区访问；Hub Chat、Hub GPT 和 Hub Mod 的产品规则仍然适用，因此全局权限本身不会授予产品访问权。

检查传输健康状况会将已保存范围和本地监听器报告的有限 async_transfer 检查排入队列。健康结果只能确认应用程序可观察的事实，不能证明路由器、NAT 或外部防火墙允许来自互联网的入站流量。

使用文档中的部署命令监督 async_transfer worker。如果状态过期或没有出现快照，请先确认 worker，再检查本地监听器报告和端口分配，然后才修改防火墙或公共端点设置。

健康状态与公布

只有共享网关已绑定所有配置的监听器并报告当前健康状态时，已启用的产品才会公布传输。缺少主机、端口被占用、TLS 文件不可用、监听器失败或进程过期都会使端点和共享保持关闭。

保存传输设置，然后使用“检查公共端口”。检查要求只有一个正在运行的共享网关工作进程、与保存的主机和端口完全一致的最新监听器报告、不包含私有或保留地址的稳定公共 DNS，以及到每个解析地址和每个明文或 TLS 端口的成功 TCP 连接。探测不发送协议数据。由于探测从应用服务器发起，当 NAT 或防火墙的 hairpin 行为不同时，还应使用已授权的外部 Direct Connect 客户端验证端点。

网关只读取一个由获准公开 Hublist 产物构建的不可变清单版本。该版本记录每个公布文件的名称、大小和 TTH。文件缺失、hash 变化、symlink、文件列表错误或原子发布未完成都会使清单失效。

产品监听器和清单都健康时，客户端资料会公布清单总大小、活动传输端口、slot 以及支持的 NMDC 或 ADC 传输能力。任何依赖不健康时，都不会公布缓存共享或传输端点。

发现与授权

有限的 NMDC 或 ADC 搜索只会与当前清单匹配。结果标识准确的公布文件和 TTH；宽泛、错误、过大或无关的搜索不会枚举服务器文件系统。

Hub 协调发现和 CTM/RCM 协商，但不代理文件字节。产品通过已验证的 Hub 会话观察对等端昵称、方向和公共端点，登记短期授权，然后由对等端打开独立传输连接。

每个入站或出站传输都需要与产品、Hub 会话、对等端昵称、公共地址、方向和到期时间绑定的近期一次性授权。直接扫描、过期或重放记录、错误产品、对等端或地址，以及私有或保留目标都会被拒绝。

文件与只读限制

共享仅包含复制到专用缓存中的生成 Hublist 下载文件及其生成的 Direct Connect 文件列表。它不会公开任意应用文件、源路径、上传内容、远程 URL 或获准版本之外的文件。

每个不可变清单还包含 HUBLIST.PWIAM.COM.md，这是由项目维护的只读信息文件。它说明 PWiAM 是 Public DC Hublist 的托管者，概述 Hub 搜索和生成的 Hublist 文件，并介绍 Hub Chat、Hub GPT 和 Hub Mod。对等方可与其他获准清单项一起读取它；该文件由应用生成，对等方不能上传、替换或修改它。

网关只允许下载。它仅接受准确清单条目的文件列表和范围请求，拒绝路径穿越及无效范围，并且不支持上传、删除、重命名、创建目录或任意路径访问。

最大并发传输数限制每个产品的活动对等端。每秒字节带宽上限对整个产品应用共享速率限制。帧大小、handshake 时间、空闲时间、请求范围和授权有效期也都有上限。

TLS 与对等端安全

明文监听器与 TLS 监听器相互独立。只有环境管理的证书和私钥路径可用时才会公布 TLS 端口。加密不能替代 Hub 授权；当前 CTM 消息不携带可验证的证书主机名或 keyprint，因此对等端 TLS 只加密传输，并不证明公共 Web PKI 身份。

故障排除

如果共享未出现，请保持产品关闭，并依次检查当前清单、公共主机、唯一公共端口、监听器健康状态、TLS 路径、进程状态和防火墙转发。重新构建并验证清单，重启共享网关，然后测试一个已授权文件列表和一个文件请求。不要为了通过测试而削弱端点验证或接受未经验证的直接 socket。

图标说明