# 快速开始

本文档说明如何安装和配置 Alfred·阿福。

## 1. 安装依赖

```bash
bun install
```

## 2. 准备配置文件

```bash
cp config.example.yaml config.yaml
```

按需编辑 `config.yaml` 中的监听地址、日志、存储路径等配置。配置文件为启动时的必传参数。

## 3. 启动开发模式

```bash
bun run dev config.yaml
```

访问 http://127.0.0.1:5173 查看应用。

## 下一步

- [配置文件](config.md) — 了解 YAML 结构、变量语法和配置字段
- [部署文档](deploy.md) — 生产构建和运行方式
- [开发文档](../development/README.md) — 开发规范、架构和质量门禁

## 功能介绍

| 功能     | 路径        | 说明                                 |
| -------- | ----------- | ------------------------------------ |
| 仪表盘   | `/`         | 应用总览，展示运行时元信息           |
| 项目管理 | `/projects` | 创建、编辑、归档、恢复和永久删除项目 |
| 用户管理 | `/users`    | 页面建设中                           |
| 系统设置 | `/settings` | 页面建设中                           |