# soul-like-cards

**Repository Path**: cycle-studio/soul-like-cards

## Basic Information

- **Project Name**: soul-like-cards
- **Description**: 类魂卡牌游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 类魂卡牌 - Soul-like Cards

一款基于《黑暗之魂》灵感设计的单人卡牌对战游戏。

## 项目简介

**类魂卡牌**是一款 PVE 回合制卡牌策略游戏，融合了《黑暗之魂》、《血源诅咒》等游戏的核心机制。

### 游戏特色

- **可学习的敌人**：敌人的每种行动都可被玩家的 1~X 种行动克制
- **互相抢招博弈**：玩家和敌人通过速度和韧性的竞争来争夺行动优先权
- **鼓励主动交互**：先出手如果韧伤 > 敌方韧性，可取消对方行动并降低其气势
- **完美选择奖励**：格挡蓝光攻击、闪避红光攻击、成功抢招获得额外奖励
- **严厉的死亡惩罚**：死亡后回到休息房，最大生命值 -2 级，但保留获得的卡牌/装备

### 游戏目标

通过策略选择和熟悉敌人招式，战胜三个区域的 BOSS，获得最终胜利。

---

## 核心机制

### 战斗回合四阶段

1. **我方行动阶段**：移动、打牌、调息、重抽、处决（五选一）、使用消耗品（不限次数）
2. **敌方行动阶段**：翻出敌方行动牌（有眩晕标记则跳过）
3. **我方反应阶段**：打出反应牌或不做任何行动
4. **结算阶段**：比拼速度 → 结算伤害 → 结算韧性 → 检查晕眩 → 移除临时标记 → 生命恢复

### 核心系统

- **气势系统**：用于强化卡牌和发动特殊技能，初始 5 点，上限 10 点
- **韧性系统**：每回合从 0 开始，韧伤 > 目标韧性时可打断敌方行动
- **速度博弈**：速度决定行动结算顺序，速度相同时同时结算
- **晕眩系统**：敌方气势值降到 0 或以下时获得眩晕标记，下回合跳过行动
- **手牌管理**：战斗开始抽 5 张，后续不自动抽牌，手牌不自动弃牌（除非主动选择"重抽"）

### 死亡惩罚

- 回到上一个休息房
- 生命值恢复至满值
- **最大生命值 -2 级**
- 从稀有牌堆抽 3 张卡，选 1 张加入牌组（补偿机制）
- 保留死亡前获得的所有卡牌/装备

---

## 技术栈

- **前端框架**: React 18 + TypeScript 5.7
- **构建工具**: Vite 6
- **桌面应用**: Electron 33
- **样式**: CSS Modules

---

## 开发指南

### 环境要求

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

### 安装依赖

```bash
npm install
```

### 开发命令

```bash
# 启动 Web 开发服务器（浏览器模式）
npm run dev

# 启动 Electron 桌面应用（开发模式）
npm run electron:dev

# 构建生产版本
npm run build

# 预览构建结果
npm run preview

# 构建 Electron 安装包
npm run electron:build

# 代码检查
npm run lint
```

### 项目结构

```
soul-like-cards/
├── electron/              # Electron 主进程
│   ├── main.cjs          # 主进程入口
│   └── preload.cjs       # 预加载脚本
├── src/
│   ├── components/       # React 组件
│   ├── hooks/           # 自定义 Hooks
│   ├── types/           # TypeScript 类型定义
│   ├── utils/           # 工具函数
│   ├── styles/          # 全局样式
│   ├── App.tsx          # 主应用组件
│   └── main.tsx         # React 入口
├── public/              # 静态资源
├── dist/                # 构建输出
├── dist-electron/       # Electron 打包输出
├── index.html           # HTML 模板
├── vite.config.ts       # Vite 配置
├── tsconfig.json        # TypeScript 配置
└── package.json         # 项目配置
```

---

## 游戏文档

- [游戏设计文档（梳理版）](./游戏设计文档（梳理版）.md) - 详细的游戏设计文档
- [技术架构与实现计划](./技术架构与实现计划.md) - 技术实现计划
- [CLAUDE.md](./CLAUDE.md) - 项目开发指南（面向 AI 助手）

---

## 许可证

MIT

---

开始你的传火之旅吧！