开发环境搭建

受众： 开发者、贡献者
前提： 熟悉命令行操作
目标： 安装完整的 CocoCat 开发环境

必需工具

Python 3.12+

CocoCat 的运行时需要 Python 3.12 或更高版本。

Windows：

从 python.org 下载安装包，安装时勾选 "Add Python to PATH"。

验证安装：

python --version
# 输出: Python 3.12.x

Node.js 20+ 和 npm

Web 管理面板（React）需要 Node.js 20 或更高版本。

Windows：

从 nodejs.org 下载 LTS 版本安装包。

验证安装：

node --version
# 输出: v20.x.x
npm --version
# 输出: 10.x.x

可选工具

工具	用途	安装方式
Git	版本控制	winget install Git.Git
VS Code	代码编辑	winget install Microsoft.VisualStudioCode
Python venv	虚拟环境	内置 python -m venv venv
Docker	容器化部署	Docker Desktop for Windows

验证完整环境

运行以下命令确认所有工具就绪：

python --version && node --version

全部成功输出后，即可按照快速开始启动 CocoCat。