back to home

lioensky / VCPChat

VChat,专为VCPToolBox设计的前端界面。一个优雅,强大的Agent聊天客户端,内置插件商店!

512 stars
124 forks
2 issues
JavaScriptCSSPython

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing lioensky/VCPChat in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/lioensky/VCPChat)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

VCPChat 聊天客户端 English | 日本語 | Русский 这是一个为 VCP (Variable & Command Protocol) 服务器打造的 AI 聊天桌面客户端。 *请立刻在全局设置里设置用户名,以避免众多依赖功能报错!* 后端链接:https://github.com/lioensky/VCPToolBox 请下载壁纸包以避免元素窗口异常:https://github.com/lioensky/VCPChat/releases 请下载音频解码包:https://github.com/lioensky/VCPChat/releases/tag/%E8%A7%A3%E7%A0%81%E5%99%A8core 安装与部署• **克隆仓库** 克隆此项目到您的本地计算机:• **安装依赖** 本项目需要 Node.js 和 Python 环境。• **安装 Node.js 依赖:**• **安装 Python 依赖** (用于音频引擎、高级插件等):• **启动应用**• **常规启动:**• **静默启动 (可选):** 您也可以使用 脚本来实现无控制台窗口的静默启动。 前后端深度协同:释放 AI 的无限潜能 VChat 不仅仅是一个聊天界面,它是强大的 VCP 后端生态(VCPToolBox)的“眼睛”和“画板”。两者深度结合,旨在释放 AI 的无限潜能:• **高级能力渲染**: VChat 专为渲染 VCP 协议的复杂输出而设计。无论是 AI 主动记录和反思的“日记”,还是多媒体内容,都能以最直观的方式呈现。Vchat的Agent输出气泡拥有近乎怪物级的渲染能力,可以渲染几乎所有主流动画和文档。• **重型异步任务**: 后端可以执行如视频生成、数据分析等耗时很长的重型任务。AI 发起任务后可立即响应用户,任务完成后,VChat 会通过后端推送,将结果(如生成的视频)实时展现在对话流中,整个过程流畅不卡顿。• **Agent 群体智能**: 后端支持多个 AI Agent 协同工作,甚至实现 Agent 主动分配任务给子 Agent。VChat 的群聊模式和清晰的发言标记系统,为这种高级的“AI 女仆团”协作流提供了完美的交互界面。• **丰富的多媒体交互**: AI 可以通过后端调用 VCP 工具,在对话中发送表情包、播放音乐、展示视频。VChat 拥有强大的多媒体渲染引擎和高级的窗口气泡动画、流式动画,确保了极致的视听体验。• **VCP 核心多模态能力**: 这使得例如 FluxGen 或 SunoGen 这样的插件生成的多媒体,AI 真的可以看到和听到。• **Base64 直通车**: 允许 AI 在 字段中直接引入 Base64 数据,极大地简化了多媒体内容的即时调用。• **全局文件 API ( v4.0 超栈追踪版)**: 实现了革命性的全URL超栈追踪。现在,AI在任何分布式节点上提交本地文件路径(如 ),主服务器都能智能解析其来源并自动向源节点请求文件的Base64数据,实现无缝的跨服务器文件调用。• **跨模态智能转译**: 实现高阶模型对低阶模型的“能力赋能”。例如,能识别音频的模型可以帮助纯文本模型,将其无法处理的音频 Base64 数据智能转译为文字描述,反哺给请求方。• **分布式多模态传输 (v4.0 核心升级)**: 借助**全 URL 超栈追踪**,任意节点上的 AI 都能直接使用本地文件路径进行跨服调用。主服务器会自动追踪并拉取数据,彻底打通了分布式网络中的文件孤岛,让多模态数据在星型网络中无缝流转。• **智能响应路由**: VCP 核心能够智能判断插件返回的是传统的 stdio 文本信息,还是包含 Base64 的结构化数据,并自动选择正确的渠道进行转发和处理。• **多 Agent 协作共享**: 在多 Agent 协同任务中,实现 Base64 数据的智能共享,并能根据需要将其动态转译为临时的 ,方便其他 Agent 或前端应用访问。 主要功能• **VCP 服务器集成**: 客户端的核心聊天功能依赖于 VCP 服务器。它通过 HTTP(S) 与 VCP 服务器通信,发送用户消息并接收 AI 的响应,支持流式传输以实现实时交互。• **VCP 工具调用**: 完美支持 VCP 服务器定义的各类工具调用,包括需要立即返回结果的**同步工具**(如计算、查询)和可后台执行的**异步工具**(如视频生成、网站长文抓取),让 AI 的能力边界无限扩展。VChat 对工具调用流程进行了深度优化,提供了更强大的交互能力:• **智能交互气泡**: 工具调用气泡经过精心设计,鼠标悬停时会自动展开,清晰展示 AI 发起的完整指令集,方便用户理解和调试。• **多样化回调机制**: 任务完成后,结果可通过多种方式通知用户:• **WebSocket 实时通知**: 适合需要即时反馈的场景。• **上下文嵌入式气泡**: 将结果无缝整合到对话流中。• **系统级多设备推送通知**: 即使用户不在应用内,也能收到重要任务的完成提醒。• **协同式指令优化**: 在执行工具调用前,AI 可以主动向用户征求意见,或邀请用户及其他 Agent 共同协作,对即将执行的指令进行修改和完善,实现了人机/多 Agent 协同决策。• **可靠的中止机制**: 当用户中止 AI 回复时,系统会同步中止正在执行的 VCP 工具调用链,并彻底终止相关的后台进程,确保资源被及时释放。• **用户端 VCP 工具调用器**:• 现在,强大的 VCP 工具不再是 AI 的专属。VChat 为用户提供了一个完整、直观的图形用户界面(GUI),让用户也能轻松调用和执行 VCP 工具。• **无需指令**: 用户无需记忆和手动输入复杂的命令,只需在 GUI 界面中选择工具、点击参数预设按钮,即可像 AI 一样利用 VCP 生态的强大能力。• **透明执行**: 调用过程和结果会清晰地展示在界面上,方便用户监控和调试。• **ComfyGen 插件面板**: 为 ComfyGen 这个强大的图像生成插件提供了丰富的管理和配置面板。这包括对工作流(Workflows)、LoRA 模型、以及其他模型文件的精细化管理。此外,它还集成了一个类似于 Stable Diffusion WebUI 的前端管理界面,允许用户和 AI 通过图形化界面,直观、精确地控制图像生成的每一个参数和内容细节,极大地提升了创作的灵活性和深度。• 这一功能打破了人与 AI 在工具使用上的界限,让用户也能成为 VCP 生态的直接参与者和创造者。• **VCP 日记渲染**: 能够渲染和显示 VCP 日记内容。这不仅是查看日志,更是观察 AI 如何形成长期记忆、实现自我进化的窗口。• **Agent 管理**:• 创建、删除和配置多个 AI Agent。• 为每个 Agent 设置名称、系统提示、模型参数(如温度、上下文Token限制、最大输出Token)。• 管理 Agent 的头像。• **自主话题管理**: Agent 现在可以感知、编辑、修改和创建自己的聊天话题列表。它们能够了解历史聊天内容,阅读特定聊天记录,或直接创建一个新话题。这在 Agent 处于后台工作并需要主动向用户发起聊天时非常有用,实现了更高级的自主交互。• 支持每个 Agent 拥有多个独立的聊天话题 (Topics),包括话题的创建、删除、重命名、排序和**导出**(支持导出为 Markdown 或 HTML 格式)。• 支持 Agent 列表的自定义排序。• **高级上下文管理 (兼容 SillyTavern)**: VChat 基于后端服务器节点实现了与 SillyTavern 高度兼容的上下文管理机制,为精细化、可复用的对话背景设定提供了强大支持。• **预设、角色卡与世界书**: 现在VCP系统完全兼容并支持挂载 SillyTavern 的 、 和 。您可以无缝导入和使用已有的 SillyTavern 资源,或在 VCP 内直接创建和管理。• **可视化预设编辑器**: 内置强大的可视化编辑器,允许您创建和编辑上下文预设。支持设置复杂的注入规则,如 和 ,精确控制每一条上下文在对话历史中的位置和行为。• **拖拽式上下文排序**: 在聊天界面中,所有注入的上下文(如系统提示、角色设定、世界信息等)都清晰可见,并支持通过 方式实时调整它们的相对顺序,直观地改变 AI 的行为优先级。• **Agent 独立挂载**: 每个 Agent 都可以独立挂载不同的预设和世界书组合。这意味着您可以为“写作助手”Agent 配置一套专业的写作背景资料,同时为“聊天伴侣”Agent 设置另一套完全不同的角色扮演设定,实现高度个性化的 AI 体验。• **群聊模式 (Agent Groups)**:• 允许多个已配置的 Agent 在同一个聊天会话中进行协作或角色扮演。• 支持创建、配置和管理 Agent 群组,包括设置群组名称、头像。• 每个群组可以包含多个从现有 Agent 列表中选择的成员。• **发言模式**:• **顺序发言 ( )**: 成员按预定顺序轮流发言(当前实现为按成员列表顺序,每次一个,具体高级轮换逻辑可后续增强)。• **自然随机 ( )**: 根据用户输入中的 、 或消息内容中与成员预设标签匹配每个Agent的关键词/描述词,来智能产生上下文权重决定哪些成员响应。此模式在构建自然权重回复序列时还保留有一定的随机性,并可能在没有明确触发时选择一个保底发言者。• **邀约模式 ( )**:根据用户点击Agent的按钮来决定谁来发言。• **群组设定 ( )**: 可以为整个群聊定义一个共同的背景、规则或系统级指令,影响群内所有 Agent 的行为。• **发言邀请 ( )**:• 这是一个模板字符串,用于在群聊中由系统(或协调者Agent)提示特定 Agent 发言。• 模板中应使用 作为占位符,系统在实际邀请时会自动将其替换为目标 Agent 的名称。• **默认 示例**: • 这个提示旨在引导 Agent 自然地开始其回合,同时告知它们关于发言标记的规则。• **发言标记系统**:• 为了在包含多个 Agent 和用户的群聊中清晰地标识每一条消息的来源,系统会自动在每条消息(无论是用户还是 Agent 的)前添加发言者标记,格式通常为 。• **重要提示**:用户和配置的 Agent 在聊天时**无需手动输入或模仿**这些标记头。Agent 的系统提示和 也应引导它们专注于对话内容,而不是讨论或生成这些标记。• 群组同样支持独立的话题管理,包括话题的创建、删除、重命名和排序。• **群文件/工作区**: 为每个群组提供一个专属的共享文件空间和工作区。• **集中存储**: 所有与群组任务相关的文件(文档、代码、素材等)都可以上传并存储在这里,群内所有成员(用户和 Agent)均可访问。• **协同编辑**: 支持对工作区内的文件进行实时协同编辑,类似于在线文档,极大地促进了团队合作和项目迭代。• **跨端记忆与无缝同步**: VChat 的记忆系统以 VCP 后端为核心,构建了一个统一的、持久化的 Agent 记忆库。这意味着,无论您在哪个前端(如网页、移动端或另一台电脑上的 VChat 客户端)与 Agent 互动,所有的对话历史、学习到的知识和形成的用户偏好都会被实时同步到这个中心记忆库。当您打开 VChat 客户端时,它会自动从后端拉取最新的记忆状态,确保您的 Agent 拥有完整、连贯的上下文。这种设计打破了设备之间的壁垒,实现了真正的“一次对话,处处同步”,让您无论身在何处,都能与同一个“老朋友”无缝沟通。• **心流锁模式 (Flow Lock)**:• **专注交互**: 当针对某个话题开启此功能后,用户将暂时无法切换 Agent 或话题,窗口会被锁定,确保对话的深度和连续性。• **AI 主动性**: 在该模式下,AI 不再仅仅被动等待用户输入,而是可以主动发起对话、继续执行任务、汇报进度或提出想法,实现真正的自主工作。• **双向控制**:• **用户**: 可以设置触发 AI 主动说话的引导语 (Prompt)、AI 主动说话的最短冷却时间 (CD),并随时手动开启或关闭心流锁。• **AI**: 也可以根据任务需求,自主开启或关闭心流锁,并能自行设置触发下一次主动行为的引导语。• **全新工作范式**: 结合 VChat 已有的主动弹窗交互 UI,心流锁模式让 Agent 能够独立进行长期、复杂的任务。AI 只在关键节点或需要决策时才征求用户建议,彻底摆脱了传统的一问一答模式,适用于需要持续思考和执行的多种场景,如研究、编程、创作等。• **Agent 正则表达式**:• 引入了强大的正则表达式功能,允许对 Agent 的行为进行更深度的控制。• 支持多种正则应用场景,包括:**聊天历史内容正则**、**渲染器正则**、**深度正则**和**content 数组正则**。• 提供完整的图形用户界面(GUI),方便用户进行正则表达式的编辑、测试和管理,极大地提升了易用性。• **VCP人类工具箱**:• **自动 GUI 生成**: 现在会将所有服务器上的 VCP 插件自动生成图形用户界面(GUI),极大地方便了人类用户的直接操作与调试。• **工作流增强**: 工作流引擎得到全面升级,提供了更精细化的节点控制和更强大的逻辑构建能力。• **节点输入输出细化**: 增强了对节点输入输出数据的控制。• **新增高级节点**:• **数据转换器**: 方便在不同节点间进行数据格式转换。• **高级条件判断**: 支持更复杂的逻辑判断分支。• **计时器/延时器**: 用于控制工作流的执行时序。• **编辑器/循环节点**: 提供了更灵活的数据处理和流程控制能力。• **URL 渲染器升级**: 现在可以直接渲染 PDF、音频和视频文件,丰富了内容的呈现方式。• **Canvas 协同模块:实时、交互式的代码与文档工作区**:• **功能定位**: 一个革命性的实时协同空间,用户或 Agent 可随时创建。它不仅仅是一个文本编辑器,而是一个集成了完整开发与渲染环境的“活文档”和“交互式白板”。• **无缝协同编辑**: 在这个工作区内,用户与 AI…