# wzy

**Repository Path**: no2bear/wzy

## Basic Information

- **Project Name**: wzy
- **Description**: wzy项目仓库
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-11
- **Last Updated**: 2025-12-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一堂武智院 🏯

> 科技禅意 · 智慧修行 · 像素风AI社区

## 项目介绍

**一堂武智院** 是一款融合科技与禅意的像素风少林寺主题AI社区。玩家扮演一位修行者，在像素化少林寺地图中自由探索，体验传统文化与现代科技的完美结合。

🎮 **在线体验**: [立即开始游戏](https://gitee.com/no2bear/wzy/raw/main/index.html)

## 🎯 核心特色

### 🏛️ 精美地图设计
- **10×20像素化地图**: 精心设计的少林寺场景布局
- **多样地形元素**: 包含🏯寺庙、🧱墙壁、🌸樱花、🌿竹林等装饰
- **碰撞检测系统**: 真实的障碍物限制，增强游戏沉浸感

### 👦 角色控制系统
- **WASD/方向键控制**: 支持键盘操作的灵活控制方式
- **触摸屏支持**: 移动设备友好，滑动即可控制移动
- **实时位置追踪**: 动态显示当前坐标和移动步数

### 🎨 视觉体验
- **科技禅意配色**: 金色(#FFD700)与深黑(#1A1A1A)的优雅搭配
- **像素艺术风格**: 简洁而富有表现力的视觉设计
- **响应式布局**: 完美适配桌面端和移动端设备

## 🎮 如何游玩

### 桌面端操作
```
↑ ↓ ← →  - 移动小和尚
W A S D    - 替代方向键控制
R          - 重置游戏位置
空格        - 暂停/继续游戏
H          - 显示帮助信息
```

### 移动端操作
- **滑动控制**: 在游戏地图上滑动手指控制移动方向
- **触感反馈**: 碰撞时的视觉震动效果

## 🛠️ 技术架构

### 前端技术栈
- **原生JavaScript**: 无框架依赖的高性能实现
- **模块化设计**: 采用ES6 Class的组件化架构
- **CSS Grid布局**: 灵活的网格系统实现地图渲染
- **响应式CSS**: 媒体查询适配多设备屏幕

### 核心组件
- **Game主控制器**: 协调游戏循环和组件通信
- **MapManager**: 地图生成、渲染和碰撞检测
- **SpriteController**: 精灵位置管理和移动逻辑
- **EventHandler**: 用户输入处理和事件响应

### 设计模式
- **观察者模式**: 事件驱动的游戏状态管理
- **工厂模式**: 地图元素和精灵的统一创建
- **策略模式**: 不同设备的输入控制策略

## 📁 项目结构

```
wzy/
├── index.html              # 游戏主页面
├── css/
│   └── style.css           # 样式文件（科技禅意主题）
├── js/
│   ├── game.js            # 游戏主控制器
│   ├── map.js             # 地图管理器
│   ├── sprite.js          # 精灵控制器
│   └── events.js          # 事件处理器
├── docs/
│   ├── PRD.md             # 产品需求文档
│   ├── DESIGN_SPEC.md     # 设计规范文档
│   └── TECH_PLAN.md       # 技术实现方案
└── README.md              # 项目说明文档
```

## 🚀 快速开始

### 本地运行
1. **克隆项目**
   ```bash
   git clone https://gitee.com/no2bear/wzy.git
   cd wzy
   ```

2. **直接打开**
   ```bash
   # 使用默认浏览器
   open index.html

   # 或使用Chrome浏览器
   google-chrome index.html
   ```

### 服务器部署
```bash
# 使用Python简单服务器
python3 -m http.server 8000

# 使用Node.js服务器
npx serve .

# 或部署到任意Web服务器
```

## 🎨 设计理念

### 科技与禅意的融合
- **科技美学**: 现代化的UI设计和流畅的交互体验
- **禅意文化**: 传统文化元素与现代科技的和谐统一
- **极简主义**: 去除冗余，保留核心游戏体验

### 用户体验优先
- **即开即玩**: 无需下载安装，打开即玩
- **跨平台兼容**: 支持桌面端、移动端多设备访问
- **直观操作**: 简单易懂的控制方式，适合全年龄段玩家

## 📊 技术规格

| 项目 | 规格 |
|------|------|
| 地图尺寸 | 10×20 网格 |
| 单元格大小 | 64×64 像素（桌面）/ 40×40 像素（移动） |
| 支持设备 | iOS 9+, Android 5+, Chrome 60+, Firefox 55+ |
| 文件大小 | < 100KB |
| 加载时间 | < 2秒 |

## 🔧 开发说明

### 环境要求
- 现代浏览器（支持ES6+）
- 本地Web服务器（用于开发测试）

### 开发工具
- **Chrome DevTools**: 调试和性能分析
- **Live Server**: 实时预览开发效果
- **Git**: 版本控制管理

### 扩展建议
- **音效系统**: 添加背景音乐和操作音效
- **存档功能**: 本地存储游戏进度
- **多语言支持**: 国际化文本系统
- **关卡编辑器**: 可视化地图设计工具

## 🤝 贡献指南

我们欢迎社区贡献！请遵循以下步骤：

1. **Fork项目** 到你的Gitee账户
2. **创建分支** (`git checkout -b feature/新功能`)
3. **提交更改** (`git commit -am '添加新功能'`)
4. **推送分支** (`git push origin feature/新功能`)
5. **创建Pull Request**

### 代码规范
- 使用ES6+语法
- 保持代码简洁易读
- 添加必要的注释
- 遵循现有的文件结构

## 📝 更新日志

### v1.0.0 (2025-01-22)
- ✨ 完成10×20像素风少林寺地图
- 👦 实现小和尚角色移动控制
- 🎨 科技禅意主题UI设计
- 📱 完善响应式布局支持
- 🐛 修复精灵移动定位问题

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🙏 致谢

- **灵感来源**: Stanford Small Town虚拟社区项目，花辣子米同学、鱼藻同学、晓斌组长、树熊组长、新壮同学等等武智院组的一堂同学们。
- **文化元素**: 少林寺传统文化符号
- **技术支持**: 一堂武智院开发组

## 📞 联系方式

- **项目主页**: https://gitee.com/no2bear/wzy
- **问题反馈**: [Issues页面](https://gitee.com/no2bear/wzy/issues)
- **游戏体验**: https://gitee.com/no2bear/wzy/raw/main/index.html

---

> **"武以修身，智以养性"** - 在科技世界中体验传统智慧