# temporal-embers

**Repository Path**: SlayerNux_admin/temporal-embers

## Basic Information

- **Project Name**: temporal-embers
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 时空余烬 (Temporal Embers)

> 一款以认知科学为主题的回合制卡牌 Roguelike 游戏

## 概述

**时空余烬**是一款 Web 端卡牌 Roguelike 游戏，玩家扮演"拾烬者"，在碎裂的时间废墟中收集认知碎片、对抗异变实体。核心机制围绕**认知分支**（逻辑/直觉/情感/知识）和**疯狂反转系统**展开。

## 技术栈

- **语言**: TypeScript (strict mode)
- **渲染**: PixiJS v8
- **构建**: Vite 6
- **测试**: Vitest
- **平台**: Web (Chrome/Firefox/Safari)

## 项目结构

```
├── src/                    # 游戏源码
│   ├── core/               # 核心引擎 (App, EventBus, RNG, etc.)
│   ├── game/               # 游戏逻辑
│   │   ├── battle/         # 战斗系统
│   │   ├── cards/          # 卡牌系统
│   │   ├── roguelike/      # Roguelike 系统 (Run, Map, Encounter)
│   │   └── meta/           # 场外进度 (Sanctuary, MetaState)
│   ├── editor/             # 编辑器/模拟器
│   ├── view/               # PixiJS 视图层
│   └── utils/              # 工具函数
├── tests/                  # 测试
│   └── unit/               # 30 个单元测试文件, 500+ 测试用例
├── assets/                 # 资源文件
├── .aide/                  # aide 工作流数据
│   ├── docs/               # 设计文档 (40+ 个)
│   ├── knowledge/          # 知识库 (173 实体, 180 关系)
│   └── memory/             # Agent 记忆
├── index.html              # 游戏入口
├── editor.html             # 编辑器入口
├── package.json
├── tsconfig.json
├── vite.config.ts
└── vitest.config.ts
```

## 开发

```bash
# 安装依赖
npm install

# 开发服务器
npm run dev

# 类型检查
npx tsc --noEmit

# 运行测试
npx vitest run

# 构建
npm run build
```

## 开发进度

本项目使用 aide 工作流系统进行迭代开发，已完成 16 轮迭代 (Phase 1-4)。

### 已实现的核心系统

- ✅ 四认知分支卡牌系统 (40 张)
- ✅ 回合制战斗引擎 (含 AI、伤害计算、状态效果)
- ✅ 疯狂反转系统 (MadnessManager + ReversalEngine)
- ✅ 三章节地图生成 (MapGenerator)
- ✅ 遗物系统 (10 个遗物)
- ✅ 认知圣殿场外进度系统
- ✅ 存档系统 (IndexedDB + LocalStorage)
- ✅ PixiJS 完整 UI (BattleScene, MapScene, etc.)
- ✅ 编辑器 + AI 模拟器 (平衡性诊断)
- ✅ 认知试剂系统 (区域异象 + 对照镜)

### 质量指标

| 指标 | 值 |
|------|------|
| TSC 错误 | 0 |
| 测试文件 | 30 |
| 测试用例 | 500+ |
| Vite 构建模块 | 827 |

## License

私有项目