水浒传：AI江湖 — 详细玩法说明

《水浒传：AI江湖》 是一款基于浏览器、融合 AI 大模型驱动的 MUD 文字冒险游戏。你将穿越至北宋末年，化身江湖儿女，在梁山泊、东京汴梁、景阳冈等经典场景中自由探索，与宋江、武松、鲁智深等一百零八将相遇结交，书写属于你自己的水浒传奇。

---

1. 概述

属性	说明
游戏名称	水浒传：AI江湖
游戏类型	AI 驱动 MUD 文字冒险 RPG
技术栈	Next.js 16 + React 19 + Prisma + SQLite + Tailwind CSS
AI 引擎	支持自定义 OpenAI 兼容 API / 内置 SDK 双重回退
画面风格	古风水墨暗色主题，20+ CSS 动画效果
语言	简体中文（自然语言指令）
核心特点	AI 实时叙事生成、自然语言命令解析、回合制战斗

---

2. 快速入门

2.1 创建角色

进入游戏后，输入你的角色名（1-12个字符）并选择一个职业：

职业	图标	特点	属性加成
武夫	⚔️	力破万法，身强力壮	力量+8、体质+6、敏捷+5
书生	🪶	智谋过人，善于策论	智力+8、魅力+7
游侠	🍃	身法灵动，来去如风	敏捷+8、运气+7
医者	⚗️	悬壶济世，气血充沛	智力+7、体质+7

初始赠送物品：朴刀×1、金疮药×3、粗布衣×1

初始位置：梁山泊·忠义堂

2.2 游戏界面

• 左侧面板：角色状态面板（属性、装备、背包、任务）
• 中央区域：游戏消息流（系统消息、叙事文本、战斗日志、NPC对话）
• 底部输入栏：输入自然语言指令，如"去北"、“看”、“和宋江说话”
• 右侧面板：小地图、快捷指令、技能系统

2.3 基本操作

所有操作通过输入自然语言命令完成。例如：

看              — 查看当前场景
向北            — 向北移动
和宋江说话       — 与宋江对话
攻击猛虎         — 发起战斗
使用金疮药       — 使用药品

---

3. 角色系统

3.1 基础属性

属性	说明	初始范围
等级 (Level)	角色等级，通过获得经验提升	1
经验 (EXP)	积累到一定值即可升级	0
生命 (HP)	归零则昏迷	100
内力 (MP)	施展技能消耗	50
力量 (STR)	影响攻击力	50+职业加成
敏捷 (AGI)	影响闪避率	50+职业加成
智力 (INT)	影响技能效果	50+职业加成
体质 (CON)	影响HP和防御	50+职业加成
魅力 (CHA)	影响NPC关系	50+职业加成
运气 (LUK)	影响暴击和随机事件	50+职业加成

3.2 战斗属性

属性	说明	来源
攻击力	基础伤害	10 + 力量 × 0.2
防御力	伤害减免	5 + 体质 × 0.1
暴击率	触发暴击概率	10% + 运气 × 0.1%
闪避率	闪避攻击概率	10% + 敏捷 × 0.15%

3.3 武器熟练度

角色拥有六种武器熟练度，通过使用对应武器逐步提升：

• 剑熟练度、枪熟练度、棍熟练度、弓熟练度

3.4 等级经验表

经验公式：所需经验 = 100 × 1.5^(等级-1)

等级	升级所需经验
1→2	100
2→3	150
3→4	225
4→5	338
5→6	506

---

4. 世界地图

4.1 四大区域

区域	地点数	势力	特色
梁山泊	6处	梁山	忠义堂、聚义厅、演武场、水寨、后山、山道
东京汴梁	3处	朝廷	大相国寺、瓦舍、汴梁大街
野外	4处	中立	景阳冈、十字坡、野猪林、快活林
城镇	4处	朝廷	沧州城、孟州城、江州城、大名府

4.2 完整地点列表

梁山泊区域

地点	代码	NPC	功能
🏯 忠义堂	liangshan_zhongyitang	宋江、吴用、卢俊义、燕青	商店
🏛️ 聚义厅	liangshan_juyiting	吴用、公孙胜	—
⚔️ 演武场	liangshan_yanwuchang	林冲、鲁智深、李逵	切磋
⚓ 水寨	liangshan_shuizhai	阮小二、阮小五、阮小七	—
⛰️ 后山	liangshan_houshan	—	探索
🛤️ 山道	liangshan_dao	—	交通枢纽

东京汴梁区域

地点	代码	NPC	功能
🛕 大相国寺	dongjing_daxiangguosi	鲁智深	—
🎭 瓦舍	dongjing_washe	—	商店
🏙️ 汴梁大街	dongjing_jie	—	—

野外区域

地点	代码	NPC	危险等级
🐅 景阳冈	jingyanggang	武松	⚠️ 高危
🛖 十字坡	shizipos	孙二娘	⚠️ 中危
🌲 野猪林	yazhulin	—	⚠️ 高危
🍷 快活林	kuaihuolin	—	⚠️ 中危

城镇区域

地点	代码	NPC	功能
🏰 沧州城	cangzhou_cheng	—	商店+医馆
🏘️ 孟州城	mengzhou_cheng	武松	商店+医馆
🏯 江州城	jiangzhou_cheng	宋江	商店+医馆
🏛️ 大名府	damingfu	卢俊义	商店

4.3 地图连接关系

          东京（大相国寺）── 瓦舍 ── 汴梁大街
                                      │
                                      │
                                 景阳冈 ── 快活林
                                      │       │
                                      │       │
  野猪林 ── 沧州城                 十字坡    │
    │          │                      │       │
    │          │                      │       │
    └── 山道 ──┘                     孟州城 ──┘
         │                              │
    ┌────┴────┐                         │
    │         │                         │
  后山 ── 忠义堂                   江州城
    │    /  │  \
    │ 聚义厅 演武场
    │       │
    └── 水寨

           大名府 ── 沧州城

---

5. 移动与探索

5.1 方向移动

指令	说明
北 / 向北 / north	向北移动
南 / 向南 / south	向南移动
东 / 向东 / east	向东移动
西 / 向西 / west	向西移动
上 / 向上 / up	向上移动
下 / 向下 / down	向下移动

5.2 目的地移动

指令	说明
去 忠义堂	移动到指定地点
前往 景阳冈	移动到指定地点

5.3 场景查看

指令	说明
看 / 查看 / 观察	查看当前场景描述
探索 / 搜索周围	探索当前位置，可能触发事件

5.4 环境要素

• 天气：系统动态生成（晴天、阴天、雨天、雪天等），影响叙事氛围
• 时间：游戏内时辰系统（辰时、午时、酉时等），不同时间 NPC 行为不同
• 危险等级：野外地点有危险标识（0=安全、1=低危、2=中危、3=高危），高危险区域更容易遭遇敌人

---

6. NPC 交互系统

6.1 NPC 列表

排名	姓名	绰号	星号	位置
1	宋江	及时雨	天魁星	忠义堂 / 江州城
2	卢俊义	玉麒麟	天罡星	忠义堂 / 大名府
3	吴用	智多星	天机星	忠义堂 / 聚义厅
4	公孙胜	入云龙	天闲星	聚义厅
6	林冲	豹子头	天雄星	演武场
13	鲁智深	花和尚	天孤星	演武场 / 大相国寺
14	武松	行者	天伤星	景阳冈 / 孟州城
22	李逵	黑旋风	天杀星	演武场
27	阮小二	立地太岁	天剑星	水寨
29	阮小五	短命二郎	天罪星	水寨
31	阮小七	活阎罗	天败星	水寨
36	燕青	浪子	天巧星	忠义堂
103	孙二娘	母夜叉	地壮星	十字坡

6.2 NPC 对话

指令	说明
和 宋江 说话 / 对话 宋江	与 NPC 对话
问 宋江 关于梁山	询问特定话题

每个 NPC 都有：

• 独特性格标签（如宋江：仁义、谨慎、有野心）
• 背景故事（AI 会根据背景故事生成个性化对话）
• 关系网络（盟友/对手/仇敌）
• 招募状态（部分 NPC 可招募）
• 招募条件（需要达到一定的实力和声望）

6.3 NPC 关系

玩家与 NPC 之间可以发展关系：

• 赠礼：赠礼 宋江 酒壶 — 提升好感
• 拜师：拜师 林冲 — 结为师徒
• 叛师：叛师 — 解除师徒关系

---

7. 战斗系统

7.1 发起战斗

指令	说明
攻击 猛虎 / 打 猛虎 / 杀 猛虎	攻击目标
挑衅 武松	挑衅 NPC 触发战斗
切磋 林冲	友好切磋（不影响关系）
逃跑 / 逃	从战斗中逃跑

7.2 战斗公式

伤害计算：

基础伤害 = max(1, 攻击力 - 防御力 × 0.5) × (1 + 力量 × 0.01)
暴击率 = 10% + 运气 × 0.15%
暴击伤害 = 基础伤害 × (1.5 + 运气/200)
闪避率 = 闪避值 + 体质 × 0.1

流程： 闪避判定 → 基础伤害 → 暴击判定 → 最终伤害

7.3 战斗状态

状态	说明
进行中	战斗正在进行
胜利	获得经验、金币、物品奖励
失败	HP 归零，可能损失物品
逃跑	脱离战斗（有概率失败）

7.4 技能战斗

技能	代码	效果
猛虎一击	skill_01	造成 2× 攻击力伤害
飞燕回旋	skill_02	造成攻击力伤害 + 提升闪避
铁壁防御	skill_03	提升防御力 2 回合
奔雷斩	skill_04	造成 1.8× 伤害 + 降低敌人防御
回天术	skill_05	恢复 30% + 智力×0.5 HP

---

8. 装备与物品

8.1 物品类型

类型	说明
武器	刀、枪、棍、弓等，提升攻击力
防具	布衣、皮甲、铠甲等，提升防御力和HP
药品	回血、回蓝药品
杂物	任务道具、收藏品
秘籍	可学习的武功秘籍

8.2 物品稀有度

稀有度	颜色	示例
普通	白色	朴刀、齐眉棍、粗布衣
精良	绿色	镔铁大刀、锁子甲
稀有	蓝色	雪花镔铁刀、明光铠
传说	金色	丈八蛇矛、六十二斤水磨禅杖

8.3 装备管理

指令	说明
装备 朴刀	装备物品
卸下 / 卸装	卸下装备
背包 / 物品栏	查看背包
使用 金疮药	使用物品
强化 朴刀	强化武器
合成	合成物品

---

9. 货币系统

货币	换算比例	获取方式
黄金	1 金	任务奖励、战斗掉落
白银	1 金 = 10 银	商店交易
铜钱	1 银 = 50 铜	技能系统产出、签到奖励

货币用于：

• 商店购买物品
• 集市交易
• 帮派捐献
• 悬赏令兑换

---

10. 任务系统

10.1 任务类型

类型	说明
主线任务	推进剧情进度，解锁新内容
支线任务	NPC 委托，获得额外奖励
随机任务	探索中触发的随机事件
每日任务	阵营日常，每天刷新
主线任务链	多分支长线剧情

10.2 任务操作

指令	说明
任务 / quests	查看当前任务
接任务	接取可用任务
接 初入江湖	接取指定任务
放弃任务	放弃当前任务
主线 / 任务链	查看主线任务链
主线进度	查看任务链进度

10.3 现有任务

主线任务：

1. 初入江湖（Lv1）— 拜见宋江，证明实力
2. 景阳冈打虎（Lv3）— 前往景阳冈降伏猛虎
3. 智取生辰纲（Lv5）— 协助吴用夺取生辰纲
4. 林冲上山（Lv3）— 护送林冲安全上梁山

支线任务：

1. 孙二娘的委托（Lv2）— 采购药材
2. 阮氏三雄的考验（Lv2）— 通过水性和勇气考验
3. 武松比武（Lv5）— 与武松切磋

---

11. 技能子系统（43种）

游戏内置 43 种休闲/生活技能子系统，每个系统有独立的等级、排名、冷却时间和成功率公式。

11.1 完整技能列表

#	前缀	技能名称	图标	顶级称号	冷却
1	dy	垂钓	🎣	钓仙	—
2	sn	烹饪	🍳	厨仙	—
3	lw	演武	⚔️	武神	—
4	yk	篆刻	🔨	天子玉玺	—
5	jb	建屋	🏗️	仙阁凌霄	—
6	cm	猜谜	💡	万谜归宗	—
7	xg	观星	🔭	摘星换斗	—
8	ql	气功	🧘	气贯长虹	—
9	ds	堆雪	❄️	冰雪奇缘	—
10	gz	制陶	🏺	陶瓷圣品	—
11	bs	狩猎	🏹	万兽之王	—
12	xc	奏乐	🎵	天籁之音	—
13	wq	舞狮	🦁	天下第一狮	—
14	lf	炼金	⚗️	点石成金	—
15	pk	劈波	🌊	海神降临	—
16	rw	摔跤	🤼	天下第一力	—
17	sq	弄蛇	🐍	万蛇之主	—
18	gx	骨牌	🎲	天下第一牌	—
19	vp	炮术	💣	毁天灭地	—
20	xl	开锁	🔑	天下无锁	—
21	qj	秋千	🎪	仙鹤秋千	—
22	nh	塑像	🗿	万象塑像	—
23	zr	扎纸	🎋	纸扎天下	—
24	td	高跷	🎪	凌空飞跷	—
25	cr	走索	🪢	天下第一索	—
26	fn	飞镖	🎯	百步穿杨	—
27	ks	扛鼎	🏋️	霸王举鼎	—
28	eh	水上漂	💧	水上飞仙	—
29	hl	悬壶	🫗	医仙圣手	—
30	ik	滑冰	⛸️	冰神降临	—
31	jw	鉴宝	🏺	天下第一眼	—
32	ln	骑术	🐴	天马行空	—
33	mz	糖人	🍬	糖仙降临	—
34	oq	擒拿	🤜	天下第一手	—
35	pr	算卦	🔮	天机不可泄	—
36	rv	走镖	🛡️	威震镖局	—
37	sx	水墨画	🎨	丹青圣手	—
38	tz	铜镜	🪞	明镜高悬	—
39	uw	驯鹰	🦅	鹰王降世	—
40	vm	伏魔	👹	万魔归伏	—
41	xo	仙棋	♟️	棋圣无双	—
42	yt	阵法	⛰️	天罡地煞阵	—
43	za	锻造	🔨	天下第一兵	—

每个技能系统均有 10 个等级，从"入门"到"天下第一"称号。

11.2 技能使用

指令示例	说明
垂钓 / 钓鱼	使用垂钓技能
烹饪 / 做饭	使用烹饪技能
观星	使用观星技能
锻造 / 打铁	使用锻造技能
技能	查看技能状态
技能 垂钓	查看指定技能详情

---

12. 天赋系统

12.1 天赋列表

天赋	效果
天生神力	力量永久 +5
身轻如燕	敏捷永久 +5
聪慧过人	智力永久 +5
铁骨铮铮	体质永久 +5
魅力四射	魅力永久 +5
福星高照	运气永久 +5
铜皮铁骨	防御力永久 +3
锋利之刃	攻击力永久 +3
回春术	HP 恢复效果 +20%
聚气术	MP 恢复效果 +20%
杀伐果断	暴击率 +5%
身法精通	闪避率 +5%

使用 天赋 或 talent 指令查看天赋详情。

---

13. 成就系统

游戏内置 16 个成就，通过特定行为自动触发解锁：

成就	触发条件	称号
初试锋芒	首次击杀敌人	江湖新秀
八面玲珑	累计对话 20 次	八面玲珑
探索者	累计探索 10 次	江湖行者
日进斗金	铜钱达到 50000	日进斗金

使用 成就 指令查看已解锁成就。

---

14. 宠物/灵兽系统

14.1 宠物操作

指令	说明
宠物	查看宠物状态
我的宠物	查看拥有的宠物
捕捉 小狐狸	捕捉野生动物
宠物出战	派遣宠物协助战斗
宠物进化	进化宠物提升能力

宠物拥有属性：名称、等级、HP、攻击、防御、敏捷、忠诚度、技能、心情、稀有度。

---

15. 帮派系统

15.1 帮派操作

指令	说明
帮派 / 门派	查看帮派信息
创建帮派 梁山会	创建新帮派
帮派信息	查看帮派详情
帮派成员	查看成员列表
帮派管理 / 帮务	管理帮派事务
帮派战 / 攻城	发起帮派战

15.2 帮派功能

• 帮派等级：通过成员贡献度升级
• 帮派技能：可研发帮派专属技能
• 帮派领地：争夺和控制领地
• 帮派战：与其他帮派群战
• 帮派金库：成员捐献资金

---

16. 师徒传承

指令	说明
拜师 林冲	拜某 NPC 为师
师父 / mentor	查看师父信息
叛师	背叛师门
传授	师父传授技能给徒弟
可传秘籍	查看可传授的秘籍

---

17. 声望与阵营

17.1 三种声望

声望	说明	获取方式
梁山声望	在梁山泊的地位	完成梁山任务、与好汉交好
朝廷声望	在朝廷中的名声	与官场互动
江湖声望	在江湖中的威名	打虎、比武、除恶

17.2 声望商店

使用声望值在声望商店兑换物品：

声望商店 / 声望商城 — 查看可兑换物品

---

18. PVP 竞技

指令	说明
pvp / 竞技	进入 PVP 竞技
比武 玩家名	向指定玩家发起挑战

PVP 段位： 新手 → 江湖少侠 → 武林高手 → 一代宗师 → 武林至尊

PVP 模式： 切磋模式、排位模式、帮派联赛

---

19. 悬赏令系统

指令	说明
悬赏 / 赏金	查看悬赏令列表
悬赏详情	查看悬赏详情
接取悬赏 [编号]	接受悬赏任务
完成悬赏 [编号]	提交完成悬赏

悬赏目标按难度分为 5 个等级，奖励逐级递增。

---

20. 藏宝图与秘境

20.1 藏宝图

指令	说明
藏宝图	查看当前藏宝图
寻宝	开始寻宝

20.2 隐藏地点/秘境

指令	说明
秘境 / 隐藏地点	查看已发现的秘境
探索秘境 [名称]	进入秘境探险

秘境有多层结构，越深入奖励越丰厚。

---

21. 炼丹炼器系统

指令	说明
炼丹 / 丹药	炼丹制药
炼器 / 锻造装备	炼制装备
配方列表	查看全部配方
炼制 [配方名]	制作指定物品
我的配方	查看已掌握配方
合成配方	查看合成配方列表

---

22. 行商与丝绸之路

22.1 行商

指令	说明
集市	进入集市交易
集市挂牌 金疮药 50	挂牌出售物品
集市购买 [编号]	购买集市物品
集市撤回 [编号]	撤回挂牌物品

22.2 丝绸之路

长途贸易路线，买卖各地特产商品赚取差价。

---

23. 江湖情缘与结义

23.1 结义系统

指令	说明
结义 [NPC名]	与 NPC 结义

23.2 情缘系统

与 NPC 培养感情，发展江湖情缘。

---

24. 节日庆典与武林盛会

系统会定期触发江湖事件和节日活动：

• 武林盛会：限时比武大会
• 节日庆典：春节、元宵、中秋等节日特殊活动
• 世界事件：梁山攻防战等大型事件
• 江湖日报：每日自动生成江湖新闻
• 天象异变：特殊天象事件

---

25. 武学境界与绝学

25.1 武功境界

境界	说明
初窥门径	入门阶段
略有小成	小有所成
融会贯通	融会贯通
炉火纯青	炉火纯青
登峰造极	登峰造极
返璞归真	返璞归真
天人合一	天人合一
破碎虚空	破碎虚空

使用 武学境界 指令查看当前境界。

25.2 绝学系统

顶级武学技能，威力巨大但有较长冷却时间。

25.3 武功秘籍

指令	说明
秘籍 / 武功秘籍	查看秘籍列表
修炼 [秘籍名]	学习修炼秘籍
已学秘籍	查看已学秘籍

---

26. 社交聊天系统

指令	说明
说话 [内容]	在当前场景发言
喊话 [内容] / 喊	世界频道发言
私聊 [玩家名] [内容]	私聊其他玩家

其他社交功能

• 邮件系统：收发江湖邮件
• 排行榜：查看各项排名
• 酒馆：与其他玩家闲聊
• 书信系统：撰写和收到 NPC 书信

---

27. 命令行指令大全

27.1 基础指令

指令	功能	别名
北 / 南 / 东 / 西	方向移动	向北、north
上 / 下	上下移动	up、down
去 [地点]	前往指定地点	前往、移动
看	查看场景	查看、观察、look
探索	探索周围	探险、搜索周围
帮助	查看帮助	help、?

27.2 角色与状态指令

指令	功能
状态 / 属性 / info / status	查看角色属性
背包 / 物品栏 / inventory	查看背包
休息 / rest	原地休息恢复
打坐 / 冥想	打坐修炼恢复MP
签到 / 每日签到	每日签到领奖励
天赋 / talent	查看天赋系统
成就 / achievement	查看成就
排行 / 排行榜 / ranking	查看排行榜
称号 / title / 头衔	查看称号
日志 / journal / 经历	查看江湖日志

27.3 战斗指令

指令	功能
攻击 [目标] / 打 [目标] / 杀 [目标]	攻击目标
挑衅 [目标] / taunt	挑衅触发战斗
切磋 [目标] / sparring / 比武	友好切磋
逃跑 / 逃 / flee	逃离战斗
pvp / 竞技	PVP 竞技

27.4 NPC 交互指令

指令	功能
和 [NPC] 说话 / 对话 [NPC]	与 NPC 对话
赠礼 [NPC] [物品] / 赠送	赠送礼物
拜师 [NPC]	拜师学艺
叛师 / 背叛师父	解除师徒关系
乞讨 / 化缘	乞讨
投石 / 投石问路	试探环境

27.5 物品与装备指令

指令	功能
装备 [物品] / 穿戴	装备物品
卸下 / 卸装	卸下装备
使用 [物品] / 用 / 吃 / 喝	使用物品
强化 [物品] / enhance	强化物品
合成 / synthesize	合成物品
鉴宝 / 鉴定 / appraise	鉴定物品

27.6 商店与经济指令

指令	功能
商店 / shop	查看商店
购买 [物品] / 买 / buy	购买物品
出售 [物品] / 卖	出售物品
集市 / market	进入集市
声望商店	声望商店
典当	典当物品

27.7 任务指令

指令	功能
任务 / quests	查看任务
接任务 / 接 [任务名]	接取任务
放弃任务	放弃任务
主线 / 任务链	主线任务链
每日任务 / 日常 / daily	每日任务

27.8 技能系统指令

指令	功能
技能 / skill	查看技能状态
垂钓 / 钓鱼	垂钓
烹饪 / 做饭	烹饪
演武 / 练武	演武
观星 / 看星	观星
气功	气功修炼
狩猎 / 打猎	狩猎
奏乐 / 弹琴	奏乐
炼金	炼金术
摔跤 / 角力	摔跤
飞镖	飞镖投掷
算卦 / 占卜	算卦占卜
阵法 / 布阵	布阵
锻造 / 打铁	锻造
… (共 43 种，详见 §11)

27.9 江湖系统指令

指令	功能
传闻 / 消息 / rumor	江湖传闻
日报 / 新闻 / news	江湖日报
悬赏 / 赏金 / bounty	悬赏令
酒馆 / 喝酒 / tavern	酒馆
练功 / 修炼 / train	独自练功
历练 / 副本 / dungeon	副本冒险
藏宝图 / treasure	藏宝图寻宝
求签 / fortune / 算命	求签问卦
奇遇 / encounter	触发江湖奇遇
江湖 / 好汉 / heroes	江湖名人录

27.10 特殊系统指令

指令	功能
帮派 / 门派 / guild	帮派系统
宠物 / pet	宠物系统
邮件 / mail / 信箱	邮件系统
秘籍 / 武功秘籍 / manual	武功秘籍
秘境 / 隐藏地点	隐藏地点
炼丹 / 丹药	炼丹系统
炼器 / 锻造装备	炼器系统
食谱 / 配方 / recipe	食谱配方
武学境界 / martial_realm	武功境界
采集 / forage	采集资源
采矿 / 挖矿 / mine	采矿

27.11 社交指令

指令	功能
说话 [内容]	场景发言
喊话 [内容] / 喊	世界频道
私聊 [玩家] [内容]	私聊

---

28. 技术架构

28.1 技术栈

层级	技术
前端框架	Next.js 16 + React 19 + TypeScript
UI 组件	Radix UI + shadcn/ui + Tailwind CSS
动画	Framer Motion + 自定义 CSS @keyframes
数据库	SQLite + Prisma ORM
AI 引擎	自定义 OpenAI 兼容 API + z-ai-web-dev-sdk 回退
状态管理	TanStack React Query + Zustand
图表	Recharts
Markdown	react-markdown
构建工具	Turbopack + Bun

28.2 项目结构

src/
├── app/
│   ├── api/game/
│   │   ├── action/route.ts      — 游戏核心行动处理器 (~23000+ 行)
│   │   ├── create/route.ts      — 角色创建 API
│   │   ├── map/route.ts         — 地图 API
│   │   ├── stats/route.ts       — 统计数据 API
│   │   └── achievements/route.ts — 成就 API
│   ├── page.tsx                 — 主游戏页面 (~6000+ 行)
│   ├── layout.tsx               — 根布局
│   └── globals.css              — 全局样式 + 20+ 动画
├── components/ui/               — shadcn/ui 组件库
├── lib/
│   ├── game/engine.ts           — 游戏引擎核心 (~9000+ 行)
│   │   ├── 战斗公式
│   │   ├── 指令解析器
│   │   ├── 43 个技能子系统定义
│   │   └── 90+ 游戏系统常量定义
│   ├── ai.ts                    — AI 模型接口层
│   ├── db.ts                    — Prisma 数据库客户端
│   └── seed.ts                  — 种子数据（地图、NPC、物品、任务）
└── hooks/                       — React Hooks

28.3 数据库模型

模型	说明
Player	玩家数据（属性、装备、声望、宠物、技能、成就）
Item	物品定义（武器、防具、药品、杂物）
PlayerItem	玩家背包（物品×数量、装备状态）
Location	地点（名称、描述、连接、NPC、功能）
Npc	NPC 数据（属性、性格、关系、对话）
Quest	任务定义（条件、步骤、奖励）
PlayerQuest	玩家任务进度
Battle	战斗记录
DialogueLog	NPC 对话历史

---

附录：游戏特色总结

1. AI 驱动叙事：所有场景描述、NPC 对话、事件结果均由 AI 大模型实时生成，每次体验都不同
2. 海量游戏系统：43 种技能子系统 + 90+ 种全局游戏系统，内容极其丰富
3. 自然语言交互：使用自然中文命令操作，无需记忆复杂语法
4. 水浒世界观：深度还原《水浒传》人物、场景、剧情，沉浸式体验
5. 高扩展性：支持自定义 AI 模型接入，后端架构易扩展
6. 水墨暗色主题：古风 UI 设计 + 20+ CSS 动画效果
7. 57,000+ 行代码：包含完整的战斗、经济、社交、养成系统

---

“替天行道，忠义为先。一百零八将在此等候你的到来！”

— 宋江·及时雨