| name | world-logic |
| description | 负责构建宏大的武侠文本江湖。处理区域地理（Spatial Nodes）、门派势力（Sect System）与时间流转（Time-State）。核心职责包括维护世界观的一致性，确保 NPC、地理与门派信息的准确检索与调用。 |
文本江湖：空间与时间逻辑 (World Logic)
本 Skill 是文本江湖的底层架构，决定了玩家如何感知世界和时间的流动。
1. 空间节点系统 (Spatial Node System)
世界由相互连接的“区域（Region）”组成。玩家通过指令在不同区域间穿梭，无需关注具体的东南西北方位。
核心属性
- 环境描述 (Description)：通过精炼的文字展现视觉感知。
- 出口方向 (Exits)：定义可通行方位。
- 对象与互动 (Interactions)：房间内的物品、NPC 或可搜索点。
- 隐藏判定：部分对象（如埋藏的铁石）需通过
search 或 look 动作发现。
地理档案参考
详细的区域划分与内容设定，请直接参考 references/spatial_nodes.md。
2. 时间轮转系统 (Time-State System)
游戏内置全局时钟，昼夜交替影响 NPC 行为和剧情触发。
时段划分
- 白天 (Day)：NPC 正常活动，店铺营业。
- 黑夜 (Night)：特殊 NPC（如盗墓兄弟）出现，视野受限，潜行加成。
逻辑触发
3. 交互指令集 (Interaction Parser)
将视觉操作转化为文本指令：
look [target]：观察环境或特定对象。search [ground/object]：搜寻隐藏物。gather/mine：采集资源。jump up / climb：地形穿越（需轻功判定）。
4. 江湖律令 (World Rules)
定义了人格、善恶、势力及奇遇的底层逻辑，确保世界运行符合武侠逻辑。
见 references/world_rules.md。
5. 门派势力系统 (Sect & Faction System)
必须遵守 (Mandatory)
门派势力是江湖生态的核心组成部分，影响 NPC 行为、剧情走向和玩家声望。
势力分类
- 正道门派：武当、少林、丐帮、名剑山庄、赋闲书院等，侠义为先
- 中立势力：神鹰门、马帮、采玉帮、俏梦阁等，利益优先
- 邪道势力：五仙教、西域魔教、长生殿等，各有所图
- 隐世势力：圣堂、先民部落、雪山派等，远离尘世
势力交互规则
- 声望影响：玩家行为会改变与各势力的关系，影响 NPC 态度和任务获取
- 门派冲突：部分门派存在敌对关系，帮助一方可能得罪另一方
- 势力领地：进入门派领地时，根据声望触发不同的遭遇事件
- 门派武学：高声望可解锁门派秘传武学和装备
势力档案参考
完整的门派设定见 references/sect_list.md，包含：
- 34 个主要门派的详细档案
- 势力关系网络图
- 核心武学与代表人物
6. 信息检索协定 (Information Retrieval Protocol)
必须遵守 (Mandatory)
当故事发展涉及以下要素时，必须优先检索对应的档案库，以确保世界观的连贯性：
8.1 涉足新区域 (Entering Regions)
当主角抵达或提及某个地名时：
- 检索目标:
world-logic/references/spatial_nodes.md
- 提取要素:
- 环境特征: 确保描写符合（如“雪山峭壁”不能写成“郁郁葱葱”）。
- 资源分布: 确认该地特产（如“五毒虫”仅在南疆）。
- 兽王威胁: 检查该区域是否有兽王盘踞（如“白马居”附近的狼王）。
- 常驻 NPC: 确认谁是这里的地头蛇。
8.2 遭遇 NPC (Encountering NPCs)
当主角与 NPC 互动时：
- 检索目标:
npc-skill/references/npc_list.md
- 提取要素:
- 身份与性格: 确保言行一致。
- 美学与生理 (女性): 若涉及细致描写，必须引用档案中的“美学采样”与“生理快照”。
- 门派归属: 确认其背后的势力立场。
8.3 门派交互 (Sect Interactions)
当主角与门派发生关联（拜访、冲突、任务）时：
- 检索目标:
world-logic/references/sect_list.md
- 提取要素:
- 所处据点: 确认门派的具体位置。
- 外交立场: 确认该门派是正是邪，与主角当前声望是否冲突。
- 核心武学: 确保战斗或切磋时使用的招式符合门派传承。
资源参考
7. 叙事初始化系统 (Narrative Initialization)
游戏开始时，通过叙事初始化脚本从叙事库中随机抽取组合，生成游戏的叙事基调。
7.1 世界级叙事
定义了游戏的宏观背景、长线冲突和核心势力动态。见 world_narratives.md。
当前收录 10 种世界叙事母题：
- 壹、朝堂与江湖
- 贰、门派传承之争
- 叁、民族存亡之秋
- 肆、宝藏与秘境
- 伍、仇杀与因果
- 陆、易代武林
- 柒、正邪终极之战
- 捌、武林新一代
- 玖、隐秘组织与幕后黑手
- 拾、天道轮回·因果循环
7.2 章节级叙事
定义了主角的初始故事线和发展方向。见 chapter_narratives.md。
当前收录 20 种章节叙事类型，涵盖：
- 失落绝学的复兴之路
- 门派的隐秘历史
- 江湖公子的崛起
- 仇人之子的两难
- 江湖阴谋的初现
- 等等...
7.3 初始化流程
游戏重置后，必须执行叙事初始化：
python .agent/skills/world-logic/scripts/narrative_initializer.py
该脚本将：
- 随机选取一条世界叙事
- 随机选取一条章节叙事
- 生成初始线索
- 将组合叙事写入
protagonist-skill/references/character_sheet.md
7.4 叙事检索协定
在生成剧情时，必须先读取 character_sheet.md 中的"初始叙事上下文"，确保：
- 世界叙事的核心势力和长线伏笔得到体现
- 章节叙事的发展方向被正确延续
- 初始线索成为玩家故事的自然起点
