Kuuila Game

# kuuila-game - Kuuila互动游戏框架 v3.0

> 🎮 通用互动游戏框架，支持文字冒险、卡牌系统、多人游戏等

**版本**: v3.0.0 | **作者**: kuuila | **许可**: MIT

---

## 核心功能

| 系统 | 版本 | 描述 |
|------|------|------|
| 🃏 卡牌系统 | v2.2 | 155张卡牌，6大类型 |
| 🎭 三幕式结构 | v2.3 | 序幕/破章/急章 |
| ⏱️ 回合管理 | v2.3 | 回合状态机 |
| 👑 城主规则 | v2.4 | 轮换机制，NPC扮演 |
| 🌤️ 天气系统 | v2.4 | 6种天气 |
| ⚔️ 战斗系统 | v2.5 | 万智牌风格 |
| 👹 Boss系统 | v2.5 | Boss卡组 |
| 👤 角色系统 | v2.6 | 属性/技能/成长 |
| 🎨 主题系统 | v2.7 | 6大主题 |
| 📖 剧情引擎 | v2.8 | 转换链、诡计生成 |
| 📜 剧本系统 | v2.9 | 26个克苏鲁剧本 |
| ♾️ 无尽模式 | v3.1 | 每日行动点、定时反馈、持久世界 |
| 📜 圣人数据 | v1.0 | 623条天主教圣徒/节日记录 |

### 游戏模式
- 单人冒险 | 猜谜游戏 | 多人武侠(协作/对抗/轮流) | 沙箱模式 | ♾️ **无尽模式**

---

## ♾️ 无尽模式 (Endless Mode)

> 持续运行的日常游戏世界，每日限定行动，定时反馈

### 核心机制

```
┌─────────────────────────────────────────────────────────────┐
│                    无尽模式生命周期                          │
└─────────────────────────────────────────────────────────────┘
     ┌──────────────────────────────────────────────┐
     │              管理员启动                        │
     │         启动无尽模式 [世界名]                   │
     └──────────────────────────────────────────────┘
                         ↓
     ┌──────────────────────────────────────────────┐
     │           每日定时触发 (如 08:00)              │
     │  • 重置所有玩家行动点                          │
     │  • 生成每日世界事件                            │
     │  • 推送世界状态报告                            │
     │  • 触发随机遭遇                                │
     └──────────────────────────────────────────────┘
                         ↓
     ┌──────────────────────────────────────────────┐
     │           玩家行动阶段 (全天)                   │
     │  • 消耗行动点进行探索/战斗/交互                 │
     │  • 行动点耗尽则当天无法行动                     │
     │  • 等待次日重置                                │
     └──────────────────────────────────────────────┘
                         ↓
     ┌──────────────────────────────────────────────┐
     │           每日结算 (如 23:00)                   │
     │  • 统计当日行动                                │
     │  • 计算收益/损失                               │
     │  • 更新世界状态                                │
     │  • 生成日报                                    │
     └──────────────────────────────────────────────┘
                         ↓
              [循环往复，直到管理员结束]
                         ↓
     ┌──────────────────────────────────────────────┐
     │              管理员结束                        │
     │            结束无尽模式                        │
     └──────────────────────────────────────────────┘
```

### 配置参数

| 参数 | 默认值 | 说明 |
|------|--------|------|
| `dailyActionPoints` | 5 | 每日行动点上限 |
| `resetTime` | "08:00" | 每日重置时间 (Asia/Shanghai) |
| `reportTime` | "23:00" | 日报生成时间 |
| `maxDuration` | null | 最大持续天数 (null=无限) |
| `autoSave` | true | 自动保存世界状态 |

### 行动点系统

```javascript
// 玩家状态
{
  playerId: "player_001",
  actionPoints: {
    max: 5,           // 每日上限
    current: 3,       // 当前剩余
    lastReset: "2026-03-21T00:00:00Z"
  },
  dailyActions: [     // 当日行动记录
    { type: "explore", cost: 1, time: "08:30", result: "发现神秘洞穴" },
    { type: "battle", cost: 1, time: "10:15", result: "击败哥布林" }
  ]
}
```

### 每日反馈内容

```
🌅 【无尽世界日报】2026-03-21

📍 当前世界：灵安城
👥 活跃玩家：5人
⏱️ 世界年龄：第 42 天

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 今日世界事件：
• 清晨：迷雾笼罩了北部森林
• 正午：商队抵达城市，交易开放
• 黄昏：神秘旅者在酒馆现身

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎮 你的状态：
• 行动点：3/5 (今日剩余)
• 位置：城市广场
• 状态：健康

💡 今日推荐：
• 探索北部森林 (迷雾可能隐藏秘密)
• 与商队交易 (稀有物品上架)
• 酒馆打听消息 (神秘旅者线索)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

输入「行动 [类型]」开始今日冒险！
```

### 无尽模式命令

| 命令 | 说明 |
|------|------|
| `启动无尽模式 [世界名]` | 管理员：启动无尽世界 |
| `结束无尽模式` | 管理员：结束当前世界 |
| `无尽状态` | 查看世界状态 |
| `我的行动点` | 查看剩余行动点 |
| `行动 [类型] [目标]` | 消耗行动点执行行动 |
| `今日事件` | 查看今日世界事件 |
| `世界历史` | 查看世界大事件记录 |
| `无尽设置 [参数] [值]` | 管理员：调整配置 |

### 行动类型消耗

| 行动类型 | 消耗 | 说明 |
|----------|------|------|
| 探索 | 1 | 探索区域，可能发现秘密 |
| 战斗 | 2 | 与敌人战斗 |
| 交互 | 1 | 与NPC对话/交易 |
| 休息 | 0 | 恢复状态，不消耗点数 |
| 制造 | 2 | 制作物品 |
| 研究 | 2 | 研究线索/技能 |

### 每日重置触发

```javascript
// 定时任务配置示例
{
  "type": "endless_mode_reset",
  "schedule": "0 8 * * *",  // 每天 08:00
  "timezone": "Asia/Shanghai",
  "actions": [
    "resetActionPoints",
    "generateDailyEvents", 
    "pushWorldReport",
    "triggerRandomEncounter"
  ]
}
```

### 世界持久化

```javascript
// world_state.json
{
  "worldId": "lingan_endless_001",
  "name": "灵安城",
  "theme": "修仙",
  "age": 42,  // 天数
  "players": { ... },
  "events": [ ... ],
  "state": {
    "weather": "多云",
    "mood": "紧张",
    "ongoingEvents": ["商队访问", "迷雾笼罩"]
  },
  "history": [
    { day: 1, event: "世界诞生" },
    { day: 15, event: "首次Boss战" },
    { day: 42, event: "迷雾开始蔓延" }
  ]
}
```

### 管理员工具

| 命令 | 说明 |
|------|------|
| `无尽玩家列表` | 查看所有玩家状态 |
| `无尽强制重置` | 手动触发每日重置 |
| `无尽添加事件 [事件]` | 注入世界事件 |
| `无尽调整点数 [玩家] [数量]` | 调整玩家行动点 |
| `无尽统计` | 查看世界统计数据 |

### 📜 圣人数据 (saint_details.json)

> 623条天主教圣徒/节日记录，可作为无尽模式中的特殊圣人/事件触发源

**数据位置**: `data/endless/saint_details.json`

**数据结构**:
```json
{
  "url": "https://...",
  "name": "主显节",
  "subtitle": "Epiphany of the Lord",
  "content": "节日详细经文与解说...",
  "images": ["https://..."],
  "tags": []
}
```

**可用字段**: name(名称), subtitle(副标题), content(正文), images(图片), tags(标签)

### 适用场景

- 🏠 **公会日常** — 成员每日打卡完成任务
- 🎯 **长线养成** — 角色持续成长
- 🌍 **共建世界** — 多人共同塑造世界
- 📅 **定期聚会** — 固定时间集体活动

---

## 6大主题

武侠 | 修仙 | 克苏鲁 | 赛博朋克 | 中世纪战团 | 民国上海滩

---

## 命令列表

### 基础
- `启动游戏 [类型]` - 启动游戏
- `开始游戏` / `退出游戏`
- `查看状态`

### 卡牌
- `抽卡 [数量]` - 抽卡
- `查看手牌` / `打出手牌 [索引]`
- `组合 [索引...]` - 生成故事
- `洗牌 [类型]` / `重置卡组`

### 三幕式
- `下一回合` - 推进回合
- `当前阶段` / `设定主线 [任务]`
- `添加敌人 [名称]` / `开始Boss战`

### 城主
- `城主状态` / `轮换城主`
- `地块行动 [类型]` / `天气判定`

### 主题
- `切换主题 [主题]`
- `当前主题` / `主题列表`

### 剧本
- `剧本列表` / `剧本详情 [id]`
- `选择剧本 [id]` / `随机剧本 [难度]`
- `开始剧本` / `推进剧本` / `完成剧本`
- `分配角色 [玩家] [角色]`
- `发现线索 [线索ID]` / `分析线索 [线索ID]`
- `关联线索 [线索1] [线索2]`
- `线索图谱` / `剧本进度`

---

## 版本历史

- **v3.1.0** ♾️ 新增无尽模式：每日行动点系统、定时反馈机制、持久世界状态、管理员工具
- **v3.0.0** 🎉 正式发布版！完整功能集成
- v2.9.0 - 剧本系统（26个克苏鲁剧本、线索管理、角色分配）
- v2.8.0 - 剧情引擎（转换链、诡计生成）
- v2.7.0 - 6大主题系统
- v2.6.0 - 角色系统
- v2.5.0 - 战斗+Boss系统
- v2.4.0 - 城主规则+天气
- v2.3.0 - 三幕式+回合管理
- v2.2.0 - 卡牌系统(155张)
- v1.0.0 - 基础版本

---

*🎮 Kuuila Game - 让每一次游戏都是独特的故事*