# weiqi

**Repository Path**: tanjiajun/weiqi

## Basic Information

- **Project Name**: weiqi
- **Description**: 围棋对战小游戏，可以支持本地双人对战
- **Primary Language**: Unknown
- **License**: Vim
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎮 围棋对战游戏

一个跨平台的围棋对战游戏，支持 Android、iOS、Web。

## ✨ 功能特性

### 🎯 游戏模式
- **吃子模式**：先吃掉指定数量对方棋子获胜（3子/5子/10子）
- **围空模式**：先围住指定目数获胜（20目/40目/60目/80目）
  - 支持 9路、13路、19路棋盘

### 🤖 对战模式
- **人机对战**：与 AI 下棋，支持 25 级到 9 段难度
  - 低难度：随机下棋，适合新手
  - 中难度：基础策略，适合入门
  - 高难度：专业策略，适合高手
- **同屏对战**：两人在同一设备轮流下棋
- **联网对战**：通过网络与好友对战

### 🎨 特色功能
- **自定义棋子颜色**：黑白双方可自选颜色
- **特效模式**：吃子和围空时触发炫酷动画和音效
- **AI 难度分级**：从 25 级到 9 段，真实模拟不同水平
- **开局定式**：高段位 AI 会占据星位等关键位置
- **智能评估**：AI 会考虑吃子、防守、连接、棋形等因素

## 📱 安装方式

### 方式 1：Android（推荐，最简单）

```bash
# 1. 安装 Android Studio
# 下载：https://developer.android.com/studio

# 2. 构建并生成 APK
cd /Users/tanjiajun/my/kgit/app
npm install
npx cap add android
npm run build:android

# 3. 在 Android Studio 中：
#    Build → Build Bundle(s) / APK(s) → Build APK(s)

# 4. APK 位置：
#    android/app/build/outputs/apk/debug/app-debug.apk

# 5. 传输到手机并安装
```

**详细指南**：查看 [ANDROID_GUIDE.md](./ANDROID_GUIDE.md)

---

### 方式 2：iOS

```bash
# 需要 Mac 电脑

# 1. 安装 Xcode（从 App Store）

# 2. 安装 CocoaPods
sudo gem install cocoapods

# 3. 构建项目
cd /Users/tanjiajun/my/kgit/app
npm install
npx cap add ios
npm run build:ios

# 4. 在 Xcode 中配置签名并运行到 iPhone/iPad
```

**详细指南**：查看 [QUICK_IOS_GUIDE.md](./QUICK_IOS_GUIDE.md) 或 [IOS_DEPLOYMENT.md](./IOS_DEPLOYMENT.md)

---

### 方式 3：Web（本地运行）

```bash
cd /Users/tanjiajun/my/kgit/app
npm install
npm run dev

# 访问：http://localhost:3000
```

## 🛠️ 开发命令

```bash
# 开发模式
npm run dev

# 构建生产版本
npm run build

# Android
npm run build:android      # 构建并打开 Android Studio
npm run update:android     # 更新代码到 Android
npm run apk:debug          # 生成调试版 APK
npm run apk:release        # 生成正式版 APK

# iOS
npm run build:ios          # 构建并打开 Xcode
npm run update:ios         # 更新代码到 iOS
```

## 📂 项目结构

```
app/
├── src/
│   ├── components/        # React 组件
│   │   ├── Menu.tsx       # 主菜单
│   │   ├── GameBoard.tsx  # 棋盘组件
│   │   ├── GameScreen.tsx # 游戏界面
│   │   └── Settings.tsx   # 设置界面
│   ├── utils/
│   │   ├── goLogic.ts     # 围棋规则逻辑
│   │   └── ai.ts          # AI 算法
│   ├── store/
│   │   └── gameStore.ts   # Zustand 状态管理
│   └── types/
│       └── game.ts        # TypeScript 类型定义
├── android/               # Android 项目（自动生成）
├── ios/                   # iOS 项目（自动生成）
└── capacitor.config.ts    # Capacitor 配置
```

## 🎯 技术栈

- **前端框架**：React + TypeScript
- **构建工具**：Vite
- **状态管理**：Zustand
- **动画**：Framer Motion
- **跨平台**：Capacitor
- **移动端**：Android Studio + Xcode

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License

---

## 📚 相关文档

- [Android 安装指南](./ANDROID_GUIDE.md) ⭐ 推荐
- [iOS 快速指南](./QUICK_IOS_GUIDE.md)
- [iOS 详细指南](./IOS_DEPLOYMENT.md)
- [部署指南](./DEPLOYMENT.md)
- [功能列表](./FEATURES.md)
- [问题排查](./TROUBLESHOOTING.md)

---

**🎉 开始你的围棋对战之旅吧！**