Desktop 安装
本指南介绍如何安装和使用 Hagicode Desktop 桌面应用程序。Hagicode Desktop 是一款功能强大且易于使用的桌面应用程序，为您提供完整的 Hagicode 体验。
什么是 Hagicode Desktop
Section titled “什么是 Hagicode Desktop”Hagicode Desktop 是 Hagicode 的官方桌面应用程序，专为 Windows、macOS 和 Linux 系统设计。它集成了 Hagicode 的所有核心功能，并通过图形化安装向导，让安装过程变得简单快捷。
- 一键安装：通过安装向导，自动完成所有配置步骤
- 自动依赖管理：自动检测并安装所需的运行时环境（如 .NET 运行时）
- 服务管理：内置 Hagicode Server 管理，轻松启动和停止服务
- 版本切换：支持多版本管理，可在不同版本之间自由切换
- 本地运行：所有数据存储在本地，保护您的隐私
- 自动更新：自动检测并下载最新版本
Hagicode Desktop 适用于以下场景：
- 个人开发者希望在本地使用 Hagicode
- 需要离线使用 Hagicode 的用户
- 希望简化安装过程的非技术用户
- 需要频繁切换不同版本的开发者
下载 Desktop
Section titled “下载 Desktop”选择适合您操作系统的版本，直接下载安装程序：
其他获取方式
Section titled “其他获取方式”您还可以从以下渠道获取 Hagicode Desktop 安装程序：
- 官方发布页面：访问 Hagicode GitHub Releases 下载最新版本
- 官方网站：访问 Hagicode 官网 获取下载链接
选择正确的版本
Section titled “选择正确的版本”根据您的操作系统选择对应的安装程序：
- Windows：下载
.exe安装程序 - macOS：建议安装 Docker 版本（前往 Container 页面）
- Linux：下载
.AppImage或.deb安装包
运行安装程序
Section titled “运行安装程序”下载完成后，运行安装程序。您将看到 Hagicode Desktop 安装程序的欢迎界面。
安装向导步骤
Section titled “安装向导步骤”Hagicode Desktop 提供了一个四步安装向导，引导您完成整个安装过程。以下是每个步骤的详细说明：
第一步：选择已配置的 AgentCLI
Section titled “第一步：选择已配置的 AgentCLI”安装向导将引导你选择已配置好的 AgentCLI 进行安装。
此步骤说明：
- 查看可用的 AgentCLI 选项列表
- 选择你预先配置好的 AgentCLI
- 确认选择后继续下一步
第二步：下载 Hagicode
Section titled “第二步：下载 Hagicode”配置完成后，向导会自动下载最新版本的 Hagicode。
此步骤说明：
- 向导自动检测并下载最新稳定版本
- 下载进度会实时显示
- 下载完成后会自动进入下一步
第三步：选择区域并安装 AI
Section titled “第三步：选择区域并安装 AI”Hagicode 支持不同区域的 AI 模型，您可以根据您的位置选择合适的区域。
区域选择说明：
- 中国大陆：优化的网络连接，适合国内用户
- 国际区域：适合海外用户或有特殊网络需求的用户
向导会根据您选择的区域自动配置并启动 AI 安装过程。
此步骤说明：
- AI 助手会引导您完成安装过程
- 请按照屏幕提示操作
- 如遇问题，可以点击”需要帮助”获取支持
第四步：启动服务
Section titled “第四步：启动服务”AI 安装完成后，向导将启动 Hagicode Server 服务。
此步骤说明：
- Hagicode Server 会在后台自动启动
- 启动过程通常只需要几秒钟
- 启动完成后，您可以开始使用 Hagicode
服务启动完成
Section titled “服务启动完成”当 Hagicode Server 成功启动后，您将看到以下界面。
点击”打开 Hagicode”按钮即可开始使用。
首次进入 Hagicode 时，您可以通过内置向导创建您的第一个项目。
创建项目的步骤：
- 选择”创建新项目”
- 配置项目名称和路径
- 选择编程语言和框架
- 配置 API 设置
- 完成项目创建
导入 Git 仓库
Section titled “导入 Git 仓库”如果您已有现有的 Git 仓库，可以轻松导入到 Hagicode 中。
导入步骤：
- 点击”导入项目”
- 输入包含 Git 仓库的文件夹路径
- Hagicode 会自动扫描该文件夹下的所有 Git 仓库
- 选择要导入的仓库并确认
Hagicode Desktop 支持多版本管理，您可以在不同版本之间自由切换。
- 打开 Hagicode Desktop
- 进入”版本管理”页面
- 选择要切换的版本
- 点击”切换版本”按钮
- 等待切换完成
启动和停止服务
Section titled “启动和停止服务”Hagicode Desktop 提供了简单的方式来管理 Hagicode Server 服务。
在 Desktop 应用程序的首页，点击”启动服务”按钮即可启动 Hagicode Server。
要停止 Hagicode Server，点击首页的”停止服务”按钮。
安装完成后，您可以继续以下步骤：
如果安装过程中遇到问题：
- 检查网络连接：确保能够访问互联网
- 检查磁盘空间：确保有足够的磁盘空间
- 以管理员身份运行：在 Windows 上，右键点击安装程序，选择”以管理员身份运行”
- 查看日志文件：安装程序会生成详细的日志文件，可以帮助诊断问题
依赖项安装失败
Section titled “依赖项安装失败”如果依赖项安装失败：
- 检查系统兼容性：确保您的操作系统满足最低要求
- 手动安装依赖项：可以手动下载并安装 .NET 运行时
- 检查防火墙设置：确保防火墙没有阻止安装程序
服务启动失败
Section titled “服务启动失败”如果 Hagicode Server 无法启动：
- 检查端口占用：确保端口 45000 未被其他程序占用
- 检查防火墙设置：确保防火墙允许 Hagicode Server 访问网络
- 重启应用程序：尝试重启 Hagicode Desktop
- 查看日志：在 Desktop 应用程序中查看详细的错误日志
需要更多帮助？
Section titled “需要更多帮助？”如果您遇到此处未涵盖的问题：
- 查看 GitHub Issues 寻找类似问题
- 访问我们的社区论坛寻求帮助
- 提交新的 Issue，详细描述您的问题