Hub Mod 是一个持久的低带宽 Direct Connect 客户端，用于授权集线器管理。它使用为所选中心配置的一个配置文件登录，保持共享实时聊天工作区可用，发现中心及其插件公布的命令，并记录其排队的每个公共命令或私人消息。
Hub Mod 并没有发明集线器权限。帐户类别和中心自己的命令目录决定了身份可以执行的操作。确认增加了强大命令的审核步骤；它不会减少 10 类身份可用的命令。
概述
- 在中心创建专用审核帐户，并分配您的政策所需的最低级别。
- 从分配的集线器配置文件中打开 Hub Mod，配置昵称、密码、客户端标签、插槽、共享、集线器计数、端口和支持标志，然后保存。
- 选择 连接 并等待 已连接。
- 选择 发现命令 请求中心、Verlihub、Ledokol、Lua 和插件帮助。
- 在发送命令之前检查发现的最小类和语法。
- 检查 外出活动 获取确切的有效负载、目的地、请求用户和交付状态。
连接状态
该状态使用与 Hub Chat 和 Hub GPT 相同的生命周期：已断开连接, 正在连接, 已连接, 重新连接, 失败，和 已停止。已连接表示集线器接受登录。运行意味着持久工作人员仍然拥有会话。
启用 允许配置的身份运行。连接 启动它。重新连接 用保存的配置文件替换当前工作人员。断开连接 停止套接字而不禁用配置。禁用 停止工作人员并防止自动启动。
自动重新连接会在发生暂时性故障后等待配置的时间间隔。后台低CPU仍然是正常的持久模式；当所有者主动使用页面时，交互模式可启用完整的访客和协议工作区。
客户简介
新配置使用 HubMOD 作为登录昵称，使用 HubMOD - hublist.pwiam.com 作为默认描述，并使用 mod 作为身份别名。身份别名保存用逗号或换行分隔的其他名称；它们不会更改登录昵称、帐户级别或 Hub 权限。
Hub Mod 重复使用 Hub Chat 和 Hub GPT 客户端配置文件字段。昵称和密码标识注册的中心帐户。客户端名称、客户端版本和连接构建客户端标签。描述、电子邮件、共享大小、连接的集线器、注册的集线器、运营商集线器、插槽、TCP 端口、UDP 端口、TLS 端口和 NMDC 支持标志重现集线器规则所需的身份。
Share 和 hub-count 值是该客户端发送的声明；他们不发布文件或打开监听端口。使用集线器所有者批准的值。密码作为受保护的秘密存储，并且永远不会打印在活动表或原始传出协议视图中。
手动聊天和命令
共享实时工作区提供主聊天、访客和私人对话，无需任何 OpenAI 处理。公共消息完全通过中心的主聊天路径发送。私人消息包括选定的收件人。单独的命令控制台接受完整的原始命令并使用相同的传递路径。
对于带有参数的命令，从发现的语法开始，用故意的值替换占位符，并在发送之前读取完整的有效负载。排队的行并不能证明集线器接受了命令；已发送意味着工作人员将其写入实时连接，而生成的集线器响应在聊天和协议证据中仍然可见。
嘉宾
访客面板使用与 Hub Chat 和 Hub GPT 相同的可排序表格。昵称和角色左对齐并可排序；共享、插槽、标签、地址、速度、说明和其他列在集线器提供时显示。选择当前访客可以打开私人会话。访客活动有独立的垂直折叠面板，折叠时不会清除加入和离开事件。
私信
私人对话显示 Hub Mod 身份的传入和传出消息。使用它来检查发送给中心安全机器人的命令，或在中心策略允许时私下联系用户。传出活动表单独保留确切的排队负载和接收者。
收件人离开后，对话仍然可见。在发送另一条消息之前，请确认已连接状态和当前访客的状态。切勿将中心密码、站点凭据或不相关的私人数据放入命令或聊天消息中。
集线器类和命令访问
| 班级 | 典型角色 | 集线器模组行为 |
|---|---|---|
| 0 | 匿名或未注册用户 | 仅提供针对 0 级通告的命令或未报告最低等级的命令。 |
| 1 | 注册用户 | 包括类别 0 和为类别 1 公布的命令。 |
| 2 | 贵宾 | 包括较低的类别和为类别 2 公布的命令。 |
| 3 | 主持人 | 包括针对 3 类公布的较低类别和普通审核命令。 |
| 4 | 操作员或高级主持人 | 包括较低的类别和为类别 4 公布的命令。 |
| 5 | 管理员 | 包括 5 级的较低级别和强大的管理命令。 |
| 10 | 集线器所有者或主人 | 即使发现报告了另一个最小类，每个语法上有效的命令都可用。不存在拒绝列表或隐藏命令例外。 |
这些名称是常见的 Verlihub 约定，而不是通用的 DC++ 标准。所选类别必须与实际中心中创建的帐户匹配。较低级别不能使用其发现的最低级别较高的命令。未知的最低等级仍然是未知的，而不是被猜测的。
命令发现
Discovery 发送只读帮助和清单探测 !help、+help、!commands、+commands、!pluglist all、!lstplug、!plugins、!lualist、!luainfo、!lua 和 !ledohelp。探测会分时发送，而不是一次突发发送。Discovery 还会读取 NMDC $UserCommand 菜单，并跟随检测到的插件帮助命令。响应会解析为调用、语法、描述、类别、来源和最低级别，同时保留未修改的帮助证据。
不同的集线器使用不同的前缀和别名。因此，发现从连接的集线器中学习，而不是依赖于一个硬编码的 Verlihub 列表。更改插件、脚本、权限或 Hub Mod 类后再次运行它。不再返回的命令将被标记为不可用，而不是静默删除。
Verlihub 命令
Verlihub 通常通过 $UserCommand 包含课程要求的框架和帮助文本。 Hub Mod 读取两者。菜单类别成为目录类别，命令标记成为调用，声明的类成为最小类。
Verlihub 安装可以重命名前缀、禁用命令或添加脚本。将连接的集线器的当前帮助视为权威。使用命令显示的语法并在发送之前确认最终的昵称、持续时间、原因、类别或配置值。
Ledokol
Ledokol 脚本包经常暴露 !ledohelp 或者在他们的横幅中提及另一个帮助条目。 Hub Mod 在插件列表中优先考虑 Ledokol，请求其帮助，并对响应公开的命令进行分类。安装的包和版本决定了实际的语法。
Lua 等插件
Hub Mod 检测到 Lua 公告和插件名称，例如 Plugin: floodprotect.lua。当证据包含帮助命令时，工作线程每次发现运行都会请求该命令一次，并存储其返回的用法。插件表显示检测到的名称、版本、帮助命令和证据。
并非每个脚本都会自我宣传或提供机器可读的帮助。如果插件可见，但未检测到帮助命令，请手动使用其记录的 hub 命令，并在插件发布帮助后重新运行发现。 Hub Mod 不得猜测未记录的参数。
强大的命令确认功能
禁止、踢出、删除、重新加载、重新启动、停止、重新配置、更改类或执行 Lua /plugin 操作的命令需要确认复选框。该复选框强制所有者重新读取确切的有效负载和目的地。它不会更改集线器授权，也不会永久阻止该命令。
对于第 10 类，每个最多 240 个字符的语法上有效的单行有效负载在任何所需的确认后仍然可执行。唯一被拒绝的有效负载是空的、太长的或包含换行符、回车符或 NUL 字符，这些字符不能是安全的单个集线器消息。
外出活动和隐私
传出活动记录确切的消息、公共或私人目的地、请求网站用户、确认状态、排队时间和传递结果。发现探测也会被记录。使用此表和可见的集线器响应来审核 Hub Mod 实际尝试的内容。
活动记录是操作证据，可以包含主持人输入的原因或昵称。限制指定的中心所有者和管理员的访问权限。命令和私信的确切内容在静态存储时会被加密，并且仅在获授权的中心所有者和管理员查看或执行时解密。密码保留在该表之外；请勿将机密粘贴到命令参数、聊天、屏幕截图或支持票证中。
Hub Mod 故障排除
| 问题 | 检查 | 恢复 |
|---|---|---|
| Hub Mod 保持断开连接 | 可用性、启用状态、集线器端点、昵称、密码和上次错误。 | 更正保存的配置文件，然后连接一次。 |
| 集线器拒绝该身份 | 注册帐户、重复昵称、类别、共享、插槽、中心计数和客户标签。 | 使配置的配置文件与批准的中心帐户匹配，然后重新连接。 |
| 没有发现命令 | 连接状态、主聊天权限、帮助前缀、集线器机器人回复和原始响应。 | 手动运行正确的帮助命令，然后在响应可见后重新运行发现。 |
| 列出的插件没有命令 | 插件证据和帮助命令。 | 发送广告插件帮助命令；不要发明论点。 |
| 下层阶级无法发送命令 | 选择集线器等级并发现最低等级。 | 使用具有足够级别的授权帐户或选择允许的命令。 |
| 10 类命令请求确认 | 确切的有效负载和确认复选框。 | 审核并确认；确认永远不会删除 10 类访问权限。 |
| 活动仍处于排队状态 | 工作线程、连接状态和上次错误。 | 恢复连接；在知道队列状态之前不要提交重复项。 |
| 页面显示老客人或留言 | 运行时模式和最新连接状态。 | 切换到交互式并允许当前快照替换过时的浏览器状态。 |
相关页面
对于共享实时客户端，请阅读 Hub Chat；对于 OpenAI 支持的机器人，请阅读 Hub GPT。返回 Hub 以选择分配的中心。
父页面
返回 Hub 了解中心所有权和诊断指导。
图标说明
| 图标 | 标签 | 它的作用 |
|---|---|---|
| Hub 聊天 | 仅管理员可用的工具，会以可配置的诊断用户连接到 Hub，并显示会话期间返回的原始 Hub 响应、聊天内容、私信和用户列表数据。 | |
| Hub 连接 | 标识用于打开并保持此 Direct Connect 会话的已保存 hub 地址和登录配置。 | |
| 原始 Hub 响应 | 显示从 hub 收到的准确协议行，便于核对回复、错误和服务器命令。 | |
| 原始 Hub 请求 | 显示客户端发出的已脱敏协议行，便于核对准确命令而不泄露秘密。 | |
| 正在启动 | 表示工作进程正在打开套接字并完成 Direct Connect 登录；聊天尚未就绪。 | |
| 已连接 | 表示 hub 已接受登录，客户端可以接收实时流量并发送该账户允许的命令。 | |
| 错误 | 标记无法启动或继续的会话；随附详情会指出失败的连接或工作进程步骤。 | |
| 已关闭 | 表示实时套接字和工作进程会话已经结束，无法继续发送 hub 流量或消息。 | |
| 切换到后台模式 | 切换到低带宽持久模式，继续接收公聊和私信，同时暂停高开销诊断更新。 | |
| 切换到交互模式 | 在保持同一 hub 连接的同时，恢复访客、原始协议流量和诊断的完整实时更新。 | |
| 启用浏览器通知 | 选择通知模式，然后授予浏览器通知权限。 | |
| 重新启动会话 | 停止当前工作进程，并使用已保存的连接和客户端配置启动新会话。 | |
| 重新连接 | 关闭当前套接字，并立即使用相同的已保存会话设置重新登录。 | |
| 关闭会话 | 主动结束工作进程和 hub 连接；已保存配置仍可用于以后再次连接。 | |
| 折叠 Hub 聊天 | 将 Hub Chat 折叠到左侧栏，并在不关闭会话的情况下把访客面板扩展到整个工作区宽度。 | |
| 展开 Hub 聊天 | 从左侧栏恢复 Hub Chat，并让 Hub Chat 与访客面板恢复为正常的并排宽度。 | |
| 折叠访客 | 将访客面板折叠到右侧栏，并把 Hub Chat 扩展到整个工作区宽度。 | |
| 展开访客 | 从右侧栏恢复访客面板，并让两个面板恢复为正常的并排宽度。 | |
| 发送 | 将输入的公聊消息或 hub 命令加入队列，通过当前已登录会话发送。 | |
| 访客 | 列出 hub 当前报告的用户，包括角色、在线状态、客户端、共享和可用身份信息。 | |
| 按昵称搜索访客 | 按昵称筛选显示的访客列表，不会向 hub 发送搜索请求或命令。 | |
| 消息 | 打开或返回与所选访客的私聊；此操作本身不会发送任何消息。 | |
| 会话 | 列出本会话保留的私信线程，包括未读状态以及每位访客是否仍在线。 | |
| 普通访客角色 | 访客表中昵称旁的灰色用户标记表示 Hub 未报告该会话具有操作员或机器人权限。 | |
| 机器人角色 | 访客表中昵称旁的银色机器人标记表示 Hub 已将该会话识别为机器人。 | |
| 操作员角色 | 访客表中昵称旁的金色钥匙表示 Hub 已授予该会话操作员权限。 | |
| 登录身份 | 集中显示登录时向 hub 公布的昵称、密码、客户端标签、共享、slots 和其他身份值。 | |
| NMDC 支持标志 | 选择登录时发送的 NMDC $Supports 标志。普通聊天客户端默认不启用 BotINFO。 | |
| 访客已加入 | 当 Hub 宣布某个昵称进入时显示在访客活动中；管理员无需执行任何操作。 | |
| 访客已离开 | 当 Hub 宣布某个昵称离开或断开连接时显示在访客活动中。 | |
| 可排序列 | 当访客或会话表中的某列可以排序但不是当前排序列时，显示在该列标题中。 | |
| 升序排列 | 当活动列按从小到大排列时显示；选择该标题可反转排序方向。 | |
| 降序排列 | 当活动列按从大到小排列时显示；选择该标题可反转排序方向。 | |
| 关闭私聊 | 从会话列表移除所选私聊；此操作不会断开访客连接，也不会封禁访客。 | |
| 访客在线 | 会话中的绿色在线标记表示该访客当前仍在已连接的 Hub 中。 | |
| 访客离线 | 会话中的灰色离线标记表示访客已不在 Hub 中，但保存的会话仍可查看。 | |
| 打开帮助 | 打开此帮助文章。 | |
| {{ PWIATERM2 }} | 标识持久化管理工作区，hub 所有者可在此检查流量、发现命令并管理 hub。 | |
| 客户端模式 | 设置 NMDC 客户端标签中的 M 值。主动模式发送 M:A；被动模式发送 M:P。 | |
| 连接状态 | 报告 Hub Mod 是否启用、工作进程和套接字是否运行、连接时间及上次失败原因。 | |
| 运行时和发现 | 集中显示机器人身份、公开的客户端配置、重连策略、hub 等级和命令发现计划。 | |
| 命令控制台 | 提供准确命令、主聊天或私信目标、收件人，以及高影响操作所需的确认。 | |
| 发现命令 | 将 hub 和插件帮助请求加入队列，包括可用帮助命令，并保存发现的命令和 Lua 插件。 | |
| 可用的命令和插件 | 列出发现的命令和插件及其用法、来源、最低等级和配置账户是否可用。 | |
| 外出活动 | 审计每条准确发出的主聊天命令或私信，包括时间、请求者、目标和发送状态。 |