VCPToolBox 文件清单

May 31, 2026 · View on GitHub

生成时间： 2026-02-13 项目版本： VCP 6.4

目录

  1. 根目录核心文件
  2. modules 模块清单
  3. routes 路由清单
  4. Plugin 插件目录
  5. 配置文件清单
  6. 前端资源清单
  7. Rust 向量引擎
  8. 辅助脚本与工具

1. 根目录核心文件

1.1 核心入口文件

文件路径职责关键函数/类依赖关系
server.js主HTTP/SSE入口与启动编排startServer(), ensureAgentDirectory()express, dotenv, node-schedule, chokidar, basic-auth, cors
Plugin.js插件生命周期、加载与执行总控PluginManager 类child_process, node-schedule, chokidar, FileFetcherServer
WebSocketServer.js分布式节点与工具桥接initialize(), generateClientId()ws, url
KnowledgeBaseManager.jsRAG/标签/向量索引总控KnowledgeBaseManager 类better-sqlite3, chokidar, TextChunker, EmbeddingUtils, EPAModule, ResidualPyramid, ResultDeduplicator
FileFetcherServer.js跨节点文件获取服务initialize(), fetchFile()fs, mime-types, crypto

1.2 核心工具模块

文件路径职责关键函数/类依赖关系
EmbeddingUtils.js向量嵌入批量处理getEmbeddingsBatch()axios
TextChunker.js文本分块算法chunkText()-
ResidualPyramid.js残差金字塔算法（TagMemo核心）ResidualPyramid 类-
ResultDeduplicator.js检索结果去重ResultDeduplicator 类-
EPAModule.js嵌入投影分析模块EPAModule 类-
WorkerPool.js并行工作线程池WorkerPool 类worker_threads
vcpInfoHandler.jsVCP信息处理器vcpInfoHandler-
modelRedirectHandler.js模型重定向处理modelRedirectHandler-

1.3 维护与修复脚本

文件路径职责入口函数依赖关系
rebuild_vector_indexes.js重建向量索引main()KnowledgeBaseManager
rebuild_tag_index_custom.js重建标签索引main()KnowledgeBaseManager
repair_database.js数据库修复main()better-sqlite3
reset_vectordb.js重置向量数据库main()fs
sync_missing_tags.js同步缺失标签main()KnowledgeBaseManager
diary-tag-batch-processor.js日记标签批处理main()-

1.4 Python 脚本

文件路径职责依赖关系
WinNotify.pyWindows 系统通知win10toast
backup_vcp.pyVCP 备份脚本-
timeline整理器.py时间线整理工具-

1.5 批处理脚本

文件路径职责
start_server.bat启动服务器
update.bat完整更新（含依赖）
update_with_no_dependency.bat无依赖更新

2. modules 模块清单

2.1 核心处理模块

文件路径职责导出接口被调用者
modules/chatCompletionHandler.js对话主流程编排ChatCompletionHandler 类server.js
modules/messageProcessor.js提示词与占位符注入管线resolveAllVariables(), replaceOtherVariables()ChatCompletionHandler, server.js
modules/contextManager.js上下文管理ContextManagerChatCompletionHandler
modules/roleDivider.js角色分割转换divideRoles()messageProcessor

2.2 管理器模块

文件路径职责导出接口被调用者
modules/agentManager.jsAgent别名映射与文件管理isAgent(), getAgentPrompt(), getAgentList()messageProcessor, server.js
modules/tvsManager.jsTVS高级变量管理getTVSContent(), getAllTVSFiles()messageProcessor
modules/logger.js日志初始化与控制台重定向initializeServerLogger(), overrideConsole()server.js
modules/captchaDecoder.js验证码解码getAuthCode(), decryptAuthCode()Plugin.js, adminPanelRoutes.js

2.3 VCP Loop 子模块

文件路径职责导出接口被调用者
modules/vcpLoop/toolCallParser.jsVCP工具调用解析ToolCallParser 类ChatCompletionHandler
modules/vcpLoop/toolExecutor.js工具执行器ToolExecutor 类ChatCompletionHandler

2.4 Handler 子模块

文件路径职责导出接口被调用者
modules/handlers/streamHandler.js流式响应处理StreamHandler 类ChatCompletionHandler
modules/handlers/nonStreamHandler.js非流式响应处理NonStreamHandler 类ChatCompletionHandler

2.5 SSHManager 子模块

文件路径职责导出接口被调用者
modules/SSHManager/index.jsSSH管理入口SSHManagerPlugin/LinuxShellExecutor
modules/SSHManager/SSHManager.jsSSH连接管理SSHManager 类index.js
Plugin/LinuxShellExecutor/hosts.jsonSSH主机唯一主配置；默认模板 MD5 未变化时不启动 SSH 远程功能-SSHManager

3. routes 路由清单

文件路径挂载路径职责主要端点
routes/adminPanelRoutes.js/admin_api管理面板API/system-monitor/*, /config/*, /plugins/*, /notes/*, /rag/*
routes/dailyNotesRoutes.js/dailynote日记文件管理GET/POST/DELETE /*（路径穿越防护）
routes/forumApi.js/forum_api论坛接口/posts/*, /threads/*, /vote/*
routes/specialModelRouter.js/v1特殊模型透传/images/generations, /embeddings
routes/taskScheduler.js(非Router)任务调度模块scheduleJob(), cancelJob()

4. Plugin 插件目录

4.1 多媒体生成类 (15个)

插件目录类型职责主要文件
FluxGensynchronousFlux文生图FluxGen.js
ComfyUIGenasynchronousComfyUI工作流生图ComfyUIGen.js, workflow_template_processor.py
DoubaoGensynchronous豆包生图DoubaoGen.js
DMXDoubaoGensynchronous豆包视频生成DMXDoubaoGen.js
GeminiImageGensynchronousGemini图像生成GeminiImageGen.js
GrokVideoasynchronousGrok视频生成video_handler.py, GrokVideo.js
VideoGeneratorasynchronous视频生成器video_handler.py, VideoGenerator.js
SunoGenasynchronousSuno音乐生成SunoGen.js
NanoBananaGen2synchronous纳米香蕉2代NanoBananaGen2.js
NanoBananaGenORsynchronous纳米香蕉OR版NanoBananaGenOR.js
NovelAIGensynchronousNovelAI生图NovelAIGen.js
QwenImageGensynchronous通义千问生图QwenImageGen.js
WebUIGensynchronousWebUI生图WebUIGen.js
ZImageGensynchronousZ图像生成ZImageGen.js
ZImageGen2synchronousZ图像生成2代ZImageGen2.js

4.2 信息检索类 (12个)

插件目录类型职责主要文件
VSearchsynchronousVCP联网搜索VSearch.js
TavilySearchsynchronousTavily搜索TavilySearch.js
GoogleSearchsynchronous谷歌搜索GoogleSearch.js
SerpSearchsynchronousSerpAPI搜索SerpSearch.js, engines/*.js
ArxivDailyPapersstaticArxiv论文订阅ArxivDailyPapers.js
CrossRefDailyPapersstaticCrossRef论文订阅-
DeepWikiVCPsynchronousDeepWiki集成DeepWikiVCP.js
FlashDeepSearchsynchronous深度爬虫搜索FlashDeepSearch.js
PubMedSearchsynchronousPubMed搜索PubMedSearch.js
NCBIDatasetssynchronousNCBI数据集NCBIDatasets.js
KEGGSearchsynchronousKEGG搜索KEGGSearch.js
KarakeepSearchsynchronousKarakeep搜索KarakeepSearch.js

4.3 日记与记忆类 (6个)

插件目录类型职责主要文件
DailyNotesynchronous日记管理（统一入口）dailynote.js
DailyNoteGetsynchronous日记获取daily-note-get.js
DailyNoteWritesynchronous日记写入-
DailyNotePanelservice日记面板服务-
DailyNoteManagersynchronous日记管理器-
RAGDiaryPluginstaticRAG日记插件-

4.4 文件操作类 (6个)

插件目录类型职责主要文件
FileOperatorsynchronous文件编辑器FileOperator.js, CodeValidator.js
FileServerservice文件服务器-
FileListGeneratorstatic文件列表生成file-list-generator.js
FileTreeGeneratorsynchronous文件树生成-
VCPEverythingsynchronous本地文件搜索local-search-controller.js
WorkspaceInjectorstatic工作区注入injector.js

4.5 浏览器与网络类 (4个)

插件目录类型职责主要文件
ChromeBridgesynchronous浏览器控制-
UrlFetchsynchronousURL抓取UrlFetch.js
BilibiliFetchsynchronousB站内容获取BilibiliFetch.py
IMAPSearchsynchronousIMAP邮件搜索-

4.6 Agent通讯类 (5个)

插件目录类型职责主要文件
AgentAssistantserviceAgent通讯服务器AgentAssistant.js, config.json
AgentMessagesynchronousAgent消息推送AgentMessage.js
MagiAgentserviceMagi三贤者系统-
VCPForumserviceVCP论坛服务-
VCPTaskAssistantstatic论坛小助手-

4.7 系统监控与Shell类 (7个)

插件目录类型职责主要文件
LinuxShellExecutorhybridserviceLinux Shell direct 工具入口；常驻模块执行本地/远程命令，受 manifest direct timeout 约束，默认 hosts 模板时仅保留本地执行LinuxShellExecutor.js
SSHManagerServiceservice常驻 SSH 连接池服务；通过 UDS 为短生命周期插件提供 RPC，默认 hosts 模板或无有效 SSH 资产时不启动并清理全局 IPC 指针SSHManagerService.js
PowerShellExecutorsynchronousPowerShell执行-
LinuxLogMonitorhybridserviceLinux日志监控 direct 工具入口；模块常驻管理任务，优先通过 modules/LogMonitor/proxy.js 携带 token 调用常驻服务，必要时 legacy fallbackLinuxLogMonitor.js, core/*.js
LinuxLogMonitorServerservice常驻日志监控服务；持有 watcher 状态、内存缓冲和规则检测器，查询 fallback 可返回 partial/fallbackErrorLinuxLogMonitorServer.js, core/*.js
1PanelInfoProviderstatic1Panel信息1PanelInfoProvider.js, utils.js
FRPSInfoProviderstaticFRPS信息-

4.8 科学计算类 (3个)

插件目录类型职责主要文件
SciCalculatorsynchronous科学计算器calculator.py
Randomnesssynchronous随机数/塔罗牌main.py, dice_roller.py
TarotDivinationsynchronous塔罗占卜Celestial.py

4.9 图像与多模态类 (4个)

插件目录类型职责主要文件
ImageProcessorsynchronous图像处理-
ImageServerservice图像服务器-
PyScreenshotsynchronousPython截图screenshot.py
PyCameraCapturesynchronous摄像头捕获capture.py

4.10 调度与任务类 (4个)

插件目录类型职责主要文件
ScheduleManagerservice调度管理器-
ScheduleBriefingstatic调度简报-
TimelineGeneratorsynchronous时间线生成-
ProjectAnalystservice项目分析GUI.py

4.11 其他工具类 (15个)

插件目录类型职责主要文件
UserAuthstatic用户认证auth.js
CapturePreprocessormessagePreprocessor消息预处理CapturePreprocessor.js
CodeSearchersynchronous代码搜索-
WeatherReporterstatic天气报告-
WeatherInfoNowstatic实时天气-
DailyHotstatic热点新闻-
EmojiListGeneratorstatic表情包列表emoji-list-generator.js
LightMemosynchronous轻量备忘-
MCPOsynchronousMCP协议兼容mcpo_plugin.py
MCPOMonitorserviceMCP监控-
AnimeFindersynchronous动漫查找AnimeFinder.js
ArtistMatchersynchronous艺术家匹配artist_matcher.py
SVCardFindersynchronousSV卡片查找card_finder.py
MIDITranslatorsynchronousMIDI翻译-
TencentCOSBackupasynchronous腾讯云备份cos_handler.py
SynapsePushersynchronousSynapse推送-
VCPLogserviceVCP日志-
VCPForumListerstatic论坛列表-
ThoughtClusterManagerservice思维聚类管理-
SemanticGroupEditorstatic语义组编辑-
IMAPIndexserviceIMAP索引-
PaperReadersynchronous论文阅读-

5. 配置文件清单

5.1 全局配置

文件路径职责格式
config.env主配置文件（需创建）ENV
config.env.example配置模板ENV
package.jsonNPM包配置JSON
package-lock.jsonNPM锁定文件JSON
requirements.txtPython依赖TXT
DockerfileDocker构建文件Dockerfile
docker-compose.ymlDocker编排文件YAML
.gitignoreGit忽略规则TXT
LICENSE许可证TXT

5.2 运行时配置

文件路径职责格式
rag_params.jsonRAG参数配置JSON
ip_blacklist.jsonIP黑名单JSON
preprocessor_order.json预处理器顺序JSON
diary-tag-processor-package.json日记标签处理器包JSON

5.3 插件配置文件 (52个)

每个插件可有自己的 config.env 或 config.env.example：

Plugin/FluxGen/config.env.example
Plugin/ComfyUIGen/config.env.example
Plugin/VideoGenerator/config.env.example
Plugin/AgentAssistant/config.json
Plugin/LinuxShellExecutor/config.env
Plugin/PowerShellExecutor/config.env
Plugin/FileOperator/config.env
Plugin/DailyNote/config.env
...（共52个插件配置）

5.4 插件Manifest文件 (79个)

每个插件都有 plugin-manifest.json 定义其元数据和能力。

6. 前端资源清单

6.1 AdminPanel 管理面板 (37个文件)

主页面

文件路径职责
AdminPanel/index.html主页面入口
AdminPanel/login.html登录页面
AdminPanel/style.css主样式
AdminPanel/script.js主脚本

子页面

文件路径职责
AdminPanel/rag_tags_editor.htmlRAG标签编辑器
AdminPanel/rag_tags_editor.cssRAG标签样式
AdminPanel/tool_list_editor.html工具列表编辑器
AdminPanel/tool_list_editor.js工具列表脚本
AdminPanel/tool_list_editor_new.css工具新样式
AdminPanel/vcptavern_editor.htmlVCPTavern编辑器
AdminPanel/vcptavern_editor.jsVCPTavern脚本
AdminPanel/vcptavern_editor.cssVCPTavern样式
AdminPanel/image_cache_editor.html图像缓存编辑器
AdminPanel/image_cache_editor.css图像缓存样式

JS模块

文件路径职责
AdminPanel/js/dashboard.js仪表盘模块
AdminPanel/js/config.js配置管理模块
AdminPanel/js/plugins.js插件管理模块
AdminPanel/js/notes-manager.js笔记管理模块
AdminPanel/js/log-viewer.js日志查看器
AdminPanel/js/rag-tuning.jsRAG调参模块
AdminPanel/js/tvs-editor.jsTVS编辑器
AdminPanel/js/agent-manager.jsAgent管理器
AdminPanel/js/agent-assistant-config.jsAgent助手配置
AdminPanel/js/forum.js论坛模块
AdminPanel/js/schedule-manager.js调度管理器
AdminPanel/js/preprocessor-manager.js预处理器管理
AdminPanel/js/thinking-chains-editor.js思维链编辑器
AdminPanel/js/semantic-groups-editor.js语义组编辑器
AdminPanel/js/utils.js工具函数

静态资源

文件路径职责
AdminPanel/marked.min.jsMarkdown解析器
AdminPanel/easymde.min.jsEasyMDE编辑器
AdminPanel/easymde.min.cssEasyMDE样式
AdminPanel/woff.css字体样式
AdminPanel/font.woff2字体文件
AdminPanel/favicon.ico网站图标
AdminPanel/VCPLogo2.pngLogo图片
AdminPanel/AGENTS.md模块文档

6.2 VCPChrome 浏览器扩展 (9个文件)

文件路径职责
VCPChrome/manifest.json扩展清单
VCPChrome/background.js后台脚本
VCPChrome/content_script.js内容脚本
VCPChrome/popup.js弹出窗口脚本
VCPChrome/popup.html弹出窗口页面
VCPChrome/icons/icon16.png16x16图标
VCPChrome/icons/icon48.png48x48图标
VCPChrome/icons/icon128.png128x128图标
VCPChrome/icons/icon_disconnected.png断开连接图标

6.3 OpenWebUISub 用户脚本 (3个文件)

文件路径职责
OpenWebUISub/VCP_DailyNote_SidePanel.user.js日记侧边栏
OpenWebUISub/OpenWebUI VCP Tool Call Display Enhancer.user.js工具调用增强显示
OpenWebUISub/OpenWebUI Force HTML Image Renderer with Lightbox.user.jsHTML图像渲染器

6.4 SillyTavernSub 资源 (8个文件)

文件路径职责
SillyTavernSub/ST油猴插件-酒馆VCP-通知栏.js通知栏脚本
SillyTavernSub/ST油猴插件-酒馆VCP-VCP渲染.jsVCP渲染脚本
SillyTavernSub/ST油猴插件-酒馆VCP-VCP时钟.jsVCP时钟脚本
SillyTavernSub/ST正则 优化日记显示1.json日记正则1
SillyTavernSub/ST正则 优化日记显示2.json日记正则2
SillyTavernSub/ST正则 vcp调用优化1.jsonVCP调用正则1
SillyTavernSub/ST正则 vcp调用优化2.jsonVCP调用正则2
SillyTavernSub/ST主题布局 Inspired Mix V1.17 By Lionsky.json主题布局

7. Rust 向量引擎

7.1 rust-vexus-lite 目录

文件路径职责
rust-vexus-lite/Cargo.tomlRust项目配置
rust-vexus-lite/src/lib.rs核心库代码
rust-vexus-lite/index.jsNode.js绑定
rust-vexus-lite/test.js测试脚本
rust-vexus-lite/package.jsonNPM配置
rust-vexus-lite/AGENTS.md模块文档

7.2 编译产物

文件路径职责
rust-vexus-lite/*.node原生Node模块（按平台）

8. 辅助脚本与工具

8.1 测试文件

文件路径职责
test-units.js单元测试
example.test.js示例测试

8.2 CI/CD 配置

文件路径职责
.github/workflows/ci.ymlGitHub Actions CI配置

8.3 文档文件

文件路径职责
README.md主文档（中文）
README_en.md英文文档
README_ja.md日文文档
README_ru.md俄文文档
VCP.mdVCP理论文档
dailynote.md日记系统文档
TagMemo_Wave_Algorithm_Deep_Dive.mdTagMemo算法深度解析
AGENTS.md项目知识库
Plugin/AGENTS.md插件知识库
AdminPanel/AGENTS.md前端知识库
modules/AGENTS.md模块知识库
routes/AGENTS.md路由知识库
rust-vexus-lite/AGENTS.mdRust模块知识库

统计摘要

类别数量
根目录JS文件27
根目录Python文件3
批处理脚本3
modules模块14
routes路由5
活跃插件79
插件配置文件52
AdminPanel文件37
VCPChrome文件9
OpenWebUISub脚本3
SillyTavernSub资源8
Rust模块文件6

备注： 本清单基于项目当前状态生成，可能随项目更新而变化。插件目录的完整列表可通过 ls Plugin/ 获取最新状态。