VCP 连接器
概述
VCP 连接器是 AIO Hub 与 VCP (Variable & Command Protocol) 生态系统之间的桥梁。它让你能在 AIO Hub 中实时观察 VCP 的运行状态，又能将 AIO Hub 的工具能力共享给 VCP 网络中的 AI Agent，实现双向能力互通。
简单来说，VCP 连接器就是你的 VCP 可视化控制台——既能看，又能用。
核心功能
- 实时消息监控：以可视化的卡片形式实时接收 VCP 服务器的运行时广播消息，包括 RAG 检索详情、元思考链推理过程、Agent 私聊预览、AI 记忆回溯和插件执行状态，是调试 VCP 工作流的绝佳窗口
- 分布式节点：将 AIO Hub 注册为 VCP 分布式网络中的一个节点，让你的 AI Agent 能远程调用 AIO Hub 的本地工具（如文件操作、数据处理等）
- 工具桥接（双向共享）：动态发现 VCP 服务器上的原生插件，并将其映射为 AIO Hub 的内部工具；反过来也能将 AIO Hub 的工具暴露给 VCP 网络。一套连接，双重共享
- 连接配置自动探测：只需指定 VCP 安装目录，系统自动读取
config.env文件，解析出 WebSocket 地址和鉴权 Key，无需手动记忆配置 - 分离窗口支持：消息监控面板可以拖拽为独立窗口，让你在工作的同时实时观察 VCP 运行状态
快速上手
准备工作
在开始之前，你需要有一个正在运行的 VCP 服务器。VCP 连接器是一个客户端工具，它通过 WebSocket 与 VCP 服务器建立连接。
首次连接 4 步走
第一步：打开 VCP 连接器
在左侧工具列表中找到 VCP 连接器，点击进入。你会看到左右分栏的布局：左侧是配置面板，右侧是消息监控和分布式节点两个标签页。
TODO: 截图 - VCP 连接器整体界面，标注左侧配置栏和右侧 Tab 标签
第二步：配置连接
在左侧的"VCP 连接与过滤"面板中，你可以选择以下两种方式之一来配置连接：
- 方式一（推荐）：选择 VCP 安装目录 —— 点击最上方的文件夹图标按钮，从文件系统选择你的 VCP 安装目录。系统会自动读取该目录下的
config.env文件，自动填入 WebSocket 地址和 VCP Key。 - 方式二：手动填写 —— 如果 VCP 服务器不在本地或无法自动探测，可以手动输入 WebSocket 地址和 VCP Key。
填写完成后，开启 自动连接 开关（可选，开启后应用启动时自动连接），然后点击 连接 按钮。
TODO: 截图 - 左侧配置面板，标注 VCP 目录选择按钮、地址/Key 输入框、连接按钮
第三步：确认连接状态
连接成功后，左侧面板会显示连接状态（绿色标识），同时右侧消息监控区域会开始接收来自 VCP 服务器的广播消息。
TODO: 截图 - 连接成功后的状态展示，标注网络延迟和重连次数
第四步：开始使用
连接建立后，你就可以：
- 切换到 消息监控 Tab 查看 VCP 的实时运行日志
- 切换到 分布式节点 Tab 管理暴露给 VCP 的工具
- 如果需要，开启 工具桥接 来使用 VCP 服务器上的插件
TODO: 截图 - 消息监控 Tab 中展示实时接收到的各类消息卡片
功能详解
连接配置面板
左侧的配置面板包含两个核心功能区：连接管理和消息过滤。
连接管理
| 配置项 | 说明 |
|---|---|
| VCP 目录 | 选择 VCP 安装目录，自动探测连接参数 |
| WebSocket 地址 | VCP 服务器的 WS 地址，如 ws://192.168.1.100:8322 |
| VCP Key | VCP 的鉴权密钥，从 config.env 中的 VCP_Key 获取 |
| 连接模式 | 支持三种模式：仅监控、仅分布式节点、全功能（两者兼有） |
| 自动连接 | 开启后应用启动时自动尝试连接 VCP |
| 连接/断开 | 手动控制连接的建立与关闭 |
TODO: 截图 - 连接面板完整视图，标注所有配置项
连接模式详解
| 模式 | 说明 | 适用场景 |
|---|---|---|
observer | 仅监听广播消息，不参与分布式调用 | 只想看 VCP 的运行日志和调试信息 |
distributed | 仅注册为分布式节点，不接收广播消息 | 只想让 VCP Agent 调用你的本地工具 |
both（默认） | 同时建立两条连接，兼具监控与分布式能力 | 既想看日志，又想共享工具 |
连接模式可以在配置面板的"监控设置"中进行选择。
TODO: 截图 - 连接模式选择下拉框
消息过滤
在连接配置下方，是消息过滤面板。VCP 广播的消息分为六种类型，每种都有独立的颜色标识：
| 类型 | 标签 | 颜色 | 说明 |
|---|---|---|---|
| RAG 检索详情 | RAG | 蓝色 | 向量检索的查询、评分、标签匹配详情 |
| 元思考链 | Chain | 紫色 | 多阶段推理过程的完整链路 |
| Agent 私聊 | Agent | 黄色 | Agent 间私聊的查询与响应预览 |
| 记忆回溯 | Memo | 绿色 | AI 记忆/日记的检索结果 |
| 插件状态 | Plugin | 灰色 | 插件执行步骤的状态变更 |
| 运行日志 | Log | 灰色 | VCP 运行时日志（工具执行、任务通知、错误报告） |
你可以通过顶部的类型按钮选择性查看特定类型的消息，也可以通过关键词搜索框快速定位关心的内容。暂停 按钮可以临时冻结消息接收，方便你仔细阅读当前内容。
TODO: 截图 - 消息过滤面板，标注类型切换按钮和搜索框
消息监控
消息监控标签页是 VCP 运行状态的"可视化仪表盘"，以卡片流的形式实时展示 VCP 广播的所有运行时事件。
消息流
消息按倒序排列（最新消息在顶部），支持虚拟滚动，即使有数千条消息也能保持流畅。每条消息都以卡片形式呈现，包含：
- 类型图标与颜色：根据消息类型自动匹配对应的图标和颜色标识
- 时间戳：消息的精确时间
- 内容详情：不同类型展示不同的核心信息
TODO: 截图 - 消息监控页面的消息卡片流
消息卡片详解
每种消息类型的卡片展示不同的核心信息：
RAG 检索详情卡：
- 显示数据库名、查询文本、K 值、耗时
- 展示检索结果的评分列表，评分高低通过颜色深浅标识
- 核心标签匹配情况高亮显示
- 支持展开/折叠查看完整详情
TODO: 截图 - RAG 检索详情卡片
元思考链卡：
- 显示链名和查询文本
- 阶段路径以胶囊节点 + 箭头形式可视化展示
- 点击可展开查看每个阶段的详细推理结果
TODO: 截图 - 元思考链卡片，展示阶段路径可视化
Agent 私聊预览卡：
- 显示 Agent 名称
- 使用气泡对的形式展示 Query 和 Response
记忆回溯卡：
- 显示记忆模式（如联想、语义等）
- 展示记录条数和提取内容预览
插件状态卡：
- 显示插件名称和当前步骤
- 状态标签（等待/运行中/已完成/失败）一目了然
运行日志卡：
- 显示工具名、来源标签
- 状态标签（成功/错误）清晰区分
- 错误日志使用红色高亮
工具栏
监控页面顶部提供以下工具：
| 工具 | 说明 |
|---|---|
| 连接状态标签 | 实时显示当前连接状态 |
| 消息计数 | 显示当前消息总量 |
| 消息速率 | 显示每分钟消息接收速率 |
| 搜索框 | 按关键词在消息内容中搜索 |
| 暂停/继续 | 临时停止/恢复消息接收 |
| 清空 | 清空当前消息列表 |
| 导出 | 将过滤后的消息导出为 JSON 文件 |
TODO: 截图 - 监控页面工具栏，标注各项按钮
分离窗口
点击消息监控面板的分离按钮，可以将监控页面拖拽为一个独立的窗口。这样你就可以在其他工具中工作时，把 VCP 的消息监控放在另一个显示器上持续观察。
当监控窗口被分离后，主窗口会显示一个占位提示，点击 收回面板 即可将监控窗口重新合入主窗口。
TODO: 截图 - 分离后的监控窗口
分布式节点
分布式节点标签页让你能将 AIO Hub 注册为 VCP 网络中的一个"能力节点"，VCP 中的 AI Agent 可以通过网络远程调用你暴露的工具方法。
节点状态面板
展示节点的运行状态和配置信息：
| 配置项 | 说明 |
|---|---|
| 节点名称 | 自定义节点在 VCP 网络中的显示名称 |
| 服务器地址 | 已连接的 VCP 服务器地址（只读，共享自连接配置） |
| 节点 ID | VCP 服务器分配的节点唯一标识 |
| 最近心跳 | 最后一次心跳上报的时间 |
| 自动注册工具 | 开启后自动扫描并注册可暴露的工具 |
TODO: 截图 - 节点状态面板，标注节点 ID 和心跳信息
暴露工具管理
在分布式节点模式下，你可以精细控制哪些工具暴露给 VCP 网络：
- 自动发现开关：开启后自动扫描所有标记为
agentCallable或distributedExposed的工具方法 - 手动添加：从所有已注册的工具中搜索并添加特定工具到暴露列表
- 工具分类标识：
- 🏷️ 内置：VCP 协议强制要求的工具（如文件读取），不可禁用或移除
- 🔄 自动：通过自动发现扫描到的 AI 工具，可启用/禁用
- ✋ 手动：你手动添加到暴露列表的工具，可启用/禁用/移除
- 同步状态：每个工具右侧显示其是否已成功同步到 VCP 服务器
TODO: 截图 - 暴露工具列表，标注内置/自动/手动的分类标识
安全提示：只有明确标记为 distributedExposed: true 的工具方法才能被远程调用。这意味着你可以精细控制哪些能力对外开放，避免敏感操作被未授权调用。
工具桥接
工具桥接是 VCP 连接器的"双向能力共享"功能。开启后，VCP 服务器上的原生插件会被动态发现并映射为 AIO Hub 的内部工具——这样一来，AIO Hub 的本地 Agent 也能使用 VCP 的插件能力。
开启桥接
- 在 分布式节点 Tab 中找到"桥接工具"区域
- 打开全局开关启用桥接功能
- 系统会自动从 VCP 服务器拉取可用插件清单
TODO: 截图 - 桥接工具列表，标注全局开关
权限控制
桥接工具支持在命令级别进行精细的权限管理：
- 启用/禁用：你可以单独启用或禁用某个远程插件，防止 Agent 调用不安全的远程命令
- 配置同步：VCP 插件的配置项会同步到 AIO Hub，支持在 AIO UI 中直接修改远程插件的参数
TODO: 截图 - 桥接工具权限控制，标注启用/禁用开关
表情包集成
如果 VCP 服务器配置了图片服务（Image_Key），VCP 连接器会自动加载 VCP 的表情包库，让 AIO Hub 的聊天功能可以使用 VCP 服务器上的表情资源。
高级用法
自动启动与后台连接
在左侧配置面板中开启 自动连接 开关后，每次启动 AIO Hub 时都会自动尝试连接 VCP 服务器。配合 自动注册工具 开关，VCP 连接器会在后台静默完成连接和工具注册——即使你没有打开 VCP 连接器的界面。
这对于设置了"跟随应用自启"的 VCP 服务器特别有用——两者启动后自动建立连接，无需任何手动操作。
同时使用三条连接
VCP 连接器实际上会管理多条 WebSocket 连接，每条都有独立的连接守卫和心跳机制：
- Observer 连接：接收 VCP 广播的运行时消息（监控功能）
- Distributed 连接：处理工具注册、远程调用和心跳上报（分布式节点功能）
- 桥接通道：通过 Distributed 连接进行插件清单拉取和远程代理调用
三条连接相互独立，一条连接出现问题时不会影响其他连接的正常运作。
结合分离窗口构建监控屏
如果你有多显示器环境，可以这样操作：
- 打开 VCP 连接器，建立连接
- 点击消息监控面板的 分离 按钮，将监控窗口拖拽到副显示器
- 在主显示器上继续使用其他 AIO Hub 工具
- 副显示器上实时展示 VCP 的运行状态
这是一种非常高效的"一边干活、一边监控"的工作模式。
使用通知系统跟进 VCP 任务
VCP 运行日志中的特定事件会通过 AIO Hub 的通知系统推送到你：
- 错误事件：VCP 工具执行报错时，自动推送错误通知，可点击查看详情
- 任务启动：VCP 任务创建时，推送任务启动通知
- 完成提示：任务归档、完成或成功时，以浮动提示形式展示
你可以在 AIO Hub 的 通知中心 中查看所有 VCP 相关的历史通知。
TODO: 截图 - VCP 任务通知在通知中心中的展示
常见问题
Q：连接不上 VCP 服务器怎么办？
最常见的原因是 VCP 服务器没有运行。请先确认 VCP 服务器已启动并正常运行。
如果服务器确认在运行但仍无法连接，可以尝试：
- 检查 WebSocket 地址格式是否正确（标准格式：
ws://IP:端口） - 确认 VCP Key 是否正确（可以在 VCP 安装目录下的
config.env文件中找到） - 检查防火墙是否阻止了连接
- 如果是远程服务器，确保服务器允许 WebSocket 连接
Q：消息监控面板没有显示任何消息？
可能的原因：
- 未建立连接：检查连接状态是否为"已连接"，如果不是请点击连接按钮
- 连接模式不对：如果选择了
distributed模式，Observer 连接不会建立，自然收不到广播消息。请切换为both或observer模式 - 暂停状态：检查消息过滤面板的"暂停"按钮是否被激活，再次点击即可恢复
- 类型过滤：检查类型过滤按钮是否全部被选中（可以点击"全部"按钮重置）
- VCP 服务器没有触发事件：VCP 只在有实际运行时事件时才会广播消息，这是正常现象
Q：暴露给 VCP 的工具太多，怎么控制？
你可以在 分布式节点 > 暴露工具列表 中进行精细控制：
- 关闭 自动注册工具 开关，这样只有你手动添加的工具才会被暴露
- 在工具列表中，点击工具右侧的开关来临时禁用某个工具
- 对于手动添加的工具，可以直接从列表中移除
这样你就可以只暴露那些你确实想让 VCP Agent 调用的工具了。
Q：工具桥接和分布式节点有什么区别？
这是两个互补但不同的功能：
- 分布式节点：AIO Hub 作为节点加入 VCP 网络，AIO 的工具可以被 VCP 中的 Agent 调用（单向：AIO → VCP）
- 工具桥接：VCP 服务器上的插件被映射到 AIO Hub 内部，AIO 的本地 Agent 也可以调用 VCP 的插件（反向：VCP → AIO）
简单来说，分布式节点是"给出去"，工具桥接是"拿回来"——两者结合实现双向工具共享。
Q：断开连接后重新连接需要手动操作吗？
不需要。如果你开启了 自动连接 开关：
- 网络断开后，系统会自动尝试重连
- 重连策略采用指数退避（1 秒 → 2 秒 → 4 秒 → ... → 最多 30 秒），外加随机抖动，避免多个连接同时重连造成服务器压力
- 连接恢复后会自动继续接收消息和注册工具
如果你没有开启自动连接，则需要手动点击 连接 按钮。
TIP
如果你需要快速重置连接，可以直接点击 断开 后再点 连接。