Getting started
首次启动与运行环境准备
了解 WinCode 首次启动时自动下载运行环境的过程
首次启动与运行环境准备
WinCode 的核心能力依赖两个运行环境组件：Node.js 运行时 和 AI 核心引擎。首次启动时，应用会自动检测并下载这些依赖，整个过程无需手动干预。
启动流程
应用启动后会自动检查本地运行环境是否就绪，并根据当前状态显示不同界面：
| 状态 | 含义 | 界面表现 |
|---|---|---|
checking | 正在检查本地依赖 | 显示「正在检查依赖...」 |
downloading | 正在下载组件 | 进度条 + 下载速度 + 百分比 |
extracting | 正在解压组件 | 脉冲进度条 + 「正在解压...」 |
ready | 依赖就绪 | 进入主界面 |
error | 出错 | 错误信息 + 重试按钮 |
下载过程
下载阶段会显示详细的进度信息：
- 当前下载的包名（
node或claude） - 包序号（如
1/2） - 下载速度（自动格式化为 KB/s、MB/s、GB/s）
- 完成百分比
错误处理
如果下载或解压过程出错，界面会显示错误面板。内置了 7 种错误码的中文提示：
| 错误码 | 含义 |
|---|---|
| E001 | 网络连接失败，请检查网络后重试 |
| E002 | 磁盘空间不足，需要至少 100MB 可用空间 |
| E003 | 权限不足，无法创建目录 |
| E004 | 文件损坏，请重试 |
| E005 | 解压失败 |
| E006 | 另一个 WinCode 实例正在下载依赖，请等待 |
| E007 | 配置文件损坏 |
点击「重试」按钮可重新触发下载流程。