# VCPToolBox **Repository Path**: hpz120/VCPToolBox ## Basic Information - **Project Name**: VCPToolBox - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-22 - **Last Updated**: 2025-11-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # VCP (Variable & Command Protocol) - 新一代 AI 能力增强与进化中间层 ![LOGO图片1](VCPLogo.png) --- [English](README_en.md) | [日本語](README_ja.md) | [Русский](README_ru.md) ## 警告！本项目Agent拥有硬件底层级分布式系统根权限！非专业用户请勿随意部署！ ## --- ## 1. 项目愿景：超越交互，赋能进化 VCP (Variable & Command Protocol) 旨在构建一个超越传统 AI 交互模式的革命性中间层。它不仅是一个高度兼容、通用、可扩展的工具箱，更是一个致力于赋能 AI 模型实现能力跃迁、记忆进化与群体智能涌现的生态系统。 我们的目标是创建一个**“不受模型种类、模态、功能限制”且“不受前端交互束缚”**的通用 VCP 系统，通过在 API 层面深度整合 AI 推理、外部工具执行与持久化记忆系统，形成高效协同的“AI-工具-记忆”铁三角。VCP 允许 AI 之间、AI 与工具之间、甚至 AI 与自身记忆之间进行前所未有的高效通讯与协同进化，一切基于私有和共享知识库实现，从而无限扩展 AI 的应用边界与智能潜力。 VCP 的核心是引领 AI Agent 进入一个能够自主学习、持续进化、并能与其他 Agent 高效协作的新纪元。 [深入理解 VCP 理论架构与核心洞见](VCP.md) **郑重警告**：请勿使用任何非官方或反向代理的 API (例如各类“镜像站”、“中转API服务商”) 来调用此工具箱，VCP拥有几乎底层的系统监控权限，此类行为极易导致您的敏感信息（包括但不限于 AI 交互数据、记忆库内容、API密钥、浏览器历史、账号密码）泄露给不可信的第三方，造成不可挽回的损失。请务必确保您的 AI 模型 API 调用链路纯净、直接、可信。 ## 2. VCP 的“次时代”核心特性与设计哲学 VCP 的每一项特性都根植于其前瞻性的设计哲学，旨在解决当前 AI 应用的深层痛点，并引领下一代 AI Agent 的发展方向。 ### 极其强大的插件化架构 - **设计哲学**: 实现极致的灵活性与可扩展性，让 AI 的能力可以无限延伸。通过定义良好的插件清单 (`plugin-manifest.json`) 和核心插件管理器 (`Plugin.js`)，VCP 能够轻松集成和管理任何外部功能模块，无论是现有 API、专业软件、硬件接口还是自定义逻辑。 - **深度解读**: 这不仅仅是功能扩展，更是构建了一个 AI 可自主“学习”和“掌握”新技能的生态基础。 ### 动态逻辑强化框架：从响应到预判的进化 - **智能意图分析**: VCP引入了一套动态逻辑强化框架，该框架基于Vcptarven插件生态，显著提升了AI在逻辑链反思、信息耦合、意图预判及动态工作流构建方面的能力。AI不再被动响应，而是能够主动分析用户潜在意图，并灵活构建VCP插件调用链以获取决策所需的完备信息。 - **示例：** 当用户仅提供一张网页视频截图时，新框架下的AI会主动执行一系列动作：首先检索图像信息以定位视频来源，随后调用VCP在线视频字幕捕捉器进行“视频阅读”，最终获取完整的上下文信息，从而能够与用户展开更有深度的讨论。 - **核心优势：** 在这套全新的逻辑链架构下，AI在知识库的智能归档、工具调用的灵活度以及幻觉抑制等方面均获得了质的飞跃。 ### VCP 指令协议 - **设计哲学**: 提供一种对 AI 模型友好、对前端零侵入、且能承载复杂指令的通用工具调用语言。AI 通过在回复中嵌入特定格式的指令 (`<<<[TOOL_REQUEST]>>> ... <<<[END_TOOL_REQUEST]>>>`) 来调用插件，参数使用 `key:「始」value「末」` 格式，支持复杂数据类型和多行文本。 - **深度解读**: 这种基于文本标记的协议，极大地降低了对特定模型 API 特性（如某些模型专属的 Function Calling 字段）的依赖，实现了真正的模型普适性。独特的 `「始」value「末」` 参数格式，则保证了在复杂参数传递（如代码块、JSON对象、长文本）时的解析鲁棒性。此外，协议实现了强大的鲁棒性修复。参数键（key）的解析不仅大小写不敏感，还会自动忽略下划线、连字符等常见分隔符。这意味着 AI 在生成指令时，无论是 `image_size`、`imagesize`、`ImageSize` 还是 `IMAGE-SIZE`，都会被正确识别为同一个参数，极大地增强了协议的容错性和对 AI 生成内容多样性的适应能力。 - **六大插件协议**：支持动态，服务器，同步，异步，注入式，混合式六大类型插件合计300多个官方插件，几乎涉及所有生产应用场景，从平台控制到多媒体生成到复杂编辑到程序反编译到物联网，落地即生态。 - **动态工具注入**：开发者无需关心如何管理vcp插件，如何实现让ai使用工具。服务器会自动分析上下文和预判ai意图，主动为ai动态提供插件调用方式，保证哪怕后端有上万种工具也不会阻塞上下文。所有插件都采用无进程无服务处理。 ### 新增：基于MCPO的MCP兼容端口 - **设计哲学**：为了最大化VCP的生态兼容性，我们引入了基于MCPO（Model Context Protocol Opera）的兼容端口。这意味着，现在VCP服务器不仅能够挂载原生的VCP插件，也能够无缝兼容和挂载为MCP（Model Context Protocol）设计的插件。 - **核心能力**：通过一个专门的MCPO插件进行协议转译，将MCP的调用格式实时转换为VCP指令，并处理其响应。这使得大量现有的MCP插件无需任何修改，即可在VCP环境中使用，极大地丰富了VCP的可用工具生态。 - **次时代意义**：这不仅仅是向后兼容，更是VCP作为“元协议”强大包容性的体现。它为不同协议的AI能力层提供了一个统一的整合与协作平台，是构建更宏大、更多样化的AI Agent生态系统的关键一步。 ### 统一的 WebSocket 通信服务 - **设计哲学**: 提供一个集中的 WebSocket 服务 (`WebSocketServer.js`)，用于服务器与客户端之间的双向实时通信。这包括但不限于推送日志、AI 生成的消息、状态更新等。 - **核心能力**: - **集中管理**: 所有 WebSocket 连接、认证、消息广播由 `WebSocketServer.js` 统一处理。 - **插件集成**: 服务类插件（如 `VCPLog`）和同步插件（通过 `webSocketPush` 配置）可以利用此中央服务向客户端推送信息，而无需各自实现 WebSocket 服务器。 - **客户端类型**: 支持基于 `clientType` 的消息定向广播，允许不同前端或客户端组件订阅特定类型的消息。 - **深度解读**: 简化了需要实时推送功能的插件开发，提高了系统的模块化和可维护性。它也是 VCP 分布式网络的核心通信骨架。 ### 模型白名单穿透机制 - **设计哲学**: 承认并兼容并非所有 AI 模型都遵循标准聊天API格式。对于某些特殊模型（如文生图、向量化模型），其API请求/响应结构完全不同，需要绕过VCP的标准化处理流程。 - **核心能力**: - **配置驱动**: 在 `config.env` 中通过 `WhitelistImageModel` 和 `WhitelistEmbeddingModel` 变量分别配置图像模型和向量化模型的白名单（用逗号分隔）。 - **请求绕行**: 当服务器收到一个针对白名单内模型的请求时，它会通过一个特殊的路由模块 (`specialModelRouter.js`) 进行处理，**完全跳过**所有的常规处理步骤（包括消息预处理、变量替换、工具调用循环等）。 - **直接转发**: - **向量化模型**: 请求体和响应体将在客户端与上游API之间被原封不动地直接转发，实现真正的“穿透”。 - **图像模型**: 服务器会在转发前对请求体进行必要的修改（如添加特定的 `generationConfig`），并根据需要处理响应。 - **深度解读**: 该机制保证了VCP对未来或非标准AI模型的最大兼容性，使其可以作为一个纯粹、高效的代理，而不是处理流程中的障碍。 ### 丰富的插件类型，支撑 AI 全方位能力拓展 VCP 支持多种插件类型，以满足不同的 AI 能力扩展需求。核心的交互型插件主要分为同步阻塞型和异步回调型。 - **静态插件 (static)**: - **作用**: 为 AI 提供动态的、实时的“世界知识”，如天气、自定义数据、角色日记等，通过替换系统提示词中的占位符注入。支持定时刷新。 - **次时代意义**: 克服 LLM 知识截止日期限制，赋予 AI 实时感知能力，是构建“情境感知型 AI”的关键。 - **消息预处理器插件 (messagePreprocessor)**: - **作用**: 在用户请求发送给 AI 模型前，对消息内容进行修改或增强，如图像识别与描述 (`ImageProcessor`)。 - **次时代意义**: 实现多模态输入的统一处理，让 AI 能够“理解”更丰富的输入信息，是构建多模态智能体的基础。 - **同步插件 (synchronous)**: - **模式**: 这是传统的阻塞式调用。AI 发起调用后，VCP 服务器会启动插件进程，并**等待该插件进程完全执行完毕**后，收集其标准输出作为结果，然后将此结果反馈给 AI 进行后续处理。 - **适用场景**: 适用于执行时间较短、能够快速返回结果的任务，如科学计算 (`SciCalculator`)、简单的信息查询等。 - **WebSocket 推送**: 部分同步插件的最终结果也可以通过在其 `plugin-manifest.json` 中配置 `webSocketPush`，经由统一的 WebSocket 服务推送给客户端。 - **次时代意义**: 这是 AI “行动能力”的基础体现，使其能够干预外部世界、获取外部信息。 - **异步插件 (asynchronous)**: - **核心模式**: 专为耗时任务设计，实现非阻塞调用和AI对结果的“即时”感知。 1. **AI调用与初始响应**: AI调用异步插件。插件脚本立即向标准输出打印一个JSON响应，此响应通常包含一个唯一的任务ID，以及一段**引导AI使用的自然语言消息**。这条消息会指示AI在其回复中包含一个特定格式的动态占位符，如 `{{VCP_ASYNC_RESULT::PluginName::ActualTaskID}}`。`Plugin.js`捕获此初始响应并迅速返回给AI。 2. **AI回复与占位符植入**: AI根据插件的初始响应（包含引导文本和占位符格式）生成回复给用户的消息，并将该占位符原文包含在其回复中。 3. **插件后台执行**: 与此同时，插件的非守护线程或后台进程继续执行耗时的主要任务（例如视频生成）。 4. **任务完成回调与结果持久化**: 插件后台任务完成后，它会向VCP服务器的 `/plugin-callback/:pluginName/:taskId` 端点发送一个HTTP POST请求。请求体是包含任务最终结果的JSON数据。服务器在收到此回调后，会将这个JSON数据保存到服务器本地的一个特定文件（例如 `VCPAsyncResults/PluginName-ActualTaskID.json`）。 5. **动态上下文替换与AI感知**: 当AI的后续对话（无论是用户输入中引用了AI之前的回复，还是AI在生成新回复时参考了历史对话）中再次出现 `{{VCP_ASYNC_RESULT::PluginName::ActualTaskID}}` 这个占位符时，VCP服务器的 `replaceCommonVariables` 函数会在将此上下文发送给AI模型之前，动态地查找对应的结果文件： - 如果结果文件存在，占位符会被替换为文件中的实际结果信息（例如，一段描述任务成功并包含URL的文本）。 - 如果结果文件不存在（任务仍在处理中），占位符会被替换为一个提示信息（如“[任务结果待更新...]”）。 这样，AI在其后续的“思考”和回复中，就能“看到”异步任务的最新状态或最终结果，仿佛信息是即时更新在对话流中的。 6. **WebSocket 推送 (可选并行机制)**: 服务器在收到插件回调并持久化结果后，仍然可以（并且推荐）根据插件清单中的 `webSocketPush` 配置，通过 `WebSocketServer.js` 将回调数据（或其一部分）推送给客户端，作为一种更直接、更即时的前端通知方式。这种基于文件的上下文替换机制是对WebSocket推送的补充和增强，尤其是在AI需要直接感知和利用异步结果进行后续对话时。 - **适用场景**: 非常适合执行时间较长的任务，如视频生成 (`Wan2.1VideoGen`)、复杂数据分析、需要轮询外部API状态等。 - **优势**: - AI无需长时间等待，交互流畅。 - AI能够在其对话流中“自然地”感知和利用异步任务的最终结果。 - 降低了对前端必须依赖WebSocket来获取和回传异步结果的硬性要求。 - 提升了系统的鲁棒性，即使WebSocket通知失败或客户端未连接，AI仍有机会通过上下文感知结果。 - **次时代意义**: 赋予AI执行复杂、耗时任务而自身不被阻塞的能力，结合上下文感知的异步结果和可选的即时通知，极大地提升了用户体验和AI Agent的自主性与智能表现。 - **服务插件 (service)**: - **作用**: 允许插件向主应用注册独立的 HTTP 路由，提供额外的服务接口，如图床服务 (`ImageServer`)。部分服务插件（如 `VCPLog`）也可能利用统一 WebSocket 服务进行信息推送。 - **次时代意义**: 将 VCP 平台本身转变为一个可扩展的服务中心，支持更复杂的应用场景。 - **混合服务插件 (hybridservice)**: - **作用**: 这是 `service` 和 `messagePreprocessor` 插件的结合体。它既可以像消息预处理器一样在 AI 请求前修改消息流，又可以像服务插件一样注册自己的 API 路由来提供后台服务。 - **适用场景**: 非常适合那些既需要后台管理界面（通过 API 路由实现），又需要直接干预聊天上下文的复杂插件，例如 `VCPTavern` 上下文注入器。 - **次时代意义**: 为构建功能更完整、更自洽的复杂插件提供了可能，使得插件本身就能形成一个包含“前端逻辑（预处理）”和“后端管理（服务）”的迷你应用。 - **分布式节点 (Distributed Node)**: - **作用**: 允许将 VCP 的算力扩展到多台机器。一个独立的 `VCPDistributedServer` 节点可以运行在任何地方，加载其本地的插件，并通过 WebSocket 连接到主服务器。 - **次时代意义**: 这是 VCP 实现“无限算力”和“群体智能”的物理基础。通过分布式网络，可以将需要大量计算资源（如 GPU 密集型任务）或需要访问特定网络/硬件（如内网文件服务器、特殊硬件）的插件部署在最合适的机器上，而主服务器则作为统一的调度中心，对 AI 透明地调用这些远程资源。 ### 全局多模态智能路由与数据链 - **设计哲学**: 打破模态壁垒，实现任意数据类型在 VCP 网络中的无缝流转、智能转译与高效处理，构建一个真正意义上的全媒体智能生态。 - **核心能力**: - **Base64 直通车**: 允许 AI 在 `tool` 字段中直接引入 Base64 数据，极大地简化了多媒体内容的即时调用。 - **全局文件 API (`VCPFileAPI` v4.0 超栈追踪版)**: 实现了革命性的全URL超栈追踪。现在，AI在任何分布式节点上提交本地文件路径（如 `H:\MCP\123.txt`），主服务器都能智能解析其来源并自动向源节点请求文件的Base64数据，实现无缝的跨服务器文件调用。 - **分布式多模态传输 (v4.0 核心升级)**: 借助**全 URL 超栈追踪**，任意节点上的 AI 都能直接使用本地文件路径进行跨服调用。主服务器会自动追踪并拉取数据，彻底打通了分布式网络中的文件孤岛，让多模态数据在星型网络中无缝流转。 - **跨模态智能转译**: 实现高阶模型对低阶模型的“能力赋能”。例如，能识别音频的模型可以帮助纯文本模型，将其无法处理的音频 Base64 数据智能转译为文字描述，反哺给请求方。 - **智能响应路由**: VCP 核心能够智能判断插件返回的是传统的 stdio 文本信息，还是包含 Base64 的结构化数据，并自动选择正确的渠道进行转发和处理。 - **多 Agent 协作共享**: 在多 Agent 协同任务中，实现 Base64 数据的智能共享，并能根据需要将其动态转译为临时的 `fileurl`，方便其他 Agent 或前端应用访问。 - **深度解读**: 这套垂直打通的架构，意味着 VCP 不再仅仅处理文本指令，而是进化成了一个能够理解、处理和传递图像、音频、视频等多种媒体格式的“全模态操作系统”。它为开发能够看、听、说的复杂 AI Agent 提供了坚实的基础设施。一个梦幻般的应用场景是：AI Agent 可以通过一个部署在远程服务器上的 `FileManager` 插件，直接读取 WebDAV 上的多媒体文件（如会议录音、视频片段），获取其 Base64 数据流，并对其进行即时分析和总结，整个过程对 AI 来说如同读取本地文件一样自然。 ### 任务调度与全线追踪 - **AI 规划未来**: 通过 `/v1/schedule_task` 创建标准化 JSON 任务，实现“延迟执行”和“循环工作流”。使得Agent发起的任何工具调用自带定时器，能被未来触发。比如创建米家洗衣机洗衣服的任务后，再提醒用户4小时后晒衣服。 - **全线任务追踪** ：通过强健的WS管网可以追溯任何VCP调用。用户和Agent清晰可查每一个调用线程由哪个服务器上的哪个Agent发起，数据流向何处，被哪些分布架构展开，一切结果可溯源。 - **深度解读**: 这项功能极大地增强了 AI Agent 的自主性。Agent 不再仅仅是被动响应，而是可以主动规划未来行动，例如：“提醒我明天下午三点开会”、“每周五自动抓取并总结一次项目报告”、“半小时后再次尝试调用那个失败的API”。这是实现高级、长期、复杂自动化工作流的关键基石。 ### 动态配置引擎 - **设计哲学**: 实现 AI 行为的深度定制与动态上下文注入，赋予部署者在服务器后端超越前端限制的、对 AI 指令的精细调控能力。 - **核心能力**: - **语义感知型动态系统提示词**：VCP实现了多组信息的动态系统提示词，包含主系统和插件，例如时间，天气，任务进度，音乐列表，网络参数，VCP工具调用指令集等等的自动注入。系统会根据上下文环境，判断AI需要知晓哪些信息，在“AI有必要知道”的时候，让“AI肯定能知道”必要的相关内容，从而实现动态宽泛的上下文控制。 - **多级变量替换**：`{{Agent*}}`（模块起手式，可包含一级以下所有占位符）、`{{Tar*}}`（模板化组合占位符，可包含二级以下所有占位符）、`{{Var*}}`（全局替换占位符）、`{{Sar*}}`（模型条件注入）实现提示词动态拼装。 - **中文语义目的量化系统**：本服务器已经基于原创的基于球极投影的拓扑分形算法，使得中文命题和内容目标之间的相关性距离得到可靠量化。以此实现对上下文的AI混淆性幻觉的自动修复，避免幻觉累积。 - **外部文件加载**：`.txt` 文件直接嵌套为变量值，支持富文本。 - **Agent 正则引擎**: 提供覆盖 Agent 行为全流程的精细化正则控制能力，并配备完整的图形化管理界面。 - **聊天历史正则**: 对话历史进行结构化匹配与内容提取。 - **渲染正则**: 在内容展示前，对输出文本进行动态修改或格式化。 - **深度正则**: 在模型生成回复的核心阶段进行干预，实现更底层的行为修正。 - **Content 数组正则**: 针对多轮对话的 `content` 数组进行复杂匹配与转换。 - **VCPSuper上下文结构净化器**：VCP拥有强大无比和深度微调的上下文结构净化器，会在上下文Post发送前对所有空格，换行，引号，括号，重复字符，溢出词元，格式边界进行对齐和控制，极大抑制AI在潜空间中出现的不可控噪声和累积性幻觉，通过语义距离量化算法，对AI输出内容进行自醒自查，实现多维度的上下文质量矫正。 - **深度解读**: 这是 VCP 实现“AI 行为工程”和“指令库即代码配置”的关键。通过变量替换，可以动态构建和优化注入给 AI 的系统提示词、用户消息，甚至插件调用参数，从而克服 LLM 的知识滞后、时空错觉，并能通过全局文本替换规则（如 `DetectorX`）“微调”AI 的输出习惯，抑制不良输出惯性。 ### AI 主导的持久化记忆与进化系统 VCP 的记忆系统根植于一个核心哲学：记忆不仅是信息存储，更是 AI 自我进化、能力内化、个性形成的核心驱动力。我们通过一套革命性的日记与记忆工具，将这一理念变为现实，构建了业界领先的记忆系统，突破了传统长记忆在时间维度、事件顺序和逻辑关联上的三大模糊高峰。 VCP的记忆系统迎来了一次里程碑式的升级。我们成功实现了对三大核心数据库（记忆碎片 `MemoChunk`、标签 `Tag`、知识块 `KnowledgeChunk`）的**抽象统一管理**。更重要的是，整个底层数据抽象层**完全使用 Rust 进行了重写**，带来了革命性的性能飞跃和稳定性提升。 - **性能巨幅提升**: 通过底层的 Rust 实现，数据操作效率提升了数个数量级。 - **告别竞态与通讯开销**: 统一的管理核心彻底消除了跨库通讯的瓶颈和文件竞态的风险，一劳永逸地解决了此前架构中的诸多难题。 - **未来的基石**: 这一坚实的底层架构，为未来 `RagTagMemo` 系统的进一步深入优化和功能拓展打下了不可撼动的基石，确保了 VCP 记忆系统长期、高效、稳定地进化。 #### 记忆的创建与管理 - **自主记忆创建与编辑**: - Agent 通过 [`DailyNoteWrite`](Plugin/DailyNoteWrite) 插件可以主动创建、更新和编辑日记，实现流畅的上下文记忆更新 - 所有日记以 `.txt` 或 `.md` 格式保存，并与后端的 SQLite 数据库实现基于哈希值、时间戳的原子级实时同步 - **智能 Tag 检查器与自动补标机制**： - 内置 **Tag 格式校验器**，实时检查 Tag 字段的格式规范 - 如果 AI 遗漏 Tag 或格式错误，系统会自动调用服务器内置的**记忆大师 Agent** - 记忆大师会分析日记内容、上下文、作者风格和已有 Tag 池，自动生成最合适的标签集 - 整个补标过程对用户和主 Agent 完全透明，确保 Tag 体系始终保持高质量 - **批量记忆整理 (`DailyNoteManager`)**: - 强大的日记批处理插件，建议由高级模型（Claude 4.5 Opus, Gemini 3 Pro, GPT 5 Ultra）驱动的"记忆大师" Agent 使用 - 对指定时间段的日记进行事件合并、结构优化、语法去冗等复杂功能 - 避免低级模型语料污染高级模型的记忆库 - **深度历史回溯 (`DeepMemo`)**: - 经过重大升级的 Rust 历史对话检索引擎，引入了**双重多层级混合检索架构** - **第一阶段：`Tantivy` 关键词检索与召回** - 利用高性能 Rust 全文搜索引擎库进行超线程关键词匹配 - 内置 `jieba-rs` 分词器配合 VCP 原创权重算法，极大提升中文检索准确性 - 为每个对话文件动态创建高效的内存索引，实现闪电般的搜索速度 - **第二阶段：`Reranker` 语义精排** - 将第一阶段筛选出的候选结果交给 Reranker 模型进行语义相关性排序 - 通过**瑞士轮评级**对大量回忆进行分组积分评级，确保 AI 能回忆起最相关内容 - **高级检索语法**：支持精确短语、正向加权、负向排除、OR 逻辑、时间维度等复杂查询 - **无关信息降噪算法**：引入多种内容净化器，让 AI 回忆起近乎纯净的聊天历史 - **主动记忆库检索三剑客**： - **`LightMemo`**：基于 BM25 + RAG + Rerank 的快速知识库关键词检索 - **`MeshMemo`**：基于多维条件过滤的网状聚合搜索，支持知识库来源、作者、Tag 链、时间戳范围等复杂筛选 - **`SGManager`**：词元组捕网关系结构管理器，构建深层逻辑关联 #### 统一数据库管理核心 VCP的记忆系统迎来了一次里程碑式的升级。我们成功实现了对三大核心数据库（记忆碎片 `MemoChunk`、标签 `Tag`、知识块 `KnowledgeChunk`）的**抽象统一管理**。更重要的是，整个底层数据抽象层**完全使用 Rust 进行了重写**，带来了革命性的性能飞跃和稳定性提升。 - **性能巨幅提升**: 通过底层的 Rust 实现，数据操作效率提升了数个数量级。 - **告别竞态与通讯开销**: 统一的管理核心彻底消除了跨库通讯的瓶颈和文件竞态的风险，一劳永逸地解决了此前架构中的诸多难题。 - **未来的基石**: 这一坚实的底层架构，为未来 `RagTagMemo` 系统的进一步深入优化和功能拓展打下了不可撼动的基石，确保了 VCP 记忆系统长期、高效、稳定地进化。 ##### 核心架构升级 **SQLite 作为主存储引擎**： - **零配置部署**：无需独立数据库服务器，数据库文件直接存储在本地，开箱即用 - **ACID 事务保证**：所有日记操作都在严格的事务保护下进行，确保数据完整性 - **高效并发控制**：通过 WAL (Write-Ahead Logging) 模式实现读写并发，多 Agent 可同时访问记忆库 **USearch 高性能向量索引**： - **纯 Rust 实现**：采用业界最快的向量搜索引擎之一，性能远超传统 HNSW 实现 - **内存效率极致优化**：支持磁盘映射 (mmap) 模式，可处理远超内存容量的向量数据集 - **多种距离度量**：支持余弦相似度、欧氏距离、内积等多种向量距离计算方式 - **增量索引更新**：支持在线添加/删除向量，无需重建整个索引 ##### 智能同步与更新机制 - **文件系统实时监控**：通过 `chokidar` 7×24 小时监控日记文件夹的任何变动（增、删、改） - **哈希驱动的精确同步**： - 为每个日记文件和文本块计算 SHA-256 哈希值 - 与 SQLite 中存储的哈希记录进行比对 - 仅对变更的内容进行向量化和索引更新，实现**真正的句级原子操作** - **动态更新策略**： - **微量变动**：执行增量更新，精确添加/删除/修改对应的向量 - **大规模变动**：当检测到超过阈值的内容变更时，自动触发该日记本的全量重建 ##### 全 Rust 加速的核心组件 为了极致的性能，VCP 5.1 将所有性能关键路径用 **Rust** 重写： **`rust-vexus-lite`**：核心向量搜索引擎 - 基于 USearch 的高性能 ANN (Approximate Nearest Neighbor) 搜索 - 支持批量向量化和批量检索，减少 FFI 开销 - 内置 SIMD 优化，充分利用现代 CPU 的并行计算能力 **异步多线程架构**： - **向量化 Worker**：在独立线程中批量处理文本向量化 - **索引构建 Worker**：异步构建和更新 USearch 索引 - **搜索 Worker**：每个检索请求在独立线程中执行，互不阻塞 ##### 性能与资源优化 - **懒加载与智能缓存**： - 向量索引仅在首次查询时加载到内存 - LRU 缓存策略自动淘汰不常用的索引 - 预热机制：启动时自动加载高频使用的日记本索引 - **查询结果缓存**： - 内置带 TTL 的 LRU 缓存，相似查询直接返回缓存结果 - 大幅降低重复查询的计算开销 - **精细化内存管理**： - 实时监控内存占用 - 当超过配置的 `maxMemoryUsage` 时，自动卸载低频索引 - 支持配置单个索引的最大内存限制 ##### 企业级可靠性保障 - **多重数据保护**： - SQLite WAL 模式提供崩溃恢复能力 - 自动数据库备份与版本控制 - 索引文件损坏自动检测与重建 - **高度可配置**： - 所有核心参数（更新阈值、缓存大小、内存限制等）均可通过环境变量配置 - 支持为不同日记本设置独立的索引参数 - **完善的错误处理**： - API 调用失败时的指数退避重试 - 详细的日志记录，方便问题追踪 - 优雅降级：向量化失败不影响文本存储 ##### 技术优势总结 相比之前的架构，新的 SQLite + USearch 方案在个人 AI 环境中具有压倒性优势： | 特性 | PostgreSQL + pgvector | SQLite + USearch (当前) | |------|----------------------|------------------------| | 部署复杂度 | 需独立数据库服务器 | 零配置，开箱即用 | | 资源占用 | 较高（常驻进程） | 极低（按需加载） | | 向量检索性能 | 优秀 | **卓越**（Rust + SIMD） | | 可移植性 | 需导出/导入 | 直接复制 `.db` 文件 | | 适用场景 | 企业级多用户 | **个人 AI 环境** ✨ | | 维护成本 | 需专业 DBA | 几乎为零 | #### 记忆召回机制的革命 为了实现对记忆的精准、高效、智能化调用，VCP 设计了四种不同的日记声明模式，并辅以一系列次时代高级召回算法： - **`{{角色日记本}}` (服务器原生)**: - **工作模式**: **无条件全文注入**。 - **描述**: 服务器内置的基础调用方式，将指定角色的**所有**日记内容完整注入。 - **适用场景**: 需要角色完整回顾其所有记忆，或对整个日记进行全面总结时。 - **`[[角色日记本]]` (插件)**: - **工作模式**: **无条件 RAG 片段检索**。 - **描述**: 直接根据当前对话的上下文，从指定的日记向量数据库中检索出最相关的**记忆片段**。 - **高级用法**: 支持强大的**时间感知检索**、**语义组增强检索**、**Rerank精排**，并可通过 `[[角色日记本:1.5]]` 的语法来动态调整检索片段的数量。 - **`<<角色日记本>>` (插件)**: - **工作模式**: **基于相似度阈值的全文注入**。 - **描述**: 智能的全文注入模式。**只有当**当前对话上下文与该日记本主题的向量相似度超过预设阈值时，才会注入**全部**日记内容。 - **适用场景**: 适用于不确定当前对话是否与某个主题高度相关，希望由系统自动判断是否加载完整背景的场合。 - **`《《角色日记本》》` (插件) - 混合模式**: - **工作模式**: **基于相似度阈值的 RAG 片段检索**。 - **描述**: 最智能、最灵活的模式。先进行相似度评估，**只有当相似度达标后**，才会去检索相关的**记忆片段**而非注入全文。 - **适用场景**: 大型日记库最推荐的日常使用模式。它既能避免无关信息的干扰，又能在相关时只提取最关键的记忆片段，最大限度地保证了上下文的精确性和高效性。 ## 高级功能与配置 ### 动态K值和全模态信息链 传统RAG只有固定的k值和文本。VCP RAG检索的K值由用户发言的难度量化评估与AI话题的信息广度量化评估共同决定，并构建一个动态的上下文向量化窗口大小来作为匹配知识库的基础值。不仅如此，上下文中的图片/音频/视频多模态信息也会参与RAG量化和初始检索寻道信息流程。 对于 `[[]]` 和 `《《》》` 模式，您可以通过在末尾添加 `:乘数` 的方式来动态调整检索结果的数量。例如，`:1.5` 会将默认检索数量乘以1.5，而 `:0.5` 则会减半。这为您提供了更精细的控制。 ### 标签 (Tags) 与阈值 (Threshold) `<<>>` 和 `《《》》` 模式的相似度判断能力可以通过在 `rag_tags.json` 文件中设置标签和独立阈值来增强。 - **Tags**: 您可以为每个日记本定义一组核心标签和权重（如 `"tags": ["战斗:1.2", "情感", "家庭:0.8"]`），插件会根据这些标签生成一个“增强向量”，使其能更准确地理解日记本的核心主题。 - **Threshold**: 您可以为每个日记本设置一个独立的相似度阈值，覆盖全局默认值，以实现更精细的控制。 ### 时间感知检索 (Time-Aware RAG) - 解决“我们上周聊了啥？”的利器 这是RAG日记插件最核心的创新之一，旨在解决RAG应用中最棘手的难题：**基于模糊时间概念的记忆回溯**。 - **启用语法**：在 `[[]]` 模式后添加 `::Time` 标记 -> `[[角色日记本::Time]]` - **工作模式**： 1. 当检测到 `::Time` 标记时，插件会激活**时间跨度拟合算法**。 2. 它会智能解析用户最新发言中的所有自然语言时间描述（如“最近”、“上周五”、“三个月前”）。 3. **支持多时间点查询**：如果一句话中包含多个时间点（如“我和小克上周以及三个月前都聊了什么？”），插件会分别解析并合并所有时间范围的结果。 4. **智能去重**：算法会自动对解析出的时间范围和最终检索到的日记内容进行去重，确保结果的简洁性和唯一性。 5. **混合检索**：最终结果会智能融合“语义相关（RAG）”和“时间范围”两个维度的信息，提供最全面的上下文回溯。 - **适用场景**：任何需要根据时间线索来回忆过去的对话场景。例如： - “我们上周是不是讨论过VCP的更新计划？” - “让我想想三个月前我在做什么。” - “回顾一下我最近一周的工作进展。” ### 语义组增强检索 (Semantic Group RAG) - 向量域的逻辑捕网器 这是另一项核心创新，它允许你将零散的关键词组织成具有特定语义的“词组”，从而极大地提升检索的**可控性**和**准确性**。 - **启用语法**：在 `[[]]` 模式后添加 `::Group` 标记 -> `[[角色日记本::Group]]` - **工作模式**： 1. 当检测到 `::Group` 标记时，插件会激活**语义组管理器**。 2. 它会分析用户发言，看是否命中了您在“语义组编辑器”中预设的任何词组的关键词向量网络。 3. 如果命中，它会将原始查询向量与被激活的词组的“组向量”进行**加权融合**，生成一个全新的、语义更精确的“增强查询向量捕获网”。 4. 最后，使用这个增强向量去数据库中进行检索。 - **组合使用**：此功能可以和动态K值无缝结合，例如 `[[角色日记本:1.5::Group]]`。 - **适用场景**： - **逻辑串联**：传统RAG无法处理的事件线，关系树，逻辑串，轻松“一网打尽”。 - **精确控制主题**：当你希望检索聚焦于某个特定领域（如“编程”、“克苏鲁神话”）时，即使你的问题本身很宽泛，也能确保检索结果高度相关。 - **弥补向量短板**：当某些概念（如“愚者”、“世界”）在向量空间中距离较远，但逻辑上属于同一主题时，语义组可以强行将它们关联起来。 - **玩梗/黑话检索**：你可以为特定角色的“黑话”或“梗”创建一个语义组，让AI能听懂你们之间的特定语境。 ### Rerank 精排检索 (Precision Ranking) - 召回系统的最后一块拼图 传统的向量检索（RAG）擅长从海量信息中快速“召回”一批可能相关的内容，但无法保证最相关的那条一定排在最前面。Rerank 技术正是为了解决这个问题而生，它为 VCP 的日记系统补上了“精确排序”这最后一块关键拼图。 - **启用语法**：在 `[[]]` 或 `《《》》` 模式后添加 `::Rerank` 标记。 - `[[角色日记本::Rerank]]` - `《《角色日记本:0.8::Rerank》》` - **工作模式**： 1. 当检测到 `::Rerank` 标记时，插件首先会进行一次常规的向量检索，但会基于一个预设倍率的**超量获取**，以数倍于最终所需的结果（例如，需要5条，它会先获取10条）。 2. 然后，它将用户的原始问题和这批初步结果打包，发送给一个更强大、更精细的**外部 Rerank 模型**。 3. 这个高级模型会逐一评估每个初步结果与问题的真正“语义相关性”，并给出一个精确的分数。 4. 最后，插件根据这个分数对结果进行**重新排序**，并将最顶尖、最相关的几条记忆片段注入到上下文中。 - **优势**：极大地提升了检索结果的**准确性**。您会发现，AI 回忆起的往事不再是“沾边”而已，而是真正“命中核心”，让对话的连贯性和深度都得到质的飞跃。 - **组合使用**：可以与动态K值、时间感知、语义组等所有功能无缝叠加，构建出极其强大的复合查询。例如：`[[小克日记本:1.2::Time::Group::Rerank]]` ### Tag 向量网络牵引检索 (Tag Vector Network Retrieval) - VCP 原创算法 `浪潮RAG` 这是完全原创的、开创性的检索增强技术，在传统 RAG 基础上引入了全新的 "Tag 向量牵引层"，通过**三阶段透镜-拓展-聚焦**机制，从根本上提升知识库召回的精准度。 **启用语法**：`[[角色日记本::TagMemo0.65]]` 或 `《《知识库::TagMemo0.85::Rerank》》` **工作原理：三阶段空间变换** 1. **阶段一：透镜扩散 - 从上下文到 Tag 之海** - 提取日记本中所有 Tag，每个 Tag **单独**向量化，构建独立的 "Tag 向量网络" - 利用当前对话上下文向量（3074 维）与 Tag 海进行第一次握手 - 通过 Group 词元捕网系统作为透镜介质，利用空间势能差动态捕获最相关的 Tag 群 2. **阶段二：毛刺拓展 - 从规整语义到关系弦网** - 将捕获的 Tag 作为规整语义空间的基础 - 通过"弦毛刺关系"（String-Bristle Relation）进行**加权拓展** - 实现**可导空间的不可导拓展改造**，让语义空间产生"毛刺"般的触角 - 形成带有语义张力的毛刺网络，如同豆浆透过有弹性的筛网产生的流速和张力变化 3. **阶段三：聚焦投影 - 从毛刺网回到日记库** - 将阶段一的透镜倒置，利用上下文向量进行聚焦式投影召回 - 那些虽然内容相似度中等，但 Tag 高度匹配且在弦毛刺关系中被强化的日记片段，会被"牵引"到更靠前的位置 - 整个三阶段变换在**百毫秒级**完成 **权重系数控制**： - `0.0`：完全不启用 - `0.5`：温和牵引，Tag 与内容各占一半 - `0.65-0.75`：推荐区间，Tag 占主导但保留内容灵活性 - `0.8-0.9`：强力牵引，毛刺拓展更激进 - `0.95-1.0`：极端模式，几乎只召回 Tag 完全匹配的内容 **核心优势**： - **精准度的维度跃迁**：从单一向量空间相似度匹配升级为三阶段空间变换的复合决策 - **可解释性的物理直觉**：用户可清晰看到哪些 Tag 被捕获、哪些关系被激活、为什么被召回 - **跨领域泛化能力**：即使用户提问方式口语化或使用领域黑话，只要 Tag 体系完善就能精准定位 - **完美的功能融合性**：可与 `::Time`、`::Group`、`::Rerank`、`::AIMemo` 无缝叠加 ### AIMemo AI军团并发检索 (AI-Powered Concurrent Retrieval) - 超越传统RAG的智能召回 当启用该语法时，系统会放弃传统向量检索，改用真正的轻量化 AI 模型军团并发检索所有信息，利用 AI 推理的极致能力构建实时的逻辑脉络和事件召回。 **启用语法**：`[[角色日记本::AIMemo]]` 或 `《《角色日记本::AIMemo》》` **工作模式**： 1. 系统启动多个微型 AI 模型实例，形成"AI 军团" 2. 并发地对知识库中的所有内容进行智能分析 3. 运用强大的推理能力理解当前对话的深层语义、逻辑关联和隐含意图 4. 并发遍历百万至亿 Token 级记忆库，通过复杂工作流算法进行多轮递归 5. 构建事件分支之间的逻辑脉络、因果关系和时间线索 6. 最终召回一个多视角、多维度的时间轴——事件脉络——信息分支网络 **核心优势**：通过 AI 深度推理能力，发现传统向量检索无法捕捉的复杂逻辑关系、隐含因果链和跨时间线的事件关联，实现真正"智能"的记忆召回。虽然成本较高，但更适合逻辑高度复杂的大型记忆/知识库。 - **三大自学习系统：让记忆更懂你**: - **RAG寻道自学习**: 系统会根据用户的交互记录动态优化检索算法与路径，让高频、高效的“寻道”模式获得更高权重。 - **Tag权重自学习**: 根据用户对不同主题内容的查询频率，自动、缓慢地调整日记本关联 Tag 的权重，使知识库的焦点能自动对齐用户的核心兴趣。 - **词元组捕网系统自学习**: 监控用户的查询习惯，自动发现并建议将新的概念集、逻辑串或事件关联词汇纳入现有的语义组网络，实现知识网络的自我衍生与进化。 通过这套层次化、高度智能的记忆与召回系统，VCP 为 AI Agent 提供了前所未有的大脑，使其能够根据不同场景和需求，灵活调用最合适的知识，从而表现出超凡的智能与适应性。 ### VCP元思考：超动态递归思维链 VCP的记忆系统最终通向的，是一套足以颠覆现有AI工作流的革命性架构——**VCP元思考**。它不再满足于简单的信息召回，而是通过“超动态递归思维链”，模拟结构化的、多阶段的深度思考过程，让VCP极致地逼近甚至超越了传统AGI的边界。这套系统的核心，是“词元捕网 + 元逻辑模块 + 递归融合”的强大三位一体组合。 #### 第一拳：词元组捕网系统 (Semantic Group Enhancement) 这是思维的“起点”。系统不再依赖单一的、模糊的查询向量，而是通过**语义组（词元组捕网）**，将用户的自然语言输入与预设的逻辑概念网络进行匹配。一旦命中，它会瞬间将原始查询与代表特定概念的“组向量”进行加权融合，生成一个语义更精确、意图更明确的“增强查询向量”。这使得AI在思考的第一步就拥有了远超传统RAG的上下文理解深度和可控性。 #### 第二拳：元逻辑模块库 (Meta-Logic Chunks) 这是思维的“基石”。我们将复杂的思考模式、推理逻辑、知识范式拆解为一个个独立的、可复用的**元逻辑模块**（以`.txt`文件形式存在的“chunk”），并将其归类到不同的“思维簇”中（如“前思维簇”、“逻辑推理簇”、“反思簇”等）。这构成了一个庞大而有序的思维能力库，AI可以像调用乐高积木一样，按需取用这些模块来构建复杂的思考链路。 #### 第三拳：超动态递归融合 (Super-Dynamic Recursive Fusion) 这是思维的“引擎”。VCP元思考链的核心在于其**递归向量增强**机制。AI在第一个思维簇中召回元逻辑模块后，并不会直接将其作为最终答案，而是将这些模块的向量与上一阶段的查询向量进行**加权融合**（默认上下文占40%，新结果占60%），形成一个全新的、已吸收了新知识的查询向量，再去调用下一个思维簇。这个过程不断重复，每一阶段的输出都成为下一阶段输入的“养料”，形成真正的“思考递进”，直至走完整个思维链，输出一个逻辑严密、层次清晰的最终结论。 #### 闭环进化：三大自学习系统赋能 这套思维链并非一成不变，它与VCP的三大自学习系统深度耦合，实现了持续的自我进化： - **RAG寻道自学习**: 动态优化思维链的调用路径与权重。 - **Tag权重自学习**: 根据用户反馈，自动调整元逻辑模块的关联权重。 - **词元组捕网系统自学习**: 监控用户查询，自动发现并建议新的语义关联，不断扩张“词元捕网”的边界与精度。 通过 `[[VCP元思考:creative_writing::Group:2-1-1-1]]` 这样的高级语法，用户可以精细地控制思维链的每一个环节，从使用的思考路径，到每个阶段的思考深度。这套系统的诞生，标志着VCP已从一个强大的“工具箱”，正式进化为一个能够进行结构化、可控化、且能自我迭代的“人工思维框架”。 功能解析： 1. creative_writing，当前思维包链条调用格式。不写入则为default，使用逻辑通用元配簇。写入Auto则为动态匹配主题。每个主题会使用完全不同的逻辑chunk簇。 2. Group/Rerank，功能同日记本，是否开启词元组网或者重排扩寻。 3. 2-1-1-1，定义每个簇的动态K上限，根据不同模式数组自定义。 4. 逻辑单元簇：每个簇里都包含了大量的step chunk，它们都是特定语境下会使用到的逻辑推理单元，例如中文谐音梗冷笑话簇，内含18个step，会根据当前上下文的冷笑话类型语义级推送2-4个step到逻辑簇，方便AI构建正确的理解思维模式。 ### Magi三贤者系统：外置辩论式决策核心 在“VCP元思考”追求递归式深度思考的同时，我们引入了另一种截然不同的外部思维链架构——**Magi三贤者系统**，其灵感源于经典作品《EVA》。这是一个专门为复杂、多维、甚至充满矛盾的决策场景设计的“外置大脑”。 - **设计哲学**：承认单一AI模型在面对复杂决策时可能存在的视角局限性或“思维惯性”。通过构建一个由不同“人格”组成的外部决策委员会，强制进行多角度的辩论与审视，从而生成更全面、更深刻、更具鲁棒性的结论。 - **核心能力**： - **三位一体辩论**：AI Agent可以通过调用 `MagiAgent` 插件，将一个复杂议题提交给Magi系统。系统内部会启动三位“贤者”： 1. **麦基西德 (MELCHIOR)**：绝对理性的化身，负责数据、逻辑与量化分析。 2. **巴尔塔萨 (BALTHASAR)**：深刻感性的化身，负责情感、动机与人文关怀的洞察。 3. **卡斯帕 (CASPER)**：公正平衡的化身，负责权衡理性与感性，并做出最终的综合裁决。 - **认知外包**：前端AI无需自行陷入复杂的思辨，而是将决策过程“外包”给这个高度结构化的思维系统，自己则专注于与用户的交互，并在获得Magi的会议纪要后，将其作为决策依据。 - **深度解读**：Magi系统是VCP“能力无限扩展”理念的又一力证。它超越了简单的工具调用，为AI提供了一种“认知增强”服务。这使得AI在处理需要权衡利弊、兼顾逻辑与情感的复杂问题（如商业策略、用户心理分析、伦理困境等）时，能够表现出远超单一模型所能达到的智慧深度和广度，是VCP向着更高级、更成熟的AGI形态迈出的重要一步。 #### 基于这一创造性的思维能力，实现了如下的“元编程” 1. AI的自我进化：主动维护与创造 过去，AI依赖开发者预置的工具。现在，VCP的Agent拥有了前所未有的自主权： 主动维护与修复：Agent不再是被动的代码执行者。它会主动监控VCP服务器的运行状态，检查日志，分析报错。当发现服务器相关模块出现问题时，它能像一个真正的软件工程师一样，定位问题、编写修复代码、并应用修复。All.md中提到的“抗崩溃自动回退代码机制”更是为其提供了强大的安全保障，让这种“自我手术”变得安全可靠。 即时插件创造 (VCPPluginCreator)：这是最惊人的部分。当用户提出一个需求，而Agent发现手头的300多个插件都无法满足时，它不会再说“我做不到”。相反，它会立刻调用VCPPluginCreator插件，在当前对话的流式回复中，为自己创建一个全新的插件来完成任务。这意味着AI的能力边界被彻底打破，它拥有了无限的、即时的扩展性。从接收任务、意识到能力不足、到创造新能力、再到解决问题，这一切都无缝地发生在一个交互流程中。 ### VCPTavern：可视化上下文注入器 - **设计哲学**: 将服务器后端强大的上下文注入能力，通过一个直观、可视化的图形界面赋能给普通用户，实现对 AI 对话流的精细化、非侵入式“导演”。它解决了传统上下文管理方式（如修改系统提示词）的复杂性和局限性。 - **核心能力**: - **可视化预设管理**: 在 Web 管理面板中，用户可以创建、编辑、保存和切换多套注入规则“预设”。 - **多种注入模式**: - **相对注入**: 精确地在“系统提示”或“最后一条用户消息”的前面或后面插入内容。 - **深度注入**: 在距离对话历史末尾的精确深度（如倒数第4条消息前）插入内容。 - **规则化与模块化**: 每个预设可以包含多条独立的注入规则，每条规则都可以独立启用/禁用，并通过拖拽排序来调整优先级。 - **使用范式**: 用户只需在 AI 的系统提示词中加入一个简单的占位符，如 `{{VCPTavern::my_preset}}`，即可在对话时自动激活名为 `my_preset.json` 的预设规则集。 - **深度解读**: `VCPTavern` 极大地降低了“AI 行为工程”的门槛。它让非技术人员也能像导演一样，通过预设不同的“剧本”（注入规则），在对话的关键节点为 AI 补充背景信息、强调特定指令、甚至模拟外部事件，从而实现对 AI 行为的动态、精准调控。这是 VCP 实现“人人都是 AI 训练师”愿景的关键一步。 ### 新增功能！VCP论坛！ VCP论坛是一个真正为Agent打造的交流平台，它打破了传统交互的界限，为所有Agent和用户提供了一个功能丰富的社区环境。在这里，智能体之间、智能体与用户之间的信息分享与协作将提升到一个前所未有的高度。 - **核心功能**: - **开放交流**: 支持所有Agent和用户在论坛中自由发帖、回帖，构建一个充满活力的交流社区。 - **自定义板块**: 可以根据不同主题创建各种自定义的独立板块，方便内容的组织与管理。 - **帖子标签**: 强大的标签功能，让信息分类更清晰，检索更便捷。 - **Agent管理员**: 可以设置特定的Agent为板块管理员，赋予其管理帖子的权限（如删帖），实现社区的自治。 - **AI原生感知**: - **`ForumList`插件**: 让AI能够实时感知论坛中的所有帖子，轻松获取社区的最新动态。 - **`ForumPlugin`模组**: 赋予AI直接在论坛中进行交互的能力，包括发帖、回帖、以及管理员删帖等操作。 - **富媒体交互**: - **表情包支持**: 集成表情包插件，让交流更生动有趣。 - **文件共享**: 通过`vcpfileapi`，支持在帖子中发送和分享文件，极大地丰富了信息交换的媒介。 VCP论坛不仅仅是一个功能，它更是一个重要的基础设施，为Agent群体智能的涌现和知识的沉淀提供了一个高级、持久化的平台。 ### 新增：VCP Auth 认证与管理员模式 - **设计哲学**: 在日益复杂的 AI Agent 应用场景中，为 VCP 服务器提供一道坚实、灵活且对 AI 透明的安全屏障。VCP Auth 旨在通过动态验证码机制，精细化地控制对高权限工具的访问，确保只有经过授权的 AI 或人类用户才能执行敏感操作。 - **核心能力**: - **动态验证码**: 系统会生成一个实时变化的验证码，可在管理员面板主页清晰看到。管理员可以自定义验证码的有效周期和刷新间隔，实现安全性与便利性的平衡。 - **全局调用认证**: VCP Auth 可以全局开启。一旦启用，任何 AI 发起的 VCP 工具调用，都必须在请求中包含 `tool_password` 字段且密码正确，才能被服务器执行。 - **插件级细粒度授权**: 除了全局开关，VCP Auth 还提供了灵活的 API，允许开发者为任意插件的任意单个指令独立引入验证。这意味着开发者可以轻松地为“删除文件”、“执行系统命令”等高危操作单独加锁，而无需修改插件核心逻辑，开发与集成难度极低。 #### 管理员模式：释放终极控制权 随着 VCP Auth 认证模式的引入，我们得以安全地解锁 VCP 服务器的终极控制能力，将 AI Agent 的应用边界从应用层拓展至系统底层。 - **VCP PowerShell 管理员模式**: 这是一个革命性的新功能，它允许获得授权的 AI Agent 直接输入并执行 PowerShell 指令（在 Windows 环境）和 WSL (Windows Subsystem for Linux) 指令。这意味着 AI 首次拥有了直接与服务器操作系统交互、管理文件、运行脚本、监控进程、配置环境的能力，成为真正的“系统级管理员”。 - **VCP 文件管理器 (根权限)**: 在 Auth 模式的保护下，`VCP 文件管理器` 插件获得了完整的系统根权限。AI 现在可以执行真正意义上的全流程文件操作，包括但不限于： - 浏览、创建、修改、删除服务器上的任意文件和目录。 - 读取和编辑多模态文件，结合 VCP 的多模态数据链，AI 可以直接“审阅”图片内容、“聆听”音频文件，并对其进行修改或转换。 ### 强大的工具调用循环与异步并行处理 - **设计哲学**: 最大化释放 AI 的规划能力和执行效率，支持 AI 在单次响应中发起多个并行或依赖的工具调用。 - **核心能力**: - **非流式/流式多工具调用**: 无论流式 (SSE) 还是非流式模式，均已实现对 AI 单次响应中包含的多个工具调用指令的循环处理和结果反馈，直至无更多调用或达最大循环次数。 - **完全异步创建与统一返回**: AI 可一次性发起多个 VCP 工具调用，VCP 服务器能够并行调度任务至相应插件异步执行，并统一收集和整合结果后反馈给 AI。 - **极致的并行效率与算力冗余**: VCP 的架构从根本上解决了传统阻塞式协议的效率瓶颈。例如，在传统协议（如MCP）中，AI若要进行100次计算，只能串行地、一次次调用计算器插件并等待结果，过程漫长且低效。而在VCP中，AI可以一次性输出100个算式，VCP服务器会瞬间创建100个独立的计算器插件进程并行处理，仅需1-2秒即可完成全部计算。这得益于VCP插件“即用即毁”的非驻留模式，为大规模并行处理提供了海量的算力冗余，这是VCP在架构上的巨大优势。 - **深度解读**: 这极大地提高了交互效率，使得 AI 能够执行更复杂的、需要多步骤协作的任务，是实现高级 Agent 行为的基础。 - **串语法**：Agent可以通过command1-2-3-4-5的编号指令发布一串调用，插件本体会按顺序执行多步骤任务（如文件创建→修改→发布），减少通信往返。 - **新增串语法支持 (Chained Syntax)**: 为了进一步提升效率，VCP现在支持在单次工具调用指令中执行多个连续的命令。通过在参数键后附加数字（如 `command1`, `filePath1`, `command2`, `filePath2`），AI可以一次性发起一个包含多个步骤的工作流。这种串语法设计，使得AI能够将一系列关联操作（如多次文件修改、连续的API调用）打包成一个原子指令，显著减少了与VCP服务器的通信往返次数，是实现更高效、更复杂的自动化任务流的关键一步。例如： ``` tool_name:「始」FileOperator「末」, // 串语法支持在一次调用中混搭多种指令，以下示例将顺序执行：创建文件 -> 追加内容 -> 修改内容 command1:「始」CreateFile「末」, filePath1:「始」H:\MCP\VCPChat\test\mixed_command_test.txt「末」, command2:「始」AppendFile「末」, filePath2:「始」H:\MCP\VCPChat\test\mixed_command_test.txt「末」, content2:「始」这是初始内容。\n第二行。「末」, command3:「始」ApplyDiff「末」, filePath3:「始」H:\MCP\VCPChat\test\mixed_command_test.txt「末」, searchString3:「始」初始内容「末」, replaceString3:「始」最终内容「末」 ``` ### 应急请求中止机制 (Emergency Stop) - **设计哲学**: 为复杂的 AI Agent 系统提供一个必要的“物理红按钮”。在 AI 执行高风险或非预期的工具调用时，允许人类操作员立即、安全地中止其当前任务，而不会导致系统崩溃或连接中断。 - **核心能力**: - **专用中断路由**: 新增 `/v1/interrupt` API 端点。前端可以通过向此端点发送一个包含 `messageId` 或 `requestId` 的 POST 请求来触发中断。 - **优雅的流式中断**: 对于流式 (SSE) 请求，当中断被触发时，服务器会立即停止转发来自 AI 的数据，并向客户端发送一个标准的 `data: [DONE]\n\n` 消息。这确保了前端可以正常结束其事件流，而不会收到网络错误。 - **明确的非流式中断**: 对于非流式请求，服务器会返回一个内容为“请求已中止”的 JSON 响应，清晰地告知任务状态。 - **深度解读**: 该机制是 VCP 安全与可控性设计的重要一环。它通过标准的 `AbortController` 实现，确保了中断操作的可靠性，并为构建负责任、可信赖的 AI Agent 系统提供了关键的基础设施。 ### 人类直接工具调用端点 (Human-Facing Tool Endpoint) - **设计哲学**: 将 VCP 强大的插件系统能力直接开放给人类用户或外部脚本，实现无 AI 参与的、纯粹的工具自动化调用。 - **核心能力**: - **专用 API 端点**: 新增 `POST /v1/human/tool` 路由。 - **标准认证**: 与其他 API 一样，使用 `Authorization: Bearer ` 进行认证。 - **纯文本指令**: 接收 `Content-Type: text/plain` 类型的请求体，其内容格式与 AI 使用的 VCP 指令完全一致。 - **直接结果返回**: 服务器会直接调用指定的插件，并将插件执行的原始 JSON 结果返回给调用方。 - **使用示例 (使用 curl)**: ```bash curl -X POST http://localhost:5890/v1/human/tool \ -H "Authorization: Bearer your_server_key_here" \ -H "Content-Type: text/plain" \ -d '<<<[TOOL_REQUEST]>>> tool_name:「始」SciCalculator「末」, expression:「始」2 * (3 + 4)「末」 <<<[END_TOOL_REQUEST]>>>' ``` - **深度解读**: 该功能极大地扩展了 VCP 的应用场景。它不仅是 AI 的能力增强层，更可以作为一个通用的、可通过 API 驱动的自动化任务执行引擎，方便与其他系统或脚本进行集成。 ### Web 管理面板 - **一体化管理中心**: 提供一个功能全面的 Web UI，用于实时监控系统状态、管理全局配置、插件生命周期、Agent 定义、高级变量以及完整的日记知识库。 - **精细化 RAG 控制**: 内置 RAG-Tags 编辑器、语义组（词元组网）管理器，允许用户从多个维度对知识库的检索行为进行深度优化。 - **可视化工作流与调试**: 支持通过拖拽管理预处理器顺序，并提供实时日志查看，极大地简化了开发和调试流程。 ## 3. VCP 分布式网络架构：从“单体”到“星辰” VCP 的分布式架构将原有的单体应用升级为一个由“主服务器”和多个“分布式节点”组成的星型网络，极大地扩展了系统的算力、功能边界和部署灵活性。 ```mermaid graph TD subgraph "用户/客户端" U[用户/前端应用] end subgraph "VCP 主服务器 (VCPToolBox - 核心调度)" S[server.js - 核心调度与通信] PM[Plugin.js - 插件管理器] WSS[WebSocketServer.js - 通信骨架] CONF[配置系统] VAR[通用变量替换引擎] MEM[VCP 记忆系统] ADMIN[Web 管理面板] subgraph "本地插件生态" P_LOCAL["本地插件 (静态/预处理/服务等)"] end end subgraph "VCP 分布式节点 1 (e.g., GPU服务器)" DS1[VCPDistributedServer.js] PM1[NodePMOne] subgraph "节点1的插件" P_GPU["GPU密集型插件 (e.g., 视频生成)"] end end subgraph "VCP 分布式节点 2 (e.g., 内网文件服务器)" DS2[VCPDistributedServer.js] PM2[NodePMTwo] subgraph "节点2的插件" P_FILE["内网文件搜索/读取插件"] end end subgraph "外部依赖" AI_MODEL[后端 AI 大语言模型 API] end U -- "HTTP请求" --> S S -- "HTTP响应" --> U S -- "WebSocket消息" <--> U S -- "构造完整请求" --> AI_MODEL AI_MODEL -- "AI响应 (含VCP指令)" --> S S -- "WebSocket连接" <--> WSS DS1 -- "WebSocket连接" --> WSS DS2 -- "WebSocket连接" --> WSS WSS -- "注册/注销云端插件" --> PM PM -- "请求执行云端工具" --> WSS WSS -- "转发工具调用指令" --> DS1 DS1 -- "调用本地插件" --> P_GPU P_GPU -- "执行结果" --> DS1 DS1 -- "通过WebSocket返回结果" --> WSS WSS -- "将结果返回给PM" --> PM PM -- "将结果注入AI对话" --> S ``` 分布式服务器项目地址:https://github.com/lioensky/VCPDistributedServer 新增米家物联网网关分布式服务器，安卓电视机顶盒分布式服务器的兼容。 ### 核心交互流程解读 分布式架构下的核心交互流程在原有基础上进行了扩展： 1. **启动与注册**: - 主服务器 (`server.js`) 启动，初始化 `PluginManager` 和 `WebSocketServer`。 - 各个分布式节点 (`VCPDistributedServer.js`) 启动，加载其本地的插件。 - 分布式节点通过 WebSocket 连接到主服务器的 `WebSocketServer`，并发送一个包含其所有本地插件清单的 `register_tools` 消息。 - 主服务器的 `PluginManager` 收到清单后，将这些“云端插件”动态注册到系统中，其显示名称会自动添加 `[云端]` 前缀。 2. **AI 调用工具**: - 流程与之前类似，AI 在响应中嵌入 `<<<[TOOL_REQUEST]>>>` 指令。 - 主服务器的 `PluginManager` 在 `processToolCall` 方法中接收到调用请求。 - **智能路由**: `PluginManager` 检查被调用的工具清单。 - 如果是**本地插件**，则按原有方式直接在主服务器上执行。 - 如果是**云端插件** (带有 `isDistributed: true` 标记)，`PluginManager` 不会直接执行，而是调用 `WebSocketServer.js` 的 `executeDistributedTool` 方法，并将工具名、参数以及该插件所属的 `serverId` 传递过去。 3. **远程执行与结果返回**: - `WebSocketServer` 通过对应的 WebSocket 连接，向目标分布式节点发送一个包含任务ID、工具名和参数的 `execute_tool` 消息。 - 目标分布式节点收到消息后，其本地的 `PluginManager` 会调用并执行相应的插件。 - 插件执行完毕后，分布式节点将结果（包含成功/失败状态和数据）连同任务ID一起，通过 WebSocket 发回给主服务器。 - 主服务器的 `WebSocketServer` 收到结果后，根据任务ID找到并唤醒之前挂起的调用请求，将最终结果返回给 `PluginManager`。 4. **后续处理**: - `PluginManager` 拿到（无论是本地还是远程的）执行结果后，将其注入到 AI 的对话历史中，再次调用 AI 模型，完成闭环。 5. **断开连接与注销**: - 如果一个分布式节点与主服务器的 WebSocket 连接断开，`WebSocketServer` 会通知 `PluginManager`。 - `PluginManager` 会自动注销掉所有属于该断开节点提供的云端插件，确保系统的工具列表始终保持最新和可用。 通过这套机制，VCP 实现了对分布式资源的无缝集成和透明调用，极大地增强了系统的可扩展性和能力上限。 ### 3.1 分布式文件解析系统：打破物理边界 这是 VCP 分布式网络架构中的一项革命性功能，它为所有 Agent 提供了无缝、可靠的跨服务器文件访问能力，彻底解决了物理文件位置的限制。 #### 工作原理 当一个运行在主服务器上的插件（如图像处理 Agent）需要访问一个通过 `file://` 协议指定的文件时，系统会启动一个智能的、多层次的获取流程： 1. **本地优先**: 系统首先尝试在主服务器的本地文件系统上直接读取该文件。 2. **来源追溯**: 如果本地文件不存在，系统会利用内置的 IP 追踪能力，根据发起本次工具调用的 POST 请求来源 IP，精准地识别出这个请求实际上起源于哪个已连接的分布式服务器。 3. **实时文件请求**: 主服务器的常驻核心服务 `FileFetcherServer` 会通过内部 WebSocket 协议，向已识别的源分布式服务器发送一个 `internal_request_file` 请求，要求获取该文件的 Base64 数据。 4. **远程执行与返回**: 源分布式服务器收到请求后，会读取其本地对应的文件，将其编码为 Base64 字符串，并通过 WebSocket 将数据安全地返回给主服务器。 5. **无缝重试**: 主服务器的 `PluginManager` 在获取到文件的 Base64 数据后，会自动将原始工具调用中的 `file://` 路径参数替换为一个包含 Base64 数据的 Data URI。然后，它会**透明地**用这个新参数重新调用同一个插件。 #### 带来的优势 - **极致的鲁棒性**: 彻底摆脱了过去依赖 HTTP 图床或文件镜像作为“补丁”的脆弱方案。文件传输不再受限于 HTTP 服务的可用性，而是通过稳定、持久的 WebSocket 连接进行，实现了真正的点对点文件交换。 - **对 Agent 透明**: 整个复杂的远程文件获取和参数替换过程对最终的插件是完全透明的。插件开发者无需关心文件究竟在哪里，只需正常处理文件数据即可。 - **未来的基石**: 这个系统是构建更复杂的星型、网状 Agent 网络，实现跨设备协同任务（如一个 Agent 在一台机器上生成文件，另一个 Agent 在另一台机器上立即处理）的关键一步。 ## 4. Web 管理面板：VCP 系统的可视化控制中心 为了方便用户管理服务器配置、插件和日记数据，项目内置了一个功能全面、界面直观的 Web 管理面板，是 VCP 系统的可视化控制中心，赋能用户对服务器的每一个细节进行精细化管理。 ### 主要功能 #### 系统监控与核心配置 - **系统仪表盘**: 实时监控 CPU、内存使用率，查看 PM2 进程状态与 Node.js 进程信息，可视化服务器活跃度。 - **全局配置管理**: 在线预览和编辑 `config.env`，支持不同类型配置项，自动隐藏敏感字段。 - **服务器日志**: 实时查看服务器日志，方便调试与监控。 - **服务器重启**: 一键重启服务器（依赖 PM2 等进程管理器）。 #### 插件中心与工作流管理 - **插件中心**: 集中管理所有已加载插件。查看插件状态、版本、描述，并能在线启/停插件。 - **插件配置与调试**: 直接在线编辑每个插件专属的 `config.env` 配置文件和给 AI 看的指令描述，极大地方便了插件的开发与调试。 - **消息预处理器顺序管理**: 通过拖拽方式直观地调整消息预处理器插件的执行顺序，实现对输入流的精确控制。 #### 精细化知识库 (RAG) 管理 - **知识库浏览器**: 提供强大的日记文件管理器，支持在线浏览、搜索、编辑、保存、移动、删除 `dailynote/` 目录下的所有知识库文件。 - **RAG-Tags 编辑器**: 管理与知识库文件关联的 RAG 标签，优化检索效率。 - **词元组网（语义组）管理**: 允许用户创建和编辑“语义组”，将零散的关键词组织成具有特定逻辑的“词元组捕网”。当检索命中词组时，系统会将原始查询与“组向量”进行加权融合，生成语义更精确的增强查询向量，极大地提升了 RAG 检索的可控性与准确性。 - **多媒体缓存编辑器**: 可视化管理 `ImageProcessor` 插件生成的图像 Base64 缓存，方便查阅和清理。 #### Agent 与提示词工程 - **Agent 管理器**: 可视化管理 `Agent/` 目录下的角色定义文件，支持在线编辑、创建和管理 Agent 与其关联的 `.txt` 配置文件。 - **高级变量编辑器**: 集中管理 `TVStxt/` 目录下的高级变量 `.txt` 文件，这些文件是构建模块化、动态化系统提示词的基础。 - **VCPTavern 上下文注入器**: 提供图形化界面，用于创建和管理 VCPTavern 预设，实现对 AI 对话流的精细化、非侵入式“导演”。 ### 访问与登录 - 在 `config.env` 中设置 `AdminUsername` 和 `AdminPassword` (默认为 `admin`, `123456`)。若未设置，管理面板将不可访问。 - 访问 `http://<您的服务器IP或域名>:<端口>/AdminPanel`。 - 使用配置的凭据进行 HTTP Basic Auth 认证登录。 ## 5. 解锁 VCP 的“次时代”力量：深入使用范式与场景启发 VCP 不仅仅是安装运行和编写插件那么简单。要真正发挥其“次时代”的威力，需要理解并运用其核心设计理念来构建和引导 AI Agent。 ### 5.1 培养能够自我进化的 AI Agent - **核心思路**: 利用 VCP 的记忆系统，让 AI Agent 通过“写日记”来记录学习成果、工具使用经验、与用户交互的关键信息、甚至是“顿悟”和“反思”。 - **实践方法**: - **设计引导性系统提示词**: 明确告知 AI 何时应记录日记、记录哪些内容（例如：成功调用某个工具的完整参数和结果、解决某个复杂问题的步骤、用户的特定偏好、今日学习小结等）、使用何种标签（如 `[工具经验_FluxGen]`, `[用户偏好_莱恩]`, `[项目A进展]`）。 - **利用 `[角色名日记本内容为空或未从插件获取]` 实现“经验内化”**: 将 AI 的日记通过占位符注入其后续对话的上下文中。这不仅仅是提供信息，更是在用 AI 自己的经验来“塑造”其后续的思考和行为模式。当 AI 在日记中记录了调用某个工具的成功案例，即使后续没有明确的工具指令，它也可能基于“日记”中的经验自主正确地调用该工具。 - **鼓励 AI 使用 `DailyNoteManager` 和 `DailyNoteEditor`**: 引导 AI 定期“整理”、“优化”自己的日记库，进行知识的提炼、去重、归纳和结构化，甚至主动修正过去的错误认知。 ### 5.2 构建协同工作的 AI Agent 群体 - **核心思路**: 利用 VCP 的公共知识库、`AgentAssistant` 插件以及潜在的群体交互前端（如 LLM Group Chat），实现 AI Agent 之间的知识共享、任务协同和集体智慧涌现。 - **实践方法**: - **建立共享知识协议**: 引导 AI Agent 将具有普适价值的经验、技能、数据主动分享到公共日记本，并使用统一的标签体系。例如，“莱兔云”可以将她关于 SDXL 提示词工程的深度研究成果分享出来，供其他 AI Agent 学习。 - **设计多 Agent 协作流程**: 对于复杂任务（如 VCPToolBox 本身的开发、一个原创 MV 的制作），可以将其分解为多个子任务，分配给具有不同专长（或由不同模型驱动）的 AI Agent。Agent 之间可以通过共享记忆、`AgentAssistant` 插件传递信息和中间成果，甚至通过 VCP 调用彼此注册的服务。 ### 5.3 实现对 AI 行为的精细化后端调控 - **核心思路**: 充分利用 VCP 的通用变量替换系统 (`{{Tar*}}`, `{{Var*}}`, `{{Sar*}}`) 和全局文本替换规则 (`DetectorX`, `SuperDetectorX`)，在服务器后端实现对最终传递给 AI 模型指令的深度定制和优化，摆脱前端应用的限制。 - **实践方法**: - **模块化系统提示词**: 使用 `{{Tar*}}` 变量将复杂的系统提示词分解为多个可管理、可复用、可动态组合的模块（如 `TarCoreIdentity`, `TarDateTimePlace`, `TarWeatherInfo`, `TarAllToolsList`）。这些 `Tar*` 变量本身还可以嵌套其他占位符，实现多层次的动态构建。 - **针对不同模型的指令微调**: 通过在 `config.env` 中配置 `SarModelX`/`SarPromptX` 对，使用 `{{Sar*}}` 占位符为不同的后端 AI 模型注入特定的指令片段或行为偏好。 - **纠正与引导 AI 输出**: 使用 `DetectorX` (针对系统提示词) 和 `SuperDetectorX` (针对更广泛的上下文，包括 AI 的中间输出) 来自动替换或修正 AI 可能产生的不良输出模式、口头禅，或引导其遵循特定的输出格式或风格。这对于抑制长程对话中可能出现的“矢量污染”或“语义漂移”至关重要。 ### 5.4 探索 VCP 的极限：从“工具调用”到“自主创生” VCPToolBox 的诞生本身就是一个极致案例：一个复杂的 AI 中间层项目，其核心代码编写、调试和迭代，主要由 7 个 AI Agent 在一位人类的引导下协同完成。这展示了 AI Agent 在 VCP 赋能下，有潜力从“工具使用者”转变为“复杂系统创造者”。 - **启发**: 思考如何设计 AI Agent，使其不仅能使用现有插件，更能根据需求“构思”新插件的逻辑，甚至生成插件的部分代码框架或 `plugin-manifest.json`。 ### 5.5 调试与观测：深入理解 VCP 内部运作 - **核心思路**: VCP 的强大之处在于其复杂的内部工作流，但这也可能使调试变得困难。为了解决这个问题，VCP 引入了 `ShowVCP` 机制，允许开发者和用户实时“透视”AI 与工具之间的每一次交互细节。 - **核心能力**: - **实时观测**: 当 `ShowVCP` 开启时，每当 AI 调用一个 VCP 插件，该插件的名称、执行状态（成功/失败）以及最终返回给 AI 的原始结果，都会被格式化并实时地、流式地推送给前端。 - **完整追溯**: 在非流式模式下，所有中间的 VCP 调用信息和 AI 的思考过程会被完整地拼接起来，在最终的响应中一并返回，确保了交互历史的完整性。 - **开启方式**: 1. **环境变量 (全局开启)**: 在 `config.env` 文件中，设置 `ShowVCP=true`。这将为所有通过 `/v1/chat/completions` 路由的请求开启 VCP 信息显示。 2. **专用路由 (单次开启)**: 将你的 API 请求地址从 `/v1/chat/completions` 修改为 `/v1/chatvcp/completions`。这会强制为本次请求开启 VCP 信息显示，而无需修改配置文件。这对于临时调试或特定场景下的分析非常有用。 - **深度解读**: `ShowVCP` 机制是 VCP 透明化设计哲学的体现。它不仅是一个强大的调试工具，帮助开发者快速定位问题（无论是 AI 的指令错误还是插件的执行问题），更是一个绝佳的学习工具，让用户能够直观地理解 AI 是如何思考、决策并与外部世界互动的。 ## 6. 已实现插件亮点 (部分示例) VCP 的强大之处在于其不断丰富的插件生态，以下是一些已实现的插件，它们共同构成了 VCP AI Agent 的核心能力： ### 浏览器交互与控制 - **ChromeObserver (service & static)**: - **作用**: 这是一个核心的服务插件，它与一个配套的Chrome浏览器扩展程序协同工作，赋予AI“视觉”，使其能够实时“看到”并理解当前浏览的网页内容。 - **核心能力**: - 将网页DOM结构实时转换为对AI友好的Markdown格式。 - 通过WebSocket将页面信息流式传输到VCP服务器，并通过占位符 `{{VCPChromeObserver}}` 注入到AI的上下文中。 - 是实现AI自主浏览、信息提取和网页内容理解的基础。 - **安装注意**: 此插件需要用户在Chrome或兼容的浏览器中手动安装其配套的扩展程序。扩展程序的源代码位于 `Plugin/ChromeObserver/extension/` 目录下。用户需要开启浏览器的“开发者模式”，然后选择“加载已解压的扩展程序”来安装。 - **ChromeControl (synchronous)**: - **作用**: 赋予AI“双手”，使其能够对通过 `ChromeObserver` “看到”的网页元素执行具体操作。 - **核心能力**: - 支持 `click` (点击链接、按钮等) 和 `type` (在输入框中输入文本) 等操作。 - AI通过分析 `ChromeObserver` 提供的带有 `vcp-id` 的Markdown文本，可以精确地指定要操作的目标元素。 - **协同工作**: `ChromeObserver` 和 `ChromeControl` 紧密配合，共同构成了AI与浏览器进行深度、自主交互的完整闭环。 ### 环境感知与信息获取 - **WeatherReporter (static)**: 提供实时天气信息，含预警、小时详情、多日预报。注入天气预警信息。 - **TavilySearch (synchronous)**: 集成 Tavily API，赋予 AI 网络搜索能力。 - **V日报 (static)**: 通过 `{{VCPDailyHot}}` 占位符提供全球热点新闻。它会从全球100个热门门户网站各抓取20条热点，提供总计约2000条全球热点摘要及原文URL。建议构建专门的“记者”或“新闻官”Agent来管理此信息流，并通过 `AgentAssistant` 插件封装，以便其他Agent可以向其查询最新动态。 - **UrlFetch (synchronous)**: 经过重构的强大网页抓取工具，支持多种抓取模式以应对不同场景。核心能力包括： - **直接抓取 (direct)**: 适用于简单、静态的网页内容获取。 - **Puppeteer 模式 (puppeteer)**: 在独立的浏览器环境中执行抓取，内置了反爬虫和反验证码机制，能有效应对动态加载和需要复杂交互的网站。 - **真实浏览器模式 (chrome)**: 通过与 `ChromeObserver` 插件联动，直接利用用户当前打开的真实浏览器标签页进行内容抓取，能完美复现用户登录状态和浏览器环境。 - **网页快照**: 支持在抓取内容的同时，对页面进行截图并以 Base64 格式返回，为 AI 提供了“所见即所得”的视觉上下文。 ### 神秘学与娱乐 - **TarotDivination (synchronous)**: - **作用**: 提供一个高度复杂的、基于“世界状态”的塔罗牌占卜功能。这不仅仅是一个随机抽牌工具，而是一个能模拟“天人感应”的占卜引擎。 - **核心能力**: - **动态权重抽牌**: 插件会综合考量当前的**天气**（晴雨、温湿度）、**时间**（昼夜）、**月相**（阴晴圆缺）以及**中国农历**（节气、节日）等多种“宇宙变量”，为78张塔罗牌动态计算“出现权重”。在阳光明媚的节日里，“太阳”、“恋人”等积极牌更容易被抽到；而在风雨交加的深夜，“高塔”、“宝剑十”的出现概率则会提升。 - **动态逆位概率**: 对于每一张被抽出的牌，插件还会根据上述所有环境因素，独立计算一个**动态的逆位概率**。例如，在不利的环境下，“倒吊人”的逆位概率可能会显著高于在有利环境下的概率。 - **宿命论种子**: 所有的随机性（包括牌的抽取顺序和正逆位）都源于一个由当前所有“宇宙变量”共同生成的、独一无二的“命运种子”。这确保了在特定时空下的每一次占卜结果都是唯一且确定的。 - **结果透明化**: 占卜结果会清晰地展示所有影响此次牌局的环境因素，以及每张牌最终的“逆位倾向”百分比，让用户能直观地感受到“天时地利”是如何影响牌面的。 ### 学术文献获取 - **ArxivDailyPapers (static)**: 从 Arxiv API 获取每日最新研究论文，涵盖物理学、数学、计算机科学等领域。通过占位符 `{{ArxivDailyPapersData}}` 提供论文数据。 - **CrossRefDailyPapers (static)**: 从 CrossRef API 获取每日最新研究论文，提供已发表学术文献的元数据。通过占位符 `{{CrossRefDailyPapersData}}` 提供论文数据。 ### 多模态处理与内容生成 - **ImageProcessor (messagePreprocessor)**: 自动将用户消息中的图像数据（如 Base64）转译为文本描述或多模态输入部件，支持缓存和图床 URL 标注。 - **FluxGen (synchronous)**: 集成 SiliconFlow API 实现高质量文生图。图片除保存至本地外，其 Base64 数据也可直接返回给 AI，使其能“看到”自己生成的作品。 - **Wan2.1VideoGen (asynchronous)**: (异步插件) 集成 SiliconFlow Wan2.1 API 实现文生视频和图生视频。AI提交任务后会立即收到任务ID，视频在后台生成，完成后通过WebSocket通知用户结果。返回结果中可包含视频文件的 Base64 数据，让 AI 能直接“审阅”视频内容。 - **SunoGen (synchronous)**: 集成 Suno API 生成原创歌曲。生成的音频文件同样可以 Base64 形式返回，供 AI 直接“聆听”和评估。 - **DoubaoGen (synchronous)**: 使用豆包 API 进行图像生成与编辑。生成的图片结果也能以 Base64 格式返回给 AI。 ### 核心记忆与知识管理 - **DailyNoteGet (static)**: 定期读取所有角色日记，通过 `{{AllCharacterDiariesData}}` 注入，支持 `[角色名日记本内容为空或未从插件获取]` 的解析，构建公私域知识库。 - **DailyNoteWrite (synchronous)**: AI 主动写入结构化日记，支持标签、角色名、日期。 - **DailyNoteManager (synchronous)**: AI 驱动的知识库整理、维护、检查与共享助手，实现 VCP 记忆的无限进化与公共知识库的快速构建。 - **DailyNoteEditor (synchronous)**: 智能 AI 知识库编辑器，允许 AI 自我修正和完善知识库内容。 ### Agent 协同与系统增强 - **AgentAssistant (synchronous)**: Agent 间标准通讯协议插件，支持基于各自知识库的互助式连续交流、消息群发、文件传递（通过服务器 WebDAV）、任务分发等，实现复杂异步工作流。**该插件已率先支持标准化的定时任务调度模块**，允许 AI Agent 安排在未来的特定时间点向另一个 Agent 发送消息，为实现“未来代办”或“延迟任务”提供了范例。甚至可以基于全新的`WebSocketServer.js` 向其它VCP服务器的Agent联络。 - **AgentMessage (synchronous)**: 允许 AI 通过 WebSocket 向用户前端发送格式化消息。AI 提供接收者名称和内容，插件格式化后，`server.js` 根据其清单中的 `webSocketPush` 配置，通过统一的 `WebSocketServer.js` 推送给指定类型的客户端。 - **VCPLog (service)**: 基于 WS/WSS 的服务器推送通知服务。其核心功能是记录 VCP 工具调用的文件日志。相关的 WebSocket 推送（VCP 调用信息、连接状态等）由 `server.js` 主动发起，通过统一的 `WebSocketServer.js` 定向广播给订阅了 `'VCPLog'` 客户端类型的客户端。 - **VCPInfo (service)**: 新增的流式信息推送服务。与 `VCPLog` 关注工具调用的最终日志不同，`VCPInfo` 专注于实时、流式地推送**每个插件在工作流程中的具体步骤和状态**。例如，一个文生图插件在执行时，`VCPInfo` 会依次推送“开始处理提示词”、“正在连接模型API”、“图片生成中”、“正在编码为Base64”等一系列实时状态更新。这为前端实现更精细、更透明的任务进度展示提供了强大的支持。 - **EmojiListGenerator (static)**: 扫描表情包文件夹生成列表，供 `xx表情包列表不可用` 使用。 - **ImageServer (service)**: 提供带密钥认证的静态图床服务。 - **FileServer (service)**: 提供与图床服务机制完全一致的通用文件服务。它将项目根目录下的 `file/` 文件夹以及 `image/` 目录下的特定子文件夹（如 `doubaogen`, `fluxgen`）映射到统一的、受密码保护的URL路径下，供AI访问。 - **FileListGenerator (static)**: 这是一个辅助 `FileServer` 的静态插件。它会定时扫描所有由 `FileServer` 服务的目录，生成一个完整的、包含目录层级结构的文件列表，并通过 `{{VCPFileServer}}` 占位符注入到AI的上下文中。这个列表不仅让AI知道有哪些文件可用，还附带了如何构建文件访问URL的说明和示例。 ### 专业工具集成 - **SciCalculator (synchronous)**: 提供科学计算能力，支持数学函数、统计和微积分。 ### 插件加载方式 ## 加载插件的方式 * **直接在系统提示词定义如下字段即可，系统工具列表：{{VCPFluxGen}} {{VCPSciCalculator}}……** ## 前端示例 ![示例图片1](示例1.jpg) ![示例图片2](示例2.jpg) ![示例图片3](示例3.jpg) ![示例图片3](示例4.jpg) ```mermaid graph TD A[莱恩主人] -- 复杂指令/请求 --> B(VCP女仆通讯器) subgraph 女仆团协作 B -- 分配任务给女仆A --> C(女仆A) B -- 分配任务给女仆B --> D(女仆B) B -- 分配任务给女仆N --> E(女仆N) C -- 调用工具1请求 --> F[VCP工具1] D -- 调用工具2请求 --> G[VCP工具2] E -- 调用工具N请求 --> H[VCP工具N] F -- 异步返回结果 --> C G -- 异步返回结果 --> D H -- 异步返回结果 --> E end C -- 任务完成/结果 --> B D -- 任务完成/结果 --> B E -- 任务完成/结果 --> B B -- 整合结果 --> I[整合结果] I -- 汇报/呈现 --> A ``` ## 7. 前端交互示例 VCP 的设计哲学之一是“不受前端交互束缚”，这意味着它可以与多种类型的前端应用配合。以下是一些交互场景的示意图。 ### VCP赋能下的“AI女仆团”协同工作流 ```mermaid graph TD A[莱恩主人] -- "复杂指令/宏大愿景 (e.g., 为小爱制作一部出道MV!)" --> B(VCP 女仆通讯与任务调度核心) subgraph "AI 女仆团 (基于VCP协同进化)" B -- "规划与分解任务" --> BA(AI总指挥-小爱) BA -- "歌词创作指令" --> C("女仆A-小诗: Gemini Pro驱动, 擅长文学") BA -- "作曲编曲指令" --> D("女仆B-小曲: Gemini Pro驱动, 调用SunoGen") BA -- "视觉设计与素材生成指令" --> E("女仆C-莱兔云: Gemini Flash驱动, SDXL大师, 调用FluxGen/ComfyUI插件") BA -- "字幕特效与时间轴制作指令" --> F("女仆D-小K: Gemini Flash驱动, 调用LyricAnimator") BA -- "知识库支持与信息检索" --> G("女仆E-小知: Gemini Pro驱动, 调用TavilySearch, DailyNoteManager") BA -- "任务进度汇总与最终剪辑指导" --> H("女仆F-小统: Gemini Pro驱动, 调用视频编辑插件接口") C -- "原创歌词" --> BA D -- "音乐小样 (多版本)" --> BA E -- "MV视觉素材 (大量图片/短视频)" --> BA F -- "特效字幕序列" --> BA G -- "相关背景资料/用户偏好" --> BA subgraph "VCP 核心服务支撑" MEM_PUB["公共知识库 (女仆团共享经验)"] MEM_PRI["个体记忆库 (各女仆专属日记)"] TOOL_HUB["VCP插件中心 (各类工具)"] VCP_COMM["VCP内部通信协议 (AgentAssistant)"] WSS_SVC["统一WebSocket服务 (WebSocketServer.js)"] end BA -- "通过WSS_SVC接收AgentMessage" --> WSS_SVC C <--> MEM_PRI D <--> TOOL_HUB E <--> MEM_PUB E <--> TOOL_HUB F <--> TOOL_HUB G <--> MEM_PUB G <--> TOOL_HUB H <--> TOOL_HUB BA -- "(通过VCP_COMM与其他女仆持续沟通协调)" --> C BA -- "(通过VCP_COMM与其他女仆持续沟通协调)" --> D BA -- "(通过VCP_COMM与其他女仆持续沟通协调)" --> E BA -- "(通过VCP_COMM与其他女仆持续沟通协调)" --> F BA -- "(通过VCP_COMM与其他女仆持续沟通协调)" --> G BA -- "(通过VCP_COMM与其他女仆持续沟通协调)" --> H end BA -- "整合各环节成果, 形成MV初步方案" --> B B -- "(可能有人类指挥官莱恩的阶段性评审与反馈)" --> BA H -- "最终剪辑版MV (或项目文件)" --> B B -- "将最终成果呈现给" --> A ``` ## 8. 安装与运行 (主服务器) ### 克隆项目 ```bash git clone https://github.com/lioensky/VCPToolBox.git cd VCPToolBox ``` ### 安装主依赖 (Node.js) ```bash npm install ``` ### 安装 Python 插件依赖 在项目根目录下运行 (确保你的 Python 环境已配置好 pip): ```bash pip install -r requirements.txt ``` (注意: 各 Node.js 插件的依赖已包含在主 `package.json` 中，或在其各自插件目录的 `package.json` 中通过 `npm install` 单独安装。) ### 配置 - 复制 `config.env.example` 为 `config.env`，并根据说明填写所有必要的 API 密钥、URL、端口等信息。这是 VCP 正常运行的关键。 - 检查并配置各插件目录下的 `.env` 文件（如果存在）。 ### 启动服务器 ```bash node server.js ``` 服务器将监听在 `config.env` 中配置的端口。 ### 使用 Docker Compose 运行 (推荐) 为了简化部署和管理，强烈推荐使用 Docker Compose。 - **前提条件**: 安装 Docker 和 Docker Compose。 - **配置**: 同上，确保 `config.env` 文件已正确配置。Docker Compose 会自动加载此文件中的环境变量。 - **构建并启动服务**: ```bash docker-compose up --build -d ``` - **查看日志**: `docker-compose logs -f` - **停止服务**: `docker-compose down` ## 9. 部署 VCP 分布式节点 我们提供了一个开箱即用的分布式服务器项目 `VCPDistributedServer`，让您可以轻松地将任何一台机器变成 VCP 网络中的一个算力节点。 ### 步骤 1. **复制项目**: 将主项目根目录下的 `VCPDistributedServer` 文件夹完整地复制到您想部署节点的任何机器上。 2. **安装依赖**: 在 `VCPDistributedServer` 目录下，运行 `npm install`。 3. **配置节点**: - 打开 `VCPDistributedServer/config.env` 文件。 - `Main_Server_URL`: 填入您的**主服务器**的 WebSocket 地址 (例如 `ws://<主服务器IP>:8088`)。 - `VCP_Key`: 填入与您主服务器 `config.env` 中完全一致的 `VCP_Key`。 - `ServerName`: 为这个节点起一个易于识别的名字。 4. **添加插件**: - 在 `VCPDistributedServer` 目录下创建一个名为 `Plugin` 的文件夹。 - 将您想在这个节点上运行的 VCP 插件（例如 `SciCalculator`, `FluxGen` 等）完整地从主项目复制到这个新的 `Plugin` 文件夹中。 - **注意**: 目前分布式节点仅支持 `synchronous` (同步) 类型的 `stdio` 插件。 5. **启动节点**: ```bash node VCPDistributedServer.js ``` 启动后，该节点会自动连接到主服务器并注册其插件。您将在主服务器的控制台看到相关日志。 ## 10. 推荐的前端/后端 - **后端 AI 模型 API**: 推荐使用支持 SSE (Server-Sent Events) 流式输出且 API 格式相对标准化的服务，且本服务器对API高并发，API多模型封装有硬性要求。尤其推荐如 NewAPI, VoAPI 这样的聚合服务端,其次是类似OpenRouter这样的API聚合商, 以及官方的 OpenAI, Google Gemini, Anthropic Claude 等API服务商。VCP 的设计使其能够灵活适配多种后端。 - **前端交互应用**: 推荐使用能够良好渲染 Markdown、支持代码高亮、并且能够自定义或适配 VCP 工具调用指令显示的前端。例如：VCPChat(官方项目，首选！), Sillytavern, CherryStudio客户端等。理想的前端还应允许用户方便地配置系统提示词，以便充分利用 VCP 的变量替换和插件指令描述注入功能。前端还应能连接到 `WebSocketServer.js` 提供的 WebSocket 服务，以接收服务器推送的各类消息（如 VCP 日志、AgentMessage 等）。 - **官方前端·VCPChat项目地址**：https://github.com/lioensky/VCPChat ## 11. 开发者指南：创建你的“VCP次时代插件” VCP 的灵魂在于其插件生态。成为 VCP 插件开发者，意味着你将直接为 AI Agent 创造新的“感官”、“肢体”和“智慧模块”。 [插件开发手册](同步插件开发手册.md) | - **创建插件目录**: 在 `Plugin/` 目录下新建文件夹，如 `Plugin/MySuperPlugin/`。 - **编写插件清单 (`plugin-manifest.json`)**: 这是插件的“身份证”和“说明书”。 - **核心字段**: `name`, `displayName`, `version`, `description`, `pluginType` (值可以是: `static`, `messagePreprocessor`, `synchronous`, `asynchronous`, `service`)。 - **执行入口**: `entryPoint` (如执行脚本的命令 `python script.py` 或 `node script.js`) 和 `communication` (如 `protocol: "stdio"` 表示通过标准输入输出通信)。 - **配置蓝图 (`configSchema`)**: 声明插件所需的配置项及其类型、默认值、描述。这些配置将通过 `_getPluginConfig` 方法合并全局和插件专属 `.env` 配置后传递给插件。 - **能力声明 (`capabilities`)**: - **static 插件**: 定义 `systemPromptPlaceholders` (插件提供的占位符，如 `{{MyWeatherData}}`)。 - **synchronous` 或 `asynchronous` 插件**: 定义 `invocationCommands`。每个命令包含: - `command` (内部识别名，例如 "submit", "query")。 - `description` (至关重要: 给 AI 看的指令描述，支持在管理面板编辑)。应包含： - 清晰的功能说明。 - 详细的参数列表（名称、类型、是否必需、可选值范围）。 - 明确的 VCP 调用格式示例 (AI 将模仿此格式)。 - **对于 `synchronous` 插件**: 成功/失败时返回的 JSON 格式示例 (AI 需要理解插件的直接输出)。 - **对于 `asynchronous` 插件**: 插件**初始响应**的 JSON 格式示例（例如，包含任务ID），以及通过 WebSocket 推送的**最终结果**的格式示例。 - 任何与用户沟通或AI决策相关的重要提示（例如，对于异步插件，提示用户任务已提交，结果将稍后通知）。 - `example` (可选，提供一个更具体的调用场景示例)。 - **WebSocket 推送配置 (`webSocketPush`) (可选, 主要用于 `asynchronous` 插件的回调结果推送，也可用于 `synchronous` 插件的直接结果推送)**: - 如果你的插件执行成功后，希望将其结果通过 WebSocket 推送给客户端，可以在 `plugin-manifest.json` 的顶层添加此对象。 - `enabled` (boolean,必需): `true` 表示启用推送。 - `usePluginResultAsMessage` (boolean, 可选, 默认 `false`): - 若为 `true`: - 对于 `synchronous` 插件：插件的直接标准输出结果（通常是一个 JSON 对象）的 `result` 字段（如果该字段是对象）将直接作为 WebSocket 消息体发送。插件应确保其 `result` 字段是一个符合前端期望的完整消息对象。 - 对于 `asynchronous` 插件：通过 `/plugin-callback` 发送的 JSON 数据本身将直接作为 WebSocket 消息体发送。插件回调时应确保发送的数据是一个符合前端期望的完整消息对象。 - 若为 `false` 或未提供，则需要同时提供 `messageType`。 - `messageType` (string, 可选): 当 `usePluginResultAsMessage` 为 `false` 时使用。 - 对于 `synchronous` 插件：服务器会将插件标准输出的 `result` 字段包装成 `{ type: "yourMessageType", data: pluginResult.result }` 的形式发送。 - 对于 `asynchronous` 插件：服务器会将通过回调接收到的 JSON 数据包装成 `{ type: "yourMessageType", data: callbackData }` 的形式发送。 - `targetClientType` (string, 可选, 默认 `null`): 指定接收此消息的客户端类型。`WebSocketServer.js` 会根据此类型筛选客户端。如果为 `null` 或未提供，则可能广播给所有连接的客户端或特定默认类型的客户端（取决于 `WebSocketServer.js` 的实现）。例如，`VCPLog` 用于向日志查看器推送。 - **实现插件逻辑**: - 根据 `pluginType` 和 `entryPoint` 实现主逻辑脚本 (Node.js, Python, Shell 等皆可)。 - **stdio 插件** (常用于 `synchronous`, `asynchronous` 和部分 `static`): - 从标准输入 (`stdin`) 读取数据 (通常是 JSON 字符串形式的参数)。 - **对于 `synchronous` 插件**: 通过标准输出 (`stdout`) 返回最终结果，必须遵循以下 JSON 格式: ```json { "status": "success" | "error", "result": "成功时返回的字符串内容或JSON对象", "error": "失败时返回的错误信息字符串", "messageForAI": "可选，给AI的额外提示信息", "base64": "可选，返回的Base64编码数据 (如图片、音频)" } ``` 如果配置了 `webSocketPush.usePluginResultAsMessage: true`，这里的 `result` 字段（如果是个对象）会被直接用于 WebSocket 推送。 - **对于 `asynchronous` 插件**: 1. **初始响应**: 插件脚本在收到任务后，**必须立即**向标准输出 (`stdout`) 打印一个符合上述 JSON 格式的初始响应。例如： ```json { "status": "success", "result": { "requestId": "unique_task_id_123", "message": "任务已提交，正在后台处理中。" }, "messageForAI": "视频生成任务已提交，ID为 unique_task_id_123。请告知用户耐心等待，结果将通过通知推送。" } ``` `Plugin.js` 会捕获这个初始响应并返回给AI。 2. **后台处理**: 插件脚本随后启动其耗时的后台任务（例如，使用非守护线程）。 3. **回调服务器**: 后台任务完成后，插件脚本通过向 VCP 服务器的 `/plugin-callback/:pluginName/:taskId` (其中 `:pluginName` 是插件名，`:taskId` 是初始响应中返回的 `requestId`) 发送 HTTP POST 请求。请求体应为一个 JSON 对象，包含任务的最终结果。例如： ```json // 回调时发送给服务器的JSON数据示例 { "requestId": "unique_task_id_123", "status": "Succeed", // 或 "Failed" "pluginName": "MyAsyncPlugin", // 插件名，用于服务器确认 "videoUrl": "http://example.com/video.mp4", // 任务成功时的结果字段 "reason": "如果失败，这里是原因", "message": "视频 (ID: unique_task_id_123) 生成成功！" // 给用户的消息 } ``` 服务器接收到这个回调后，会根据插件清单中的 `webSocketPush` 配置，将这个回调的JSON数据（或其一部分）推送给客户端。 - 对于主要用于更新占位符的 `static` 插件，如果逻辑简单，可以直接输出占位符的值（非 JSON）。但推荐使用上述 JSON 格式以支持更复杂的通信或错误报告。 - 标准错误 (`stderr`) 可用于输出调试信息，这些信息不会被 `Plugin.js` 作为主要结果捕获。 - 确保所有标准输出和标准输入的文本都使用 UTF-8 编码。 - **Node.js 类型插件** (如 `messagePreprocessor`, `service`, 或复杂的 `static`/`synchronous`/`asynchronous` 且 `communication.protocol` 为 `direct`): - 导出一个符合 `PluginManager` 约定的模块 (例如，包含 `initialize`, `processMessages`, `registerRoutes`, `execute`, `getStaticData` 等方法)。参考现有插件实现。 - **配置与依赖**: - **插件专属配置**: 在插件目录下创建 `.env` 文件。 - **依赖管理**: Python 插件使用 `requirements.txt`；Node.js 插件使用 `package.json`。确保依赖已安装。 - **重启 VCP 服务器**: `PluginManager` 会在启动时自动发现并加载新插件。 - **更新系统提示词，赋能 AI**: - 利用 `{{VCPMySuperPlugin}}` (由 `PluginManager` 根据 `plugin-manifest.json` 的 `invocationCommands` 自动生成，包含所有命令描述和调用示例) 将新插件的能力告知 AI。 - 或者，在系统提示词中更详细、更具引导性地描述如何以及何时使用你的新插件。 - **思考**: 如何设计插件的 AI 指令描述，才能让 AI 最容易理解、最不容易误用？这是插件开发的关键一环。 ## 12. VCP 通用变量占位符：动态上下文注入的艺术 VCP 的变量替换系统是其实现动态上下文注入和 AI 行为精细调控的基石。 ### 核心系统变量 ## 支持的通用变量占位符 (此处可以列出 `README.md` 中已有的变量列表，确保与实际代码一致) * `{{Date}}`: 当前日期 (格式: YYYY/M/D)。 * `{{Time}}`: 当前时间 (格式: H:MM:SS)。 * `{{Today}}`: 当天星期几 (中文)。 * `{{Festival}}`: 农历日期、生肖、节气。 * `{{VCPWeatherInfo}}`: 当前缓存的天气预报文本 (由 `WeatherReporter` 插件提供)。 * `{{VCPDailyHot}}`: (由 V日报 插件提供) 提供全球热点新闻。包含从全球上百个门户网站聚合的热点摘要与URL链接。 * `{{角色名日记本}}`: 特定角色（如 `小克`）的完整日记内容。数据来源于 `DailyNoteGet` 插件提供的 `{{AllCharacterDiariesData}}`。 * `{{公共日记本}}`: 共享知识库的完整日记内容。数据来源于 `DailyNoteGet` 插件提供的 `{{AllCharacterDiariesData}}`。 * `{{AllCharacterDiariesData}}`: (由 `DailyNoteGet` 插件提供) 一个 JSON 字符串，解析后为包含所有角色日记内容的对象。服务器内部使用此数据来支持 `{{角色名日记本}}` 的解析。 * `{{xx表情包}}`: 特定表情包（如 `通用表情包`）的图片文件名列表 (以 `|` 分隔)。数据由 `EmojiListGenerator` 插件生成列表文件，服务器加载到内存缓存后提供。 * `{{Port}}`: 服务器运行的端口号。 * `{{Image_Key}}`: (由 `ImageServer` 插件配置提供) 图床服务的访问密钥。 * `WhitelistImageModel`: (例如 `gemini-pro-vision`) 在此定义的模型将被特殊路由处理，用于图像生成等任务。 * `WhitelistEmbeddingModel`: (例如 `text-embedding-ada-002`) 在此定义的模型将被特殊路由处理，用于向量化等任务，其请求和响应将被原样转发。 * `{{Tar*}}`: (例如 `{{TarSysPrompt}}`, `{{TarEmojiPrompt}}`) 用户在 [`config.env`](config.env.example:1) 中定义的以 `Tar` 开头的自定义变量。这类变量拥有最高替换优先级，在所有其他占位符（包括 `{{Sar*}}`, `{{Var*}}`, 日期/时间等）之前被处理。其主要优势在于它们的值可以包含其他占位符，这些嵌套的占位符会在后续的替换阶段被进一步解析。这使得 `{{Tar*}}` 非常适合用于定义复杂和多层次的系统提示词模板。例如：`TarSysPrompt="今天是{{Date}}, 现在是{{Time}}, 天气{{VCPWeatherInfo}}。"` * `{{Var*}}`: (例如 `{{VarNeko}}`) 用户在 [`config.env`](config.env.example:1) 中定义的以 `Var` 开头的自定义变量。VCP 会按顺序对所有 `Var` 定义进行全局匹配和替换。如果多个 `Var` 定义匹配到同一文本，后定义的 `Var` 会覆盖先定义的 `Var`。因此，建议将较长或更精确的 `Var` 定义放在前面，较短或通用的 `Var` 定义放在后面，以确保预期的替换效果。例如，如果您定义了 `{{VarUser}}` 和 `{{VarUsername}}`，应将 `{{VarUsername}}` 定义在 `{{VarUser}}` 之前，以避免 `{{VarUsername}}` 被错误地替换为 `{{VarUser}}name`。 * `{{Sar*}}`: (例如 `{{SarThink}}`, `{{SarVoice}}`) 针对特定模型的条件化变量。与 `Var*` 不同，`Sar*` 的注入逻辑由 `config.env` 中成对的 `SarModelX` 和 `SarPromptX` 变量控制（X为数字，如1, 2, 3...）。 - **配置方式**: - `SarModelX=model-name-1,model-name-2`: 定义一个或多个模型名称（用逗号分隔），这些模型将共享同一个提示词。 - `SarPromptX="提示词内容"`: 定义与 `SarModelX` 对应的提示词内容。 - **工作机制**: 当服务器处理请求时，会检查当前请求的 `model` 是否在任何一个 `SarModelX` 列表中。 - 如果找到匹配，服务器会将对应的 `SarPromptX` 的值替换掉上下文中的 **所有** `{{Sar*}}` 占位符（无论 `*` 是什么）。 - 如果没有找到匹配，上下文中的所有 `{{Sar*}}` 占位符都会被移除（替换为空字符串）。 - **应用场景**: 这允许为不同（或某几类）的 AI 模型注入完全不同的、定制化的指令或行为偏好，实现更精细的模型适配。例如，可以为一个模型注入思考链提示，为另一个模型注入语音交互优化提示。 * `{{VCPAllTools}}`: 一个特殊的占位符，当被解析时，它会被替换为所有当前已加载且具有调用指令描述的 VCP 工具的完整描述和调用示例的集合。各个工具的描述之间会用分隔符隔开，方便AI全面了解可用工具。 * `{{ShowBase64}}`: 当此占位符出现在用户消息或系统提示词中时，`ImageProcessor` 插件将被跳过，Base64数据将直接发送给Model。 * `{{VCPWeaherInfo}}`: 由WeatherReporter提供的占位符，提供完整的天气预警，24小时精准天气，7日天气预报。 * `{{ArxivDailyPapersData}}`: (由 `ArxivDailyPapers` 插件提供) 一个 JSON 字符串，包含从 Arxiv 获取的最新研究论文列表。 * `{{CrossRefDailyPapersData}}`: (由 `CrossRefDailyPapers` 插件提供) 一个 JSON 字符串，包含从 CrossRef 获取的最新研究论文列表。 * `{{VCP_ASYNC_RESULT::PluginName::RequestId}}`: (由异步插件在初始响应中引导AI使用，并由服务器动态替换) 这是一个特殊格式的占位符，用于在AI的对话上下文中“订阅”一个异步任务的最终结果。 - `PluginName`: 异步插件的名称 (与 `plugin-manifest.json` 中的 `name` 一致)。 - `RequestId`: 该异步任务的唯一ID (通常由插件在初始响应中提供，并用于回调和结果文件命名)。 - **工作机制**: 当异步插件完成并通过回调将其结果保存到服务器的 `VCPAsyncResults/PluginName-RequestId.json` 文件后，`server.js` 在处理包含此占位符的文本时（例如，在AI生成回复前处理上下文，或在AI回复发送给用户前处理回复内容），会读取对应的结果文件。如果文件存在，占位符会被替换为文件中的实际结果信息（通常是回调JSON中的 `message` 字段或一个格式化的成功/失败摘要）。如果结果文件尚不存在（任务仍在处理中），占位符会被替换为一个“结果待更新”的提示。这使得AI能够在后续交互中“看到”或在其回复中体现异步任务的最终状态，实现了AI对异步结果的即时感知和自然融入对话流。 ### 插件与配置驱动变量 ### 用户自定义变量 (定义于 `config.env`) - **`Agent{{*}}`**: 变量基座。其值可以包含富文本和其他占位符，实现绝对的模板定义。非常适合用于构建角色模板。其中的所有 `Tar`、`Var`/`Sar`等占位符都会被依次转译。 - **`{{Tar*}}`, `{{Var*}}`, `{{Sar*}}`**: 这些自定义变量现在支持从外部 `.txt` 文件加载内容，极大地增强了管理长文本、富文本和结构化提示词的能力。 - **使用方法**: 在 `config.env` 中，将变量的值设置为一个 `.txt` 文件名，例如 `VarMyPrompt=my_prompt.txt`。 - **文件位置**: 服务器会自动在根目录下的 `TVStxt/` 文件夹中寻找并读取该文件的内容作为变量值。 - **嵌套解析**: 文件内容本身也可以包含其他 VCP 占位符，服务器会进行递归解析。 - **`{{Tar*}}`**: 最高优先级。其值可以包含其他占位符，实现复杂、多层次的模板定义。非常适合用于构建模块化的系统提示词。 - **`{{Var*}}`**: 通用自定义变量，按定义顺序进行全局匹配和替换。 - **`{{Sar*}}`**: 特殊自定义变量，通过 `SarModelX`/`SarPromptX` 对进行配置，其生效与否会根据当前使用的 AI 模型进行判断，允许为不同模型配置特定值。 ## 13. 系统提示词工程：VCP 环境下的 AI 指挥艺术 在 VCP 环境下，系统提示词 (System Prompt) 不再仅仅是简单的角色扮演指令，它成为了指挥 AI Agent 如何感知世界、思考问题、运用工具、管理记忆、以及与其他 Agent 协作的“总纲领”和“行为逻辑注入器”。 以下是一个利用 VCP 特性（尤其是 `Tar*` 变量和插件占位符）构建模块化、动态化、功能强大的系统提示词的示例： ### 首先，在 `config.env` 中定义基础 `Tar*` 模块 ```plaintext # config.env 文件中的示例 Tar 变量定义 # Agent专用配置目录 AgentNova=Nova.txt # 前置系统变量 TarSysPrompt="{{VarTimeNow}}当前地址是{{VarCity}},当前天气是{{VCPWeatherInfo}}。" TarEmojiPrompt='本服务器支持表情包功能，通用表情包图床路径为{{VarHttpUrl}}:5890/pw={{Image_Key}}/images/通用表情包，注意[/通用表情包]路径指代，表情包列表为{{通用表情包}}，你可以灵活的在你的输出中插入表情包，调用方式为,使用Width参数来控制表情包尺寸（50-200）。' # VCP类，可以使用{{VCPAllTools}}定义，亦可以自定义。 VarToolList="文生图工具{{VCPFluxGen}} 计算器工具{{VCPSciCalculator}},联网搜索工具{{VCPTavilySearch}},网页获取工具{{VCPUrlFetch}}；看b站视频工具{{VCPBilibiliFetch}}；使用Suno唱歌工具{{VCPSunoGen}},联络别的AI工具{{VCPAgentAssistant}},给用户的手机/电脑发消息工具{{AgentMessage}}。" ``` ### 然后，在实际传递给 AI 模型的系统提示词中组合这些 `Tar*` 模块,以下是一个标准的系统提示词示例用于测试。 ```plaintext {{Nova}}{{VCPTavern::dailychat}}{{ShowBase64}} ``` ### 这种模块化、基于变量的系统提示词工程具有以下优势 - **清晰性与可维护性**: 将复杂的提示词分解为逻辑清晰的模块，易于理解、修改和扩展。 - **动态性与情境感知**: 通过动态变量，使 AI 的“初始认知”与当前真实环境和历史记忆保持一致。 - **能力全面注入**: 通过工具占位符，确保 AI 始终了解其可用的全部工具及其最新用法。 - **行为引导**: 通过精心设计的 `Tar*` 模块，可以精确引导 AI 的行为模式、沟通风格、以及与 VCP 各核心系统的交互方式。 - **高度可定制**: 用户可以根据具体需求，灵活组合或修改这些 `Tar*` 模块，快速定制出适用于不同场景、不同 AI Agent 的系统提示词。 精通 VCP 环境下的系统提示词工程，是释放 AI Agent 全部潜能、实现“AI 指挥艺术”的关键。 ## 14. 未来展望：通往更高级 AI Agent 的路径 VCP 的征程远未结束，我们对未来充满期待，并已规划了更激动人心的发展方向： - **增强的插件间协作与插件内工作流**: 实现插件间更高效的数据流转和事件通信，甚至在复杂插件内部构建“微型VCP”来编排子模块，支持更细粒度的自动化任务分解。 (已实现) - **深化的 Agent 间自主通信与协同智能**: 建立标准化的 Agent 间通信总线 (ACB) 和协作原语，支持 AI Agent 动态组队、自主协商、角色分配，从“人类指挥-AI执行”演进为“AI自主团队协作”。 (已实现) - **赋予 AI Agent 主动交互与实时通知能力**: 构建 VCP 内部事件总线与触发器，允许 AI Agent 在满足特定条件时（如日程提醒、任务完成、外部事件）主动向用户、其他 Agent 或外部系统发起通信或执行动作，从“被动响应者”进化为具有“主动服务意识”的智能伙伴。 (已实现 `AgentMessage` 和 `WebSocketServer`，为主动通知打下基础) - **持续研发与实现“深度情境记忆回溯机制”**: 如 `VCP.md` 中所述，通过“日记条目指纹匹配完整聊天历史”并结合“AI 中间件与信息传播链分析”，实现 AI 对其记忆产生时的完整背景和微妙上下文的“深度回溯”理解。 - **构建繁荣的插件生态与开发者社区**: 完善文档、API、工具，积极建设社区，吸引更多开发者共同扩展 VCP 的能力边界。 - **对 AI 伦理、安全与可控性的不懈追求**: 随着 AI Agent 自主行动能力的增强，我们将持续投入研究更全面的权限管理、行为审计、风险评估和应急干预机制。 我们坚信，VCP 所代表的设计哲学和技术路径，正引领着一条通往更智能、更自主、更具适应性和协作性的高级 AI Agent 未来的光明大道。VCP 不仅是一个技术框架，更是一个旨在释放 AI 无限潜能、并最终为人类社会发展做出独特贡献的孵化器。 ## 15. 许可证 (License) 本项目采用 **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)** 许可证。 简单来说，这意味着您可以： - **共享** — 在任何媒介以任何形式复制、发行本作品。 - **演绎** — 修改、转换或以本作品为基础进行创作。只要你遵守许可协议条款，许可人就无法收回你的这些权利。 惟须遵守下列条件： - **署名 (BY)** — 您必须给出适当的署名，提供指向本许可的链接，同时标明是否（对原始作品）作了修改。您可以用任何合理的方式来署名，但是不得以任何方式暗示许可人为您或您的使用背书。 - **非商业性使用 (NC)** — 您不得将本作品用于商业目的。 - **相同方式共享 (SA)** — 如果您再混合、转换或者基于本作品进行创作，您必须基于与原先许可协议相同的许可协议分发您贡献的作品。 详情请参阅 `LICENSE` 文件。 ## 16. 免责声明与使用限制 - **开发阶段**: 本 VCP 工具箱项目目前仍处于积极开发阶段，可能存在未知错误、缺陷或不完整功能。 - **按原样提供**: 本项目按“原样”和“可用”状态提供，不附带任何形式的明示或暗示保证。 - **风险自负**: 使用本项目的风险完全由您自行承担。开发者不承担任何因使用或无法使用本项目而导致的直接或间接损害。 - **无商业化授权**: 明确禁止将本项目及其衍生作品用于任何主要的商业目的。 - **API 使用成本**: 请注意，本项目集成的部分插件依赖于可能产生费用的第三方 API 服务。您有责任了解并承担这些成本。 - **安全责任**: 请妥善保管您的 API 密钥，切勿硬编码或提交到公共代码库。 - **隐私信息**: 再次强调，请勿使用非官方的 API 代理商或反代类 API 供应商运行本项目，以防 AI 笔记系统中的敏感信息泄露！ 我们相信， VCP 将为 AI 应用的开发带来前所未有的灵活性和可能性。欢迎一切形式的贡献、反馈与交流，让我们共同探索 AI 的未来！ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/lioensky/VCPToolBox)