末法仙薄 · 文字修仙沙盒
末法之世，灵气如残灯。 一款慢节奏、强沉浸的文字修仙沙盒：六边形格子天下、数值化民生流转、信息即玩法——你听到的每一句话都可能是假的。 手机 / Pad / PC 三端适配，多语言（默认中文）。
本项目由 xiuxian_demo（3D 单机 demo）的成熟设定演化而来，保留其核心世界观与修炼体系，载体从 3D 实时画面改为文字 + 六边形地图，以便在手机低配设备上承载更深的世界模拟与信息玩法。
0. 当前阶段：M3 收尾 · M4 进行中
M0 设定已于 2026-09-23 全部拍板，git 仓库已初始化（main）。M1（工程骨架）、M2（出身篇与六边形天下）均已关闭；M3：活的人间 + 炼气前期 主体落地待收尾，M4：炼气圆满 → 筑基 已开工（妖兽遭遇三段式、见闻重构、时辰历、切磋、神识与识海盘入战、8 层阳窍炼器、筑基四阶与灵宠契约、战斗状态与战丹四味、技能熟练度五档（第十段）、中宫符箓工艺与人对人交涉（第十一段）、**心魔战首版与筑基中期御器/后期外门执事（第十二段）**均已落地；M4 余项见 12）。
常用命令：
npm install # 依赖（已配 .npmrc 走 npmmirror）
npm run dev # 本地开发
npm run typecheck; npm run lint; npm test; npm run build # 质量门
npx playwright test # 三视口（375/1024/1280）冒烟
设计文档仍是开发的唯一真源，索引见下方。
1. 文档索引（AI 与开发者的唯一真源）
| 文档 | 内容 | 何时读 |
|---|---|---|
| docs/00-overview.md | 一句话定位、核心支柱、平台范围、开放问题、命名 | 最先读 |
| docs/01-worldview.md | 末法世界观、时间历法（行动结算）、灵气分布、一世一真相（九假说）、天象 | 做世界/内容时 |
| docs/02-cultivation.md | 修炼体系：九大境界无品阶、每层丹材、行为印记塑道、道心明蚀浊、以寿换境 | 做修炼/战斗时 |
| docs/03-hex-map.md | 六边形世界模型：坐标/地形/灵气/资源/定居点/子区域/势力领地/迷雾/移动与路途遭遇 | 做地图/移动时 |
| docs/04-society.md | 社会：村镇城寨/宗门/家族/国家、民生数值模拟、NPC 模型、人际关系、经济百工 | 做势力/NPC/经济时 |
| docs/05-life-death.md | 角色创建、属性与日常、死亡五类痕迹、转世、飞升、一世小传 | 做角色/存档结构时 |
| docs/06-simulation-events.md | 世界模拟引擎：时间 tick、事件总线、事件库、编年史、文字战斗方案 | 做核心模拟时 |
| docs/07-information.md | 信息系统：知识三态、日志分 tab、传闻网络、打探/封锁/造谣、道心虚假信息 | 做日志/情报时 |
| docs/08-ui-design.md | 三端 UI 规范：布局、导航、组件、视觉语言、断点、无障碍 | 做任何界面时 |
| docs/09-i18n-copy.md | 多语言架构、术语译法表、沉浸式文案风格规约 | 写文案/做 i18n 时 |
| docs/10-tech-architecture.md | 技术栈、分层架构、存档、性能、测试、目录规划 | 写代码前 |
| docs/11-ai-workflow.md | AI 接手指南：阅读顺序、文档契约、智能体分工、技能与 MCP 推荐、提效工具 | AI 每次接手时 |
| docs/12-roadmap.md | 里程碑路线图、MVP 范围、验收标准、决策日志 | 排期/开工时 |
| docs/13-references.md | 小说/影视/游戏参考与可借鉴点 | 头脑风暴时 |
| docs/14-origins-tutorial.md | 出身谱系与仙途缘起剧情、教程解锁全表 | 做出身/新手引导时 |
| docs/15-combat-shenshen.md | 实时战斗、识海盘装备、功法行为相、技能熟练度、灵宠战用规则 | 做战斗/装备时 |
| docs/16-crafting-materials.md | 各境界丹方、法宝、符箓、阵法、材料体系、背包仓库 | 做百工/物品时 |
| docs/17-secret-factions-party.md | 秘境搜打撤、宗门/家族/朝廷玩法（入门大逃杀/擂台/自立）、组队 | 做组织/副本时 |
| docs/18-truth-cosmos.md | 剧透向：九真相假说库、飞升、三次飞升后的宇宙树终局 | 做主线/终局时 |
| docs/19-monetization.md | 盈利方式全景调研与本作方案（免费试玩+买断+DLC+外观，拒绝数值内购） | 谈商业化/发布时 |
| 设计图 | 内容 |
|---|---|
| design/prototype.html | 六个 UI 画板：手机（区域/地图/行囊）、识海盘与战斗三段式、Pad 竖屏定制、Pad 横屏、PC，浏览器打开 |
| AI 配置 | 内容 |
|---|---|
| .trae/rules/project.md | Trae 项目规则（自动生效）：文档契约、术语、禁区、拍板后全库扫改 |
| .trae/skills/ | 项目技能：lore-sweep（拍板扫库）、new-setting（吸收新设定）、copy-review（文案审查） |
| AGENTS.md | 跨工具（Codeline/ChatGPT 等）通用 AI 接手入口 |
| docs/11-ai-workflow.md | 智能体/技能/MCP 实操步骤、提效工具、用户待办清单（§7.7） |
| tools/glossary.json + check-copy.mjs | 文案违禁词/术语表 + 机检脚本（node tools/check-copy.mjs --docs） |
2. 文档维护契约（AI 与开发者必读，最高优先级）
凡发生以下变动，必须在同一轮任务内同步更新对应文档，再宣告任务完成：
- 设定调整（世界观、境界、丹性、道心、寿元、势力、地图规则、信息规则、文案风格等）→ 更新
docs/01~`docs/09` 对应章节。 - 新增/删除/重构系统或数据结构 → 更新对应设计文档与 docs/10-tech-architecture.md；路线变化更新
docs/12-roadmap.md。 - 新增工程坑/教训（排查出的 bug 根因、环境/存档问题）→ 追加到 docs/10-tech-architecture.md 的「已知坑与教训」。
- UI/交互变动 → 同步更新 docs/08-ui-design.md 与
design/prototype.html。 - 新增/改动任何玩家可见文案 → 必须同时写入 i18n 语言包（默认 zh-CN），禁止硬编码字符串（见 docs/09-i18n-copy.md）。
- AI 工作流变化（新智能体、新技能、新 MCP、新提效工具）→ 更新 docs/11-ai-workflow.md。
交付前自检：
- 改动是否真实落盘（历史教训：外部进程回滚导致修复丢失，grep/读文件验证关键改动仍在）；
- 文档描述与代码/设计图是否一致；
- 拍板后全库捋一遍（强制）：任何设定/系统一旦由用户拍板，除了改当事文档，必须 grep 全库检索旧表述（旧名、旧数字、旧方案）并同步修正，再更新 docs/00-overview.md 拍板进度与 docs/12-roadmap.md 决策日志；汇报时列出"本轮共扫改了哪几处"。
- 汇报只发应用与文档站三路链接（2026-09-26 修订，原「逐份文档直链」作废）：只给应用与文档站的本机/内网/外网链接各一组，不再逐份给出被改文档直链；地址取自服务实际输出，可用性由用户自测。
3. 与旧项目（xiuxian_demo / xiuxian_next）的关系
- 设定继承与演进：境界无品阶（升级为九大境界+小层丹材）、道心明蚀浊、寿元坐化与以寿换境、死亡五类痕迹、一世一真相（原 32 碎片三说演进为九假说库）、正魔宗门与地界（降为世人标签，内部是行为印记）、村庄人口四级、兽袭/血月/雷劫/心魔劫、传闻扩散、编年史——详见各文档。
- 载体变化：3D 实时移动/战斗 → 六边形移动 + 文字实时自动演算战斗（对峙→观战→处置，战中不操作）。旧实现不直接复用代码，但设计经验全部有效（低配优先、seed 入存档、沉浸文案、打击感转化为战报文风等）。
- 旧项目保持独立可玩，不删除、不回退。