Desktop 安装
本页说明如何安装和使用 Hagicode Desktop。它是官方桌面客户端，负责把默认本地安装流程与日常管理入口放到同一处。
什么是 Hagicode Desktop
Section titled “什么是 Hagicode Desktop”Hagicode Desktop 是 Hagicode 的官方桌面应用程序，专为 Windows、macOS 和 Linux 系统设计。它集成了 Hagicode 的核心功能，默认安装向导会把首次部署流程顺着带完。
- 一键安装：通过安装向导，自动完成所有配置步骤
- 自动运行时准备：默认安装流程已内置所需运行时，无需单独安装
.NET - 服务管理：内置 Hagicode Server 管理，轻松启动和停止服务
- 版本切换：支持多版本管理，可在不同版本之间自由切换
- 本地运行：所有数据存储在本地，保护您的隐私
- 自动更新：自动检测并下载最新版本
这些场景可优先用 Desktop：
- 个人开发者希望在本地使用 Hagicode
- 需要离线使用 Hagicode 的用户
- 希望简化安装过程的非技术用户
- 需要频繁切换不同版本的开发者
下载 Desktop
Section titled “下载 Desktop”选择适合您操作系统的版本，直接下载安装程序：
其他获取方式
Section titled “其他获取方式”您还可以从以下渠道获取 Hagicode Desktop 安装程序：
- 官方发布页面：访问 Hagicode GitHub Releases 下载最新版本
- 官方网站：访问 Hagicode 官网 获取下载链接
选择正确的版本
Section titled “选择正确的版本”根据您的操作系统选择对应的安装程序：
- Windows：下载
.exe安装程序 - macOS：下载
.dmg安装程序 - Linux：下载
.AppImage或.deb安装包
运行安装程序
Section titled “运行安装程序”下载完成后，运行安装程序。您将看到 Hagicode Desktop 安装程序的欢迎界面。
安装向导步骤
Section titled “安装向导步骤”当前默认安装流程主要分为两个阶段。以下是每个阶段的详细说明：
第一步：下载 Hagicode
Section titled “第一步：下载 Hagicode”配置完成后，向导会自动下载最新版本的 Hagicode。
此步骤说明：
- 向导自动检测并下载最新稳定版本
- 下载进度会实时显示
- 下载完成后会自动进入下一步
第二步：启动服务
Section titled “第二步：启动服务”Hagicode 下载完成后，向导将启动 Hagicode Server 服务。
此步骤说明：
- Hagicode Server 会在后台自动启动
- 启动过程通常只需要几秒钟
- 启动完成后，您可以开始使用 Hagicode
服务启动完成
Section titled “服务启动完成”当 Hagicode Server 成功启动后，您将看到以下界面。
点击”打开 Hagicode”按钮即可开始使用。
首次进入 Hagicode 后，您会立即进入当前版本的初始化向导。新版向导会按 8 步连续完成语言、系统组件检测、主题、AgentCLI、Agents、项目与社区入口等设置，而不是继续沿用旧版分散的三步说明。
如果您想按最新界面逐步完成首次设置，请直接阅读快速开始中的专门页面：
Hagicode Desktop 支持多版本管理，您可以在不同版本之间自由切换。
- 打开 Hagicode Desktop
- 进入”版本管理”页面
- 选择要切换的版本
- 点击”切换版本”按钮
- 等待切换完成
启动和停止服务
Section titled “启动和停止服务”Hagicode Desktop 提供了简单的方式来管理 Hagicode Server 服务。
在 Desktop 应用程序的首页，点击”启动服务”按钮即可启动 Hagicode Server。
要停止 Hagicode Server，点击首页的”停止服务”按钮。
安装完成后，您可以继续以下步骤：
如果安装过程中遇到问题：
- 检查网络连接：确保能够访问互联网
- 检查磁盘空间：确保有足够的磁盘空间
- 以管理员身份运行：在 Windows 上，右键点击安装程序，选择”以管理员身份运行”
- 查看日志文件：安装程序会生成详细的日志文件，可以帮助诊断问题
依赖项安装失败
Section titled “依赖项安装失败”如果依赖项安装失败：
- 检查系统兼容性：确保您的操作系统满足最低要求
- 检查网络与防火墙设置：确保安装程序可以访问所需下载资源，且未被防火墙拦截
- 确认安装权限：在 Windows 上可尝试使用”以管理员身份运行”，确保安装程序拥有足够权限
- 重启应用后重试：关闭并重新打开 Hagicode Desktop，再重新执行安装
- 查看日志文件：在 Desktop 应用程序中查看详细日志，定位具体失败原因
服务启动失败
Section titled “服务启动失败”如果 Hagicode Server 无法启动：
- 检查端口占用：确保端口 45000 未被其他程序占用
- 检查防火墙设置：确保防火墙允许 Hagicode Server 访问网络
- 重启应用程序：尝试重启 Hagicode Desktop
- 查看日志：在 Desktop 应用程序中查看详细的错误日志
需要更多帮助？
Section titled “需要更多帮助？”如果您遇到此处未涵盖的问题：
- 查看 GitHub Issues 寻找类似问题
- 访问我们的社区论坛寻求帮助
- 提交新的 Issue，详细描述您的问题