第 1 章 · 下载安装与系统要求
本章目标：在您的电脑上正确安装小紫 AI 工作台 v5.4.35，完成首次启动自检；知道去哪里核对版本、遇到安装问题怎么排查。
学时建议：1～1.5 小时（含下载与安装）
前置：无；需能访问贤紫优选官网下载页。
1.1 场景说明：装错版本或路径，后面全白搭
常见翻车：
- 装的不是 5.4.35，教程菜单对不上
- 安装路径含中文，部分工具链异常
- 双击没反应被安全软件拦截，以为「软件坏了」
本章按 Windows 主路径写逐步操作；macOS / Linux 见 1.2，原则相同。
1.2 学完你能
| 能力 | 验收 |
|---|---|
| 核对版本 | 帮助 → 关于 = 5.4.35 |
| 完成安装 | 能看到登录窗口 |
| 自检 | 1.5 清单全部打勾 |
| 排错 | 对照 1.6 表处理常见问题 |
1.3 产品信息（安装前请核对）
| 项目 | 实际值 |
|---|---|
| 产品名称 | 小紫 AI 工作台 |
| 当前版本 | 5.4.35 |
| 安装包内显示名 | XiaoziAI-Workbench |
| 官方下载 | 贤紫优选官网 → 小紫 AI 工作台下载页 |
安装后：帮助 → 关于 核对版本。
1.4 系统要求
Windows（推荐）
| 项 | 要求 |
|---|---|
| 系统 | Windows 10 22H2+，64 位 |
| 内存 | 建议 16 GB+（AI + 多文件编辑） |
| 磁盘 | 安装约 300 MB；工作区与缓存预留 5 GB+ |
| 网络 | 首次登录、会员校验、云端模型需联网 |
macOS：10.11+（建议 12+）；dmg 拖入「应用程序」
Linux：主流 64 位；AppImage（以官网为准）
路径建议：安装目录、工作区尽量 英文路径，避免中文与特殊字符。
1.5 跟练：Windows 下载安装（逐步）
步骤 1 — 下载
- 浏览器打开官网 小紫 AI 工作台 下载页
- 选 Windows 安装包下载
- 确认文件名与官网说明一致
步骤 2 — 运行安装程序
- 双击安装包（必要时右键「以管理员身份运行」）
- 选择安装目录（可自定义，建议英文路径）
- 建议勾选：桌面快捷方式、开始菜单快捷方式
- 快捷方式名：小紫AI工作台
- 等待安装完成
步骤 3 — 首次启动
- 开始菜单或桌面启动 小紫AI工作台
- 你应该看到：全屏 「贤紫优选账号登录」（未登录无法进主界面）
- 窗口标题含 小紫AI工作台 或 小紫AI - 工作区
1.6 安装后自检清单（全部打勾再继续 ch02）
- [ ] 能打开登录窗口，标题 贤紫优选账号登录
- [ ] 有 账号、密码、记住我、登录
- [ ] 底部 注册账号 链到官网注册页
- [ ] 帮助 → 关于 版本 5.4.35
- [ ] 系统托盘可出现 小紫 AI 工作台 图标（Windows）
1.7 常见问题
| 现象 | 处理 |
|---|---|
| 双击无反应 | 管理员运行；查杀毒拦截 |
| macOS 无法验证开发者 | 系统设置 → 隐私与安全性 → 仍要打开 |
| 闪退 | 换英文路径重装；更新显卡驱动 |
| 登录框一直转圈 | 检查能否打开贤紫优选官网 |
1.8 与后续章节衔接
| 下一章 | 内容 |
|---|---|
| ch02 | 登录与会员 |
| ch03 | 模式大厅与主界面 |
| srx-v7 | SRX 改代码（需先登录） |
| local-deploy | 本机模型（与工作台分开装） |
跟练任务
- 完成 1.5 安装并 1.6 自检打勾。
- 截图 帮助 → 关于 版本号留档。
- 写
quickstart-notes/ch01.md：你的安装路径是否英文。
自检清单
- [ ] 版本 5.4.35
- [ ] 登录窗正常
- [ ] 英文路径（推荐）
- [ ] 知官网下载入口
- [ ] 常见故障会查表
本章小结
- 安装成功 = 看到 贤紫优选账号登录。
- 版本、路径、网络三项先对齐，再学 ch02。