创建您的第一个项目
欢迎来到 Hagicode！安装完成后,让我们创建你的第一个项目。本指南会带你一步步完成设置,从准备代码仓库到初始化 OpenSpec,就像朋友手把手教你一样。
在创建第一个项目之前，请确保你具备：
- 一个想要使用 Hagicode 管理的代码仓库
- 已安装并配置 Git
- 对命令行操作的基本了解
别担心，这些都很简单！
步骤 1：准备您的代码仓库
Section titled “步骤 1：准备您的代码仓库”在将项目添加到 Hagicode 之前，您需要准备一个想要用 Hagicode 管理的代码仓库。
克隆您的代码仓库
Section titled “克隆您的代码仓库”如果您想要管理的代码已经在远程仓库（GitHub、GitLab 等）中，请将其克隆到本地：
# 克隆您的代码仓库到本地git clone https://github.com/your-username/your-repo.gitcd your-repo克隆后，记下仓库的本地路径（例如：C:\Users\YourName\Projects\your-repo 或 /home/yourname/projects/your-repo），在下一步中您将需要这个路径。
如果您的代码只在本地
Section titled “如果您的代码只在本地”如果您想要管理的代码还在本地，尚未推送到远程仓库：
cd /path/to/your/projectgit initgit add .git commit -m "Initial commit"建议在 GitHub/GitLab 上创建远程仓库并推送：
git remote add origin https://github.com/your-username/your-repo.gitgit push -u origin main步骤 2：在 Hagicode 界面中添加项目
Section titled “步骤 2：在 Hagicode 界面中添加项目”现在让我们将项目添加到 Hagicode 界面。
访问项目页面
Section titled “访问项目页面”- 在浏览器中导航到
http://127.0.0.1:34567 - 点击导航侧边栏中的 Projects（项目）
- 点击 Add Project（添加项目）按钮
配置项目设置
Section titled “配置项目设置”填写项目信息：
填写完必填信息后：
- 点击 创建项目按钮添加项目
- Hagicode 将验证仓库路径
- 您的项目将出现在项目列表中
步骤 3：初始化 SDD
Section titled “步骤 3：初始化 SDD”SDD（软件设计文档）是 Hagicode 中用于管理项目设计和变更的重要组件。在项目中初始化 SDD 会创建管理变更所需的必要结构。
运行 SDD 初始化
Section titled “运行 SDD 初始化”在项目概览中，找到 SDD 部分：
- 点击项目的 SDD tab
- 点击 初始化 SDD 按钮
步骤 4：优化 project.md
Section titled “步骤 4：优化 project.md”Hagicode 会自动为您优化 project.md 文件，添加详细的项目信息和提示词配置。
- 在项目详情页面，点击右上角的 优化 按钮
- Hagicode 将自动分析您的代码仓库并生成优化的 project.md 内容
步骤 5：提交到版本控制
Section titled “步骤 5：提交到版本控制”完成 SDD 初始化和 project.md 优化后，需要将这些重要的配置文件提交到您的版本控制系统。
提交所有更改
Section titled “提交所有更改”将所有生成的文件和优化后的配置提交到您的仓库：
cd /path/to/your/projectgit add .git commit -m "初始化 SDD 并优化 project.md"恭喜！您已经在 Hagicode 中创建了第一个项目。以下是一些推荐的后续步骤：