# friend

**Repository Path**: fishfishh/friend

## Basic Information

- **Project Name**: friend
- **Description**: 神人收集梦想生活
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://friend.gamer.gd/
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 朋友收集 梦想生活

一款可爱的生活模拟游戏，玩家可以创建角色、管理岛屿、建立关系并体验各种有趣的事件。

## 🎮 游戏特色

- **角色创建系统**：丰富的捏脸功能，支持拖拽调整外貌细节
- **岛屿管理**：建设和管理自己的梦想岛屿，支持扩建
- **设施解锁系统**：根据居民人数和满意度逐步解锁设施
- **心情球系统**：满足居民需求获得心情球，用于许愿
- **关系系统**：与角色建立友谊、恋爱关系
- **背包系统**：购买物品存入背包，对角色使用提升属性
- **随机事件**：各种有趣的随机事件和隐藏剧情
- **成就系统**：完成各种挑战获得成就
- **存档系统**：支持本地保存和自动保存

## 🛠️ 技术栈

- **框架**: React 18 + TypeScript
- **构建工具**: Vite 6
- **样式**: Tailwind CSS 3
- **图标**: Lucide React
- **状态管理**: React Context API
- **数据存储**: Browser localStorage（本地存储）

## 📦 安装与运行

### 前置要求

- Node.js >= 18.0.0
- npm >= 9.0.0

### 开发环境

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 访问地址
# http://localhost:5173
```

### 生产构建

```bash
# 构建生产版本
npm run build

# 预览生产版本
npm run preview
```

### 代码检查

```bash
# ESLint检查
npm run lint

# TypeScript类型检查
npm run typecheck
```

## 📁 项目结构

```
src/
├── components/          # React组件目录
├── context/             # 状态管理
├── data/                # 数据文件
├── types/               # TypeScript类型定义
├── App.tsx              # 主应用组件
├── index.css            # 全局样式
└── main.tsx             # 应用入口
```

## 📖 项目文档

详细的项目文档请查看：[docs/project.md](docs/project.md)

## 📄 许可证

MIT License

---

**游戏名**: 朋友收集 梦想生活  
**版本**: 1.0.0  
**开发者**: 匿名的）神人制作组