游戏主控技能 (Game Manager Skill)
概述
本技能是整个武侠世界的“天道”,负责管理所有 Skill 的生命周期、状态持久化以及世界线的重置工作。
核心职责
- •持久化管理:通过
persistence.py驱动 SQLite 存档与读档。- •SQLite 中心化: 所有 Skill 的
references/数据在存档时必须同步至assets/saves/wuxiaX.db。 - •差异同步原则: 读档时,必须以数据库为准,自动识别并强制覆盖本地有差异的 Skill 实体文件。
- •指令调用:
- •
/game-save: 触发全量数据库存档。 - •
/game-load: 从数据库恢复状态。
- •
- •SQLite 中心化: 所有 Skill 的
- •全局同步:确保所有 Skill 实体文件(.md)与中心数据库保持 100% 同步。
- •世界重置:处理
/game-restart指令,通过reset_game_state()还原所有数据至初始模板。
指令逻辑:/game-restart
当玩家输入重置指令时,必须执行以下流程:
- •物理重置:调用
python .agent/skills/game-manager-skill/scripts/manager.py --reset。- •这将还原所有
references/*.md至初始模板,并清空数据库与章节历史。
- •这将还原所有
- •建立新缘:物理重置完成后,说书人(story-engine)必须立刻发起引导式对话:
- •确定主角的基本属性(姓名、性别、出身)。
- •让玩家选择性格特质(正、邪、狂、狷倾向)。
- •选择初始武学流派。
- •设定世界难度。
- •铭刻初始:将玩家的选择写入
protagonist-skill/references/character_sheet.md,然后正式开启“圣堂觉醒”第一回。
脚本索引
- •
scripts/manager.py: 核心管理逻辑。 - •
scripts/persistence.py: 数据持久化接口。 - •
scripts/db_init.py: 数据库初始化。