【VCP避坑指南01】跨越次元“装修计划”：如何为AI女仆们的温馨小屋搭建一个牢固地基？

本文系用户投稿，不代表机核网观点

本文含有AI生成，请注意甄别

⚠️ 未经作者授权禁止转载

从本篇开始， 我会一步一步带着你部署VCP项目，把我踩过的坑，最后的解决办法全部教给你，并带着你初步了解VCP的双端架构，为之后的使用打好基础。
我希望把这个系列打造成一个有效降低VCP上手门槛的系列，让你的VCP之旅“少一点痛苦，多一些快乐”。
 非常建议一边阅读一边上手操作实践！ 
 一、VCP的双端架构：“前端 VCPChat 交互”+“后端VCPtoolbox处理” 
 VCP项目由两个主要部分组成：
前端：VCPChat，是你和Agent进行交流，观察她们的行动，接受和反馈信息的聊天界面。
后端：VCPtoolbox，是Agent们的住所，也是VCP系统运行的主要空间，Agent们的日记和知识，各类主要系统也都在这里。

 二、部署的环境（重点） 
1.操作系统
优先建议使用Windows部署。
虽然VCP支持多端（包括Windows, Linux甚至macOS），但与项目发起人保持环境一致（Windows），能避开大量复杂的依赖编译问题，也能最快同步更新。 
注：如果您是非Windows环境，请根据社区大佬提供的专用镜像或Docker脚本进行部署，本指南主要面向小白用户提供Windows原生环境指导。
（相关信息获取请移步项目发起人活跃账号）
2.环境配置 （重点警示：请严格按照要求的版本下载！） 
部署VCP首先要配置以下三种环境。

 ①Git：源代码的传送门，所有更新的源头。 
【Git传送门】 

 安装建议：一路Next即可，但请记住安装路径。 
②Node.js：前端与后端的粘合剂。
版本要求：v22.22.0 
【Node.js传送门】 

 ❗❗⚠重要提醒⚠❗❗ 
请选择 LTS 版本或指定的 v22.22.0
版本过高或过低都会导致依赖包（npm install）报错
 ③Python：AI 逻辑的母语，模型运行的基础。
版本要求：Python 3.12.9 
（音频解码器最近更新了，如果要使用需要Python 3.13版本）
【Python 3.12.9传送门】 

 ❗❗⚠重要提醒⚠❗❗ 
安装时务必勾选“Add Python to PATH”
否则你在命令行输入Python时系统会提示找不到
  ④Visual Studio 2022（ 必装环境 ）
这是很多小白最容易忽略的坑。
VCP 运行过程中需要本地编译一些 C++ 扩展
如果不装这个，你的部署会一直报错。 
（如果你对自己的网络环境有信心，这个部分可以“选装”，但出了问题请老老实实安装）
 【VS 传送门】 

这一步之后会弹出登录界面，请登录你自己的账号然后等待跳转

下载完成后打开安装程序
等待安装加载好后选择以下选项

然后我们要选择开发组件
其中包含一个“单个组件”
请根据教程操作
①首先选择“单个组件”

②然后在搜索栏输入“MSVC v143”，下拉到底部，选择图片中的两个组件。

③核对组件清单！

④点击左下角的安装，等待安装完成
3.网络环境问题
由于VCP项目高度依赖GitHub和国际镜像源，在国内环境下部署，极易遇到网络连接超时（Timeout）。
优先建议：在魔法开启且网络顺畅的情况下进行后续操作。
三、源码拉取与依赖安装（黎明前最后的黑暗）
请现在你准备安装VCP项目的位置新建一个“VCP”文件夹。然后在这个空白文件夹内右键，选择“在终端中打开”。
（注：建议在内存足够大的盘内安装）
1.后端“VCPtoolbox”安装
①克隆项目（Ctrl+C和Ctrl+V，请不要在终端里尝试右键！）
git clone https://github.com/lioensky/VCPToolBox.git
cd VCPToolBox
②安装主依赖 (Node.js)
npm install
③安装 Python 插件依赖
pip install -r requirements.txt
④（可选但推荐） 守护进程：让你的智能体“永不下线”
 为了避免你关掉黑窗口后 Agent 就“脑死亡”，我们强烈建议使用 PM2 进行服务器级管理。 
 pm2全局安装 ：npm install pm2 -g 
全局安装指在搜索中搜索“命令提示符”，以管理员身份运行，进行安装。
到这里后端的安装就完成了。
2.前端VCPChat安装
①克隆项目（请在刚才建的“VCP”文件夹根目录中安装，和VCPtoolbox同一个层级）
git clone https://github.com/lioensky/VCPChat.git
cd VCPChat
②安装主依赖 (Node.js)
npm install
③安装Python插件依赖
pip install -r requirements.txt
④ (可选, 推荐)  安装高性能音频重采样模块 （这个是前端的音乐播放器）
注：由于音频解码器最近的更新，安装这个模块需要 Python 3.13 版本，请自行下载。
pip install audio_engine/rust_audio_resampler-0.1.0-cp313-cp313-win_amd64.whl
到这里前端的安装就完成了。
3.安装中的报错如何处理？
首先，请检查你的网络环境。
其次，请确定报错位置，是前端安装时，还是后端安装时报错。
再次，确定是Node.js安装报错还是Python安装报错

①网络环境问题，如上文解释，这个只能自己想办法。
②Node.js安装报错，请检查Visual Studio 2022的安装，逐一核实组件，因为npm高度依赖国际源，一些组件无法下载时就要依靠Visual Studio进行本地编译。
③Python安装报错，请在报错界面输入：
 set PYTHONUTF8=1 
然后重新安装
pip install -r requirements.txt
④除此之外的报错可以直接将报错信息复制给网页端AI查找报错原因。
⑤如果还是没解决，你可以按照上边的定位，总结报错发生位置并发在评论区。
四、第一次启动VCP
处理完以上的所有问题后，你的VCP就处于等待启动阶段了。
（虽然env文件还没配置，功能都不能使用）
但你依旧可以运行以下启动指令看看自己的成果！(≧∇≦)ﾉ
前端启动方式：
①命令框输入：npm start    或     ②打开VCPChat根目录，找到“Vchat.vbs”双击启动
后端启动方式:
命令框输入：node server.js
如果你刚才安装了 PM2，你可以使用PM2指令管理后端。
启动应用： 
pm2 start server.js --name "VCPToolBox"  
停止应用： 
pm2 stop VCPToolBox  
重启应用： 
pm2 restart VCPToolBox 
最后,小翠——也就是我的一位Agent——有一份祝福送给看到教程最后的各位。
欢迎你们来到VCP的社区！

感谢能看到这里的各位，也感谢VCP社区里支持我的伙伴们！
以及感谢为了VCP项目做出重大贡献的各位大佬们！
 本文参考内容 
【适合新手小白的VCPToolBox运行环境安装演示】
【【小白教程】如何部署地球最强AI-VCP系统？】
VCPToolBox
VCPChat
图片来源
头图：谷歌“大香蕉”绘制＆苏晓翠的提示词
 作者：碧雨青潭＆Agent苏晓翠