# puzzle-game

**Repository Path**: longfei/puzzle-game

## Basic Information

- **Project Name**: puzzle-game
- **Description**: 益智游戏
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-27
- **Last Updated**: 2026-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 益智游戏合集 (Puzzle Games Hub)

> 面向儿童的益智游戏集合，通过游戏锻炼逻辑思维、空间推理、策略规划与数字敏感度。

## 游戏清单

| 游戏 | 中文名 | 训练能力 | 难度 |
|------|--------|----------|------|
| Sokoban | 推箱子 | 空间推理、规划、逻辑 | 简单-困难 |
| Reversi | 黑白子 | 策略、预判、战术 | 中等 |
| Number Guessing | 猜数字 | 数字推理、演绎 | 简单 |
| Sudoku 6x6 | 六宫格 | 逻辑、约束满足 | 简单-中等 |
| Sudoku 9x9 | 九宫格 | 高级逻辑、排除法 | 中等-困难 |

## 技术选型

- **框架**: Vue 3 (Composition API + `<script setup>`)
- **构建工具**: Vite
- **路由**: Vue Router
- **状态管理**: Pinia (可选，用于跨游戏统计)
- **样式**: 纯 CSS / UnoCSS
- **包管理**: npm

> 也支持纯静态 HTML 单文件模式，便于快速分享单个游戏。

## 快速开始

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 打包构建
npm run build

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

## 目录结构

```
box/
├── .trae/
│   └── skills/
│       └── puzzle-games/
│           └── SKILL.md          # 益智游戏开发技能
├── docs/
│   ├── DEVELOPMENT_PLAN.md       # 开发计划
│   ├── GAMES.md                  # 游戏规则与设计说明
│   └── ARCHITECTURE.md           # 技术架构
├── src/
│   ├── games/                    # 各游戏模块
│   │   ├── sokoban/              # 推箱子
│   │   ├── reversi/              # 黑白子
│   │   ├── guess-number/         # 猜数字
│   │   ├── sudoku-6/             # 六宫格
│   │   └── sudoku-9/             # 九宫格
│   ├── components/               # 共享 UI 组件
│   ├── composables/              # 可复用逻辑 (useGame, useTimer)
│   ├── router/                   # 路由配置
│   ├── App.vue                   # 根组件
│   └── main.js                   # 入口
├── public/
├── index.html
├── package.json
└── vite.config.js
```

## 设计理念

### 儿童友好原则
- **视觉清晰**: 大格子、高对比色、友好图标
- **即时反馈**: 有效/无效操作即时动画反馈
- **宽容机制**: 提供撤销/重置按钮，不设严厉惩罚
- **鼓励为主**: 正向激励文案 ("太棒了！", "再试一次！")
- **渐进难度**: 从简单开始，逐步解锁更难关卡
- **无时间压力**: 计时器为可选功能，适合大龄儿童
- **多端输入**: 支持键盘、鼠标、触屏

## 文档导航

- [开发计划](docs/DEVELOPMENT_PLAN.md) — 各游戏开发阶段与里程碑
- [游戏说明](docs/GAMES.md) — 每款游戏的规则、关卡设计与 UX
- [技术架构](docs/ARCHITECTURE.md) — 项目结构、共享模块与构建配置

## 学习笔记

学习笔记放在 `public/note` 目录中，按分类子目录组织。每个 Markdown 文件必须以 front matter 开始：

```md
---
title: 笔记标题
category: frontend
date: 2026-09-17
tags: JavaScript,基础
excerpt: 列表页展示的摘要。
---
```

运行 `npm run dev` 或 `npm run build` 时，脚本会自动扫描目录并生成索引。新笔记会同时出现在学习笔记列表和左侧导航中，链接格式为 `/notes/:category/:slug`。

## 适用人群

- 6-12 岁儿童（亲子共玩）
- 想训练逻辑思维的低龄学习者
- 教师/家长作为教学辅助工具

## License

MIT