VCPToolBox

环境要求

• Node.js 运行环境（npm install、node server.js）
• Python 与 pip（用于安装 requirements.txt 依赖）
• 从 config.env.example 复制出的 config.env 配置文件
• 可选：Docker 与 docker-compose（一键部署方式）

安装与启动步骤

1. 1安装 Node 依赖

   在项目根目录执行，安装 package.json 中声明的 JavaScript 依赖。

   npm install

   复制

2. 2安装 Python 依赖

   若项目含 Python 插件或组件，需按 requirements.txt 安装依赖。

   pip install -r requirements.txt

   复制

3. 3生成配置文件

   从示例文件复制出 config.env，后续所有配置（端口、API 等）都在此文件中填写。

   cp config.env.example config.env

   复制

4. 4填写配置项

   按 config.env 内注释填写 API 地址、密钥等；README 未列出具体字段，请参考示例文件与运维文档。

5. 5启动主服务

   运行主程序，主服务监听配置的端口，管理面板自动监听主端口+1。

   node server.js

   复制

6. 6Docker 方式部署

   也可使用官方镜像一键部署，官方镜像名为 lioensky/vcptoolbox。

   docker pull lioensky/vcptoolbox:latest
   docker-compose up -d

   复制

关键配置

如何确认成功

访问 http://<服务器地址>:<主端口+1>/AdminPanel（如主服务 6005 则访问 6006），能打开管理面板即成功。

常见问题

注意事项

• VCP Agent 拥有分布式系统底层级权限，非专业用户请谨慎部署。
• 严禁使用任何非官方或反向代理的 API（镜像站、中转 API），否则可能泄露数据、记忆与密钥。
• 推荐后端为支持 SSE 流式输出与格式标准化的官方或聚合 API，例如 NewAPI、Openrouter。
• 更详细的安装、分布式节点部署与前端配置见 docs/OPERATIONS.md。