Hagicode Desktop

Hagicode 提供两种部署方式：Desktop 版本和 Server 版本。两种版本各有优势，但都采用用户自主管理服务器和数据的方式，因此都具备更好的数据保护特性。

Desktop 版本

• 在本地电脑上运行，更加轻便
• 无需配置服务器，开箱即用
• 适合个人开发者和轻量使用场景
• 所有数据完全本地化

Server 版本

• 可部署在远程服务器上
• 支持多用户远程访问
• 更适合团队协作和广泛扩展
• 为未来的企业级功能和多设备同步做准备

无论选择哪种版本，你都完全掌控自己的服务器和数据，享受更好的隐私保护和数据安全。

Hagicode Desktop 本质上是一个启动器，安装完成后首次启动时，它会引导你完成以下步骤：

• 下载 Hagicode Core： Desktop 会自动检测并提示下载 Hagicode 核心组件
• 安装核心组件： 按照界面提示完成核心组件的安装
• 配置 AI 编码助手： 根据需要配置 Claude Code 等助手

整个过程在 Desktop 界面中都有清晰的提示指引，请确保在首次启动时保持网络连接以完成核心组件的下载。

完成这些步骤后，你就可以正常使用 Hagicode Desktop 的所有功能了。

Desktop 会自动检查更新。当有新版本可用时，会在界面右上角显示提示。你也可以在"设置"中手动检查更新。

Hagicode Desktop 通过 Agent CLI 提供强大的 AI 编码助手支持：

• 当前支持：Claude Code（主要支持）
• 即将支持：Copilot、Gemini、Kimi Code 等各类 CLI Agent

我们正在积极扩展对更多 AI 编码助手的支持，敬请期待后续版本的更新。

Hagicode Desktop 使用 Electron 框架发布，所有数据都存储在 Electron 的 UserData 目录中：

• Windows: C:\Users\<用户名>\AppData\Roaming\Hagicode Desktop
• macOS: ~/Library/Application Support/Hagicode Desktop
• Linux: ~/.config/Hagicode Desktop

这是 Electron 应用的标准数据存储位置，确保你的配置和数据与应用程序生命周期保持一致。

• Windows: 通过"设置 > 应用"卸载，或运行卸载程序
• macOS: 删除 Applications 文件夹中的 Hagicode Desktop
• Linux: 使用包管理器卸载或删除 AppImage 文件

仅在以下情况需要网络连接：

• 首次下载和安装应用
• 使用 AI 编码助手（如 Claude Code、Copilot 等）
• 检查和下载应用更新

应用本体可以离线运行，但 AI 编码助手功能需要网络连接来调用相应的服务。

如果你在使用 Hagicode Desktop 时遇到问题或有任何建议，我们提供多种方式与你联系：

• 官方网站： https://hagicode.com
  访问我们的官网获取最新动态、文档和教程。
• GitHub 仓库： https://github.com/HagiCode-org/site
  在 GitHub 上提交 Issue、参与讨论或查看源代码。欢迎给我们一个 Star ⭐
• QQ 群： 技术支持群 610394020
  加入我们的 QQ 群与其他用户交流，获取实时帮助。
• 邮箱支持： support@hagicode.com
  通过邮件联系我们，我们会在收到邮件后尽快回复。

我们欢迎所有形式的反馈，包括功能建议、Bug 报告和使用体验分享。你的意见对我们非常重要！