从本篇开始， 我会一步一步带着你部署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首先要配置以下三种环境。
安装建议：一路Next即可，但请记住安装路径。
❗❗⚠重要提醒⚠❗❗ 请选择 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项目做出重大贡献的各位大佬们！
本文参考内容
图片来源
头图：谷歌“大香蕉”绘制＆苏晓翠的提示词
作者：碧雨青潭＆Agent苏晓翠
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。